Dans le cadre des améliorations continues de la solution Fulfilment de Zalando, un nouvel endpoint API a été introduit pour la récupération des articles reçus. Ce changement entrera en vigueur à partir du 1er mai 2025.
Ce qui changeÂ
L’endpoint actuel "GET /received-items/{merchant-id}" sera obsolète et remplacé par "GET /reports/received-items/{merchant-id}".
Lengow intègre ce nouvel endpoint, aucune action n’est requise de votre part si vous utilisez directement la solution Fulfilment de Zalando via Lengow. Consultez la documentation de l’API Lengow ici.
En revanche, si vous utilisez l’ancien endpoint dans le cadre d’intégrations personnalisées, vous devez mettre à jour vos systèmes en conséquence.
Améliorations du nouvel endpoint
Zalando a introduit plusieurs améliorations :
- Extension de l’intervalle de temps : Récupérez les données sur une période allant jusqu’à 1 an (auparavant limité à 100 jours).
- Pagination basée sur un curseur : Permet une récupération des données plus facile grâce à un "next_page_token", sans avoir à ajuster manuellement les intervalles de temps.
- Suppression des champs inutilisés ou redondants : "site_id (doublon de location_id)"; "parent"; "tour_number"; "consumed_timestamp".
- Conservation de "received_timestamp", indiquant la date et l’heure où les articles ont été physiquement reçus.
- Ajout de deux nouveaux champs optionnels : "merchant_item_id"; "merchant_article_id".
(Ces champs ne sont présents que si vous les avez fournis lors de l'inbound)
Consultez la documentation de l’API Zalando ici.
Ce que vous devez faireÂ
Actions requises avant le 1er mai 2025
Si vous utilisez l'endpoint obsolète "GET /received-items/{merchant-id}" dans une configuration personnalisée, assurez-vous de :
- Passer au nouvel endpoint : "GET /reports/received-items/{merchant-id}"
- Adapter votre traitement des données pour tenir compte des nouveaux champs et de la pagination
- Cesser d'utiliser les champs supprimés
L’Endpoint précédent sera complètement désactivé le 1er mai 2025.
Message Original
[...]
This new endpoint comes with some improvements:
We are extending the time interval limitation from 100 days to 1 year.
It supports cursor-based pagination, allowing you to seamlessly retrieve the next set of data by simply providing the next page token, without the need to adjust the time interval.
Irrelevant and duplicated properties have been eliminated:
site_id and location_id properties represented the same value, so we have removed site_id.
parent and tour_number have been removed, as these properties were unused.
consumed_timestamp property is removed as it represents data that is relevant for internal usage only. Note that the received_timestamp property remains as it represents the time when an item was physically inbounded.
We’ve also added two new properties:
merchant_item_id and merchant_article_id properties are introduced to provide merchant-specified data if it was supplied during the items’ inbound process.
[...]