- Documentation Portal
- SDK and API
- General API Reference
- Browsing Support Methods
- ShippingOptions
ShippingOptions
Returns all available shipping options for the cart information specified either by cartToken or by including all the relevant checkoutCartInfo details.
Method/URL
https://{server_name}/Browsing/ShippingOptions
Parameters
Request
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Merchants who implement API checkout only, may specify the Cart token returned by the | Either |
| Object | Full cart information. | Either |
CheckoutCartInfo
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| Boolean | Indicates if the end customer’s consent to receive emails from merchants should be pre-selected in the Global‑e Checkout. TRUE - Customer consents to receive emails. FALSE - Customer does not consent to receive emails. | No |
| Object | Billing details of a registered user (if available on the Merchant’s site). If the | No |
| String | The end customer’s IP address | No |
| String | 2-char ISO country code of the shipping country either pre-defined using geo-location or actively selected by the end customer. This may be different from | No |
| String | ISO culture code. If specified, the textual properties will be returned in the requested culture’s language if available. Texts in English will be returned by default. | No |
| String | 3-char ISO currency code denoting the end customer’s currency. If not specified, the Merchant’s default currency will be assumed by default. | No |
| List of | List of JSON-serialized Discounts to be applied to the cart. Discounts of any type (“cart”, “shipping”, etc.) may be specified. | No |
| Boolean | Indicates if the end customer must not be charged VAT. This is usually set to TRUE for registered users who have validated their business entity’s VAT Registration Number with the merchant and are therefore VAT exempted. | No |
| nvarchar | Merchant’s free shipping coupon code applied by the end customer. Max length: 50. | No |
| Decimal | Identifier of the Global‑e’s Local Hub previously returned by API. If not specified, the default Merchant’s Hub will be used instead. | No |
| Decimal | Optional for the merchants not supporting browsing integration. The value is returned from CountryCoefficients API. | No |
| Boolean | Indicates if the Merchant offers free international shipping to the end customer. | No |
| String | The loyalty code specified by the end customer (or read from the end customer’s account) on the Merchant’s site. | No |
| Object | LoyaltyPoints contains data about the registered user for applying loyalty points on the Checkout page. | No |
| Decimal | The number of loyalty points to be earned for this purchase by the end customer on the Merchant’s site. | No |
| Decimal | The number of loyalty points to be spent for this purchase by the end customer on the Merchant’s site. | No |
| Decimal | The total number of loyalty points currently available in the end customer’s user account on the Merchant’s site. | No |
| nvarchar | A hash may be optionally generated by the merchant and returned to the merchant with an order API call. This hash may be used for additional cart and order validation purposes on the Merchant’s side. No max length. | No |
| String | The merchant order id, if it is already known, at the point when the user is still in the cart page on the merchant’s store. | No |
| String | 3-char ISO currency code denoting the original currency on the Merchant’s site (before applying country coefficient and FX conversion). If not specified, the Merchant’s default currency will be assumed by default. | No |
| Decimal | Amount of the one-time voucher in | No |
| String | One-time voucher code for the cart (for applicable platforms). | No |
| String | One-time voucher currency used for the amount. | No |
| String | List of available payment instalment amounts. For example: {2,4,6,8} – This indicates that we should allow instalmentsin 2, 4, 6 or 8 instalment options (to be selected by the customer). | No |
| List of | List of Product objects (specified in the request body) | Yes |
| String | Currency data is used by Global-e to verify the currency rate and to return the value received in the used currency rate. | Optional, irrelevant for GetCheckoutCartInfo API response |
| Object | Shipping details of a registered user (if available on the Merchant’s site). If the If If not specified neither in the | No |
| List of | List of JSON-serialized Shipping Options available for local shipping of the order from the Merchant to Global‑e’s Local Hub previously returned by ActiveHubDetails API. If the Global-e integration shipping API has been created and enabled for Global‑e on the Merchant’s site, Global‑e will prefer this Shipping Option when posting the order back to the Merchant’s site (using SendOrderToMerchant API). Therefore, all other shipping APIs available for local shipping may be omitted in | No |
| List of | List of JSON-serialized Key:Value pairs denoting the values of the parameters specified in the respective Merchant’s REST API action URLs. For example, to instruct Global‑e to include “en-AU” locale in the SendOrderToMerchant call for this cart, | No |
| Object | All available details of the user including all relevant addresses. If | No |
| String | VAT Registration Number of the end customer’s business entity validated with the merchant. | No |
| nvarchar | Code used on the merchant’s side to identify the web store where the current cart is originating. This code should be used when a multi-store setup is on the merchant’s site. Max length: 100 | No |
| String | Code used on the merchant’s side to identify the web store instance where the current cart is originating from. This code should be used in case of multi-store domains set up on the merchant’s site. | No |
CartUserDetails
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| List of | All available addresses are taken from the registered customer address book | No |
| String | Internal User identifier on the Merchant’s site | No |
AddressDetails
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Address line 1. | No |
| String | Address line 2. | No |
| String | Id of the current address from within the address book | No |
| String | Name of the current address from within the address book | No |
| String | City name. | No |
| String | Company name | No |
| String | 2-char ISO country code | No |
| String | E-mail address | No |
| String | Fax | No |
| String | First name | No |
| String | First name in local culture | No |
| Boolean | Indicates that the current address can be used as a billing address | No |
| Boolean | Indicates that the current address is the default billing address | No |
| Boolean | Indicates that the current address is the default shipping address | No |
| Boolean | Indicates that the current address can be used as a shipping address | No |
| String | Last name | No |
| String | Last name in local culture | No |
| String | Middle name | No |
| String | Phone #1 | No |
| String | Phone #2 | No |
| String | Salutation or title (e.g. Dr., Mr., etc.). | No |
| String | State or province ISO code such as AZ for Arizona (if applicable) | No |
| String | State or province name | No |
| String | User’s personal ID document number | No |
| Object | User’s personal ID document type (e.g. Passport, ID card, etc.) | No |
| String | Zip or postal code | No |
UserIdNumberType
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Identification document type name | |
| String | Code denoting a user identification document type (e.g. Passport, ID card, etc.) on the Merchant’s site (to be mapped on the Global‑e side) |
Discounts
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Merchant Coupon Code used for this discount (applicable to coupon-based discounts only). Max length: 100 chars. | No |
| String | Discount textual description. Length: Unlimited. | No |
| Integer | One of the following possible values of
| No |
| Decimal | Discount value in end customer’s currency (specified in | No |
| String | Discount name. Length: Unlimited. | No |
| Decimal | Discount value in the currency defined in the | Yes |
| Decimal | The VAT rate applied to this discount | No (Required for merchants whose base country has VAT. If not specified, will default to 0.) |
| String | For product level discount, match the unique CartItemId line identifier of the respective product in the productList. For cart level discounts, leave this field blank or null. | No |
| Integer | The mode of calculation:
| Yes |
KeyValuePair
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Entity key (for example a URL parameter) used on the Merchant’s site (to be mapped on the Global‑e side) | |
| String | Entity value for the respective Key |
LoyaltyPoints
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| Decimal | The limit loyalty points that the user can use in this order – if not exists the | No |
| Decimal | Value of one loyalty point for earn, in Merchant currency – optional if | No |
| Decimal | Value of one loyalty point for spending, in Merchant currency – optional if | No |
| Decimal | The total loyalty points the user has on account at the Merchant’s site | No |
| Decimal | Value of one loyalty point for earn, in customer currency – optional if | No |
| Decimal | Value of one loyalty point for spending, in customer currency – optional if | 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) |
ShippingOption
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Carrier’s short name | |
| String | Carrier’s full name | |
| String | Carrier’s title | |
| String | Shipping method code used to identify the shipping option on the Merchant’s site (to be mapped on the Global‑e side) | |
| String | Shipping method name | |
| String | Shipping method title | |
| String | Shipping method description | |
| Decimal | Shipping price in Merchant’s original currency defined in the |
UserDetails
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Address line 1 | No |
| String | Address line 2 | No |
| String | City name | No |
| String | Company name | No |
| String | 2-char ISO country code | No |
| String | Country name | No |
| String | E-mail address | No |
| String | Fax | No |
| String | First name | No |
| String | First name in local culture Ex: Kana Japanese dialect | No |
| String | Last name | No |
| String | Last name in local culture Ex: Kana Japanese dialect | No |
| String | Middle name | No |
| String | Phone #1 | No |
| String | Phone #2 | No |
| String | Salutation or title (e.g. Dr., Mr., etc.) | No |
| String | State or province ISO code such as AZ for Arizona (if applicable) | No |
| String | State or province name | No |
| String | Internal User identifier on the Merchant site | No |
| String | User’s personal ID document number | No |
| Object | User’s personal ID document type (e.g. Passport, ID card, etc.) | No |
| String | Zip or postal code | No |
UserIdNumberType
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| String | Identification document type name | |
| String | Code denoting a user identification document type (e.g. Passport, ID card, etc.) on the Merchant’s site (to be mapped on the Global‑e side) |
Response
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| List of | List of shipping options |
CheckoutShippingOption
Parameter Name | Type | Description | Mandatory |
|---|---|---|---|
| Decimal | Minimum number of days for delivery to the end customer’s shipping country for this shipping option | No |
| Decimal | Maximum number of delivery days to the end customer’s shipping country for this shipping option | No |
| Decimal | One of the possible values of | |
| Decimal | Shipping price in end customer currency for this cart | |
| Decimal | Shipping price in end customer currency for this cart, before applying shipping discounts | |
| String | Unique identifier of the shipping method in the Global-e system | |
| String | Shipping method type name | |
| Boolean | Indicates if taxes & duties may be prepaid for this shipping option |
ForceDDP
Contains one of the following possible values of the ForceDDPTypes enumeration:
ForceDDPType Option Value | Name | Description |
|---|---|---|
0 | Do Not Force DDP | Pre-payment of taxes & duties must NOT be forced. |
1 | Force DDP | Pre-payment of taxes & duties must be forced. The cost should be paid by the end customer. |
2 | Hidden Force DDP | Pre-payment of taxes & duties must be forced. The cost should be subsidized by the Merchant. |
Example
Request for CheckoutCartInfo
[
{
"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"
}
],
"OrderedQuantity": 1
}
]