Classes
The following classes are used by the API methods defined further in this document.
AddressDetails
string
UserIdNumber
(optional)User’s personal ID document number
UserDIdNumberType
UserIdNumberType
(optional)User’s personal ID document type (e.g. Passport, ID card, etc.)
string
FirstName
(optional)First name
string
LastName
(optional)Last name
string
FirstNameInLocalCulture
(optional)First name in local culture
string
LastNameInLocalCulture
(optional)Last name in local culture
string MiddleName
(optional)
Middle name
string Salutation
(optional)
Salutation or title (e.g. Dr., Mr., etc.)
string Phone1
(optional)
Phone #1
string Phone2
(optional)
Phone #2
string Fax
(optional)
Fax
string Email
(optional)
E-mail address
string Company
(optional)
Company name
string Address1
(optional)
Address line 1
string Address2
(optional)
Address line 2
string City
(optional)
City name
string StateOrProvice
(optional)
State or province name
string StateCode
(optional)
State or province ISO code such as AZ for Arizona (if applicable)
string Zip
(optional)
Zip or postal code
string CountryCode
(optional)
2-char ISO country code
bool IsShipping
(optional)
Indicates that the current address can be used as a shipping address
bool IsBilling
(optional)
Indicates that the current address can be used as a billing address
bool IsDefaultShipping
(optional)
Indicates that the current address is the default shipping address
bool IsDefaultBilling
(optional)
Indicates that the current address is the default billing address
string AddressBookId
(optional)
Id of the current address from within the address book
string AddressBookName
(optional)
Name of the current address from within the address book
AppSetting
string Value
Application setting value
AppSettings
Dictionary<string, AppSetting> ClientSettings
Dictionary of client-side settings
Dictionary<string, AppSetting> ServerSettings
Dictionary of server-side settings
AppVersion
string WebClientVersion
Version identifier of Global-e client-side (JS) code.
string APIVersion
Version identifier of Global-e API.
Attribute
string AttributeCode
Custom attribute code denoting a Merchant-specific attribute such as size, color, etc. (to be mapped on the Global‑e side)
string Name
Attribute name
string AttributeTypeCode
Code used to identify the attribute type on the Merchant’s site such as “size” for size, “color” for color, etc. (to be mapped on the Global‑e side)
Brand
string BrandCode
Brand code on the Merchant’s site (to be mapped on the Global‑e side)
string Name
Brand name
City
string Code
City code (unique in the respective Region)
string Name
City name
CartCultureData
string CultureCode
(optional)
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.
string InputDataCultureCode
(optional)
ISO culture code. Denotes the culture for the products’ textual properties being saved (e.g. Description). If not specified, the Merchant’s default culture will be assumed by default.
string PreferedCultureCode
(optional)
ISO culture code. Denotes the preferred culture for the checkout page. If not specified, the Merchant’s default culture will be used by default
CartCurrencyData
string currencyCode
(optional)
3-char ISO currency code denoting the end customer’s currency. If not specified, the Merchant’s default currency will be assumed by default.
string originalCurrencyCode
(optional)
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.
CartFreeShippingData
bool IsFreeShipping
(optional)
Indicates if the Merchant offers free international shipping to the end customer.
string FreeShippingCouponCode
(optional)
Merchant’s free shipping coupon code applied by the end customer.
CartInfo
string CartToken
Cart token for the cart generated on Global‑e side by SendCart
method (further on to be passed by the Merchant’s site to Global‑e checkout widget or to API checkout methods)
CartLoyaltyData
string LoyaltyCode
(optional)
Loyalty code applicable to the Merchant’s site entered by the end customer in Global‑e checkout
decimal LoyaltyPointsSpent
(optional)
The number of loyalty points spent for this purchase. The existing loyalty points handling procedure must be applied to the end customer’s user account. Therefore, the “Loyalty points” type discount must not be applied to the order directly but can be used for display purposes elsewhere in the system (i.e. on the end user’s My Account page)
decimal LoyaltyPointsEarned
(optional)
The number of loyalty points to be earned for this purchase by the end customer on the Merchant’s site, as specified in the loyaltyPointsEarned
argument for the SendCart
method for the cart converted to this order on Global-e.
decimal LoyaltyPointsTotal
(optional)
The total number of loyalty points currently available in the end customer’s user account on the Merchant’s site.
CartOTVoucherData
string OTVoucherCode
(optional)
One-time voucher code for the cart (for applicable platforms)
decimal OTVoucherAmount
(optional)
Amount of the one-time voucher in otVoucherCurrencyCode
currency
string OTVoucherCurrencyCode
(optional)
One-time voucher currency used for the amount
CartPriceModificationData
Int64 RoundingRuleId
(optional for the merchants not supporting browsing integration)
The RoundingRuleId value returned from the RoundingRules
method.
decimal priceCoefficientRate
(optional for the merchants not supporting browsing integration)
The rate returned from the CountryCoefficients
method.
Int64 IncludeVAT
(optional for the merchants not supporting browsing integration)
The IncludeVAT
value returned from the CountryCoefficients
method
CartUserDetails
string UserId
(optional)
Internal User identifier on the Merchant’s site.
List<AddressDetails> AddressDetails
(optional)
All available addresses are taken from the registered customer address book
CartVATRegistrationData
string VatRegistrationNumber
(optional)
VAT Registration Number of the end customer’s business entity validated with the merchant.
bool DoNotChargeVAT
(optional)
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.
CartVoucherData
List<LoyaltyVoucher> LoyaltyVouchers
(optional)
List of available loyalty vouchers for the registered customer
CartOTVoucherData OTVoucher
(optional)
One-time voucher information
Category
string CategoryCode
Category code on the Merchant site (to be mapped on the Global‑e side)
string Name
Category name
CheckoutAddress
string Address1
Address line 1
string Address2
(optional)
Address line 2
string City
City name
string StateCode
(optional)
State or province ISO code such as AZ for Arizona (if applicable)
string Zip
Zip or postal code
string CountryCode
2-char ISO country code
CheckoutCardDetails
string OwnerName
(optional)
Card owner’s full name
string CardNumber
Card number
string CVVNumber
Card CVV number
string ExpirationDate
Card expiration date (in YYYY-MM-DD format)
CheckoutCartInfo
List<Product> productsList
List of Product objects (specified in the request body)
string clientIP
(optional)
The end customer’s IP address
string countryCode
(optional)
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 shippingDetails
. CountryCode
property denoting the registered user’s country defined below.
UserDetails shippingDetails
(optional)
Shipping details of a registered user (if available on the Merchant’s site). If userDetails
property mentioned below is specified then shippingDetails
will be ignored.
If countryCode
argument defined above is not specified, the shipping country must be specified in shippingDetails.CountryCode property. If not specified neither in countryCode argument nor in shippingDetails.CountryCode property, clientIP argument defined above becomes mandatory and will be used to determine the end user’s shipping country by Global‑e system.
UserDetails billingDetails
(optional)
Billing details of a registered user (if available on the Merchant’s site). If the userDetails
property mentioned below is specified then billingDetails
will be ignored.
CartUserDetails userDetails
(optional)
All available details of the user including all relevant addresses. If userDetails
is not specified then shippingDetails
and billingDetails properties will be used instead. userDetails property can be used by merchants who support multiple shipping and/or multiple billing addresses in user’s account.
Int64 includeVAT
(optional for the merchants not supporting browsing integration)
IncludeVAT
value returned from CountryCoefficients
method
List<Discount> discountsList
(optional)
List of JSON-serialized Discounts to be applied to the cart. Discounts of any type (“cart”, “shipping”, etc.) may be specified.
string currencyCode
(optional)
3-char ISO currency code denoting the end customer’s currency. If not specified, the Merchant’s default currency will be assumed by default.
string originalCurrencyCode
(optional)
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.
string cultureCode
(optional)
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.
List<ShippingOption> shippingOptionsList
(optional in GetCheckoutCartInfo
)
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
method.
If the “globaleintegration_standard
” shipping method 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 method). Therefore, all other shipping methods available for local shipping may be omitted in shippingOptionsList
.
Int64 hubId
(optional)
Identifier of the Global‑e’s Local Hub previously returned by ActiveHubDetails
method. If not specified, the default Merchant’s Hub will be used instead.
decimal loyaltyPointsTotal
(optional)
The total number of loyalty points currently available in the end customer’s user account on the Merchant’s site.
decimal loyaltyPointsEarned
(optional)
The number of loyalty points to be earned for this purchase by the end customer on the Merchant’s site.
decimal loyaltyPointsSpent
(optional)
The number of loyalty points to be spent for this purchase by the end customer on the Merchant’s site.
string loyaltyCode
(optional)
The loyalty code specified by the end customer (or read from the end customer’s account) on the Merchant’s site.
string vatRegistrationNumber
(optional)
VAT Registration Number of the end customer’s business entity validated with the merchant.
bool doNotChargeVAT
(optional)
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.
boolisFreeShipping
(optional)
Indicates if the Merchant offers free international shipping to the end customer.
string freeShippingCouponCode
(optional)
Merchant’s free shipping coupon code applied by the end customer.
string paymentInstallments
(optional)
List of available payment instalmentinstallmentamounts.
Example: {2,4,6,8} – This indicates that we should allow instalmentsinstallmentsin 2, 4, 6 or 8 instalmentinstallmentoptions (to be selected by the customer)
List<KeyValuePair> urlParameters
(optional)
List of JSON-serialized KeyValuePairs
that denote parameter values to be 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, urlParameters should include the following KeyValuePair: [{"Key":"locale", "Value":"en-AU"}]. In this example “locale” parameter should be configured for SendOrderToMerchant URL for this merchant on the Global‑e side.
string otVoucherCode
(optional)
One-time voucher code for the cart (for applicable platforms)
string otVoucherCurrencyCode
(optional)
One-time voucher currency used for the amount
decimal otVoucherAmount
(optional)
Amount of the one-time voucher in otVoucherCurrencyCode
currency
string rateData
(optional, irrelevant for GetCheckoutCartInfo
method response)
Currency data used by Global‑e to verify the currency rate. Return the value received in the used currency rate.
string webStoreCode
(optional)
Code used on the merchant’s side to identify the web store where the current cart is originating from. This code should be used in case of a multi-store setup on the merchant’s site.
string webStoreInstanceCode
(optional)
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.
LoyaltyPoints LoyaltyPoints
(optional)
Holds information on the registered user for applying loyalty points on the checkout page.
string merchantCartHash
(optional)
Hash optionally generated by the merchant, to be 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.
bool allowMailsFromMerchant
(optional)
Indicates if the end customer’s consent to receive emails from merchants should be pre-selected in the Global‑e checkout.
string MerchantOrderId
(optional)
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.
CheckoutInfoGiftCard
Dictionary<string, string> CardFields
The gift card fields filled in the checkout
ValidateGiftCardResponse ValidationResult
The gift card validation result
CheckoutPaymentMethod
string PaymentMethodId
Unique identifier of the payment method in the Global-e system
string Name
Payment method name
bool IsCard
Indicates if this payment method denotes a card (rather than an alternative payment method)
string Icon
URL Full URL of the icon image for this payment method
CheckoutShippingOption
string ShippingMethodId
Unique identifier of the shipping method in the Global-e system
string ShippingMethodTypeName
Shipping method type name
decimal Price
Shipping price in end customer currency for this cart
decimalPriceBeforeDiscount
Shipping price in end customer currency for this cart, before applying shipping discounts
Int64 DeliveryDaysFrom
(optional)
Minimum number of days for delivery to the end customer’s shipping country for this shipping option
Int64 DeliveryDaysTo
(optional)
Maximum number of delivery days to the end customer’s shipping country for this shipping option
bool SupportsDDP
Indicates if taxes & duties may be prepaid for this shipping option
Int64 ForceDDP
One of the following possible values of ForceDDPTypes
enumeration denoting a type of DDP enforcement for this shipping option (applicable only if SupportsDDP
is set to TRUE):
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. |
CheckoutTaxInfo
bool CanPrePay
Indicates if taxes & duties have been successfully calculated for this cart and can be prepaid
decimal TaxesValue
Taxes & duties value in the end customer’s currency for this cart
decimal ClearanceFeesValue
Clearance fees value in the end customer’s currency for this cart
Country
string Code
2-char ISO country code
string Name
Country name
string SiteURL
URL of a country-specific site owned by the merchant. Used to allow redirection to the merchant’s country-specific domain for a selected country.
bool IsStateMandatory
TRUE if State or province (region) is mandatory for addresses in this country.
bool IsOperatedByGlobalE
Flag to be used as a Mode indicator. Countries that are not operated by Global‑e must still be available for selection as a shipping destination on the merchant site. However Global‑e functionality must be disabled for such countries.
string DefaultCurrencyCode
3-char ISO currency code
VATRateType DefaultVATRateType
(optional)
Default (most widely used) VAT rate type or class for this country.
bool UseCountryVAT
(optional)
TRUE if VAT rate specific to this shipping country must be applied to the product prices. Otherwise, VAT rates defined for the products on the merchant’s site must be used. This setting is used to support trade agreements between the countries such as EEA, when the end customer must pay VAT for the shipping country in certain cases.
bool SupportsFixedPrices
(optional)
TRUE if fixed product prices are allowed for this country. Product prices may be fixed only in the Default Currency for this Country.
CountryCoefficient
string CountryCode
2-char ISO country code
string ProductClassCode
(optional)
Product class code used by the merchant to classify products for using different country coefficient rates per classes of products instead of the single country level default (when no rate is defined for a certain product class, the country level default rate should be used by the merchant for the respective product).
decimal Rate
Country Coefficient rate decimal value. All the prices displayed to the end customer shipping to the country involved must be multiplied by this value.
decimal CoefficientWithVATType
:
Depending on VATRateType
. This value is calculated as follows:
“HideVAT “→
CoefficientWithVATType
= Country coefficientVATType = “PocketVAT” →
CoefficientWithVATType
= Country coefficient * Origin Country (Merchant Country) VAT rateVATType = “ForceVAT “→
CoefficientWithVATType
= Country coefficient * Destination country VAT rateIf Merchant Account Settings “DisableVATAdjustmentForShopifyCoefficient“ = True →
CoefficientWithVATType
= Country Coefficient
Int64 IncludeVAT
(optional)
This attribute is applicable only to the Country level (i.e. not applicable to the ProductClass
level).
One of the possible values of IncludeVATOptions
enumeration is designated to control the way VAT is handled in browsing on the Merchant’s site and in checkout on Global‑e.
Following is the list of IncludeVATOptions
values and the expected results for the sample Product.
In the table below we are considering a product with the original cost in the UK = 100 GBP before VAT to be shipped to Germany (with country coefficient Rate=1 and user selected currency=GBP, for simplicity).
For this sample product UK VAT=20%, DE Duties Total=17%:
IncludeVAT Option Value | Description | Price In Browsing | Price In Checkout | Price Paid To Merchant (incl. VAT) | Checkout Duties Total | Checkout Total |
---|---|---|---|---|---|---|
0 | Hide VAT (default) | 100 | 100 | 120 | 17 | 117 |
2 | Show VAT | 120 | 100 | 120 | 17 | 117 |
4 | “Pocket” VAT (increase the original price by the value of the respective product’s VAT) | 120 | 120 | 144 | 20.4 (17%) | 140.4 |
6 | Force VAT (used to support trade agreements between the countries such as EEA, when the end customer must pay VAT; for simplicity assuming | 120 | 120 | 120 | 0 | 120 |
8 | Force & Hide VAT (used to support trade agreements between the countries such as EEA, when end customer must pay VAT but VAT is not shown in browsing; for simplicity assuming | 100 | 120 | 120 | 0 | 120 |
CreateSyncOrderData
string CCAuthorizationToken
bool IsTaxPrePaid
string ExternalOperationId
string Source
eSyncOrderType OrderType
CreateOrderFinalCustomerPayments CustomerPayments
CreateOrderFinalCustomerPayments
decimal Duties
decimal Taxes
decimal CustomClearanceFee
decimal ShippingPrice
Culture
string Code
ISO culture code
string Name
Culture name
string LocalizedName
Culture name in the respective language, such as “עברית” for he-IL (Hebrew-Israel) culture
bool IsRTL
TRUE for “right-to-left” languages such as Hebrew and Arabic
Currency
string Code
3-char ISO currency code
string Name
Currency name
string Symbol
Currency symbol (e.g. $ for USD)
Int64 MaxDecimalPlaces
The number of decimal places indicating the fractional (“cents”) part of the price. For example, Bahraini Dinar “cents” has 3 decimal places, US Dollar has 2, and Japanese Yen has 0.
CurrencyLocale
long DisplayDecimalPlaces
The number of decimal places indicating the fractional (“cents”) part of the price. For example, Bahraini Dinar “cents” has 3 decimal places, US Dollar has 2, and Japanese Yen has 0.
string CurrencySymbol
Currency symbol (e.g. $ for USD)
CurrencyRate
string SourceCurrencyCode
3-char ISO currency code.
string TargetCurrencyCode
3-char ISO currency code
decimal Rate
Currency rate decimal value
string RateData
Currency data used by Global‑e to verify the rate
CustomProductAttribute
string AttributeKey
Custom product attribute name that is used for product personalization by the end customer (e.g. engraving)
string AttributeValue
Custom product attribute value that is used for product personalization by the end customer (e.g. engraving).
DeliveryAddress
string CountryCode
string ProvinceCode
string PostalCode
string City
string Address1
string Address2
DeliveryAdviceInformation
string ParcelCode
Code used to identify the Parcel on the Merchant’s site
string CommercialInvoiceNumber
Commercial invoice number of the parcel if it exists on the parcel level, otherwise order commercial invoice number. Can be null if a commercial invoice does npt exist for the order.
string TotalValue
Value of all products in the parcel
string CurrencyCode
TotalValue
3-char ISO currency code
DutiesAndTaxesResponse
decimal DutiesValue
Value of the duties according to the cart details including the respective shipping option price
decimal TaxesValue
Value of the taxes (VAT/sales tax/GST) according to the cart details including the respective shipping option price
Discount
decimal OriginalDiscountValue
Discount value in original Merchant currency including the local VAT, before applying any price modifications. This property always denotes the discount value in the default Merchant’s country, regardless of UseCountryVAT
for the end customer’s current country.
decimal VATRate
The VAT rate applied to this discount
decimal LocalVATRate
(optional)
VAT rate that would be applied to this discount if the order was placed by the local customer. This value must be specified if UseCountryVAT
for the current Country is TRUE and therefore VATRate
property denotes the VAT for the target country.
decimal DiscountValue
Discount value as displayed to the customer, after applying country coefficient, FX conversion and IncludeVAT
handling.
string Name
Discount name
string Description
(optional)
Discount textual description
string CouponCode
(optional)
Merchant CouponCode
used for this discount (applicable to coupon-based discounts only)
string ProductCartItemId
(optional)
Identifier of the product cart item related to this discount on the Merchant’s site. This property may be optionally specified in the SendCart
method only so that the same value could be posted back when creating the order on the Merchant’s site with the SendOrderToMerchant
method.
string DiscountCode
(optional)
Discount code used to identify the discount on the Merchant’s site. This property may be optionally specified in the SendCart
method only, so that the same value could be posted back when creating the order on the Merchant’s site with the SendOrderToMerchant
method.
string LoyaltyVoucherCode
(optional)
Code used on the Merchant’s site to identify the Loyalty Voucher that this discount is based on
Int64 DiscountType
One of the following possible values of DiscountTypeOptions
enumeration denoting a type of discount:
DiscountType Option Value | Name | Description |
---|---|---|
1 | Cart discount | Discount related to volume, amount, coupon or another promotion value. |
2 | Shipping discount | Discount aimed to sponsor international shipping. |
3 | Loyalty points discount | Discount applied against the Merchant’s loyalty points to be spent for this purchase. |
4 | Duties discount | Discount aimed to sponsor taxes & duties pre-paid by the end customer in Global‑e checkout. |
5 | Checkout Loyalty Points Discount | Discount applied against the Merchant’s loyalty points in Global‑e checkout. |
6 | Payment Charge | Discount aimed to sponsor “Cash on Delivery” fee. |
Int64CalculationMode
(optional)
One of the following possible values of CalculationModeOptions
enumeration denoting the calculation mode of a discount to be implemented by GEM:
CalculationMode Option Value | Name | Description |
---|---|---|
1 (default) | Percentage discount | The discount value specified in Note: The discount value provided is not a percentage. It represents the discount amount in your domestic currency. The ratio of the discount amount to the domestic price is calculated in the shopper's currency. This same ratio is then applied and deducted in the shopper's currency. |
2 | Fixed in original currency | The discount value specified in OriginalDiscountValue denotes the fixed value in the merchant’s currency. When calculating the discount’s |
3 | Fixed in customer currency | The discount value specified in |
DTBreakdown
decimal Duties
Duties that are applied.
decimal SalesTaxes
Sales taxes that are applied.
decimal Other
Optional. Other DT fees that are applied.
ErrorInfo
string Code
Error code
string Error
Error message
string Description
Error description
eSyncOrderType
None = 0,
Raffle = 1,
FlashSale = 2,
Collection = 3
FinalCustomerPayments
decimal Duties
decimal Taxes
decimal CustomClearanceFee
decimal ShippingPrice
decimal Total
GetOrdersManifestRequest
List<string> OrderIds
The list of order ids to manifest.
List<string> MerchantOrderIds
The list of merchant order ids to manifest
string HubCode
(optional)
The Merchant hub code that indicates which hub the parcels or orders are being dispatched from.
NOTE: hubCode
should be mapped to a Global‑e hubId
on the Global‑e side.
Int OuterBoxesAmount
(optional)
The amount of outer boxes that are used through the manifest processing for DispatchConsolidateShipment
.
GiftCardData
CardData This model will be used for most calls where multiple cards will be passed
Int64 CardId
id of the card in the DB table on the Global‑e side
decimal BalanceInGiftCardCurrency
Total available amount in gift card currency
decimal BalanceInCustomerCurrency
Total available amount in customer currency
decimal BalanceUsedInCardCurrency
Amount to redeem in gift card currency
decimal BalanceUsedInCustomerCurrency
Amount to redeem in gift user currency
string GiftCardCurrencyCode
Gift card currency code
string CustomerCurrencyCode
User currency code (checkout currency)
Dictionary<string,string> CardFields
Key value pairs of each field defined in the configuration
string RedeemTransactionId
The value that is set as a result of card redemption (should be provided by the platform)
decimal RefundedBalanceInCustomerCurrency
The amount of refunded money in customer currency
decimal RefundedBalanceInGiftCardCurrency
The amount of refunded money in gift card currency
bool IsRefundSuccess
The flag about refund status should be set to true if the refund is successfully applied to the gift card. If the refund failed, it should be set to false. If there is no refund on the card, it should be NULL.
string ErrorCode
(optional)
Code of the error
string ErrorText
(optional)
Error message
HubDetails
Int64 HubId
Hub identifier on Global‑e system
string HubName
Name of the Hub
string CountryName
Country name
string CountryCode
2-char ISO country code
string StateOrProvice
State or province name
string StateCode
State or province ISO code such as AZ for Arizona (if applicable)
string City
City name
string Zip
Zip or postal code
string Address1
Address line 1
string Address2
Address line 2
string Phone1
Phone #1
string Phone2
Phone #2
string Fax
Fax
string Email
E-mail address
InitCheckoutResponse
string cartToken
Cart token for the cart generated on the Global‑e side.
List<MerchantCartProductResponse> merchantCartProduct
List of products with calculated international prices.
List<MerchantCartDiscountResponse> merchantCartDiscounts
List of discounts with calculated international prices.
CurrencyLocale CurrencyLocale
Currency price display formatting information according to the received cultureCode
.
InitOrderResponse
string OrderId
Global‑e’s order id
IPRange
A sample code to convert dot-decimal to decimal IPV4 address is available here: http://stackoverflow.com/questions/11548273/convert-an-ip-address-to-its-decimal-equivalent-in-java
Int64 From
A decimal value of a range start
Int64 To
A decimal value of a range end
string Type
Either IPV4 or IPV6
KeyValuePair
string Key
Entity key (for example a URL parameter) used on the Merchant’s site (to be mapped on the Global‑e side)
string Value
Entity value for the respective Key
LocationCulture
string CountryCode
2-char ISO country code
string RegionCode
Region code (unique in the respective Country)
string CityCode
City code (unique in the respective Region)
Culture Culture
Culture definition for this location
LoyaltyVoucher
decimal OriginalDiscountValue
The discount value to which the end customer is entitled if this Loyalty Voucher is applied to the cart. This value should be specified in the original Merchant currency including the local VAT, before applying any price modifications. This property always denotes the discount value in the default Merchant’s country, regardless of UseCountryVAT
for the end customer’s current country.
decimal VATRate
The VAT rate applied to the discount based on this Loyalty Voucher
decimal LocalVATRate
(optional)
The VAT rate to be applied to the discount based on this Loyalty Voucher if the order was placed by the local customer. This value must be specified if UseCountryVAT
for the current Country is TRUE and therefore VATRate
property actually denotes the VAT for the target country.
decimal DiscountValue
Value of the discount based on the Loyalty Voucher. This value should be specified in the end customer’s currency, after applying country coefficient, FX conversion and IncludeVAT
handling.
string Name
Loyalty Voucher’s name
string Description
(optional)
Loyalty Voucher’s textual description
string VoucherCode
Code used to identify the Loyalty Voucher on the Merchant’s site
bool IsApplied
Indicates if the Loyalty Voucher is already applied by the end customer to the current cart
LoyaltyVoucher
decimal OriginalDiscountValue
The discount value to which the end customer is entitled if this Loyalty Voucher is applied to the cart. This value should be specified in the original Merchant currency including the local VAT, before applying any price modifications. This property always denotes the discount value in the default Merchant’s country, regardless of UseCountryVAT
for the end customer’s current country.
decimal VATRate
The VAT rate applied to the discount based on this Loyalty Voucher
decimal LocalVATRate
(optional)
The VAT rate to be applied to the discount based on this Loyalty Voucher if the order was placed by the local customer. This value must be specified if UseCountryVAT
for the current Country is TRUE and therefore VATRate
property actually denotes the VAT for the target country.
decimal DiscountValue
Value of the discount based on the Loyalty Voucher. This value should be specified in the end customer’s currency, after applying country coefficient, FX conversion and IncludeVAT
handling.
string Name
Loyalty Voucher’s name
string Description
(optional)
Loyalty Voucher’s textual description
string VoucherCode
Code used to identify the Loyalty Voucher on the Merchant’s site
bool IsApplied
Indicates if the Loyalty Voucher is already applied by the end customer to the current cart
LoyaltyPoints
decimal LoyaltyPointsTotal'
The total loyalty points the user has on account at the merchant’s site
decimal LoyaltyPointsMaxSpend
(optional)
The limit loyalty points that the user can use in this order – if not exists the LoyaltyPointsTotal
is taken.
decimal LoyaltyPointsValueForSpend
(optional)
Value of one loyalty point for spending, in customer currency – optional if LoyaltyPointsOriginalValueForSpend
exists.
decimal LoyaltyPointsOriginalValueForSpend
(optional)
Value of one loyalty point for spending, in merchant currency – optional if LoyaltyPointsValueForSpend
exists.
decimal LoyaltyPointsValueForEarn
(optional)
Value of one loyalty point for earn, in customer currency – optional if LoyaltyPointsOriginalValueForEarn
exists.
decimal LoyaltyPointsOriginalValueForEarn
(optional)
Value of one loyalty point for earn, in merchant currency – optional if LoyaltyPointsOriginalForEarn
exists.
MarketplaceData
long MarketplaceId
string MarketplaceOrderId
Merchant.Brand
string BrandCode
Brand code
string Name
Brand name
Merchant.Category
string CategoryCode
Category code
string Name
Category name
Merchant.CartAction
string MerchantGUID
(optional)
Unique identifier of the Merchant on Global-e. This property is mandatory only for server-side calls.
string CartToken
(optional)
Cart token for the cart generated on the Global‑e side by the SendCart
method preceding the current cart action. This property is mandatory only for server-side calls.
string CartId
(optional)
Identifier of the cart on the Merchant’s site originally specified in the merchantCartToken
argument for the SendCart
method preceding the current cart action.
string CartHash
(optional)
Cart hash originally specified in the merchantCartHash
argument for the SendCart
method preceding the current cart action.
string UserId
(optional)
Internal User identifier on the Merchant’s site originally specified in the shipping details.UserId
argument for the SendCart
method preceding the current cart action.
string LoyaltyVouchers
(optional)
A JSON-serialized array of Loyalty Voucher codes to be applied to the cart. This list is mandatory only in the ClientApplyLoyaltyVouchers
method.
MerchantCartDiscountResponse
decimal DiscountValue
Discount value in end customer currency, after applying country coefficient, FX conversion and IncludeVAT
handling.
string DiscountCode
Discount code used to identify the discount on the Merchant’s site returned in the respective GetCheckoutCartinfo
API method response. If not received, will enumerate each discount according to the order in the received list.
Merchant.CartProductAttribute
string AttributeKey
Custom product attribute name that is used to describe the personalized product.
string AttributeValue
Custom product attribute value that is used to describe the personalized product.
MerchantCartProductResponse
string ProductCode
SKU code used to identify the product on the Merchant’s site (to be mapped on the Global‑e side)
string CartItemId
(optional)
Identifier of the cart item on the Merchant’s site originally specified in Product.CartItemId
property of the respective product in the GetCheckoutCartInfo
API method response for the current cart.
decimal ListPrice
Product list price in end customer currency (before any discounts), after applying country coefficient, FX conversion, rounding rule (if applicable) and IncludeVAT
handling.
decimal SalePrice
Product sale price in end customer currency, after applying country coefficient, FX conversion, rounding rule (if applicable) and IncludeVAT
handling
Merchant.CartValidationData [Inherits all fields from Merchant.OrderV2 - 3.123]
string GlobalECartToken
GlobalE
cart token
string PreferredCultureCode
ISO culture code. Denotes the preferred culture for the checkout page. If not specified, the Merchant’s default culture will be used by default
string AuthToken
JWT AuthToken from the merchant’s platform
string SessionId
JWT SessionId
from the merchant’s platform
List<Merchant.CartValidationData
> Subs
Contains Sub carts validation data related to Mixed carts. This list is defined only in case the cart is Mixed.
Merchant.CartVoucherValidation
string MerchantGUID
Unique identifier of the Merchant on Global-e.
string CartToken
The value returned from the previous call to SendCart
for the same client (must be stored in the client session or persistent cookie on the merchant’s side). This parameter is used to support cart updates.
string CartId
Identifier of the cart on the Merchant’s site originally specified in merchantCartToken
argument for SendCart
method for the cart converted to this order on Global‑e.
string CartHash
Cart hash originally specified in merchantCartHash
argument for SendCart
method for the cart converted to this order on Global‑e.
string VoucherCode
The voucher code specified on the merchant site.
Int64 VoucherType
Enumeration of VoucherTypes
:
1 DiscountVoucher
string UserId
(optional)
Internal User identifier on the Merchant’s site in case it was specified in the SendCart
call.
string CountryCode
2-char ISO country code
bool IsFreeShipping
Indicates if the Merchant offers free international shipping to the end customer.
string FreeShippingCouponCode
The merchant free shipping coupon code applied by the end customer.
string WebStoreCode
Code used on the merchant’s side to identify the web store where the current cart is originating from. This code should be used in case of a multi-store setup on the merchant’s site.
string WebStoreInstanceCode
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.
List<Merchant.ProductVoucherValidation> Products
Cart products for voucher validation.
List<Merchant.DiscountVoucherValidation> Discounts
Cart discounts for voucher validation.
string CurrencyCode
3-char ISO currency code.
Merchant.Customer
bool SendConfirmation
Indicates if e-mail confirmation of the respective order’s status change needs to be sent to the paying customer (Global‑e acts as a paying customer).
bool IsEndCustomerPrimary
Indicates if end customer details are “swapped” with a paying (Global‑e) customer’s details when submitting the order to the Merchant. By default, IsEndCustomerPrimary is FALSE which means that the primary customer denotes the paying (Global‑e) customer and the secondary customer denotes the end customer who has placed the order with Global‑e checkout.
Merchant.CustomerDetails
string FirstName
(optional)
First name
string LastName
(optional)
Last name
string FirstNameInLocalCulture
(optional)
First name in local culture
string LastNameInLocalCulture
(optional)
Last name in local culture
string MiddleName
(optional)
Middle name
string Salutation
(optional)
Salutation or title (e.g. Dr., Mr., etc.)
string Phone1
(optional)
Phone #1
string Phone2
(optional)
Phone #2
string Fax
(optional)
Fax
string Email
(optional)
Email address
string Company
(optional)
Company name
string Address1
(optional)
Address line 1
string Address2
(optional)
Address line 2
string City
(optional)
City name
string StateOrProvice
(optional)
State or province name
string StateCode
(optional)
State or province ISO code such as AZ for Arizona (if applicable)
string Zip
(optional)
Zip or postal code
string CountryCode
(optional)
2-char ISO country code
string CountryName
(optional)
Country name
string AddressBookId
(optional)
Id of the current address from within the address book
string AddressBookName
(optional)
Name of the current address from within the address book
bool SaveAddress
(optional)
Indicates that the current address should be saved in the merchant platform
Merchant.Discount
string Name
Discount name
decimal Price
Discount value in the currency defined in the CurrencyCode
property of the respective Merchant.Order
object for the order being submitted to the Merchant.
decimal VATRate
The VAT rate applied to this discount
decimal LocalVATRate
(optional)
The VAT rate that would be applied to this discount if the order was placed by the local customer. This value must be specified if UseCountryVAT
for the current Country is TRUE and therefore the VATRate
property denotes the VAT for the target country.
decimal InternationalPrice
(optional)
Discount value in end customer’s currency (specified in InternationalDetails.CurrencyCode
property for the respective Merchant.Order
), after applying country coefficient, FX conversion, and IncludeVAT
handling.
string Name
Discount name
string Description
(optional)
Discount textual description
string CouponCode
(optional)
Merchant CouponCode
used for this discount (applicable to coupon-based discounts only)
string ProductCartItemId
(optional)
Identifier of the product cart item related to this discount on the Merchant’s site originally specified in the Discount.ProductCartItemId
property of the respective discount in the SendCart
method for the cart converted to this order on Global‑e.
string DiscountCode
(optional)
Discount code originally specified in the Discount.DiscountCode
property of the respective discount in SendCart
method for the cart converted to this order on Global‑e.
string LoyaltyVoucherCode
(optional)
Loyalty Voucher code originally specified in Discount.LoyaltyVoucherCode
property of the respective discount in SendCart
method for the cart converted to this order on Global‑e.
Int64 DiscountType
Discount type (“Cart”, “Shipping”, etc.), as defined in the DiscountTypeOptions
enumeration described in the Discount class in this document.
optional values DiscountSource
(required)
Values:
1 | Merchant |
2 | FixedShippingPrice |
3 | PercentageCartPrice |
4 | HiddenForceDDP |
5 | Amend |
6 | RemoteAreaSurchargeSubsidy |
7 | LoyaltyPoints |
8 | PaymentCharge |
9 | ReplacementOrder |
Merchant.DiscountVoucherValidation
string Name
Discount name.
decimal Price
Original discount value.
decimal VatRate
The VAT rate applied to this discount.
string CouponCode
Merchant’s CouponCode
used for this discount (applicable to coupon-based discounts only).
string ProductCartItemId
Identifier of the product cart item related to this discount on the Merchant’s site originally specified in the Discount.ProductCartItemId
property of the respective discount in the SendCart
method for the cart converted to this order on Global‑e.
string DiscountCode
Discount code originally specified in Discount.DiscountCode
property of the respective discount in SendCart
method for the cart converted to this order on Global‑e.
Int64 DiscountType
Enumeration of DiscountTypes
:
1 Cart discount
2 Shipping discount
3 Loyalty points discount
4 Taxes Subsidization
5 CheckoutLoyaltyPointsDiscount
6 PaymentCharge
Merchant.ExporterDetails
string VATRegistrationNumber
(optional)
Global‑e Exporter entity registration VAT number
string EORINumber
(optional)
Global‑e Exporter entity registration EORI number
string IOSSNumber
(optional)
Global‑e Exporter entity IOSS number (for shipments to the EU)
Merchant.ImporterDetails
string Name
First and Last name
string Address1
(optional)
Address line 1
string Address2
(optional)
Address line 2
string City
(optional)
City name
string StateOrProvince
(optional)
State or province name
string StateCode
(optional)
State or province ISO code such as AZ for Arizona (if applicable)
string Zip
(optional)
Zip or postal code
string CountryCode
(optional)
2-char ISO country code
string Country
(optional)
Country name
Merchant.ImporterAddress
string Company
(optional)
Either the Customer Company name, if provided in the cart/checkout, or the Global‑e importer entity name for the relevant markets (eg. Switzerland)
string VATRegistrationNumber
(optional)
Either. the Customer VAT Registration Number, if provided in the cart/checkout, or the Global‑e importer entity registration number for relevant markets (eg. Switzerland)
string CustomerTaxId
(optional)
The Customer tax number is provided at checkout, as required for clearance into certain markets (e.g. Brazil, Turkey).
int ImporterType
Importer type, depending on the order type and destination:
- 0: Private importer – standard B2C shipment
- 1: Global‑e Importer – specific importer mentions required
Merchant.ImporterAddress Address
(optional)
Full address of the importer as the Private/Business Importer (customer) or the Global‑e Importer entity, if relevant.
Merchant.InternationalDetails
string CurrencyCode
3-char ISO code for the currency selected by the end customer for the order payment.
decimal TotalPrice
Total order price in the currency denoted by CurrencyCode
.
string TransactionCurrencyCode
3-char ISO code for the currency actually used for the current order payment. TransactionCurrencyCode
may differ from CurrencyCode
if the currency selected by the end customer could not be used with the selected payment method.
decimal TransactionTotalPrice
Total order price actually paid by the end customer in the currency denoted by TransactionCurrencyCode
.
decimal TotalShippingPrice
Total shipping price in the currency denoted by CurrencyCode
.
decimal ConsignmentFee
(optional)
The consignment fee is paid by the end customer in the currency denoted by CurrencyCode
. This value is included in TotalShippingPrice
.
decimal SizeOverchargeValue
(optional)
Oversized items charge paid by the end customer in the currency denoted by CurrencyCode
. This value is included in TotalShippingPrice
.
decimal RemoteAreaSurcharge
(optional)
Remote area surcharge paid by the end customer in the currency denoted by CurrencyCode
. This value is included in TotalShippingPrice
.
decimal SameDayDispatchCost
(optional)
Cost of the “Same Day Dispatch” option (if selected by the end customer on Global‑e checkout), in the currency denoted by CurrencyCode
. This value is NOT included in TotalShippingPrice
.
decimal TotalDutiesPrice
Total Duties & Taxes value including Customs Clearance Fees, in the currency denoted by CurrencyCode
.
decimal USSalesTax
Sales tax value for the USA in the currency denoted by CurrencyCode
. This value is included in TotalDutiesPrice.
decimal TotalCCFPrice
(optional)
Total Customs Clearance Fees value in the currency denoted by CurrencyCode
. This value is included in TotalDutiesPrice
.
string ShippingMethodCode
Code denoting the selected international shipping method as defined on the Merchant’s site (to be mapped on the Global‑e side). If this international shipping method doesn’t exist on the Merchant’s site, the internal Global‑e shipping method code will be specified instead.
string ShippingMethodName
Name of the selected international shipping method.
string ShippingMethodTypeCode
Code denoting the selected international shipping method type as defined on the Merchant’s site (to be mapped on the Global‑e side). If this international shipping method type does not exist on the Merchant’s site, the internal Global‑e shipping method type code will be specified instead.
string ShippingMethodTypeName
Name of the selected international shipping method type.
Int64 DeliveryDaysFrom
(optional)
The minimum number of days for delivery to the end customer for the selected shipping method.
Int64 DeliveryDaysTo
(optional)
The maximum number of days for delivery to the end customer for the selected shipping method.
string PaymentMethodCode
Code denoting the selected payment method as defined on the Merchant’s site (to be mapped on the Global‑e side). If this payment method doesn’t exist on the Merchant’s site, the internal Global‑e payment method code will be specified instead.
string PaymentMethodName
Name of the selected payment method.
bool DutiesGuaranteed
Indicates if the end customer has selected the “guaranteed duties and taxes” option.
string OrderTrackingNumber
(optional)
Tracking number used by the selected international shipping method for this order.
string OrderTrackingUrl
(optional)
Full tracking URL including OrderTrackingNumber
used by the selected international shipping method for this order.
string OrderWaybillNumber
(optional)
Waybill number used by the selected international shipping method for this order.
string ShippingMethodStatusCode
(optional)
Code denoting the selected shipping status as defined on the Merchant’s site (to be mapped on the Global‑e side). If this shipping status doesn’t exist on the Merchant’s site, the internal Global‑e shipping status code will be specified instead.
string ShippingMethodStatusName
(optional)
Name of the shipping status.
decimal DiscountedShippingPrice
The price paid by the customer in local currency. Total Shipping price reducing Order Discounts International price.
List<Merchant.ParcelTracking> ParcelsTracking
List of Merchant.ParcelTracking
objects, each object holds the parcel tracking number and full tracking URL for the relevant shipper (with the parcel tracking number).
string CardNumberLastFourDigits
(optional)
The last 4 digits of the Card number (if applicable).
string ExpirationDate
(optional)
Card expiration date in YYYY-MM-DD format (if applicable).
decimal CashOnDeliveryFee
(optional)
The additional charge is paid by the end customer when the “Cash on Delivery” payment method has been selected.
decimal TotalVATAmount
Amount of VAT paid by the customer to Global‑e
DTBreakdown CustomerDTBreakdown
(optional)
Contains the duties and taxes parts the customer paid for the order in the currency denoted by CurrencyCode
.
DTBreakdown MerchantDTBreakdown
(optional)
Contains the duties and taxes parts the merchant subsidized for the order in the currency denoted by CurrencyCode
.
decimal ShippingVATRate
The shipping VAT rate for the customer. This rate is applied to the shipping cost.
Merchant.Order
string MerchantGUID
Unique identifier of the Merchant on Global-e.
string OrderId
Global‑e order unique identifier.
string MerchantOrderId
(optional)
Order unique identifier on the Merchant’s site returned from a previous call to the SendOrderToMerchant
method for this order.
string CartId
(optional)
Identifier of the cart on the Merchant’s site originally specified in merchantCartToken
argument for SendCart
method for the cart converted to this order on Global‑e.
string CartHash
(optional)
Cart hash originally specified in the merchantCartHash
argument for the SendCart
method for the cart converted to this order on Global‑e.
string StatusCode
Code denoting the order status on the Merchant’s site (to be mapped on the Global‑e side).
OrderStatusReason OrderStatusReason
Reason for the order status, why it was cancelledcanceled.
string CurrencyCode
3-char ISO currency code for the order being posted. By default, this is set to the original Merchant’s currency.
decimal PriceCoefficientRate
CountryCoefficient
rate applied to the prices in this order.
decimal RoundingRate
The average conversion rate applied to the prices paid by the end customer when calculating the prices paid by Global‑e to the Merchant in the original Merchant’s currency. This rate includes “FX conversion” and “marketing rounding” factors.
string UserId
(optional)
Internal User identifier on the Merchant’s site originally specified in the shippingDetails
.UserId
argument for SendCart
method for the cart converted to this order on Global‑e.
string ShippingMethodCode
(optional)
Code denoting the local shipping method selected from the list of available shipping options provided in the shippingOptionsList
argument for the SendCart
method for the cart converted to this order on Global‑e.
bool ClearCart
Indicates if the end customer’s cart must be cleared before this method finishes execution on the Merchant’s site.
bool AllowMailsFromMerchant
Indicates if the end customer has opted on the Global‑e checkout page to receive emails from the Merchant.
decimal LoyaltyPointsSpent
(optional)
The number of loyalty points spent for this purchase. The existing loyalty points handling procedure must be applied to the end customer’s user account. Therefore, the “Loyalty points” type discount must not be applied to the order directly but can be used for display purposes elsewhere in the system (i.e. on the end user’s My Account page).
decimal LoyaltyPointsEarned
(optional)
The number of loyalty points to be earned for this purchase by the end customer on the Merchant’s site, as specified in the loyaltyPointsEarned
argument for the SendCart
method for the cart converted to this order on Global-e.
string LoyaltyCode
(optional)
Loyalty code applicable to the Merchant’s site entered by the end customer in Global‑e checkout.
bool SameDayDispatch
(optional)
Indicates if the end customer has requested “Same Day Dispatch” on Global‑e checkout.
decimal SameDayDispatchCost
(optional)
Cost of the “Same Day Dispatch” option selected by the end customer on Global‑e checkout, in the original Merchant’s currency.
bool DoNotChargeVAT
(optional)
Indicates if the end customer hasn’t been charged VAT in Global‑e checkout, as specified in the doNotChargeVAT
argument for the SendCart
method for the cart converted to this order on Global‑e.
bool IsFreeShipping
(optional)
Indicates if the Merchant offers free international shipping to the end customer, as specified in the IsFreeShipping
argument for the SendCart
method for the cart converted to this order on Global‑e.
string FreeShippingCouponCode
(optional)
Merchant’s free shipping CouponCode
applied by the end customer, as specified in the FreeShippingCouponCode
argument for the SendCart
method for the cart converted to this order on Global‑e.
string ShipToStoreCode
(optional)
Code denoting the Merchant’s store specified by the customer for “ship to shop” shipping destination (to be mapped on the Global‑e side).
string CustomerComments
(optional)
Comments text entered by the end customer in Global‑e checkout.
List<orderDocoment> AdditionalRequiredDocuments
The required additional documents for shipping. When the information is provided, the Merchant must wait for the documents to be provided before starting fulfilmentfulfillment.
bool IsSplitOrder
(optional)
Indicates if the order should be handled as a split order (i.e. without consolidation)
string OTVoucherCode
(optional)
One-time voucher code used to place the order
string OTCurrencyCode
(optional)
Currency of the one-time voucher code used to place the order.
decimal OTVoucherAmount
(optional)
The amount taken off the voucher when applicable.
string WebStoreCode
(optional)
Code used on the merchant’s side to identify the web store, as specified in the WebStoreCode
argument for the SendCart
method for the cart converted to this order on Global‑e.
List<Merchant.Product> Products
The list of products being purchased.
List<Merchant.Discount> Discounts
(optional).
The list of discounts being applied to the order, according to the original list of discounts received in SendCart
for this order, and to the Merchant shipping configuration on Global‑e.
List<Merchant.Discount> Markups
(optional)
The list of markups being applied to the order, according to the Merchant shipping configuration on Global‑e. Effectively Markup is a “negative Discount”. The main use case for markups is when the end customer is charged in Global‑e checkout, a flat shipping rate, which is higher than the shipping rate, calculated for the respective order. In this case, Global‑e pays the difference to the merchant in the form of Markups applied to the order.
Unlike Discounts, Markups may be only passed to the Merchant’s back-end ERP system for reconciliation purposes, and may not be displayed to the end customer.
Merchant.Customer Customer
The paying customer’s preferences (Global-e acts as a paying customer).
Merchant.CustomerDetails PrimaryBilling
The primary customer’s billing details. If IsEndCustomerPrimary
is set to TRUE, then the primary customer is the payer and his details are indicated in the URL-encoded form.
Merchant.CustomerDetails PrimaryShipping
Primary customer’s shipping details. If Customer.IsEndCustomerPrimary
is TRUE, this field contains the end customers' shipping details. this field contains the Global-e hub's shipping address in the URL-encoded form.
Merchant.PaymentDetails PaymentDetails
The paying customer’s payment details.
Merchant.CustomerDetails SecondaryBilling
Secondary customer’s billing details. If Customer.IsEndCustomerPrimary
is FALSE, this contains attributes of the end customer’s details indicated in the URL-encoded form.
Merchant.CustomerDetails SecondaryShipping
Secondary customer’s shipping details. If Customer.IsEndCustomerPrimary
is FALSE, this field contains the end customers' shipping details.
Merchant.InternationalDetails InternationalDetails
(optional)
Details referring to the end customer’s order placed on the Global‑e side. These details apply only to the Merchants dealing with international customers’ support themselves.
decimal DiscountedShippingPrice
The shipping price paid by the customer converted to the merchant’s currency. Total Shipping price reducing Order Discounts (InternationalDetails.DiscountedShippingPrice
price converted to the merchant currency).
bool PrePayOffered
Indicates if the prepayment option for duties and taxes was offered to the customer.
bool IsReplacementOrder
Indicates if the order is a replacement.
Merchant.OriginalOrder OriginalOrder
(optional)
Details that refer to the original order if the current order is a replacement.
string DateCreated
(optional, returned by GetOrdersDetails
API only)
Order creation date and time
string CurrencyName
(optional, returned by GetOrdersDetails
API only)
Customer currency name
List<Merchant.Parcel> Parcels
(optional, returned by GetOrdersDetails
API only)
The list of parcels created for the order
decimal TotalDutiesAndTaxesPrice
Total Duties & Taxes value including Customs Clearance Fees, in the merchant currency. This amount is the total amount, regardless of whether the customer or the merchant paid it.
decimal USSalesTax
Sales tax value for USA in the merchant currency. This value is included in TotalDutiesAndTaxesPrice.
decimal CCFPrice
Customs Clearance Fees (CCF), in the merchant currency.
DTBreakdown CustomerDTBreakdown
Optional. Contains the duties and tax parts the customer paid for the order.
DTBreakdown MerchantDTBreakdown
Optional. Contains the duties and tax parts that the merchant subsidized for the order.
List<OrderPaymentMethod> OrderPaymentMethods
List of payment methods the customer use (Credit card, Gift Cards)
List<OrderDocument> OrderDocuments
Always contains a single document - it can be either a VAT Invoice or a Customer Receipt, depends if it is within the EU or not.
decimal TotalDutiesPaidByCustomerPrice
The total amount of duties paid by the customer in the merchant’s currency.
Int64 OrderCreationSource
One of the following possible values of OrderCreationSource
enumeration denoting a type of discount:
OrderCreationSource Value | Name | Description |
---|---|---|
0 | GECheckout | The default value for orders created in a normal flow via Global‑e Checkout |
1 | Marketplace | The value for orders that are created at a marketplace and sent to Global-e via your brand |
decimal CashOnDeliveryFee
CashOnDeliveryFee amount in merchant’s currency.
List<Merchant.Order> Subs
Contains Sub orders related to Mixed order. This list is defined only in case the order is Mixed.
bool IsTaxExemption
Indicates if the order has a tax exemption.
bool IsB2B
Indicates if the order has a Company name and VAT registration number.
bool IsMoto
true - the customer is a customer support agent and an “Offline order” took place,
false - regular customer
string ModifiedProduct
Holds the product’s SKU
string CustomerComments
Holds the gift message. In the offline order flow, holds the product comment.
bool ExporterDetails.LocalRegistrationClearance
Indicates whether the merchant can use destination Registration number. When set to ‘true’ the merchant can use ExporterDetails.DestinationRegistrationNumber
.
decimal ExporterDetails.DestinationRegistrationNumber
The Tax reference number of the GE Entity at the destination country. Should only be provided when the order is tax-collected. Otherwise, the field should be Null. The value should be Null if the order destination is for an EU country.
Merchant.OrderV2 [inherits all fields from Merchant.Order - 3.64]
DateTime DateCreated
Creation date
string CurrencyName
Name of the currency of the order
List<Parcel> Parcels
List of the parcels associated with the order
Merchant.OrderRefund
string MerchantGUID
Unique identifier of the Merchant on Global-e.
string OrderId
Global‑e order unique identifier.
string MerchantOrderId
(optional)
Order unique identifier on the Merchant’s site returned from a previous call to the SendOrderToMerchant
method for this order.
decimal OriginalTotalRefundAmount
The refund amount in the original Merchant currency including the local Merchant’s VAT (currency is specified in CurrencyCode
property of the respective Merchant.Order
).
decimal TotalRefundAmount
The total refund amount in the end customer’s currency used for this order’s payment (currency is specified in InternationalDetails.CurrencyCode
property for the respective Merchant.Order
).
Merchant.OrderRefundReason RefundReason
(optional)
Reason for the order refund
string RefundComments
(optional)
Comments for the order refund
decimal ServiceGestureAmount
(optional)
The “Service gesture” amount in the customer’s currency is included in the TotalRefundAmount
. “Service gesture” denotes any additional refund granted to the user, on top of the refund related to other components.
List<Merchant.RefundProduct> Products
(optional)
List of RefundProduct
objects for this order refund.
string WebStoreCode
(optional)
Code used on the merchant’s side to identify the web store, as specified in the WebStoreCode
argument for the SendCart
method for the cart converted to this order on Global‑e.
List<Merchant.RefundComponent> Components
(optional)
The list of RefundComponent
objects for this order refund.
string RMANumber
(optional)
The RMA number taken from the related Return.
string MerchantRMANumber
(optional)
The Merchant RMA number taken from the related Return.
Merchant.OrderRefundReason
string OrderRefundReasonCode
Code denoting the order refund reason on the Merchant’s site (to be mapped on the Global‑e side). If not mapped, Global‑e internal code will be specified instead.
string Name
Order refund reason name
Merchant.OrderTracking
string ShippingMethodCode
Code denoting the selected international shipping method as defined on the Merchant’s site (to be mapped on the Global‑e side). If this international shipping method does not exist on the Merchant’s site, the internal Global‑e shipping method code will be specified instead.
string ShippingMethodName
Name of the selected international shipping method.
string ShippingMethodStatusCode
Code denoting the selected shipping status as defined on the Merchant’s site (to be mapped on the Global‑e side). If this shipping status does not exist on the Merchant’s site, the internal Global‑e shipping status code will be specified instead.
string ShippingMethodStatusName
Name of the shipping status.
string ShipmentStatusUpdateTime
Date and time of the shipment status update. The date is in the UTC time zone specified in RFC 2822 format (i.e. Fri, 8 Aug 2014 17:13:07 +0000).
string ShipmentLocation
Last known location of the shipment.
Merchant.OriginalOrder
string OrderId
Global‑e order unique identifier for the original order.
string MerchantOrderId
(optional)
OrderId
returned from SendOrderToMerchant
call for the original order.
string MerchantInternalOrderId
(optional)
InternalOrderId
returned from SendOrderToMerchant
call for the original order.
Merchant.Parcel
string Code
Parcel code.
Int64 ParcelStatusId
Parcel status id.
string StatusName
Parcel status name.
string TrackingUrl
Direct tracking URL.
List<Merchant.ParcelProduct> Products
(optional)
List of products included in the parcel.
Merchant.ParcelProduct
string Sku
Product SKU.
string CartItemId
Cart item id of the product.
Int64 Quantity
Product quantity included in the parcel.
Merchant.ParcelTracking
string ParcelTrackingNumber
The tracking number is used by the selected international shipping method for this parcel.
string ParcelTrackingUrl
Full tracking URL including ParcelTrackingNumber
used by the selected international shipping method for this parcel.
string ParcelCode
Parcel code.
Merchant.PaymentDetails
string OwnerFirstName
(optional if OwnerName
is specified)
Card owner’s first name
string OwnerLastName
(optional if OwnerName
is specified)
Card owner’s last name
string OwnerName
(optional)
Card owner’s full name (the Merchant may choose to consider either full name or first name with the last name, according to the existing payment method input validation requirements).
string CardNumber
Card number
string CVVNumber
Card CVV number
string PaymentMethodName
Payment method name
string PaymentMethodCode
Payment method code used to identify the payment method on the Merchant’s site (to be mapped on the Global‑e side).
string PaymentMethodTypeCode
Payment method type’s code used to identify the payment method type (such as Credit Card or Check) on the Merchant’s site (to be mapped on the Global‑e side).
string ExpirationDate
Card expiration date (in YYYY-MM-DD format)
string CountryName
Country name
string CountryCode
2-char ISO country code
string StateCode
(optional)
State or province ISO code such as AZ for Arizona (if applicable)
string StateOrProvice
(optional)
State or province name
string City
(optional)
City name
string Zip
(optional)
Zip or postal code
string Address1
(optional)
Address line 1
string Address2
(optional)
Address line 2
string Phone1
(optional)
Phone #1
string Phone2
(optional)
Phone #2
string Fax
(optional)
Fax
string Email
(optional)
E-mail address
Merchant.Product
string Sku
SKU code used to identify the product on the Merchant’s site (to be mapped on the Global‑e side).
decimal Price
Single product final sale price in the currency defined in the CurrencyCode
property of the respective Merchant.Order
object for the order being submitted to the Merchant.
decimal ListPrice
Single product List price in the currency defined in the CurrencyCode
property of the respective Merchant.Order
object for the order being submitted to the Merchant.
decimal VATRate
The VAT rate applied to this product
decimal PriceBeforeGlobalEDiscount
- DEPRECATED
Single product price in the currency defined in the CurrencyCode
property of the respective Merchant.Order
object for the order being submitted to the Merchant, before applying any per-product Global‑e discounts (such as per-product Shipping discounts). If no Global‑e discount was applied, PriceBeforeGlobalEDiscount
is equal to Price.
decimal LineItemPriceBeforeGlobalEDiscount
(optional) - DEPRECATED
Line item (product in ordered quantity) price in the currency defined in the CurrencyCode
property of the respective Merchant.Order
object for the order being submitted to the Merchant, before applying any per-product Global‑e discounts (such as per-product Shipping discounts). If not specified, should be deemed equal to “PriceBeforeGlobalEDiscount * Quantity”. If specified, should take preference over PriceBeforeGlobalEDiscount
.
decimal InternationalPrice
(optional)
Single product final sale price in end customer currency (specified in InternationalDetails.CurrencyCode property for the respective Merchant.Order)
, after applying country coefficient, FX conversion, rounding rule (if applicable), and IncludeVAT
handling.
decimal InternationalListPrice
(optional)
Single product list price in end customer’s currency (specified in the InternationalDetails.CurrencyCode
property for the respective Merchant.Order
), after applying country coefficient, FX conversion, rounding rule (if applicable), and IncludeVAT
handling.
decimal LineItemInternationalPrice
(optional)
Line item (product in ordered quantity) price in end customer’s currency (specified in the InternationalDetails.CurrencyCode
property for the respective Merchant.Order
), after applying country coefficient, FX conversion, rounding rule (if applicable), and IncludeVAT
handling. If not specified, should be deemed equal to “InternationalPrice * Quantity”. If specified, should take preference over InternationalPrice.
decimal RoundingRate
The conversion rate applied to this product price paid by the end customer when calculating the prices paid by Global‑e to the Merchant in the original Merchant’s currency. This rate includes “FX conversion” and “marketing rounding” factors.
Int64 Quantity
Product quantity in the order that is currently being submitted to the Merchant.
string CartItemId
(optional)
Identifier of the cart item on the Merchant’s site originally specified in the Product.CartItemId
property of the respective product in the SendCart
method for the cart converted to this order on Global‑e.
string ParentCartItemId
(optional)
Identifier of the current item’s parent cart item on the Merchant’s site originally specified in the Product.ParentCartItemId
property of the respective product in the SendCart
method for the cart converted to this order on Global‑e.
string CartItemOptionId
(optional)
Identifier of the child cart item “option” on the Merchant’s site originally specified in the Product.CartItemOptionId
property of the respective product in the SendCart
method for the cart converted to this order on Global‑e.
string HandlingCode
(optional)
Code originally specified in Product.HandlingCode
property of the respective product in the SendCart
method for the cart converted to this order on Global‑e.
string GiftMessage
(optional)
Text originally specified in the Product.GiftMessage
property of the respective product in the SendCart
method for the cart converted to this order on Global‑e.
bool IsBackOrdered
(optional)
Boolean specifying if the product was ordered as a backed ordered item
string BackOrderDate
(optional)
Estimated date for the backordered item to be in stock
decimal DiscountedPrice
The product value is in merchant currency after deducting all product and cart level discounts from the price. Product level discounts will be fully deducted from the respective product’s price and cart discounts will be prorated over all products according to the remaining value.
This value can be used as the pre-calculated value for the returned product’s refund.
decimal InternationalDiscountedPrice
The product value in customer currency after deducting all product and cart level discounts from the price. Product level discounts will be fully deducted from the respective product’s price and cart discounts will be prorated over all products according to the remaining value.
This value can be used as the pre-calculated value for the returned product’s refund.
Merchant.Brand Brand
(optional)
Product’s brand
List<Merchant.Category> Categories
(optional)
Product categories
List<Merchant.CartProductAttribute> Attributes
(optional)
Custom attributes describe products that customers can personalize according to what the site offers.
Each Attribute holds a key to specify attribute name and Value properties.
string Name
(optional, returned by GetOrdersDetails
API only)
Name of the product
List<Merchant.ProductAttribute> ProductAttributes
(optional, returned by GetOrdersDetails
API only)
Product attributes
string GenericHSCode
(optional)
Product’s HS code
decimal DiscountedPriceForCustoms
Product price in merchant currency reflects the price after Reverse D&T calculation.
decimal InternationalDiscountedPriceForCustoms
Product price in customer currency reflects the price after Reverse D&T calculation
DTBreakdown DTBreakdown
(optional)
Optional. Contains the duties and taxes per item in merchant currency.
DTBreakdown InternationalDTBreakdown
(optional)
Contains the duties and taxes per item in customer currency.
decimal CustomerVATRate
The customer VAT rate applied to this product
decimal InternationalDiscountedPriceInMerchantCurrency
Product Price in merchant currency
Merchant.ProductAttribute
string AttributeCode
Product custom attribute code originally specified in the respective Attribute in Attributes list in the SendCart
method for the cart converted to this order on Global‑e.
string AttributeTypeCode
Product attribute type code originally specified in the respective Attribute in Attributes list in the SendCart
method for the cart converted to this order on Global‑e.
Merchant.ProductVoucherValidation
string Sku
SKU code used to identify the product on the Merchant’s site (to be mapped on the Global‑e side).
decimal Price
Int64 Quantity
Product ordered quantity.
decimal VATRate
The VAT rate applied to this product.
string CartItemId
Identifier of the cart item on the Merchant’s site originally specified in the Product.CartItemId
property of the respective product in the SendCart
method for the cart converted to this order on Global‑e.
string ParentCartItemId
Identifier of the current item’s parent cart item on the Merchant’s site originally specified in the Product.ParentCartItemId
property of the respective product in the SendCart
method for the cart converted to this order on Global‑e.
string CartItemOptionId
Identifier of the child cart item “option” on the Merchant’s site originally specified in the Product.CartItemOptionId property of the respective product in the SendCart
method for the cart converted to this order on Global‑e.
string HandlingCode
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 SendOrderToMerchant
method.
List<string> Categories
- DEPRECATED
List of categories mapped for current cart product.
Merchant.RefundComponent
decimal Amount
The refund amount in customer currency.
decimal OriginalAmount
The refund amount in merchant currency.
bool IsChargedToMerchant
If this component is charged to the merchant, the flag is TRUE (default). If this component is charged to Global‑e, the flag is FALSE. If the same component is split between charged to the merchant and charged to Global‑e, it should appear twice, each time with a different value in IsChargedToMerchant
. Exception: A component PrepaidReturn
– it should always be IsChargedToMerchant
= TRUE.
string ComponentType
Products, Shipping, Duties, PrepaidReturn
or ServiceGesture
.
Merchant.RefundProduct
string CartItemId
(optional)
Identifier of the line item on the Merchant’s site. This property is mandatory and should be equal to the respective Product’s CartItemId
originally specified in the SendCart
method for the order being refunded.
Int64 RefundQuantity
Product quantity (i.e. a part of the originally ordered quantity) that the refund refers to.
decimal OriginalRefundAmount
The refund amount in the original Merchant currency including the local Merchant’s VAT for this product line item, before applying any price modifications (i.e. part of or the full value paid by Global-e to the Merchant, as was specified in Merchant.Product.Price
for the respective order).
decimal RefundAmount
The refund amount for this product line item in customer currency used for the payment of this order.
Merchant.OrderRefundReason RefundReason
(optional)
Reason for this product’s refund.
string RefundComments
(optional)
Comments for this product’s refund.
string SKU
(optional)
This field is obsolete. Use ProductCode
below instead. Product SKU or Product Variant ID according to merchant configuration. Can be used as a Product Identifier instead of CartItemId
. In case there are multiple products with the same identifier we will choose one of them arbitrarily.
string ProductCode
(optional)
Product SKU or Product Variant ID according to merchant configuration. Can be used as a Product Identifier instead of CartItemId
. In case there are multiple products with the same identifier, we choose one of them arbitrarily.
Merchant.RemoveRestrictedProductsRequest
string MerchantGUID
Unique identifier of the Merchant on Global-e.
string CartToken
The value returned from the previous call to SendCart
for the same client (must be stored in the client session or persistent cookie on the merchant’s side). This parameter is used to support cart updates.
string CartId
Identifier of the cart on the Merchant’s site originally specified in merchantCartToken
argument for SendCart method for the cart converted to this order on Global‑e.
string UserId
(optional)
Internal User identifier on the Merchant’s site in case it was specified in the SendCart
call.
string CountryCode
2-char ISO country code
string CurrencyCode
3-char ISO currency code.
string WebStoreCode
Code used on the merchant’s side to identify the web store where the current cart is originating from. This code should be used in case of a multi-store setup on the merchant’s site.
string WebStoreInstanceCode
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.
List<string> RemovedProductCodes
List of SKU codes for products removal from the cart.
Merchant.RemoveRestrictedProductsResponse
bool IsSuccess
TRUE if the result is success
string ErrorMessage
(optional)
Description of the error if it happened
string ErrorCode
(optional)
Code of the error if it happened
Merchant.ResponseInfo
string InternalOrderId
(optional in case of error, failure or if the action is not related to a specific order)
Order unique identifier on the Merchant’s site
string OrderId
(optional)
Order identifier on the Merchant’s site used for display and reporting purposes only. Unlike the InternalOrderId
, this identifier is not necessarily unique over time, as the Merchant’s site may potentially reuse it (for example after deleting the old order having the same OrderId
).
string StatusCode
(optional in case of error or failure)
Code denoting the order status on the Merchant’s site (to be mapped on the Global‑e side).
string PaymentCurrencyCode
(optional)
3-char ISO currency code for the order (if payment was processed in the respective API method call).
string PaymentAmount
(optional)
The total payment amount in PaymentCurrency
charged for the order (if payment was processed in the respective API method call).
bool Success
Indicates if the call has succeeded. FALSE denotes an error or failure.
string ErrorCode
(optional)
Error code to be returned when an error occurs.
string Message
(optional)
Optional response message. In case of an error, this property indicates the error message text.
string Description
(optional)
Optional response description. In case of an error, this property indicates the error message description.
Merchant.StockValidationResponse
List<Merchant.StockValidationRowResponse> AmendedProducts
(optional)
The list of products that don’t have full stock availability for the Product.Quantity
specified in the respective ValidateStock
API request.
string Error
(optional)
The error message returned from the merchant
string ReservationRequestId
(optional)
The stock reservation code returned from the merchant if the stock has been actually reserved as a result of the ValidateStock
API call.
Dictionary<string, string> CustomResources
(optional)
Dictionary with custom resources for error and oos popup. Keys for the dictionary:
TitleTextResourceId, BodyTextResourceId, ButtonTextResourceId, RedirectUrl
.
Dictionary<string, string> TextResourcesPlaceholders
(optional)
Dictionary with placeholders which need to be replaced in text resources for error and oos popup which was passed in CustomResources
(except RedirectUrl
key).
Merchant.StockValidationRowResponse
string CartItemId
Identifier of the cart item on the Merchant’s site originally specified in the Product.CartItemId
property of the respective product in the cart.
string QuantityInStock
Available product quantity.
MerchantReturn
string OrderId
string MerchantOrderId
string RMANumber
string ShipperName
string ReturnTrackingNumber
string TrackingURL
string CreatedBy
List<MerchantReturnProduct> ReturnedProducts
string MerchantGUID
MerchantReturnProduct
string SKU
string Name
string CartItemId
string ReturnQuantity
string ReturnReasonName
string MerchantReturnReasonCode
string MerchantReturnReasonName
Merchant.TrackingDetails
string TrackingNumber
The tracking number as the shipper has specified.
string ShipperName
The shipping method name.
string TrackingURL
Full tracking URL including the TrackingNumber
used by the selected international shipping method.
Merchant.VoucherValidationResponse
bool IsVoucherValid
TRUE if the voucher is valid
Int64 VoucherType
Enumeration of VoucherTypes
:
1 DiscountVoucher
string CartToken
CartToken
returned from the new SendCart
/ SendCartV2
API call, executed after the voucher has been applied to the respective user’s basket.
List<Merchant.VoucherValidationRestriction> VoucherRestrictions
List of validation restrictions applied to vouchers.
string ValidationFaliureMessage
Error message in case voucher is not valid.
Merchant.VoucherValidationRestriction
Int64 VoucherValidationRestrictionType
0 - Country
string RestrictionEntityCode
Country code value
OrderCreationSource
GECheckout = 0,
Marketplace = 1,
ExternalApp = 2,
ShopifyAPI = 3,
OrdersDetailsFilter
List<string> OrderIds
List of order ids to manifest.
OrderDocument
string DocumentData
Base64 encoded byte array representing the document file content.
string URL
URL of the document.
string DocumentTypeCode
Document type code, this value can be:
CommercialInvoice = 1
PackingList = 2
ShipperManifest = 3
Label = 4
VATInvoice = 5
DangerousGoodDeclarationLink = 6
GELabel = 7
CustomerReceiptInvoice = 8
ArchibeLabel = 9
DeliveryAdvice = 10
EAD = 11
string DocumentTypeName
Document type name, e.g. AWB
, CommercialInvoiceAndPackingList
or Manifest
.
string DocumentExtension
Document extension (PDF, ZPL, EPL).
string ErrorMessage
(optional)
Description of the error for this entity (order/parcel) if it happened.
string ShippingServiceName
(optional)
The name of the shipping service for this document (relevant for DispatchOrders
and DispatchConsolidatedShipment
).
string ParcelCode
(optional)
The parcel code related to the document.
string DocumentReference
(optional)
The reference provided by the government authorities to this document (such as MRN or ITN number).
DateTime CreationDateTime
(optional)
The date and time the document was created.
OrderDocumentsResponse
bool IsSuccess
Indicates whether the API call was successful
string ErrorText
(optional)
Description of the error to get documents
List<OrderDocument> Documents
(optional)
List of OrderDocument
objects that hold the shipping documents. This property is included only in the GetShippingDocuments
method response.
List<OrderDocument> ShipperManifests
(optional)
List of OrderDocument
objects that hold shipper manifest documents. This property is included only in the DispatchOrders
method response.
List<Merchant.ParcelTracking> ParcelsTracking
(optional)
List of the Merchant.ParcelTracking
objects, each object holds the parcel tracking number and full tracking URL for the relevant shipper (with the parcel tracking number).
Merchant.TrackingDetails TrackingDetails
(optional)
Order tracking information.
List<DeliveryAdviceInformation> DeliveryAdviceInformation
(optional)
List of DeliveryAdviceInformation
objects that hold the information required for the “Delivery Advice” document.
OrderManifestDetails
string OrderId
(optional)
Global‑e order unique identifier.
NOTE Either OrderID
or MerchantOrderID
should be specified.
This property is mandatory only if the MerchantOrderID
property has not been specified.
string MerchantOrderId
(optional)
Order unique identifier on the Merchant’s site.
NOTE Either OrderID
or MerchantOrderID
should be specified.
This property is mandatory only if the OrderID
property has not been specified.
OrderPaymentMethod
long PaymentMethodId
string PaymentMethodName
bool IsGiftCard
string GiftCardFields
decimal PaidAmountInCustomerCurrency
decimal PaidAmountInMerchantCurrency
OrderStatus
string OrderStatusCode
Code denoting the order status on the Merchant’s site (to be mapped on the Global‑e side)
string Name
Order status name
OrderStatusDetails
string OrderId
Global‑e order unique identifier (previously submitted to the Merchant’s SendOrderToMerchant
method defined below in this document when the order had been created with the Global‑e checkout)
OrderStatus OrderStatus
Order status
OrderStatusReason OrderStatusReason
(optional)
Reason for the order status
string OrderComments
(optional)
Merchant's comments for the order
string ConfirmationNumber
(optional)
Merchant's Order confirmation number
string TrackingServiceName
(optional)
Name of the tracking service used by the Merchant for this order
string TrackingServiceSite
(optional)
URL of the tracking service site used by the Merchant for this order
string TrackingNumber
(optional)
Reference number valid for the tracking service used by the Merchant for this order
string TrackingURL
(optional)
Full tracking URL on the tracking service site used by the Merchant (if specified overrides all other “Tracking…” properties)
string DeliveryReferenceNumber
(optional)
Merchant’s internal Delivery Reference Number for this order
OrderStatusReason
string OrderStatusReasonCode
Code denoting the order status reason on the Merchant’s site (to be mapped on the Global‑e side)
string Name
Order status reason name
OrderRefundDetails
string OrderId
Global‑e order unique identifier (previously submitted to the Merchant’s SendOrderToMerchant
method when the order had been created with Global‑e checkout) or Order unique identifier on the Merchant’s site.
decimal TotalRefundAmount
(optional)
The total refund amount in the end customer’s currency and used for this order’s payment. If this attribute is not specified, OriginalTotalRefundAmount
along with the sum of OriginalRefundAmount
values in the refundProductsList
specified in the respective CreateOrderRefund
, will be used to calculate the TotalRefundAmount
.
decimal OriginalTotalRefundAmount
(optional)
The refund amount in the original Merchant currency including the local Merchant VAT.
OrderRefundReason RefundReason
(optional)
Reason for the order refund
string RefundComments
(optional)
Merchant's comments for the order refund
decimal DutiesAmount
(optional)
The “Duties
” amount in the customer's currency included in the TotalRefundAmount
. “Duties
” denotes the funds that should be refunded due to Duties, Taxes and CCF costs.
decimal ShippingAmount
(optional)
The “Shipping
” amount in the customer’s currency included in TotalRefundAmount
. “Shipping
” denotes the funds that should be refunded due to shipping costs.
decimal ServiceGestureAmount
(optional)
“Service gesture” amount in the customer’s currency included in TotalRefundAmount
. “Service gesture” denotes any additional refund granted to the user, on top of the refund related to other components.
bool FullRefund
(optional)
The flag indicates that the full refund of the order should be performed.
bool ProductsDutiesRefund
(optional)
The flag indicates that the refund for the products should also include the associated duties and taxes. If ProductsDutiesRefund
is specified, all refund totals will be auto-calculated, and therefore specifying DutiesAmount
, TotalRefundAmount
or OriginalTotalRefundAmount
will return an error in this case.
bool ShippingRefund
(optional)
The flag indicates that the full shipping cost should be refunded. Either the ShippingRefund
flag or ShippingAmount
can be provided at the same time If a part of the shipping cost was already refunded – only the remaining available part will be refunded.
decimal CustomerPrepaidRefundAmount
(optional)
Represents a prepaid fee that the customer is required to pay in case of refunds. This fee is deducted from the total refund amount due to the customer. The value of this field is specified in the currency of the customer.
decimal OriginalCustomerPrepaidRefundAmount
(optional)
Represents a prepaid fee that the customer is required to pay in case of refunds. This field is populated in the original currency of the merchant. The prepaid fee is converted to the currency of the customer and then deducted from the total refund amount due to the customer. Currency conversion rates are calculated based on the Spot rate on the day of the order creation.
Use this field only when CustomerPrepaidRefundAmount
is not provided. Make sure that only one of these fields is populated at a time to avoid double deductions.
Positive Decimal OriginalAmountPrepaidRefund
The return shipping cost in the customer’s currency.
Positive Decimal CustomerAmountPrepaidRefund
The return shipping cost. Populated by the merchant.
OrderRefundReason
string OrderRefundReasonCode
Code denoting the order refund reason on the Merchant’s site (to be mapped on the Global‑e side)
string Name
Order refund reason name
OrderReplacementData
string OriginalOrderId
List<ReplacedProduct> ReplacedProducts
Parcel
string ParcelCode
Code used to identify the Parcel on the Merchant’s site
List<Product> Products
(optional)
List of products contained in the parcel (for each Product object the following fields are relevant when used in the Parcel class: ProductCode, CartItemId, DeliveryQuantity
). The products list is applicable only when including the list of products in each parcel is mandatory (such as in the UpdateParcelDispatch
method).
TrackingDetails TrackingDetails
(optional)
Tracking information about the order/parcel.
decimal Weight
(optional)
Parcel weight in grams as measured by the merchant.
decimal Height
(optional)
Parcel height in centimetrescentimeters as measured by the merchant.
decimal Width
(optional)
Parcel width in centimetrescentimeters as measured by the merchant.
decimal Length
(optional)
Parcel length in centimetrescentimeters as measured by the merchant.
ParcelStatus
string merchantParcelStatusCode
(Mandatory)
The status code of the parcel, on the merchant side.
string merchantParcelStatusReason
NOT IN USE – Reserved for future use.
ParcelError extends ErrorBase<T>
string ParcelCode
Parcel Code provided in the VoidParcelRequest
string InnerErrorText
Specifies inner error text in a case when third-party errors have occurred
PriceItemInfo
string PriceItemId
Unique identifier for the price item in the list (e.g. shipping option)
decimal Price
Price of the item
Product
string ProductCode
SKU code used to identify the product on the Merchant’s site (to be mapped on the Global‑e side)
string ProductGroupCode
(optional)
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 colourcolors").
string ProductCodeSecondary
(optional)
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 ProductCode
and is not guaranteed to be unique (may be reused for other products as long as the old product is not available on the merchant’s site any more).
string ProductGroupCodeSecondary
(optional)
Secondary code that may refer to the group of products on the Merchant’s site. This code may be used in addition to the ProductGroupCode
and is not guaranteed to be unique (may be reused for other groups as long as the old group is not available on the merchant’s site anymore).
string CartItemId
(optional)
Identifier of the cart item on the Merchant’s site. This property may be optionally specified in the SendCart
method only so that the same value can be posted back when creating the order on the Merchant’s site with the SendOrderToMerchant
method.
string ParentCartItemId
(optional)
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 (CartItemId
must not be specified for this item because this attribute applies only to the “parent” item itself). For example, this item might indicate a custom option (such as a product package) for the parent item in the same cart. This property may be optionally specified in the SendCart
method only so that the same value can be posted back when creating the order on the Merchant’s site with the SendOrderToMerchant
method.
string CartItemOptionId
(optional)
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 (CartItemId
must not be specified for this item because this attribute applies only to the “parent” item itself). For example, this item might indicate a package for the parent item in the same cart. This property may be optionally specified in the SendCart
method only so that the same value can be posted back when creating the order on the Merchant’s site with the SendOrderToMerchant
method.
string Name
Name of the Product
string NameEnglish
Name of the Product in English
string Description
Description of the Product
string DescriptionEnglish
Description of the Product in English
string Keywords
(optional)
The product’s keywords
string URL
(optional)
The product’s information page URL
string GiftMessage
(optional)
Optional “gift message” text defined by the end customer to be printed on the product.
string GenericHSCode
(optional)
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.
string OriginCountryCode
(optional)
2-char ISO country code of the product’s country of Origin. The Merchant’s country will be assumed if not specified.
decimal Weight
(optional)
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.
decimal NetWeight
(optional)
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.
decimal Height
(optional)
The product’s height in the Merchant’s default unit of length measure (will be converted to CM).
decimal Width
(optional)
The product’s width in the Merchant’s default unit of length measure (will be converted to CM).
decimal Length
(optional)
The product’s length in the Merchant’s default unit of length measure (will be converted to CM).
decimal Volume
(optional, and alternative for specifying all 3 dimensions above)
The product’s volume in the Merchant’s default unit of volume measure (will be converted to cubic CM).
decimal NetVolume
(optional)
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.
string ImageURL
(optional)
The product’s image URL
Int64 ImageHeight
(optional)
The product’s image height in pixels
Int64 ImageWidth
(optional)
The product’s image width in pixels
decimal ListPrice
(optional in SendCart, SaveProductsBulk
)
Product list price (before discounts) as displayed to the customer, after applying country coefficient, FX conversion, rounding rule (if applicable) and IncludeVAT
handling.
decimal OriginalListPrice
(optional in SendCart, SaveProductsBulk
)
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 UseCountryVAT
for the end customer’s current country.
decimal SalePrice
(optional in SaveProductsList, SaveProductsBulk, GetCheckoutCartInfo
)
Product sale price as displayed to the customer, after applying country coefficient, FX conversion, rounding rule (if applicable) and IncludeVAT
handling.
decimal SalePriceBeforeRounding
(optional)
Product sale price as displayed to the customer, after applying country coefficient, FX conversion and IncludeVAT
handling, before rounding rules have been applied. If not specified, will be deemed equal to SalePrice
.
decimal LineItemSalePrice
(optional)
Line item (product in ordered quantity) sale price as displayed to the customer, after applying country coefficient, FX conversion and IncludeVAT
handling, before rounding rules have been applied. If not specified, will be deemed equal to “SalePrice * OrderedQuantity”
. If specified, will take preference over SalePrice
.
decimal OriginalSalePrice
(optional in SaveProductsList, SaveProductsBulk
)
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 UseCountryVAT for the end customer’s current country.
decimal LineItemOriginalSalePrice
(optional)
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 UseCountryVAT
for the end customer’s current country. If not specified, will be deemed equal to “OriginalSalePrice
* OrderedQuantity”. If specified, will take preference over OriginalSalePrice.
string SalePriceReason
(optional)
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”).
bool IsFixedPrice
(optional)
Setting this to TRUE indicates that the product’s price is fixed by the Merchant, in the default currency for the country. In this case, all price modifications are disabled for this product. Setting fixed prices is only allowed for the Countries where the SupportsFixedPrices
flag is set to TRUE.
Int64 OrderedQuantity
(optional)
Ordered quantity for the product (to be used in Checkout / Order methods described below, as needed)
Int64 DeliveryQuantity
(optional)
The quantity actually set for delivery for the product (to be used in the Order methods described below, as needed)
bool IsBundle
(optional)
Setting this to TRUE indicates that the product represents a set of other products. If a bundled product has non-zero prices specified (i.e. OriginalListPrice
, ListPrice
, etc.), then all the contained products must have zero prices, and vice versa, to avoid double charging for the same products.
bool IsVirtual
(optional)
Setting this to TRUE indicates that the product represents a virtual product that does not have weight or volume and doesn’t affect shipping calculation in Global‑e checkout.
bool IsBlockedForGlobalE
(optional)
Setting this to TRUE indicates that the product is not available for international shipping
string HandlingCode
(optional)
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 SendOrderToMerchant
method.
VATRateType VATRateType
(optional)
Product’s VAT rate type or class
VATRateType LocalVATRateType
(optional)
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 UseCountryVAT
for the current Country is TRUE, and therefore the VATRateType
property actually denotes the VAT for the target country.
VATCategory VATCategory
(optional)
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.
Brand Brand
(optional)
The product’s brand
List<Category> Categories
(optional)
The product’s categories
List<Attribute> Attributes
(optional)
The product’s custom attributes (such as Color, Size, etc.)
List<Attribute> AttributesEnglish
(optional)
The product’s custom attributes (such as Color, Size, etc.) in English
bool IsBackOrdered
(optional – default false)
Boolean specifying if the product was ordered as a backed ordered item
string BackOrderDate
(optional)
Estimated date for the backordered item to be in stock
string ProductClassCode
(optional)
The product class code is used by the merchant to classify products to use different country coefficient rates.
decimal PriceCoefficientRate
(optional)
Rate applicable to this Product’s ProductClassCode
if returned from the CountryCoefficients
method.
ProductMetaData MetaData
(optional)
Used to hold additional product data such as customer-defined product attributes.
string HubCode
(optional)
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.
ProductCountry
string ProductCode
SKU code used to identify the product on the Merchant’s site (to be mapped on the Global‑e side)
string CountryCode
2-char ISO code of the shipping country
VATRateType VATRateType
(optional)
Product’s VAT rate type or class to be used for this product in this shipping country. If not specified, the respective VATCategoryCountry’s VATRateType
or Country’s DefaultVATRateType
must be used if applicable according to the UseCountryVAT value for this country. Otherwise, the VAT rate defined for this product on the merchant’s site must be used.
bool IsRestricted
TRUE if this product has import restrictions for this shipping country. If at least one restricted product is included in the Cart, the end customer will not be able to place the order with Global-e until the product is either removed from the Cart or a shipping country with no restrictions for this product is selected.
string RestrictionMessage
Textual definition of the restriction (will be empty if IsRestricted
is FALSE)
bool IsForbidden
TRUE if this product is not supported for shipping to this country by Global-e. Adding this product to the cart must be disabled completely.
string ForbiddanceMessage
Textual definition of the forbiddance (will be empty if IsForbidden
is FALSE)
bool IsVerified
Indicates if product restrictions and other data contained in this object have been verified by Global‑e (i.e. some algorithmic approximations may be used by the system until manually resolved by Global‑e personnel)
Int64 TTL
Time-to-live interval (in seconds) before this object must be refreshed from the Global-e server. This property overwrites the “max-age” header returned by any method call which returns the ProductCountry
object.
bool UploadedViaCatalog
Indicates whether the product was uploaded via catalogue catalog or not.
ProductMetaData
List<CustomProductAttribute> Attributes
(optional)
Customer-defined product attributes that allow the personalisation of the product if supported by the merchant’s site (e.g. engraving).
RefundProduct
string CartItemId
Identifier of the line item on the Merchant’s site. This property is mandatory and should be equal to the respective Product’s CartItemId
originally specified in the SendCart
method for the order being refunded.
Int64 RefundQuantity
(optional)
Product quantity (i.e. a part of the originally ordered quantity) that the refund refers to.
decimal OriginalRefundAmount
(optional)
The refund amount in the original Merchant’s currency including the local Merchant’s VAT for this product line item, before applying any price modifications (i.e. part of or the full value paid by Global-e to the Merchant, as was specified in Merchant.Product.Price
for the respective order).
decimal RefundAmount
(optional)
The refund amount for this product line item in customer currency and used for this order payment. If this attribute is not specified, OriginalRefundAmount
multiplied by RoundingRate
for this product line item should be used to calculate TotalRefundAmount
for this order’s refund.
OrderRefundReason RefundReason
(optional)
Reason for this product’s refund
string RefundComments
(optional)
Merchant's comments for this product’s refund
string Sku
(optional)
The field is obsolete, please use ProductCode
(below) instead.
Product SKU or Product Variant ID. can according to merchant configuration. Can be used as a Product Identifier instead of CartItemId
. In case there are multiple products with the same identifier we will choose one of them arbitrarily
string ProductCode
(optional)
Product SKU or Product Variant ID according to merchant configuration. Can be used as Product Identifier instead of CartItemId
. In case there are multiple products with the same identifier we will choose one of them arbitrarily.
Region
string Code
Region code for this state or province (unique in the respective Country).
string Name
Region name
string CountryCode
2-char ISO country code to which this region belongs
RedeemGiftCardRequest
string MerchantGUID
Merchant unique identifier
string ShippingCountryCode
Code of country selected on checkout
List<GiftCardData> Cards
List with gift cards data objects
string OrderId
Global‑e Order ID
string MerchantCartToken
Identifier of the cart on the Merchant’s site originally specified in the merchantCartToken
argument for the respective SendCart
call
RedeemGiftCardResponse
List<GiftCardData> Cards
List with gift cards data objects data
string ErrorCode
Code of the error
string ErrorText
Error message
RefundGiftCardRequest
string MerchantGUID
Merchant unique identifier
List<GiftCardData> Cards
List with gift cards data objects
string OrderId
Global‑e Order ID
decimal TotalToRefundInGiftCardCurrency
The total value to refund for all gift cards in gift card currency
decimal TotalToRefundInCustomerCurrency
The total value to refund for all gift cards in customer currency
decimal ConversionRate
Rate of conversion from gift card currency to customer currency
RefundGiftCardResponse
bool IsRefunded
Return true if amounts of redeemed cards successfully returned
List<GiftCardData> Cards
List with gift cards data objects data
string ErrorCode
Code of the error
string ErrorText
Error message
ReplacedProduct
string CartItemId
long Quantity
ResponseInfo
bool Success
Indicates if the respective API method call was successful. Success property value may be only TRUE. Otherwise, ErrorInfo
will be returned instead (like in any API method, as described above in this document).
string Reason
(optional) Text that optionally describes the reason for Success status.
RoundingException
decimal ExceptionValue
A decimal value to avoid rounding for. Rounding exceptions always behave like “Relative Decimal”.
RoundingRange
decimal From
A decimal value of the range start, exclusive of the From value itself. If a range must start from 0 inclusive, the From value must be set to a negative number.
decimal To
A decimal value of the range end, inclusive.
decimal Threshold
A decimal value used to split the range so that the values less than the threshold would be rounded to the Lower target, and values greater than or equal to the threshold would be rounded to the Upper target. For the "Absolute target," the threshold range is an absolute value. Other Ranges are Relative values. See the absolute target in Rounding Range for more information.
decimal LowerTarget
A decimal value used to calculate the target rounded value, for the numbers less than the Threshold, according to the defined Range behaviourbehavior. If the LowerTarget
value violates the MaxDecimalPlaces
setting for the respective currency, it must be truncated as described in the “Important Notices” below.
decimal UpperTarget
A decimal value used to calculate the target rounded value, for the numbers greater than or equal to the Threshold, according to the defined Range behaviourbehavior. If the UpperTarget
value violates the MaxDecimalPlaces
setting for the respective currency, it must be truncated as described in the “Important Notices” below.
Int64 RangeBehavior
One of the possible values of RangeBehaviors
enumeration defined below which is designed to control the way rounding range is handled. The range behaviourbehavioris applied to Threshold
, LowerTarget
, UpperTarget
and Exceptions
in the RoundingExceptions
list.
decimal TargetBehaviorHelperValue
A decimal value required for the “nearest target” and “relative whole target” behaviourbehavior.
List<RoundingException> RoundingExceptions
List of decimal values used to calculate the exceptions for rounding, i.e. values not to apply rounding for.
RangeBehaviors enumeration:
RangeBehavior Option Value | Name | Description |
---|---|---|
1 | Absolute target | In this behaviourbehavior, all the values within the specified range ( Getting rounding result (R) for the source number (S) must be implemented as follows: If (S = Exceptionn) then R = Exceptionn If (S < Threshold) then R = LowerTarget If (S >= Threshold) then R = UpperTarget |
2 | Relative Decimal target | In this behaviourbehavior, all the values within the specified range ( For source number (S): B = whole part of S LowerTarget (absolute): LA = B – 1 + LowerTarget UpperTarget (absolute): UA = B + UpperTarget Threshold (absolute): TA = B + Threshold Exceptionn (absolute): EAn = B + Exceptionn If (S = EAn) then Result (R) = EAn If (S < TA) then R = LA If (S >= TA) then R = UA |
3 | Relative Whole target | In this behaviourbehavior, all the values within the specified range ( Getting rounding result (R) for the source number (S) must be implemented as follows: For source number (S): B = S rounded down to the closest multiple of V For example if (S = 56789 and V = 1000) then B = 56000 LowerTarget (absolute): LA = B – V + LowerTarget UpperTarget (absolute): UA = B + UpperTarget Threshold (absolute): TA = B + Threshold Exceptionn (absolute): EAn = B + Exceptionn If (S = EAn) then Result (R) = EAn If (S < TA) then R = LA If (S >= TA) then R = UA |
4 | Nearest target | In this behaviourbehavior, Getting rounding result (R) for the source number (S) must be implemented as follows: For source number (S): B = S rounded down to the closest multiple of V For example, if (S = 123 and V = 5) then B = 120 LowerTarget (absolute): LA = B – 1 + LowerTarget UpperTarget (absolute): UA = B – 1 + V + UpperTarget Threshold (absolute): TA = B + Threshold Exceptionn (absolute): EAn = B + Exceptionn If (S = EAn) then Result (R) = EAn If (S < TA) then R = LA If (S >= TA) then R = UA |
Important:
If the result of rounding is a negative number, it must be set to zero, for any rounding behaviourbehaviordefined in the table above.
If either LowerTarget
or UpperTarget
value violates MaxDecimalPlaces
setting for the respective currency, this value must be truncated accordingly. For example, if UpperTarget
is set to 0.999 for USD, it must be truncated to 0.99 before using in any further calculations.
Rounding Rules Samples:
The following samples indicate how rounding X to Y (X → Y) is implemented using the respective settings.
0.25 → 0 3 → 0 1.5 → 1.5 2 → 2 | 22.47 → 21.95 22.48 → 22.99 22.50 → 22.50 33.75 → 33.75 | 2047 → 1995 2048 → 2100 | 122.26 → 124.99 122.25 → 119.99 127.26 → 129.99 121.50 → 121.50 127.50 → 127.50 123 → 123 128 → 128 | 2047 → 1999 2048 → 2100 | |
---|---|---|---|---|---|
From | 0 | 1 | 1000 | 100 | 1000 |
To | 3 | 250 | 10000 | 1000 | 10000 |
Threshold | 3.01 | 0.48 | 48 | 2.26 | 48 |
LowerTarget | 0 | 0.95 | 95 | 0.99 | 0 |
UpperTarget | 0 | 0.99 | 100 | 0.99 | 1 |
RangeBehavior | 1 Absolute | 2 Relative Decimal | 3 Relative Whole | 4 Nearest | 4 Nearest |
TargetBehaviorHelperValue | 100 | 5 | 100 | ||
RoundingExceptions | 1.5 | 0.50 | 1.50 | ||
2 | 0.75 | 2.50 | |||
3 |
RoundingRule
Int64RoundingRuleId
Rule identifier denoting the respective Rounding Rule on the Global‑e side. This value must be further specified when calling SaveProductsList
and SendCart
methods.
stringCurrencyCode
3-char ISO currency code.
stringCountryCode
2-char ISO country code
List<RoundingRange> RoundingRanges
List of decimal ranges and their respective rounding behaviourbehavior. See RoundingRange for more information.
SendAdditionalRequiredDocumentsToMerchantRequest
string OrderId
Global‑e’s order id.
string MerchantOrderId
Order unique identifier on the Merchant’s site returned from a previous call to the SendOrderToMerchant
method for this order.
string CountryCode
2-char ISO country code.
List <OrderDocument> AdditionalRequiredDocuments
Additional documents which are required to ship the order.
SendCartData
string CountryCode
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 the shippingDetails.CountryCode
property denoting the registered user’s country defined below.
string clientIP
(optional)
The end customer’s IP address.
CartCurrencyData
Currency
CartPriceModificationData
PriceModification
(optional for the merchants not supporting browsing integration)
Culture (optional)
List <
ShippingOption
> LocalShippingOptions
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 the ActiveHubDetails
method. If the “globaleintegration_standard” shipping method 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 the SendOrderToMerchant
API method). Therefore, all other shipping methods available for local shipping may be omitted in LocalShippingOptions
.
List<Product> Products
List of Product objects.
string CartToken
The value returned from the previous call to SendCart
for the same client (must be stored in the client session or persistent cookie on the merchant’s side). This parameter is used to support cart updates.
string MerchantCartToken
Cart or session identifier used for the cart on the Merchant’s site, to be returned to the merchant with the order API call.
string MerchantCartHash
Hash optionally generated by the merchant, to be returned to the merchant with the order API call. This hash may be used for additional cart and order validation purposes on the Merchant’s side.
Int64 HubId
Identifier of the Global‑e’s Local Hub previously returned by the ActiveHubDetails
method. If not specified, the default Merchant’s Hub will be used instead.
List<Int64> PaymentInstallments
List of available payment instalmentinstallment amounts.
CartUserDetails UserDetails
All available details of the user including all relevant addresses.
string UrlParameters
List of JSON-serialized KeyValuePairs
that denote parameter values to be specified in the respective Merchant’s RESTFul API action URLs.
For example, to instruct Global‑e to include the “en-AU
” locale in the SendOrderToMerchant call for this cart, urlParameters
should include:
KeyValuePair: [{"Key":"locale", "Value":"en-AU"}]
.
In this example “locale” parameter should be configured for the SendOrderToMerchant URL for this merchant on the Global‑e side.
List<Discount> Discounts
List of Discounts to be applied to the cart. Discounts of any type (“cart”, “shipping”, etc.) may be specified.
CartVATRegistrationData VATRegistration
Holds information required for VAT exemption within the EU.
CartFreeShippingData FreeShipping
Holds information required carts that were awarded free international shipping according to the merchant platform (as opposed to the flat shipping pricing system on the global-e system).
CartVoucherData VoucherData
Holds information for merchant-side vouchers to be applied (includes loyalty vouchers and one-time vouchers).
CartLoyaltyData LoyaltyData
Holds information for merchant-side loyalty points to be applied.
string rateData
Currency data used by Global‑e to verify the currency rate. Return the value received in the used currency rate.
string WebStoreCode
(optional)
Code used on the merchant’s side to identify the web store where the current cart is originating from. This code should be used in case of a multi-store setup on the merchant’s site.
string WebStoreInstanceCode
(optional)
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.
LoyaltyPoints LoyaltyPoints
(optional)
Holds information on the registered user to apply loyalty points on the checkout page.
bool AllowMailsFromMerchant
(optional)
Indicates if the end customer’s consent to receive emails from merchants should be pre-selected in Global‑e checkout.
string CartId
(optional)
A string that represents the merchant order id if it is known already at the point when the user is still in the cart page on the merchant’s store.
string MerchantOrderId
Unique identifier of merchant order ID.
string MerchantInternalOrderId
Unique identifier of merchant internal order ID.
bool IsMoto
(optional - default value: 0) 1 – The customer is a customer support agent and an “Offline order” takes place, 0 – The customer is a regular customer.
SendFinalCartData extends SendCartData
UserDetails ShippingDetails
Shipping details entered by the customer in the checkout form. If CountryCode
is included, it is ignored (a new InitCheckout
call is required if the shipping country is changed)
UserDetails BillingDetails
Billing details entered by the customer in the checkout form
string ShippingMethodId
The ID of the shipping option selected by the customer
bool IsTaxPrePaid
Indicates if the end customer has selected or has been forced to prepay duties & taxes
bool IsSameDayDispatchSelected
Indicates if the user selected an option to dispatch the order on the same day
List<Merchant.CheckoutInfoGiftCard> GiftCards
The collection of GiftCards
that were applied to the cart
FinalCustomerPayments CustomerPayments
The values of total duties, total taxes, total additional fees (like Custom Clearance Fee), shipping price, and total that was shown to the customer on the checkout page
string CheckoutUrl
Checkout URL; it redirects you to the checkout or confirmation page (different URL for each merchant)
MarketplaceData MarketplaceData
Marketplace information received by the API
OrderReplacementData OrderReplacementData
Order replacement information received by the API
CreateSyncOrderData OrderData
Information about the order
OrderCreationSource OrderCreationSource
Source for the order creation process
SendOrderResponseInfo
Merchant.Order Order
Pending payment Global‑e order that was created following the SendOrder
request
string PaymentActionURL
URL where the end customer should be redirected to complete the purchase with the selected alternative (non-card) payment method, or card payment action URL in Global-e secured environment for card payment methods.
ShippingOption
string Carrier
Carrier’s short name
string CarrierName
Carrier’s full name
string CarrierTitle
Carrier’s title
string Code
Shipping method code used to identify the shipping option on the Merchant’s site (to be mapped on the Global‑e side)
string Method
Shipping method name
string MethodTitle
Shipping method title
string MethodDescription
Shipping method description
decimal Price
Shipping price in Merchant’s original currency defined in the originalCurrencyCode
argument of the respective method call (i.e. SendCart
)
ShippingOptionPricesResponse
List<PriceItemInfo> ShippingPrices
List of shipping options with calculated international prices
ShippingOptionResponse
string ShippingOptionId
Unique identifier for the item in the requested shipping options list
DutiesAndTaxesResponse DutiesAndTaxes
Full duties and taxes information according to the specific shipping option price
UpdateOrderDispatchException
string CartItemId
(optional)
Identifier of the cart item on the Merchant’s site. This property may be optionally specified in the SendCart method only so that the same value could be posted back when creating the order on the Merchant’s site with the SendOrderToMerchant
method.
Note
Either CartItemId
or ProductCode
should be specified.
This property is mandatory only if the ProductCode
property has not been specified.
string ProductCode
(optional)
Product unique identifier on the Merchant’s site.
Note
Either CartItemId
or ProductCode
should be specified.
This property is mandatory only if the CartItemId
property has not been specified.
date ExpectedFulfilmentDate
(optional)
Expected date for backordered/preordered/customized item to be fulfilled (in YYYY-MM-DD format).
Int64 Quantity
(optional)
Product quantity that the exception refers to.
Note
The product quantity is required for exception Type 3.
Int64 ExceptionType
One of the following possible values of the ExceptionTypes
enumeration:
ExceptionType | Name | Description |
---|---|---|
1 | Out Of Stock | Out-of-stock items will not be fulfilled. |
2 | Backorder Preorder Customized Item | Backorder/preorder/customized items will be fulfilled. |
3 | Cancellation by request | Cancelled by customer request will not be fulfilled. |
UpdateOrderDispatchRequest
string OrderId
(optional)
Global‑e order unique identifier.
Note
Either OrderID
or MerchantOrderID
should be specified.
This property is mandatory only if the MerchantOrderID
property has not been specified.
string MerchantOrderId
(optional)
Order unique identifier on the Merchant’s site.
Note
Either OrderID
or MerchantOrderID
should be specified.
This property is mandatory only if the OrderID
property has not been specified.
string DeliveryReferenceNumber
(optional)
Merchant’s internal Delivery Reference Number for this order.
bool IsCompleted
Flag to mark orders as “completed” by the merchant. TRUE if order fulfilmentfulfillmentt has been completed and no more products will be shipped. FALSE if order fulfilmentfulfillment has not been completed yet.
List<Parcel> Parcels
List of Parcel objects for this UpdateOrderDispatchRequest
.
Note
Either Parcels or Exceptions should be specified.
This property is mandatory only if the Exceptions property has not been specified.
List<UpdateOrderDispatchException> Exceptions
List of UpdateOrderDispatchException
objects for this the UpdateOrderDispatchRequest
.
Note
Either Parcels or Exceptions should be specified.
This property is mandatory only if the Parcels
property has not been specified.
TrackingDetails TrackingDetails
(optional)
Tracking information at the order level of the parcel in case the merchant does the shipping by itself.
string HubCode
(optional)
Merchant hub code that indicates which hub the parcels are being sent from.
Note
The hubCode
should be mapped to a Global‑e hubId on the Global‑e side.
string ShippingMethodCode
(optional)
Shipping Method Code used for the order instead of the original one.
The order should use WYOL and the input shipping method also be WYOL.
NOTE: The Shipping Method Code should be mapped to a Global‑e Shipping Method on the Global‑e side.
string<shippingAdditionalInformation> ShippingAdditionalInformation
(optional)
Additional information is required for shipment.
Currently, it is used for the ITN number when exporting from the US.
UpdateOrderProductsRequest
string OrderId
Global‑e unique identifier or Merchant unique identifier of the order that requires updating.
List <Product>
Products
The list of products that require updating.
string MetaDataUpdateType
The type of metadata update. Must be set to "Merge
".
UpdateOrderResponse
DutiesAndTaxesResponse DutiesAndTaxes
Full duties and taxes information according to the cart details including the respective shipping option price
UpdateParcelDispatchRequest
string OrderId
Global‑e order unique identifier (previously submitted to the Merchant’s SendOrderToMerchant
method when the order had been created with Global‑e checkout)
List<OrderProduct> Products
List of parcels for this order’s shipment to the Global‑e hub
UpdateRMANumber
string OrderId
string MerchantOrderId
string RMANumber
string MerchantRMANumber
UserDetails
string UserId
(optional)
Internal User identifier on the Merchant site
string UserIdNumber
(optional)
User’s personal ID document number
UserIdNumberType UserIdNumberType
(optional)
User’s personal ID document type (e.g. Passport, ID card, etc.)
string FirstName
(optional)
First name
string LastName
(optional)
Last name
string FirstNameInLocalCulture
(optional)
First name in local culture Ex: Kana Japanese dialect
string LastNameInLocalCulture
(optional)
Last name in local culture Ex: Kana Japanese dialect
string MiddleName
(optional)
Middle name
string Salutation
(optional)
Salutation or title (e.g. Dr., Mr., etc.)
string Phone1
(optional)
Phone #1
string Phone2
(optional)
Phone #2
string Fax
(optional)
Fax
string Email
(optional)
E-mail address
string Company
(optional)
Company name
string Address1
(optional)
Address line 1
string Address2
(optional)
Address line 2
string City
(optional)
City name
string StateOrProvice
(optional)
State or province name
string StateCode
(optional)
State or province ISO code such as AZ for Arizona (if applicable)
string Zip
(optional)
Zip or postal code
string CountryCode
(optional)
2-char ISO country code
string CountryName
(optional)
Country name
UserIdNumberType
string UserIdNumberTypeCode
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)
string Name
Identification document type name
ValidateGiftCardRequest
string MerchantGUID
Merchant unique identifier
string ShippingCountryCode
Code of country selected on checkout
Dictionary<string,string> CardFields
Key value pairs of each field defined in the configuration
string MerchantCartToken
Identifier of the cart on the Merchant’s site originally specified in the merchantCartToken
argument for the respective SendCart
call
ValidateGiftCardResponse
bool IsValid
The flag which approves that user entered the correct card data
decimal Balance
The available amount of money on a gift card
string CurrencyCode
Code of card currency
bool IsGlobalEGiftCard
If the card was bought from Global‑e should be true
string ErrorCode
Code of the error
string ErrorText
Error message
VATCategory
string VATCategoryCode
Code used to identify the VAT category on the Merchant’s site (to be mapped on the Global‑e side)
string Name
VAT Category name
VATCategoryCountry
string VATCategoryCode
Code used to identify the VAT category on the Merchant’s site (to be mapped on the Global‑e side)
string CountryCode
2-char ISO code of the shipping country
VATRateType VATRateType
(optional)
Product VAT rate type or class to be used for the products related to this VAT Category in this shipping country, unless defined on ProductCountry
level for the respective product. If VATRateType
is not defined either on ProductCountry
or on VATCategoryCountry
levels, the respective country’s DefaultVATRateType
must be used if applicable, according to the UseCountryVAT
value for this country. Otherwise, the VAT rate defined for the respective products on the merchant’s site must be used.
VATRateType
string VATRateTypeCode
VAT rate type (or class) code on the Merchant’s site (to be mapped on the Global-e side)
string Name
(optional)
VAT rate type name
decimal Rate
VAT rate decimal value
VoidParcelRequest
string OrderId
(optional)
Global‑e order unique identifier
NOTE: Specify one of the following: the OrderID
, MerchantOrderID
, or DeliveryReferenceNumber
.
This property is mandatory only if MerchantOrderID
and DeliveryReferenceNumber
properties have not been specified.
string MerchantOrderId
(optional)
Order unique identifier on the Merchant’s site
NOTE: Either the OrderID
, the MerchantOrderID
or DeliveryReferenceNumber
should be specified/
This property is mandatory only if OrderID
and DeliveryReferenceNumber
properties have not been specified
string MerchantOrderId
(optional)
Merchant’s internal Delivery Reference Number for this order
NOTE: Either the OrderID
or MerchantOrderID
or DeliveryReferenceNumber
should be specified.
This property is mandatory only if MerchantOrderID
and OrderID
properties have not been specified/
string ParcelCode
The code used to identify the Parcel in an order on the Merchant’s site
VoidParselResponse
bool IsSuccess
Return true if the parcel was voided successfully
list <ParcelError class>
A list of the specified errors occurs while the request proceeds
WebStoreCodes
string WebStoreCode
The code of the merchant web store
string WebStoreInstanceCode
The code of the instance of the web store