快工助手跨境电商知识与商机助手

跨境巴西站点自画面单接口字段变更(CrossBorder Brazil Shop Self-Design AWB API Field Change)

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/changelogtopic/developertopic/uncategorized

资料正文

§1 跨境巴西站点自画面单接口字段变更(CrossBorder Brazil Shop Self-Design AWB API Field Change)

尊敬的开发者,

由于系统升级,自画面单的跨境卖家,巴西站点面单上的Tracking NO.在自画面单接口GetOrderLogistics(/api/v1/logistics/order/get)取值需从“tracking_no"字段改为新字段“shopee_tracking_no”。

以下接口:

GetOrderLogistics(/api/v1/logistics/order/get)

Init(/api/v1/logistics/init)

GetOrderDetails(/api/v1/orders/detail)

GetForderInfo(/api/v1/orders/forder/get)

的返参“tracking_no”字段的输出值将变为尾程第三方追踪号,便于买家卖家用于当地第三方物流商平台追踪货态,但不能用于自画面单。

请对接新字段,确保追踪号和对应条码准确。可通过追踪号的格式(BR+数字字母)来检验:

此外,接口其他字段不受影响。再次强调,此改动仅适用于巴西站点跨境店铺的面单,其他站点面单,“tracking_no”和”shopee_tracking_no”都能获取现有追踪号(前两字母为站点缩写,比如"BR"),可视自身情况决定取值字段。

“shopee_tracking_no”字段将在8月22日上线,上线后会保持输出现有追踪号,目前在沙箱已可测试。“tracking_no”字段将在9月16日开始对巴西订单改为输出尾程第三方追踪号,请在9月15日前改用“shopee_tracking_no”自画巴西面单。

请各位开发者提前测试并积极配合调整,避免上线后出现面单不符合仓库收货标准,导致无法入库。

Dear Developers,

For CrossBorder self-design Airway Bill sellers, their Brazil AWB Tracking NO should be fetched from “shopee_tracking_no” field instead of “tracking_no” field in GetOrderLogistics(/api/v1/logistics/order/get) API.

“tracking_no” field in below APIs will return last mile tracking no, which can NOT be used for self-design AWB, for sellers and buyers to check logistics status on 3PL platform.

GetOrderLogistics(/api/v1/logistics/order/get)

Init(/api/v1/logistics/init)

GetOrderDetails(/api/v1/orders/detail)

GetForderInfo(/api/v1/orders/forder/get)

Please integrate with the new field to ensure correct tracking no on AWB. You can validate by the format(BR+number/alphabet).

The other fields of those APIs remain unchanged. Again, this change only applies to CB Brazil orders. For CB shops in other regions, both “tracking_no” and “shopee_tracking_no” will return the current tracking no (started with Region abbreviation like “BR”). Please configure the field to use per your discretion.

“shopee_tracking_no” field will go live on 22 Aug, and will keep returning the current tracking no. “tracking_no” field will change to return last mile tracking no starting on 16 Sep. Please switch to “shopee_tracking_no” to self-design Brazil AWB. This feature is now testable in Sandbox. Request for your cooperation on testing in advance to avoid incorrect AWB and subsequent correspondence in the warehouse.

#