> ## Documentation Index
> Fetch the complete documentation index at: https://nce-docs.bglobale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Field Mappings

The API method return a list of order details. In the context of producing shipping documentation, the below fields and associated logic must be considered:

| **Exporter details**                             | Should remain the same as today, i.e. the brand, 3PL, or other relevant party                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Global-e local tax registration**              | In specific destinations, such as Norway, the UK, the EU (Cross-border), Switzerland, Australia, New Zealand, Singapore, and Malaysia (the exact list of applicable countries will be confirmed during the project), Global-e is responsible for remitting taxes to local authorities.<br />For orders below 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 local authorities.<br />**Merchant.Order.ExporterDetails.LocalRegistrationClearance** *– A Boolean value indicating whether Global-e will remit the tax locally for the order.*<br />If TRUE, the following fields must be considered:<br />**Merchant.Order.ExporterDetails.DestinationRegistrationNumber –** *GE local registration registration number in destination country*<br />**Merchant.Order.ExporterDetails.IOSSNumber –** *for shipments to the EU*<br />️ **Important Note:**<br />Global-e’s IOSS number **must NOT** be 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 for shipments to Switzerland.***- Merchant.Order.ImporterDetails.Company** –*Global-e importer entity name for 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**                                     | If **shipping country** \*\*= “Switzerland”\*\*Shipment to be cleared under Global-e’s ZAZ account / "Terms of Delivery" to be decided with carrier️ **Important Note:** Only the taxes applicable to the clearance into Switzerland should be billed against Global-e’s ZAZ account. Any other fee charged by the carrier in relation to the clearance should be billed to the Shipper of Record (brand/3PL)**Merchant.Order.InternationalDetails.DutiesGuaranteed :** trueShipment to be cleared as DDP or equivalent incoterm, to ensure no additional Duties and/or Taxes are requested to be paid at delivery by the customer.If **"Merchant.Order.InternationalDetails.DutiesGuaranteed"** : false and **"Merchant.Order.ExporterDetails.LocalRegistrationClearance”** : falseShipment to be cleared as DAP or equivalent incoterm, with applicable Duties and/or Taxes paid at delivery by the customer.If **"Merchant.Order.InternationalDetails.DutiesGuaranteed"** : false and **"Merchant.Order.ExporterDetails.LocalRegistrationClearance”** : trueGlobal-e’s local tax registration to be provided to the carrier and presented on the clearance documents, considering that taxes will be filled by Global-e in the destination country (as mentioned in section “Global-e local tax registration number”)Shipment booking to be done following carrier requirements (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. Possible values:**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 calculation rules defined per country in Global-e system. Clearance documents to be aligned accordingly.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Total shipment declarative value for customs** | **Merchant.Order.TotalValueForCustoms**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
