- Documentation Portal
- SDK and API
- General API Reference
- Order Methods
- UpdateOrderDispatch
UpdateOrderDispatch
Note
LEGACY: For reference only. These methods do not need to be implemented by merchants anymore.
Updates the order status and delivery quantities for the products, as well as merchant’s internal Delivery Reference Number, if applicable. Optionally, you can include the list of parcels for this order shipment to the Global-e hub.
URL
https://api_domain]/Order/UpdateOrderDispatch
Parameters
Request
Name | Type | Description | Mandatory |
|---|---|---|---|
OrderStatus | Object OrderStatusDetails | Status details to update for the order specified | |
parcelsList | List <Parcel> | List of Parcel objects for this order’s shipment to the Global‑e hub | |
productsList | List Product | List of Product objects (specified in the request body) |
OrderStatusDetails
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Merchant's Order confirmation number | No |
| String | Merchant’s internal Delivery Reference Number for this order | No |
| String | Merchant's comments for the order | No |
| String | Global‑e order unique identifier (previously submitted to the Merchant’s | |
| Object | The order status | |
| Object | Reason for the order status | No |
| String | Reference number valid for the tracking service used by the Merchant for this order | No |
| String | Name of the tracking service used by the Merchant for this order | No |
| String | URL of the tracking service site used by the Merchant for this order | No |
| String | Full tracking URL on the tracking service site used by the Merchant (if specified overrides all other “Tracking…” properties) | No |
OrderStatus
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Order status name | |
| String | Code denoting the order status on the Merchant’s site (to be mapped on the Global‑e side) |
OrderStatusReason
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Order status reason name | |
| String | Code denoting the order status reason on the Merchant’s site (to be mapped on the Global‑e side) |
Parcel
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| Decimal | Parcel height in centimeters/inches as measured by the Merchant. | No |
| Decimal | Parcel length in centimeters/inches as measured by the Merchant. | No |
| String | Code used to identify the Parcel on the Merchant’s site | |
| List of | List of products contained in the parcel (for each Product object the following fields are relevant when used in the Parcel class: | No |
| Object | Tracking information about the order/parcel. | No |
| Decimal | Parcel weight in grams as measured by the Merchant. | No |
| Decimal | Parcel width in grams as measured by the Merchant. | No |
Product
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| List of | The product’s custom attributes (such as Color, Size, etc.) | No |
| List of | The product’s custom attributes (such as Color, Size, etc.) in English | No |
| String | Estimated date for the backordered item to be in stock | No |
| Object | The product’s brand | No |
| String | Identifier of the cart item on the Merchant’s site. This property may be optionally specified in the | No |
| String | Identifier of the child cart item “option” on the Merchant’s site. This value must be specified if the current cart item is related to a parent item ( | No |
| List of | The product’s categories | No |
| Decimal | The quantity actually set for delivery for the product (to be used in the Order methods described below, as needed) | No |
| String | Description of the Product | |
| String | Description of the Product in English | |
| String | The product’s generic HS Code (not country-specific). If specified this property may assist in mapping the product for duties and taxes calculation purposes. | No |
| String | Optional “gift message” text defined by the end customer to be printed on the product. | No |
| String | Code applicable to the product on the Merchant’s site. This code may be optionally used by the Merchant to trigger a certain business logic when this product is included in the order posted back to the Merchant’s site with the | No |
| Decimal | The product’s height in the Merchant’s default unit of length measure (will be converted to CM). | No |
| String | The Merchant hub code indicates from which hub the product was sent. Note that the HubCode should be mapped to a Global-e hubId on the Global-e side. | No |
| Decimal | The product’s image height in pixels | No |
| String | The product’s image URL | No |
| Decimal | The product’s image width in pixels | |
| Boolean | Boolean specifying if the product was ordered as a backed ordered item. TRUE - The item is back ordered FALSE - The item is not back ordered. Default FALSE. | No |
| Boolean | Indicates if product is available for international shipping. TRUE - The product is not available for international shipping FALSE - The product is available for international shipping | No |
| Boolean | Indicates if the product represents a set of products. TRUE - The product represents a set of other products. If a bundled product has non-zero prices specified (i.e. FALSE - The product does not represent a set of other products. | No |
| Boolean | Indicates if the product’s price is fixed by the Merchant, in the default currency for the country. TRUE - The product’s price is fixed. In this case, all price modifications are disabled for this product. Setting fixed prices is only allowed for the Countries where the FALSE - The product's price is not fixed. | No |
| Boolean | Indicates if the product represents a virtual product that does not have weight or volume and doesn’t affect shipping calculation in Global‑e checkout TRUE - The product represents a virtual product FALSE - The product does not represent a virtual product | No |
| String | The product’s keywords | No |
| Decimal | The product’s length in the Merchant’s default unit of length measure (will be converted to CM). | No |
| Decimal | Line item (product in ordered quantity) sale price in the original Merchant’s currency including the local VAT, before applying any price modifications. This property always denotes the price in the default Merchant’s country, regardless of | No |
| Decimal | Line item (product in ordered quantity) sale price as displayed to the customer, after applying country coefficient, FX conversion and | No |
| Decimal | Product list price (before discounts) as displayed to the customer, after applying country coefficient, FX conversion, rounding rule (if applicable) and | Optional in |
| Object | VAT rate type or class that would be applied to this product if the order was placed by the local customer. This value must be specified if | No |
| Object | Used to hold additional product data such as customer-defined product attributes. | No |
| String | Name of the Product | |
| String | Name of the Product in English | |
| Decimal | The product’s net volume in the Merchant’s default unit of volume measure (will be converted to cubic CM). If specified, this property indicates the net volume of the product, excluding any packaging. | No |
| Decimal | The product’s net weight in the Merchant’s default unit of weight measure (will be converted to grams). If specified, this property indicates the net weight of the product, excluding any packaging. | No |
| Decimal | Ordered quantity for the product (to be used in Checkout / Order methods described below, as needed) | No |
| Decimal | Product list price (before any discounts) in the original Merchant’s currency including the local VAT, before applying any price modifications. This property always denotes the product’s price in the default Merchant’s country, regardless of | Optional in |
| Decimal | Product sale price in the original Merchant’s currency including the local VAT, before applying any price modifications. This property always denotes the product’s price in the default Merchant’s country, regardless of | Optional in SaveProductsList, |
| String | 2-char ISO country code of the product’s country of Origin. The Merchant’s country will be assumed if not specified. | No |
| String | Identifier of the current item’s parent cart item on the Merchant’s site. This value must be specified if the current cart item is related to a parent item ( | No |
| Decimal | Rate applicable to this Product’s | No |
| String | The product class code is used by the Merchant to classify products to use different country coefficient rates. | No |
| String | SKU code used to identify the product on the Merchant’s site (to be mapped on the Global‑e side) | |
| String | Secondary code that may be used to refer to the product on the Merchant’s site. This code may be used in addition to the | No |
| String | Product’s group code on the Merchant’s site (to be mapped on the Global‑e side). Usually, this value is a part of the product SKU code denoting a group of similar products (such as "the same product in different s"). | No |
| String | Secondary code that may refer to the group of products on the Merchant’s site. This code may be used in addition to the | No |
| Decimal | Product sale price as displayed to the customer, after applying country coefficient, FX conversion, rounding rule (if applicable) and | Optional in SaveProductsList, |
| Decimal | Product sale price as displayed to the customer, after applying country coefficient, FX conversion and | No |
| String | Reason for the sale price. This property may optionally contain the text definition of the promo that has resulted in the price deduction for this product (such as “10% discount on all shoes”). | No |
| String | The product’s information page URL | No |
| Object | The product’s VAT category. A product may be assigned to a single VAT category on the Merchant’s site. If available, the respective product’s HS Code should be used as the VAT category for a product. | No |
| Object | Product’s VAT rate type or class | No |
| Decimal | The product’s volume in the Merchant’s default unit of volume measure (will be converted to cubic CM). | Optional, can be used as an alternative for specifying all Height, Width and Length dimensions |
| Decimal | The product’s weight is in the Merchant’s default unit of weight measure (will be converted to grams). The Merchant’s default product weight will be used if not specified. | No |
| Decimal | The product’s width in the Merchant’s default unit of length measure (will be converted to CM). | No |
Attributes
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Custom attribute code denoting a Merchant-specific attribute such as size, color, etc. (to be mapped on the Global‑e side) | |
| String | Code used to identify the attribute type on the Merchant’s site such as “size” for size, “color” for "colour", etc. (to be mapped on the Global‑e side) | |
| String | Attribute name |
Brand
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Brand code on the Merchant’s site (to be mapped on the Global‑e side) | |
| String | Brand name |
Category
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Category code on the Merchant site (to be mapped on the Global‑e side) | |
| String | Category name |
MetaData
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| List of | Customer-defined product attributes that allow the personalisation of the product if supported by the merchant’s site (e.g. engraving) |
Attributes
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Custom attribute code denoting a Merchant-specific attribute such as size, color, etc. (to be mapped on the Global‑e side) | |
| String | Code used to identify the attribute type on the Merchant’s site such as “size” for size, “color” for "colour", etc. (to be mapped on the Global‑e side) | |
| String | Attribute name |
VATCategory
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | VAT Category name | |
| String | Code used to identify the VAT category on the Merchant’s site (to be mapped on the Global‑e side) |
VATRateType
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | VAT rate type name | No |
| Decimal | VAT rate decimal value | |
| String | VAT rate type (or class) code on the Merchant’s site (to be mapped on the Global-e side) |
TrackingDetails
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | The tracking number as the shipper has specified |
Product
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| List of | The product’s custom attributes (such as Color, Size, etc.) | No |
| List of | The product’s custom attributes (such as Color, Size, etc.) in English | No |
| String | Estimated date for the backordered item to be in stock | No |
| Object | The product’s brand | No |
| String | Identifier of the cart item on the Merchant’s site. This property may be optionally specified in the | No |
| String | Identifier of the child cart item “option” on the Merchant’s site. This value must be specified if the current cart item is related to a parent item ( | No |
| List of | The product’s categories | No |
| Decimal | The quantity actually set for delivery for the product (to be used in the Order methods described below, as needed) | No |
| String | Description of the Product | |
| String | Description of the Product in English | |
| String | The product’s generic HS Code (not country-specific). If specified this property may assist in mapping the product for duties and taxes calculation purposes. | No |
| String | Optional “gift message” text defined by the end customer to be printed on the product. | No |
| String | Code applicable to the product on the Merchant’s site. This code may be optionally used by the Merchant to trigger a certain business logic when this product is included in the order posted back to the Merchant’s site with the | No |
| Decimal | The product’s height in the Merchant’s default unit of length measure (will be converted to CM). | No |
| String | The Merchant hub code indicates from which hub the product was sent. Note that the HubCode should be mapped to a Global-e hubId on the Global-e side. | No |
| Decimal | The product’s image height in pixels | No |
| String | The product’s image URL | No |
| Decimal | The product’s image width in pixels | |
| Boolean | Boolean specifying if the product was ordered as a backed ordered item. TRUE - The item is back ordered FALSE - The item is not back ordered. Default FALSE. | No |
| Boolean | Indicates if product is available for international shipping. TRUE - The product is not available for international shipping FALSE - The product is available for international shipping | No |
| Boolean | Indicates if the product represents a set of products. TRUE - The product represents a set of other products. If a bundled product has non-zero prices specified (i.e. FALSE - The product does not represent a set of other products. | No |
| Boolean | Indicates if the product’s price is fixed by the Merchant, in the default currency for the country. TRUE - The product’s price is fixed. In this case, all price modifications are disabled for this product. Setting fixed prices is only allowed for the Countries where the FALSE - The product's price is not fixed. | No |
| Boolean | Indicates if the product represents a virtual product that does not have weight or volume and doesn’t affect shipping calculation in Global‑e checkout TRUE - The product represents a virtual product FALSE - The product does not represent a virtual product | No |
| String | The product’s keywords | No |
| Decimal | The product’s length in the Merchant’s default unit of length measure (will be converted to CM). | No |
| Decimal | Line item (product in ordered quantity) sale price in the original Merchant’s currency including the local VAT, before applying any price modifications. This property always denotes the price in the default Merchant’s country, regardless of | No |
| Decimal | Line item (product in ordered quantity) sale price as displayed to the customer, after applying country coefficient, FX conversion and | No |
| Decimal | Product list price (before discounts) as displayed to the customer, after applying country coefficient, FX conversion, rounding rule (if applicable) and | Optional in |
| Object | VAT rate type or class that would be applied to this product if the order was placed by the local customer. This value must be specified if | No |
| Object | Used to hold additional product data such as customer-defined product attributes. | No |
| String | Name of the Product | |
| String | Name of the Product in English | |
| Decimal | The product’s net volume in the Merchant’s default unit of volume measure (will be converted to cubic CM). If specified, this property indicates the net volume of the product, excluding any packaging. | No |
| Decimal | The product’s net weight in the Merchant’s default unit of weight measure (will be converted to grams). If specified, this property indicates the net weight of the product, excluding any packaging. | No |
| Decimal | Ordered quantity for the product (to be used in Checkout / Order methods described below, as needed) | No |
| Decimal | Product list price (before any discounts) in the original Merchant’s currency including the local VAT, before applying any price modifications. This property always denotes the product’s price in the default Merchant’s country, regardless of | Optional in |
| Decimal | Product sale price in the original Merchant’s currency including the local VAT, before applying any price modifications. This property always denotes the product’s price in the default Merchant’s country, regardless of | Optional in SaveProductsList, |
| String | 2-char ISO country code of the product’s country of Origin. The Merchant’s country will be assumed if not specified. | No |
| String | Identifier of the current item’s parent cart item on the Merchant’s site. This value must be specified if the current cart item is related to a parent item ( | No |
| Decimal | Rate applicable to this Product’s | No |
| String | The product class code is used by the Merchant to classify products to use different country coefficient rates. | No |
| String | SKU code used to identify the product on the Merchant’s site (to be mapped on the Global‑e side) | |
| String | Secondary code that may be used to refer to the product on the Merchant’s site. This code may be used in addition to the | No |
| String | Product’s group code on the Merchant’s site (to be mapped on the Global‑e side). Usually, this value is a part of the product SKU code denoting a group of similar products (such as "the same product in different s"). | No |
| String | Secondary code that may refer to the group of products on the Merchant’s site. This code may be used in addition to the | No |
| Decimal | Product sale price as displayed to the customer, after applying country coefficient, FX conversion, rounding rule (if applicable) and | Optional in SaveProductsList, |
| Decimal | Product sale price as displayed to the customer, after applying country coefficient, FX conversion and | No |
| String | Reason for the sale price. This property may optionally contain the text definition of the promo that has resulted in the price deduction for this product (such as “10% discount on all shoes”). | No |
| String | The product’s information page URL | No |
| Object | The product’s VAT category. A product may be assigned to a single VAT category on the Merchant’s site. If available, the respective product’s HS Code should be used as the VAT category for a product. | No |
| Object | Product’s VAT rate type or class | No |
| Decimal | The product’s volume in the Merchant’s default unit of volume measure (will be converted to cubic CM). | Optional, can be used as an alternative for specifying all Height, Width and Length dimensions |
| Decimal | The product’s weight is in the Merchant’s default unit of weight measure (will be converted to grams). The Merchant’s default product weight will be used if not specified. | No |
| Decimal | The product’s width in the Merchant’s default unit of length measure (will be converted to CM). | No |
Attributes
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Custom attribute code denoting a Merchant-specific attribute such as size, color, etc. (to be mapped on the Global‑e side) | |
| String | Code used to identify the attribute type on the Merchant’s site such as “size” for size, “color” for "colour", etc. (to be mapped on the Global‑e side) | |
| String | Attribute name |
Brand
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Brand code on the Merchant’s site (to be mapped on the Global‑e side) | |
| String | Brand name |
Category
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Category code on the Merchant site (to be mapped on the Global‑e side) | |
| String | Category name |
MetaData
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| List of | Customer-defined product attributes that allow the personalisation of the product if supported by the merchant’s site (e.g. engraving) |
Attributes
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Custom attribute code denoting a Merchant-specific attribute such as size, color, etc. (to be mapped on the Global‑e side) | |
| String | Code used to identify the attribute type on the Merchant’s site such as “size” for size, “color” for "colour", etc. (to be mapped on the Global‑e side) | |
| String | Attribute name |
VATCategory
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | VAT Category name | |
| String | Code used to identify the VAT category on the Merchant’s site (to be mapped on the Global‑e side) |
VATRateType
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | VAT rate type name | No |
| Decimal | VAT rate decimal value | |
| String | VAT rate type (or class) code on the Merchant’s site (to be mapped on the Global-e side) |
Response
Name | Type | Description | Mandatory |
|---|---|---|---|
ResponseInfo | Object ResponseInfo | Response details for API call |
ResponseInfo
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| Boolean | Indicates if the call was successful. Success property value may be only TRUE. Otherwise, ErrorInfo will be returned instead. TRUE - Call was successful FALSE - Call failed For more information see | |
| String | Text that optionally describes the reason for Success status. |
ErrorInfo
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | The error code | |
| String | The error message | |
| String | The error description |
Examples
Response
[{
"ProductCode": "1020872",
"Name": "Lanolin",
"Description": "Breast%20Feeding%20Ointment",
"GenericHSCode": "",
"OriginCountryCode": "",
"Weight": "1.0000",
"Height": null,
"Length": null,
"Volume": "60",
"ImageURL": "\/a\/3\/a3c9ef_ece3bec0467310603bce72e9a58e33d3.jpg",
"ImageHeight": "",
"ImageWidth": "",
"ListPrice": "25.0000",
"OriginalListPrice": "17.7000",
"SalePrice": "15.0000",
"OriginalSalePrice": "17.7000",
"VATRateType": {
"VATRateTypeCode": 1,
"Name": "Low",
"Rate": "18.0000"
},
"Brand": {
"BrandCode": "7",
"Name": "Brand2"
},
"Categories": [{
"CategoryCode": "3",
"Name": "Maternity"
}
],
"DeliveryQuantity": 1
}
]