Applicable products: Netmarkets

📣 Zalando - 新闻 - 2025年5月1日 - 履行:API端点更新

作为Zalando履行解决方案持续改进的一部分,已经引入了一个新的API端点,用于检索收到的物品。此更改将于2025年5月1日生效。

正在改变的是什么


当前的端点"GET /received-items/{merchant-id}"将被弃用,并被"GET /reports/received-items/{merchant-id}"替代
Lengow已经集成了这个新的端点,如果你直接使用Lengow Zalando履行解决方案,不需要你采取任何行动。请查阅Lengow API文档 这里

然而,如果你在自定义集成中使用旧的端点,你必须相应地更新你的系统。

新端点的改进

Zalando已经引入了几项增强功能:

  • 扩展时间间隔:检索长达1年的数据(以前限制为100天)。
  • 基于光标的分页:使用next_page_token,无需手动调整时间间隔即可更轻松地检索数据。
  • 删除未使用或冗余的字区分:"site_id (location_id的副本)"; "parent"; "tour_number"; "consumed_timestamp"。
  • 保留received_timestamp,表示物品实际接收的时间。
  • 添加了两个新的可选字区分:"merchant_item_id";  "merchant_article_id"。
    (只有在入库时提供了这些字区分,才会包含这些字区分。)

查看Zalando API文档 这里。

你需要做什么

2025年5月1日前需要采取的行动

如果你在自定义设置中使用已弃用的端点"GET​/received-items​/{merchant-id}",请确保:

  • 切换到新的端点:"GET /reports/received-items/{merchant-id}"
  • 调整你的数据解析以适应新的字区分和分页
  • 停止使用已删除的字区分

旧的端点将在2025年5月1日完全停用。

原始消息

[...]

这个新的端点带来了一些改进:

我们将时间间隔限制从100天延长到1年。

它支持基于光标的分页,允许你通过简单地提供下一页令牌,无需调整时间间隔,就可以无缝地检索下一组数据。

已经消除了无关和重复的字区分:

site_id和location_id字区分表示相同的值,所以我们已经删除了site_id。

已经删除了parent和tour_number,因为这些字区分未被使用。

已经删除了consumed_timestamp字区分,因为它表示只对内部使用的数据。请注意,received_timestamp字区分仍然存在,因为它表示物品实际入库的时间。

我们还添加了两个新的字区分:

引入了merchant_item_id和merchant_article_id字区分,如果在物品入库过程中提供了商家指定的数据,就可以提供这些数据。

[...]
 

本文已自动翻译。如有疑问,请参阅英文或法文原文。

此组别内的文章

新闻、服务与事件报告
探索更新、网络研讨会和专家服务,助您充分利用 Lengow。