Implementation of the Solution
Order API
API Documentation
Fields mappings The API method return a list of order details. Inthecontextof producing shipping documentation, the below fieldsand associated logic mustbeconsidered:| Exporterdetails | Global-e/Merchant |
|---|---|
| Global-elocalregistrationdetails | In specific destinations, such as Norway, the UK, the EU (Cross-border), Switzerland, Australia, New Zealand, Singapore, and Malaysia (the exact list ofapplicablecountrieswillbe confirmed during the project),Global-e is responsible for remitting taxes to local authorities. For ordersbelow the threshold, Global-e’s local tax registration must be included on the commercial invoice and declared to the carrier, as Global-e will handle the direct filing of applicable taxes with the respective localauthorities. Merchant.Order.ExporterDetails.LocalRegistrationClearance– A Boolean value indicating whetherGlobal-e will remit the tax locallyforthe order. IfTRUE, the following fieldsmustbe considered: Merchant.Order.ExporterDetails.DestinationRegistrationNumber–GElocal registrationregistrationnumberin destinationcountry Merchant.ExporterDetails.EORINumber–GEEntity EORI Merchant.Order.ExporterDetails.IOSSNumber–for shipments to the EU ⚠️ImportantNote: 🚨Global-e’s IOSS numbermust NOTbe displayed on the Commercial Invoices🚨 |
| Importer and import type mention | If(Merchant.ImporterDetails.ImporterType= 0)“Private Import Mention” for B2C shipment-Merchant.Order.ImportDetails.CustomerTaxId-Customer Tax number provided at checkout as required for clearance into certain markets (eg.Brazil, Turkey)If(Merchant.ImporterDetails.ImporterType= 1)Importer details should have the Mention “Business Importer”–only applicable forshipments to Switzerland.-Merchant.Order.ImporterDetails.Company–Global-e importer entitynamefor relevant markets (e.g.Switzerland)-Merchant.Order.ImporterDetails.VATRegistrationNumber-Global-e importer entity registration number for relevant markets (e.g. Switzerland)-Merchant.Order.ImporterDetails.Address-Global-e Importer entity |
| Shipper name/address | Should remain the same as today, e.g. the brand, 3PL, or other relevant party |
| Currency | Merchant.Order.InternationalDetails.CurrencyCode |
| Incoterm | Ifshipping country=“Switzerland”Shipmentto be clearedunder Global-e’sZAZ account / “Terms of Delivery” to bedecidedwith carrier⚠️Important Note:Onlythe taxes applicableto the clearance into Switzerland should be billed against Global-e’s ZAZ account.Any other fee charged by the carrier in relation to theclearance should be billed to the Shipper of Record (brand/3PL)Merchant.Order.InternationalDetails.DutiesGuaranteed:trueShipmentto be clearedas DDPor equivalent incoterm, to ensureno additional Duties and/or Taxesare requestedto be paid at delivery by the customer.If”Merchant.Order.InternationalDetails.DutiesGuaranteed”:falseand”Merchant.Order.ExporterDetails.LocalRegistrationClearance”:falseShipmentto be clearedasDAP or equivalent incoterm, with applicable Duties and/or Taxes paid at delivery by the customer.If”Merchant.Order.InternationalDetails.DutiesGuaranteed”:falseand”Merchant.Order.ExporterDetails.LocalRegistrationClearance”:trueGlobal-e’s local tax registration to be providedto the carrier and presented on the clearance documents, consideringthat taxes will be filledby Global-ein the destination country(as mentioned in section “Global-e local tax registration number”)Shipment booking to be donefollowing carrierrequirements(process to be aligned by the brand with carrier) |
| Products | <List>Merchant.Order.Products |
| · COO | n/a – to be taken from own systems |
| · HS Code | n/a – to be taken from own systems |
| Price exclusive of D&T | Merchant.Order.Products[i].InternationalDiscountedPriceForCustoms |
| Shipping Cost | Merchant.Order.InternationalDetails.DiscountedShippingPrice |
| Destination Tax calculation rule | Merchant.Order.TaxCalculationRule-determines how duties and taxes are calculated for an order.Possiblevalues:CIF(Cost, Insurance, and Freight):This method calculates duties and taxes based on the total cost of goods, including insurance and freight charges.FOB(Free on Board):This method calculates duties and taxes based only on the value of the goodsTax calculationrulesdefined per country in Global-e system. Clearancedocuments tobe alignedaccordingly. |
| Total shipment declarative value for customs | Merchant.Order.TotalValueForCustoms |