Skip to main content

Documentation Portal

Merchant Implementation

To support Mixed Orders functionality, merchants are required to implement the following on their side:

Hub Identification

Merchants must provide and include a Hub ID (Hub Code) as part of the integration.

  • The Hub ID is used to identify the fulfillment hub associated with each shipment.

  • It must be passed in relevant API calls (for example, shipping document retrieval and order dispatch).

  • The correct mapping between merchant systems and hub identifiers must be maintained to ensure accurate processing.

Parcel-Level Reconciliation

Merchants must support parcel-level reconciliation in their accounting systems and reports.

  • Financial reconciliation (for example, duties, taxes, and shipping costs) is calculated and reported at the parcel level rather than at the order level.

  • Merchant accounting systems must be able to ingest and process reconciliation data accordingly.

Impact on Merchant Systems

These requirements may require updates to the merchant’s internal systems:

  • Accounting and finance systems

  • Reporting and reconciliation workflows

  • Integration logic for API communication

  • Complete hub and warehouses mapping to ensure correct logistic flow

Merchants should ensure their systems are capable of handling these changes prior to enabling the feature.

Reconciliation Behavior

When the feature is not enabled, reconciliation will continue to be performed at the order level. When the feature is enabled, reconciliation is expected to be performed at the parcel level.

Technical Implementation

Retrieval of Global-e shipping documentation is done by using HubCode in API calls:

  • GetShippingDocument (GSD)

  • DispatchOrder (DO)