Relevante Schritte für die Anbindung an die exporto-API

Nachfolgend werden die erforderlichen Schritte ausführlich beschrieben, um den Transport und ggf. die Zollabfertigung von Sendungen "mit" oder "ohne" einer Übermittlung eines Tagesabschluss zu ermöglichen. Sie dient als zusätzliche Information für die effektive Nutzung der exporto-API in Ihrem Integrations- und Onboardingsprozess. 

Die ausführliche technische API-Dokumentation finden Sie  zusätzlich in der Swagger-Doku auf https://api.exporto.de/v1/docs 

Generell: Schaubild der Datenpunkte und Datenflüsse

Über die exporto-API ist es zwingend notwendig alle relevanten Informationen für Zollanmeldungen zu übermitteln. Dafür werden drei wichtige Endpunkte verwendet: "Article" , "Order" und - falls mit Ihnen vereinbart - "Tour".
 

(1) Article Data

Darüber empfängt exporto relevante Informationen zum Artikelstamm mit Artikelnamen, Artikelbeschreibung, sowie weitere hilfreiche Artikelinfos.
In der Regel erfolgt zunächst ein Upload des vollständigen Artikelstamms, der bei Bedarf aktualisiert wird.
 

(2) & (3) Order Data

Erhält Details zu Bestellungen, einschließlich Adressdaten, Sendungsnummer, Bestellinhalt und Versandgewicht. Zusätzlich: 

• "foreignOutboundTrackingId" = Sendungsnummer vom Label-Endpunkt oder von der direkter Carrier-Integration für die Hinsendung.
• "foreignInboundTrackingId" = Tracking-ID für Rücksendung (Retoure) falls relevant.
Entsprechende Artikel müssen zuvor über den Artikel-Endpunkt registriert werden.

(4)  Relevanter Endpunkt für die Labelerstellung

Label: Der Label-Endpunkt ermöglicht den Abruf von Last-Mile-Carrier-Labels über exporto. Wenn Sie bereits über eine bestehende Carrier-Integration für Ihren bevorzugten Last-Mile-Carrier verfügen, wenden Sie sich bitte an Ihren Exporto-Onboarding-Manager, um die Kompatibilität zu ermitteln.

• Die Antwort enthält in der Regel ein PDF-Label,
  base64-codiert, und ein separates
  TrackingCode Feld.
• shipmentMethodId: Für jedes Carrier-Product werden unterschiedliche shipmentMethodIds verwendet, die von exporto bereitgestellt werden.
   

(5) Tour-Data

Falls mit Ihrem Unternehmen im Onboarding- & technischen Integrationsprozess die Übermittlung eines Tagesabschlusses (Tour Data) explizit vereinbart wurde, ist eine Datenübertragung über diesen Endpunkt relevant.

Die Datenübertragung erfordert hierbei: 

• eine umfassende und vollständige Liste alles shipmentIDs oder foreignOutboundTrackingIds für die Abholung. Die Liste muss vollständig sein, um eine korrekte Zollanmeldung zu gewährleisten.