Skip to main content
POST
Edit order
Applies to all platforms except Shopify. See the Edit Order integration guide for prerequisites, constraints, and examples.

Body

application/json

Details of changes to the order, including products to add to or remove from the order.

OrderId
string
required

Global-e order ID.

NewProducts
Product · object[]
required

List providing information about the products.

SubsidizeHigherValue
integer
required

In a quote request: set to 0 to receive the expected order values with no merchant subsidy discount applied in case of higher value; set to 1 to receive the expected order values including the merchant subsidy for the cost difference. In an edit request: set to 0 to avoid subsidizing the cost difference in case of a higher value (if the new order value is higher and the value is 0/null/empty, the editing request will fail); set to 1 to subsidize the additional cost between the original order value prior to the update and the updated value.

RemovedProducts
RemovedProduct · object[]

List providing information about removed products.

Response

The updated Merchant.Order object.

MerchantGUID
string

Unique identifier of the Merchant on Global-e.

OrderId
string

Global-e order unique identifier.

MerchantOrderId
string

Optional. Order unique identifier on the Merchant's site returned from a previous call to SendOrderToMerchant method for this order.

CartId
string

Optional. Identifier of the cart on the Merchant's site originally specified in merchantCartToken argument for the SendCart method for the cart converted to this order on Global-e.

CartHash
string

Optional. Cart hash originally specified in merchantCartHash argument for SendCart method for the cart converted to this order on Global-e.

StatusCode
string

Code denoting the order status on the Merchant site (to be mapped on the Global-e side).

CurrencyCode
string

3-char ISO currency code for the order being posted. By default, this is set to the original Merchant's currency.

PriceCoefficientRate
number

CountryCoefficient rate is applied to the prices in this order.

RoundingRate
number

The average conversion rate applied to the prices paid by the 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.

UserId
string

Optional. Internal User identifier on the Merchant's site originally specified in shippingDetails.UserId argument for the SendCart method for the cart converted to this order on Global-e.

ShippingMethodCode
string

Optional. Code denoting the local shipping method selected from the list of available shipping options provided in shippingOptionsList argument for SendCart method for the cart converted to this order on Global-e.

ClearCart
boolean

Indicates if the end customer's cart must be cleared before this method finishes execution on the Merchant's site.

AllowMailsFromMerchant
boolean

Indicates if the end customer has opted for Global-e checkout to receive emails from the Merchant.

LoyaltyPointsSpent
number

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 (on the user's My Account page).

LoyaltyPointsEarned
number

Optional. The number of loyalty points to be earned for this purchase by the 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.

LoyaltyCode
string

Optional. The loyalty code applicable to the Merchant's site is entered by the customer in Global-e checkout.

SameDayDispatch
boolean

Optional. Indicates if the customer has requested a "Same Day Dispatch" in the Global-e checkout.

SameDayDispatchCost
number

Optional. Cost of the "Same Day Dispatch" option selected by the end customer on Global-e checkout, in the original Merchant's currency.

DoNotChargeVAT
boolean

Optional. Indicates if the end customer has not 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.

IsFreeShipping
boolean

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.

FreeShippingCouponCode
string

Optional. Merchant's free shipping coupon code 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.

ShipToStoreCode
string

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).

CustomerComments
string

Optional. Comments text entered by the end customer in Global-e checkout.

IsSplitOrder
boolean

Optional. Indicates if the order should be handled as split order (i.e. without consolidation).

OTVoucherCode
string

Optional. One-time voucher code used to place the order.

OTCurrencyCode
string

Optional. Currency of the one-time voucher code used to place the order.

OTVoucherAmount
number

Optional. Amount taken off the voucher when applicable.

WebStoreCode
string

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.

Products
Merchant.Product · object[]

The list of products being purchased.

Discounts
Merchant.Discount · object[]

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.

Markups
Merchant.Discount · object[]

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 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.

Customer
Merchant.Customer · object

The paying customer's preferences (Global-e acts as a paying customer).

PrimaryBilling
Merchant.CustomerDetails · object

Primary customer's billing details. Primary customer denotes the paying (Global-e) customer unless Customer.IsEndCustomerPrimary is FALSE. Note that all string attributes of customer details are indicated in the URL-encoded form. Therefore, if the Customer.IsEndCustomerPrimary is TRUE then all string attributes in PrimaryBilling are URL encoded.

PrimaryShipping
Merchant.CustomerDetails · object

Primary customer's shipping details. Primary customer denotes the paying (Global-e) customer unless Customer.IsEndCustomerPrimary is FALSE. Note that all string attributes of customer's details are indicated in URL encoded form. Therefore, if Customer.IsEndCustomerPrimary is TRUE then all string attributes in PrimaryShipping are URL encoded.

PaymentDetails
Merchant.PaymentDetails · object

The paying customer's payment details.

SecondaryBilling
Merchant.CustomerDetails · object

Secondary customer's billing details. Secondary customer denotes the end customer who has placed the order with Global-e checkout unless Customer.IsEndCustomerPrimary is FALSE. Note that all string attributes of customer's details are indicated in URL encoded form. Therefore, if Customer.IsEndCustomerPrimary is FALSE then all string attributes in SecondaryBilling are URL encoded.

SecondaryShipping
Merchant.CustomerDetails · object

Secondary customer's shipping details. Secondary customer denotes the end customer who has placed the order with Global-e checkout unless Customer.IsEndCustomerPrimary is FALSE. Note that all string attributes of customer's details are indicated in URL encoded form. Therefore, if Customer.IsEndCustomerPrimary is FALSE then all string attributes in SecondaryShipping are URL encoded.

InternationalDetails
Merchant.InternationalDetails · object

Optional. Details referring to the customer's order placed on the Global-e side. These details are applicable only to the Merchants dealing with international customers' support themselves.

DiscountedShippingPrice
number

The shipping price paid by the customer is converted to the merchant currency. Total Shipping price reducing Order Discounts (InternationalDetails.DiscountedShippingPrice price converted to the merchant currency).

PrePayOffered
boolean

Indicates if the prepayment option for duties and taxes was offered to the customer.

IsReplacementOrder
boolean

Indicates if the order is a replacement.

OriginalOrder
Merchant.OriginalOrder · object

Optional. Details referring to the original order if the current order is a replacement.

DateCreated
string

Optional, returned by GetOrdersDetails API only. Order creation date and time.

CurrencyName
string

Optional, returned by GetOrdersDetails API only. Customer currency name.

Parcels
Merchant.Parcel · object[]

Optional, returned by GetOrdersDetails API only. The list of parcels created for the order.

TotalDutiesAndTaxesPrice
number

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.

USSalesTax
number

Sales tax value for USA in the Merchant currency. This value is included in TotalDutiesAndTaxesPrice.

ExporterDetails
Merchant.ExporterDetails · object

Exporter details (relevant EIN / EORI / VAT

ImporterDetails
Merchant.ImporterDetails · object

Importer details (relevant EIN / EORI / VAT

DeclarativeShippingPriceInCustomerCurrency
number

Shipping cost used for declarative purposes. If the value is 0 (free shipping), a non-zero low value is recommended (may attract duties and taxes). By default, if the customer benefits from Free Shipping, 5 USD is added instead for declarative purposes — this can be disabled by the Global-e team.

TaxCalculationRule
enum<string>

Indicates if destination Duties & Tax calculation is based on Products, Freight, and Duties. Possible values are accordingly: FOB, CIF, CIFD.

Available options:
FOB,
CIF,
CIFD
TotalValueForCustoms
number

Total shipment declarative value for customs. Calculated to include Products, Freight, and Duties.