Platform Mappings - Global-e Docs

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.

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.

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.

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.

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.

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

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