Shipping With Non Global-e-Carriers
Overview
This guide is designed for merchants using their own carrier accounts and integration to ship Global-e orders. It provides the essential guidelines for creating the necessary clearance documents, including shipping labels and commercial invoices.
Implementation of the Solution
GetOrdersDetails API Workflow
API and Environment Details
API Documentation
For detailed API specifications, refer to GetOrdersDetails.
Global-e Environments
Note
Consult your Global-e project team to determine the appropriate environments for your integration.
Environment | URL Endpoing |
|---|---|
INT (Integration) | |
STG (Staging) | |
PROD (Production) |
Field Mappings
The API method returns a list of order details. In the context of producing shipping documentation, the following 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. 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.
API Field | Description |
|---|---|
Merchant.Order.ExporterDetails.LocalRegistrationClearance | Boolean value indicating whether Global-e will remit the tax locally for the order. If TRUE, the following fields must be considered. |
Merchant.Order.ExporterDetails.DestinationRegistrationNumber | GE local registration number in destination country. |
Merchant.ExporterDetails.EORINumber | GE Entity EORI number. |
Merchant.Order.ExporterDetails.IOSSNumber | For shipments to the EU. |
Important
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" applies for B2C shipments:
Merchant.Order.ImportDetails.CustomerTaxId – Customer Tax number provided at checkout, as required for clearance into certain markets (e.g. 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.
Merchant.Order.ImporterDetails.Address – Global-e importer entity address.
The Shipper Name and Address should remain the same as today, e.g. the brand, 3PL, or other relevant party. The currency is Merchant.Order.InternationalDetails.CurrencyCode.
The following shows the incoterm logic:
Condition | Action |
|---|---|
Shipping country = Switzerland | Shipment to be cleared under Global-e’s ZAZ account / "Terms of Delivery" to be decided with carrier. |
Merchant.Order.InternationalDetails.DutiesGuaranteed = true | Shipment 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. |
DutiesGuaranteed = false AND LocalRegistrationClearance = false | Shipment to be cleared as DAP or equivalent incoterm, with applicable Duties and/or Taxes paid at delivery by the customer. |
DutiesGuaranteed = false AND LocalRegistrationClearance = true | Global-e’s local tax registration to be provided to the carrier and presented on the clearance documents, considering that taxes will be filed by Global-e in the destination country. Shipment booking to be done following carrier requirements (process to be aligned by the brand with carrier). |
Warning
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).
Products
Field | Source |
|---|---|
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 (CIF or FOB) |
Total shipment declarative value for customs | Merchant.Order.TotalValueForCustoms |
Tax calculation rule definitions:
CIF (Cost, Insurance, and Freight): duties and taxes are calculated based on the total cost of goods, including insurance and freight charges.
FOB (Free on Board): duties and taxes are calculated based only on the value of the goods.
Tax calculation rules are defined per country in the Global-e system. Clearance documents must be aligned accordingly.
Platform Mapping
SFCC Mapping
Exporter details
Should remain the same as today, e.g. the brand, third party logistics (3PL), or other relevant party.
Global-e Local registration details
In specific destinations (Norway, the UK, the EU (Cross-border), Switzerland, Australia, New Zealand, Singapore, and Malaysia – exact list confirmed during the project), Global-e is responsible for remitting taxes to local authorities. For orders below the threshold, Global-e’s local tax registration must be included on the commercial invoice and declared to the carrier. The relevant details for each destination will be provided separately to allow them to be stored in the relevant system as part of the integration.
Warning
Global-e’s IOSS number must NOT be displayed on the Commercial Invoices.
To determine when Global-e local registration details need to be declared, use:
geLocalRegistrationClearance – A Boolean value indicating whether the order is tax collected.
Importer and import type mention
If shipping country ≠ Switzerland → "Private Import Mention" for B2C shipment; geCustomerTaxId – Customer Tax number provided at checkout (e.g. Brazil, Turkey).
Else → importer details should have the mention "Business Importer". Importer details for Switzerland will be communicated in a separate file.
Shipper name / address
Should remain the same as today, i.e. the brand, 3PL, or other relevant party.
Currency
geCustomerCurrencyCode
Incoterm logic
Condition | Action |
|---|---|
Shipping country = Switzerland | Shipment cleared under Global-e’s ZAZ account / "Terms of Delivery" to be decided with carrier. |
geDutiesGuaranteed = true | Shipment cleared as DDP or equivalent incoterm — no additional D&T paid at delivery by customer. |
geDutiesGuaranteed = false AND geLocalRegistrationClearance = false | Shipment cleared as DAP or equivalent incoterm — applicable D&T paid at delivery by customer. |
geDutiesGuaranteed = false AND geLocalRegistrationClearance = true | Global-e’s local tax registration provided to carrier and presented on clearance documents; taxes filed by Global-e in destination country. Shipment booking done per carrier requirements. |
Warning
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 should be billed to the Shipper of Record (brand / 3PL).
Products
Field | Source |
|---|---|
Source | <product-lineitem> data from SFCC order record |
COO | N/A — taken from own systems |
HS Code | N/A — taken from own systems |
Price exclusive of D&T | geInternationalDiscountedPriceForCustoms |
Shipping Cost | geTotalDiscountedShippingPrice |
Destination Tax calculation rule | geTaxCalculationRule (CIF or FOB) |
Total shipment declarative value for customs | geTotalValueForCustoms |
Shopify Mapping
For brands / third party logistics (3PLs) relying on Shopify data to create the shipping documents related to Global-e orders, most of the additional information required is made available through the Shopify note_attributes, as detailed below.
Warning
While for standard orders the required note_attributes are added prior to the Shopify order status being updated to PAID (typically the trigger for export), for orders where no payment is taken (e.g. influencer orders, replacements) or those paid via Gift Cards, the additional data will only be added after the order is marked as PAID, requiring specific logic to be built as part of the order export process.
Exporter details
Should remain the same as today, i.e. the brand, 3PL, or other relevant party.
Global-e Local registration details
Same destination scope as above. Global-e’s local tax registration must be included on the commercial invoice and declared to the carrier for orders below threshold.
Warning
Global-e’s IOSS number must NOT be displayed on the Commercial Invoices.
To determine when Global-e local registration details need to be declared, use:
order.note_attributes [LocalRegistrationClearance] – Boolean value indicating whether the order is tax collected.
Importer and import type mention
If shipping country ≠ Switzerland → "Private Import Mention" for B2C shipment.
Else → "Business Importer". Importer details for Switzerland communicated in a separate file.
Shipper name / address
Should remain the same as today, i.e. the brand, 3PL, or other relevant party.
Currency
order.presentment_currency
Incoterm logic
Condition | Action |
|---|---|
Shipping country = Switzerland | Cleared under Global-e’s ZAZ account / "Terms of Delivery" to be decided with carrier. |
order.note_attributes [DutiesPrePaid] = true | Cleared as DDP or equivalent incoterm. |
DutiesPrePaid = false AND LocalRegistrationClearance = false | Cleared as DAP or equivalent incoterm. |
DutiesPrePaid = false AND LocalRegistrationClearance = true | Global-e local tax registration provided to carrier; taxes filed by Global-e in destination country. |
Products
Field | Source |
|---|---|
Source | order.line_items |
COO | n/a — taken from own systems |
HS Code | n/a — taken from own systems |
Price exclusive of D&T | order.note_attributes [InternationalOrderProductsForCustoms] |
Shipping Cost | order.note_attributes [DiscountedShippingPrice] |
Destination Tax calculation rule | order.note_attributes [TaxCalculationRule] (CIF or FOB) |
Total shipment declarative value for customs | order.note_attributes [TotalValueForCustoms] |
GEM Mapping
Exporter details
Should remain the same as today, i.e. the brand, third party logistics, or other relevant party.
Global-e Local registration details
Same destination scope as the API and other platform mappings. Global-e’s local tax registration must be included on the commercial invoice and declared to the carrier for orders below the applicable threshold.
Warning
Global-e’s IOSS number must NOT be displayed on the Commercial Invoices.
To determine when Global-e local registration details need to be declared, use:
Merchant.Order.ExporterDetails.LocalRegistrationClearance – Boolean value indicating whether the order is tax collected.
Importer and import type mention
If Merchant.ImporterDetails.ImporterType = 0 → "Private Import Mention" for B2C shipment; Merchant.Order.ImportDetails.CustomerTaxId.
If Merchant.ImporterDetails.ImporterType = 1 → "Business Importer". Importer details for Switzerland communicated in a separate file.
Shipper name / address
Should remain the same as today, i.e. the brand, 3PL, or other relevant party.
Currency
Merchant.Order.InternationalDetails.CurrencyCode
Incoterm logic
Condition | Action |
|---|---|
Shipping country = Switzerland | Cleared under Global-e’s ZAZ account / "Terms of Delivery" to be decided with carrier. |
Merchant.Order.InternationalDetails.DutiesGuaranteed = true | Cleared as DDP or equivalent incoterm. |
DutiesGuaranteed = false AND LocalRegistrationClearance = false | Cleared as DAP or equivalent incoterm. |
DutiesGuaranteed = false AND LocalRegistrationClearance = true | Global-e local tax registration provided to carrier and presented on clearance documents; taxes filed by Global-e in destination country. |
Products
Warning
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 / Third Party Logistics).
Field | Source |
|---|---|
Source | <List> Merchant.Order.Products |
COO | N/A — taken from own systems |
HS Code | N/A — 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 (CIF or FOB) |
Total shipment declarative value for customs | Merchant.Order.TotalValueForCustoms |
API & Environment Details
API Documentation
️ For detailed API specifications, refer to GetOrdersDetails.
Global-e Environments
Note
Consult your Global-e project team to determine the appropriate environments for your integration.
Environment | URL Endpoint |
|---|---|
INT (Integration) | https://connect.bglobale.com/ |
STG (Staging) | https://connect2.bglobale.com/ |
PROD (Production) | https://api.global-e.com/ |