Als Teil der kontinuierlichen Verbesserungen an Zalandos Fulfilment-Lösung wurde ein neuer API-Endpunkt für den Abruf von empfangenen Artikeln eingeführt. Diese Änderung wird ab dem 1. Mai 2025 wirksam.
Was ändert sich
Der aktuelle Endpunkt "GET /received-items/{merchant-id}" wird abgeschafft und durch "GET /reports/received-items/{merchant-id}" ersetzt
Lengow hat diesen neuen Endpunkt bereits integriert und es ist keine Aktion von Ihnen erforderlich, wenn Sie die Lengow Zalando Fulfilment-Lösung direkt verwenden. Konsultieren Sie die Lengow API-Dokumentation hier.
Sollten Sie jedoch den alten Endpunkt in benutzerdefinierten Integrationen verwenden, müssen Sie Ihre Systeme entsprechend aktualisieren.
Verbesserungen im neuen Endpunkt
Zalando hat mehrere Verbesserungen eingeführt:
- Erweitertes Zeitintervall: Datenabruf für bis zu 1 Jahr (zuvor auf 100 Tage begrenzt).
- Cursor-basierte Paginierung: Ermöglicht eine einfachere Datenabfrage mit einem next_page_token, ohne manuelle Anpassungen der Zeitintervalle.
- Entfernung von ungenutzten oder redundanten Feldern: "site_id (Duplikat von location_id)"; "parent"; "tour_number"; "consumed_timestamp".
- Beibehaltung von received_timestamp, das angibt, wann Artikel physisch empfangen wurden.
- Zwei neue optionale Felder hinzugefügt: "merchant_item_id"; "merchant_article_id".
(Diese Felder sind nur enthalten, wenn Sie sie während des Wareneingangs bereitgestellt haben.)
Überprüfen Sie die Zalando API-Dokumentation hier.
Was Sie tun müssen
Aktion erforderlich bis zum 1. Mai 2025
Wenn Sie den veralteten Endpunkt "GET/received-items/{merchant-id}" in einer benutzerdefinierten Einrichtung verwenden, stellen Sie bitte sicher, dass Sie:
- Wechseln Sie zum neuen Endpunkt: "GET /reports/received-items/{merchant-id}"
- Passen Sie Ihr Daten-Parsing an, um neue Felder und Paginierung zu berücksichtigen
- Stellen Sie die Verwendung von entfernten Feldern ein
Der vorherige Endpunkt wird am 1. Mai 2025 vollständig deaktiviert.
Ursprüngliche Nachricht
[...]
Dieser neue Endpunkt bringt einige Verbesserungen mit sich:
Wir erweitern die Begrenzung des Zeitintervalls von 100 Tagen auf 1 Jahr.
Es unterstützt die Cursor-basierte Paginierung, die es Ihnen ermöglicht, nahtlos die nächste Datensatzmenge abzurufen, indem Sie einfach das Token für die nächste Seite bereitstellen, ohne das Zeitintervall anpassen zu müssen.
Irrelevante und doppelte Eigenschaften wurden eliminiert:
Die Eigenschaften site_id und location_id repräsentierten den gleichen Wert, daher haben wir site_id entfernt.
Die Eigenschaften parent und tour_number wurden entfernt, da diese Eigenschaften nicht verwendet wurden.
Die Eigenschaft consumed_timestamp wurde entfernt, da sie Daten darstellt, die nur für den internen Gebrauch relevant sind. Beachten Sie, dass die Eigenschaft received_timestamp erhalten bleibt, da sie die Zeit darstellt, zu der ein Artikel physisch eingegangen ist.
Wir haben auch zwei neue Eigenschaften hinzugefügt:
Die Eigenschaften merchant_item_id und merchant_article_id wurden eingeführt, um vom Händler angegebene Daten bereitzustellen, wenn sie während des Wareneingangsprozesses der Artikel bereitgestellt wurden.
[...]