来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 [MY] Important Update for MY-SG SIP and Direct Programme AWB API
Dear Developers,
We’re reaching out to share an important update regarding MY-SG Shopee International Platform and MY-SG Direct Programme order fulfillment.
Background
1, To provide a great buyer experience in terms of delivery speed, we’re launching a logistics improvement project with more streamlined and efficient operational process
- As part of the process improvement, one airway bill (1-AWB) will be required to be used for MY-SG Shopee International Platform and MY-SG Direct Programme orders
[MY-SG Shopee International Platform orders] Changes required
Affected channel ID:
-
18061 5-Day Delivery
-
18092 Shopee Collection Point (Overseas)
-
18054 Doorstep Delivery (Overseas)
| Change required | Technical Details | Rationale of the change | Timeline required |
|---|---|---|---|
| #1 Get familiarized with the new 1-AWB format | 1. Recipient’s address shown will be in Singapore, instead of Malaysia 2. The Tracking Number shown will start with MY… instead of SPXMY… 3. Please see the attachment for more details | To ensure you are aware of the new 1-AWB format and smoothly perform daily shop operations | Before 12 Nov 2024 |
| #2 Call open API to determine whether the order is SG-destination SIP order, for which only Open API standard AWB will be supported | 1. Kindly use /api/v2.order.get_order_detail to identify if the order belongs to an SG-destination SIP order via new parameter allow_self_design_awb 2. If the order belongs to an SG-destination SIP, then allow_self_design_awb= false Please see Change #3 for further instructions. 3. If allow_self_design_awb= true, you may continue to use v2.logistics.get_shipping_document_data_info to self-design AWB. | To ensure that you are able to distinguish the affected orders that should use Open API standard AWB | Before 12 Nov 2024 |
| #3 Call a different OpenAPI to print Standard AWB | 1. If the order is from the affected channels (meaning it belongs to the SG-destination SIP order), kindly use /api/v2/logistics/download_shipping_document to directly download the AWB document to ensure the end-to-end logistics can use the 1-AWB. 2. Kindly refrain from using /api/v2/logistics/get_shipping_document_data_info to retrieve shipping document data and print self-drawn AWB. 3. Kindly allow for a few seconds after arranging shipment before printing AWB, so that the system can generate the last-mile tracking numbers accurately. Delay Recommendation: 3-5 sec 4. Failure to comply may result in parcels being rejected for pickup/dropoff, and delays/cancellations in fulfillment. Note: If there are no system/workflow constraints, it is encouraged to fully transition to using /api/v2/logistics/download_shipping_document for all cases. | To ensure 1-AWB is printed and pasted onto MY-SG Shopee International Platform orders | Before 12 Nov 2024 |
[MY-SG Direct Programme orders] Changes required
Affected channel ID:
-
18079 Shopee Collection Point (Overseas)
-
18080 5-Day Delivery (SPX)
| Change required | Technical Details | Rationale of the change | Timeline required |
|---|---|---|---|
| #1 Get familiarized with the new 1-AWB format | 1. Recipient’s address shown will be in Singapore, instead of Malaysia 2. The Tracking Number shown will start with SG… instead of SPXMY… 3. Please see the attachment for more details | To ensure you are aware of the new 1-AWB format and smoothly perform daily shop operations | Before 12 Nov 2024 |
| #2 Call a different OpenAPI to print Standard AWB | 1. If the orders are from these channels, kindly use /api/v2/logistics/download_shipping_document to directly download the AWB document to ensure the end-to-end logistics can use the 1-AWB. 2.Kindly refrain from using /api/v2/logistics/get_shipping_document_data_info to retrieve shipping document data and print self-drawn AWB. 3. Kindly allow for a few seconds after arranging shipment before printing AWB, so that the system can generate the last-mile tracking numbers accurately. Delay Recommendation: 3-5 sec 4. Failure to comply may result in parcels being rejected for pickup/dropoff, and delays/cancellations in fulfillment. | To ensure 1-AWB is printed and pasted onto MY-SG Shopee Direct Programme orders | Before 12 Nov 2024 |
Please raise an Open Platform Ticket in our Support Center if you have further questions or require further assistance.
亲爱的开发者：
我们在此与您分享关于 MY-SG Shopee International Platform和 MY-SG Direct Programme 订单履约的重要更新。
背景
-
为了提升买家在配送速度方面的体验，我们启动了一项物流提升项目，以实现更高效和精简的运营流程
-
作为流程优化的一部分，MY-SG Shopee International Platform和 MY-SG Direct Programme 的订单将统一使用一单到底 (1-AWB)
[MY-SG Shopee International Platform 订单] 所需变更:
受影响的渠道ID:
1.18061 5-Day Delivery
2.18092 Shopee Collection Point (Overseas)
3.18054 Doorstep Delivery (Overseas)
| 所需变更 | 初步技术细节 | 变更原因 | 时间要求 |
|---|---|---|---|
| #1 熟悉新的 1-AWB 格式 | 1. 收件人地址 将显示为新加坡，而非马来西亚 2. 物流单号 (Tracking Number) 将以 MY... 开头，而非 SPXMY... 3. 请参阅附件了解更多详情 | 确保您了解新的 1-AWB（一单到底) 格式，并顺利进行日常运营 | 2024年11月12日之前 |
| #2 调用 OpenAPI 确定订单是否属于 SG 目的地 SIP 订单 | 1. 请使用 /api/v2.order.get_order_detail通过新增参数 allow_self_design_awb 识别订单是否属于 SG 目的地 SIP 订单 2. 如果订单属于 SG 目的地 SIP，此参数回传值将会是allow_self_design_awb= false 并请参阅变更 #3 3. 如果不是，此参数回传值将会是 allow_self_design_awb= true 您可以继续使用自绘 AWB | 确保您能够识别需要使用Open API 标准 AWB 的订单 | 2024年11月12日之前 |
| #3 使用不同的 OpenAPI 打印标准 AWB | 1. 若订单来自受影响的渠道（即 SG 目的地 SIP 订单），请使用 /api/v2/logistics/download_shipping_document 直接下载 AWB 文件，确保端到端物流可以使用 1-AWB 2. 请不要使用 /api/v2/logistics/get_shipping_document_data_info 获取运单数据并自绘 AWB 3. 打印 AWB 前，请在安排发货后等待几秒，以便系统能够准确生成LMTN 建议延迟时间：3-5 秒 4. 未能遵守流程可能导致包裹被拒收、无法取件或交付延误/取消.备 备注：若无系统或流程上的限制，建议全面采用 /api/v2/logistics/download_shipping_document 处理所有订单。 | 确保 1-AWB (一单到底）被打印并粘贴在 MY-SG Shopee 国际平台订单上。 | 2024年11月12日之前 |
[MY-SG Direct Programme订单] 所需变更:
受影响的渠道 ID:
1.18079 Shopee Collection Point (Overseas)
2.18080 5-Day Delivery (SPX)
| 所需变更 | 初步技术细节 | 变更原因 | 时间要求 |
|---|---|---|---|
| #1 熟悉新的 1-AWB 格式 | 1. 收件人地址 将显示为新加坡，而非马来西亚 2. 物流单号 (Tracking Number) 将以 SG... 开头，而非 SPXMY... 3. 请参阅附件了解更多详情 | 确保您了解新的 1-AWB（一单到底) 格式，并顺利进行日常运营 | 2024年11月12日之前 |
| #2 使用不同的 OpenAPI 打印标准 AWB | 1. 若订单来自这些渠道，请使用 /api/v2/logistics/download_shipping_document 直接下载 AWB 文件，确保端到端物流可以使用 1-AWB。 2. 请不要使用 /api/v2/logistics/get_shipping_document_data_info 获取运单数据并自绘 AWB 3. 打印 AWB 前，请在安排发货后等待几秒，以便系统能够准确生成LMTN 建议延迟时间：3-5 秒 4. 未能遵守流程可能导致包裹被拒收、无法取件或发货延迟/取消。 | 确保 1-AWB（一单到底）的面单格式被打印并贴在 MY-SG Shopee Direct Programme 的订单上。 | 2024年11月12日之前 |
如果您有其他问题，请在我们的支持中心提交问题工单。