Parcel Methods

UpdateParcelDispatch

Note

LEGACY: For reference only. These methods do not need to be implemented by Merchants anymore.

UpdateParcelDispatch (UpdateParcelDispatchRequest request)

Marks the relevant parcels within a specific order as dispatched from the merchant to the Global‑e hub and updates Delivery Quantities for the products included in each parcel.

SAMPLE

Body:

{
    "OrderId": "GE123456789GB",
    "Parcels": [{
            "ParcelCode": "abc-1234",
            "Products": [{
                    "CartItemId": "123544",
                    "ProductCode": "123467",
                    "DeliveryQuantity": 1
                }, {
                    "CartItemId": "123545",
                    "ProductCode": "123468",
                    "DeliveryQuantity": 0
                }
            ]
        }, {
            "ParcelCode": "abc-1235",
            "Products": [{
                    "CartItemId": "123554",
                    "ProductCode": "123487",
                    "DeliveryQuantity": 2
                }, {
                    "CartItemId": "123545",
                    "ProductCode": "123468",
                    "DeliveryQuantity": 3
                }
            ]
        }
    ]
}

URL:

https://{server_name}/Parcel/UpdateParcelDispatch?merchantGUID=abcdabcd-abcd-abcd-abcd-abcdabcdabcd

ACCEPTS

UpdateParcelDispatchRequest request

Full post data including the OrderId and Parcels for the call

RETURNS

ResponseInfo class

UpdateParcelStatus

Overview

The update status request is issued by the merchant to notify of a parcel’s status change. The notification is received by Global-e and handled asynchronously until the new parcel status is successfully updated. In case of a failure to update, the merchant will not be asked to retry.

For example, if the status update to the new status requested by the merchant is not allowed, or if the parcel has not yet been created, then manual intervention by Global-e will be required.

Prerequisites

When using this call for the Buy-Online-Pick-In-Store (BOPIS) procedure, the UpdateParcelStatus call is initiated by the merchant following the issue of the UpdateOrderDispatchV2 call.

Implementation

API Endpoint URL:

[POST] https://{server_name}/orders/{orderId}/parcels/{parcelCode}/statuses

Parameters

Request Path Parameters

Parameter	Type	Description	Mandatory
`orderId`	string	A unique ID of the order. The merchant ID, or the order ID given by Global-e.	Yes
`parcelCode`	string	The parcel code for which a status update is required.	Yes

Request Body Parameters

Parameter	Type	Description	Mandatory
`merchantParcelStatus`	string	Parcel status to be modified by the merchant.	No

Returns

ResponseInfo class

Example:

[POST] https://{server_name}/orders/GE1235436GB/parcels/4666593812/statuses

Request

{
	"merchantParcelStatusCode": "Delivered"
}

Response

{
  "success":true
}

Error Codes

#	Code	Error Message	Description
1	B001	Order ID not found	The Order ID provided by the merchant does not exist.

VoidParcel

VoidParcel (VoidParcelRequest request)

Voids the relevant parcel within a specific order. The corresponding parcel in the order sends canceling shipment request and sets the parcel status to inactive in the Global-e system.