Skip to main content

Documentation Portal

Get Order Details

When using the GetOrdersDetails API to produce shipping documentation, ensure the following attributes receive the relevant information:

Information

Attributes

Exporter details

(relevant EIN / EORI / VAT #)

Merchant.Order.ExporterDetails

Importer

(relevant EIN / EORI / VAT #)

Merchant.Order.ImporterDetails

Shipper name/address

Must include a “Global‑e” mention as the exporter

Currency

Merchant.Order.InternationalDetails.CurrencyCode

Private import mention

Should include a “Private importer” mention

Incoterm (DAP/DDP)

Merchant.Order.DutiesGuaranteed

Products

<List> Merchant.Order.Products

-- COO

N/A – taken from merchant systems

-- HS Code

N/A – taken from merchant systems

-- Price excluding D&T

Merchant.Order.Products[i].InternationalDiscountedPriceForCustoms

Shipping Cost

Merchant.Order.InternationalDetails.DeclarativeShippingPriceInCustomerCurrency

If the value is 0 (free shipping), we recommend using a non-zero low value (may attract duties and taxes)

By default, if the customer benefits from Free Shipping, 5 USD is added instead of declarative purposes – this can be disabled by the Global‑e team.

Destination Tax calculation rule

Merchant.Order.TaxCalculationRule Indicates if destination Duties & Tax calculation is based on Products, Freight, and Duties

Possible values are accordingly: FOB, CIF, CIFD

Total shipment declarative value for customs

Merchant.Order.TotalValueForCustoms

Calculated according to the two sub-points above to include Products, Freight, and Duties

Prerequisites

The merchant OMS or WhMS should have knowledge of the following information and allow, either directly or through an escalation process, to:

  • Have the full list of items in the order

  • Enable selection of items to be dispatched

  • if applicable, enable the cancellation of line items

  • if applicable, enable the declaration of items as back-ordered

After performing the effective pick&pack and required actions in the OMS/WhMS, the following integration can be used to process the orders prior to dispatch.

Schedule

The report should be sent once the pick and pack in the merchant warehouse has been completed for the day and before the orders arrive at the Global-e hub or before the orders are prepared for international shipping by merchants fulfilling from their own warehouse.