Retrieve-API zur Versandvorabmitteilung (ASN)

Test-Endpunkt:
https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/test
https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/499999999/test

Produktionsendpunkt:
https://transact.ti.com/v2/store/orders/{Order Number}/advanced-shipment-notices/
https://transact.ti.com/v2/store/orders/{Order Number}/advanced-shipment-notices/{Waybill Number}

Nachdem Sie Ihre Bestellung verpackt haben und sie versandbereit ist, erstellt TI Informationen zur Sendungsverfolgung. Verwenden Sie die ASN-API (Advanced Ship Notification), um detaillierte Informationen zu Ihren versendeten Bestellungen abzurufen, einschließlich Sendungsverfolgungsnummern, Spediteurdetails und Handelsrechnungen.

Die ASN-API bietet:

  • Echtzeit-Aktualisierungen: Die Push-API sendet einen Webhook an Ihr System, um Sie zu benachrichtigen, dass Ihre Bestellung versandbereit ist, und kann verwendet werden, um automatisierte Prozesse auszulösen.
  • Detaillierte Versandinformationen: Erhalten Sie Sendungsverfolgungsnummern, Spediteurinformationen und Handelsrechnungen.
  • Flexible Abrufoptionen: Rufen Sie Informationen für ganze Bestellungen über die Bestellnummer oder für bestimmte Lieferungen über die Frachtbriefnummer ab.

So verwenden Sie die ASN-API:

  1. Authentifizierung: Sie benötigen Ihren zugewiesenen API-Schlüssel und Ihr Geheimnis, um sich bei der API zu authentifizieren.
  2. Abrufen von Informationen zur Sendungsverfolgung:
    • Gesamte Bestellung: Geben Sie in Ihrer Anfrage die Bestellnummer an.
    • Bestimmte Lieferung: Geben Sie die Frachtbriefnummer an, die Sie zuvor erhalten haben oder Ihrem myTI-Bestellverlauf entnehmen können.
  3. API-Antwort: Sie erhalten eine Antwort mit einem Statuscode (200 OK) und einer JSON-Datei, die Ihre Versanddetails enthält.
  4. Spezifische Bestelldetails abrufen:
    • Um detaillierte Informationen zu einer bestimmten Bestellung zu erhalten, fragen Sie die API für Bestellungen mit der Bestellnummer ab.
    • Zum Beispiel: "https://transact.ti.com/v2/store/orders/T999999999"

Testen der API:

Es ist eine Testumgebung verfügbar, in der Sie mit der API experimentieren können, bevor Sie sie mit Live-Daten verwenden. Beim Testen:

  • Verwenden Sie die bereitgestellte Test-Endpunkt-URL.
  • Die Auftrags-ID sollte immer als T10999999 und die Frachtbriefnummer immer als 0499999999 übergeben werden.

https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/test?requestCommercialInvoicePDF=true&requestWaybillPDF=true 

oder

https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/499999999/test?requestCommercialInvoicePDF=true&requestWaybillPDF=true

Zusätzliche Hinweise:

  • Ihr Zugriffstoken ermöglicht mehrere Anforderungen innerhalb einer Sitzung, solange es gültig ist.
  • Die API ist in Push- oder Retrieve-Implementierungen verfügbar. Weitere Informationen finden Sie unter Einrichtung von Push-Benachrichtigungen.

 

Beispiel für eine Anfrage zum Abruf:

curl --request GET \
--url 'https://transact.ti.com/v2/store/orders/{orderNumber}/advanced-shipment-notices/{wayBillNumber}'
--header 'Authorization: Bearer {access_token}' \