Como parte de las mejoras continuas a la solución de cumplimiento de Zalando, se ha introducido un nuevo punto final de API para recuperar los artículos recibidos. Este cambio entrará en vigor a partir del 1 de mayo de 2025.
Qué está cambiando
El punto final actual "GET /received-items/{merchant-id}" será desaprobado y reemplazado por "GET /reports/received-items/{merchant-id}"
Lengow ya ha integrado este nuevo punto final, y no se requiere ninguna acción de su parte utilizando la solución de cumplimiento de Zalando Lengow directamente. Consulte la documentación de la API de Lengow aquí.
Sin embargo, si está utilizando el punto final antiguo en integraciones personalizadas, debe actualizar sus sistemas en consecuencia.
Mejoras en el nuevo punto final
Zalando ha introducido varias mejoras:
- Intervalo de tiempo extendido: Recupere datos de hasta 1 año (anteriormente limitado a 100 días).
- Paginación basada en cursor: Permite una recuperación de datos más fácil utilizando un next_page_token, sin ajustar los intervalos de tiempo manualmente.
- Eliminación de campos no utilizados o redundantes: "site_id (duplicado de location_id)"; "parent"; "tour_number"; "consumed_timestamp".
- Conservación de received_timestamp, indicando cuándo se recibieron físicamente los artículos.
- Se agregaron dos nuevos campos opcionales: "merchant_item_id"; "merchant_article_id".
(Estos campos se incluyen solo si los proporcionó durante la entrada.)
Consulte la documentación de la API de Zalando aquí.
Lo que tienes que hacer
Acción requerida antes del 1 de mayo de 2025
Si está utilizando el punto final desaprobado "GET/received-items/{merchant-id}" en una configuración personalizada, asegúrese de:
- Cambiar al nuevo punto final: "GET /reports/received-items/{merchant-id}"
- Adapte su análisis de datos para tener en cuenta los nuevos campos y la paginación
- Deje de usar los campos eliminados
El punto final anterior se desactivará completamente el 1 de mayo de 2025.
Mensaje original
[...]
Este nuevo punto final viene con algunas mejoras:
Estamos extendiendo la limitación del intervalo de tiempo de 100 días a 1 año.
Admite paginación basada en cursor, lo que le permite recuperar sin problemas el siguiente conjunto de datos simplemente proporcionando el token de la próxima página, sin la necesidad de ajustar el intervalo de tiempo.
Se han eliminado las propiedades irrelevantes y duplicadas:
Las propiedades site_id y location_id representaban el mismo valor, por lo que hemos eliminado site_id.
Se han eliminado parent y tour_number, ya que estas propiedades no se utilizaban.
Se ha eliminado la propiedad consumed_timestamp ya que representa datos que son relevantes solo para uso interno. Tenga en cuenta que la propiedad received_timestamp permanece ya que representa el momento en que un artículo fue recibido físicamente.
También hemos agregado dos nuevas propiedades:
Las propiedades merchant_item_id y merchant_article_id se introducen para proporcionar datos especificados por el comerciante si se suministraron durante el proceso de entrada de los artículos.
[...]