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 |