Skip to main content

​
EAD — Export From Germany

An EAD (Export Accompanying Document) is required by German Customs for orders with a customs declarative value above 1,000 EURO shipped from Germany to a country outside the European Union. Global-e can provide this document to Merchants who are doing the shipping themselves. This functionality is not yet supported for Merchants who are using Global-e for shipping. When an order is created, Global-e flags any additional shipping documents required for merchants that are shipping the order themselves in AdditionalRequiredDocuments on the SendOrderToMerchant (Global-e to Merchant) notification. In that case, the merchant should delay the fulfillment until the documents are ready and provided to the merchant in the SendAdditionalRequiredDocumentsToMerchant webhook. The SendAdditionalRequiredDocumentsToMerchant (Global-e to Merchant) notification posts the required shipping documents of the order to the Merchant’s site. This notification informs the Merchant that the documents previously listed in the SendOrderToMerchant notification (under AdditionalRequiredDocuments), initiated by calling CreateAdditionalRequiredDocuments, are ready. The document’s content is included in this notification.
These APIs are part of Global-e’s extensions and plug-ins. Merchants do not need to implement them unless a custom integration is required.

​
Procedure for receiving an EAD

  1. When an order is created, Global-e sends an indication that an EAD is required in the SendOrderToMerchant (Global-e to Merchant) notification (see the AdditionalRequiredDocuments section). Do not start fulfilment until the document is ready.
  2. Global-e notifies you when the EAD is ready by sending the SendAdditionalRequiredDocumentsToMerchant (Global-e to Merchant) endpoint and including the document itself (base64 encoded) in the notification. Upon receiving this notification, you can do the fulfilment with this document included in the order shipping documents.

​
Reference

Send Order To Merchant — full request & response

Parameters, schema, examples for POST (merchant-hosted) /order-update-create-url.

Send Additional Required Documents To Merchant — full request & response

Parameters, schema, examples for POST (merchant-hosted) /send-additional-required-documents-url.

​
Use Cases

​
EAD indication on the order (SendOrderToMerchant)

The EAD indication is carried in the AdditionalRequiredDocuments array of the order payload (DocumentTypeCode 11 = EAD):

​
Send additional required documents (SendAdditionalRequiredDocumentsToMerchant)

Global-e posts the ready document(s) to the merchant-hosted endpoint. The document file content is base64 encoded in DocumentData; DocumentTypeCode 11 denotes an EAD.
Some values are encoded and require the merchant to decode them, for example URLs, addresses, emails, and phone numbers.

​
Document type codes

DocumentTypeCode can be one of the following values: