[Updated] [Action required] Important update for customized Air Waybills (AWB)

Hi Developer,

The updates below on AWBs are only applicable to developers who provide customized AWBs.

1. After a detailed assessment of the customized AWBs that you’re currently using, certain mandatory fields are not found or are optional inclusions in the AWB. Please take note of the mandatory fields that has to be included in all customized AWBs:

2. When designing your AWB, please take note that the minimum requirements (including mandatory fields) are as follows:

Please refer to the sample AWB below that is sectioned for easy reading and includes all necessary fields:

Please take note that all mandatory fields should be included in your customized AWB by 19 August 2022.

FAQs

1. Do I need to follow the sample AWB as shown above when designing the AWB?

No, the sample above is the format that Shopee recommends. Please also take note that not all fields will be returned as well (e.g. some logistics partners do not have Sorting Codes, and some addresses do not have sub-district). Shopee recommends referring to our standard AWB, and to follow the format to ensure that all mandatory fields are included.

2. What should I do if some of the mandatory fields are returned as empty fields in the response parameters?

If the mandatory fields were responded as empty fields, you do not need to include it in your customized AWBs.

3. Do I need to include the mandatory fields above if you do not have it in the standard AWB?

No, you do not need to include it if Shopee’s standard AWB does not have it as well.

4. Does Shopee provide QR code and barcode images?

No, you need to create the QR code and barcode images using tracking numbers provided by the logistics partner.

Please raise an Open Platform Ticket in our Support Center if you have further questions or require further assistance.

Thank you.

以下关于面单的更新只适用于提供自画面单的开发者。

1. 我们对目前使用的自画面单进行详细评估后，发现当前面单中缺失某些必填字段，或其它可选的字段。请注意自画面单中必须包含以下必填字段。

表1：必须填写的字段和APIs

2.在设计自画面单时，开发者需注意以下最低要求（包括必填字段)。

*适用于马来西亚、泰国、印度尼西亚、越南和菲律宾的Shopee Xpress (SPX) AWB。

表2：必填项目和详细内容

请参考下面的面单样例，该例为分段式的，便于阅读，并包括所有必填字段。

请于2022年8月19日之前，对自画面单必填内容做以上调整，感谢您的配合。

FAQs

1. 在设计AWB时，我需要完全按照上面的样本面单样式吗？

答: 不需要，上面的样本是Shopee推荐的格式。请注意，并非所有的字段都会被返回（例如，有些物流合作伙伴没有分类代码，有些地址没有分区）。Shopee建议参考我们的标准面单，并遵循其格式，以确保所有必须的字段都包括在内。

2. 如果一些必填字段在响应参数中被作为空字段返回，我应该怎么做？

答: 如果必填字段被响应为空字段，你不需要在你的自画面单中包括它。

3. 如果某些必填字段在Shopee提供的标准面单中没有，自画面单时需要包括上面的必填字段吗？

答: 不需要，如果Shopee的标准AWB也没有，你不需要包括它。

4. Shopee是否提供二维码和条形码图片？

答: 您需要使用物流合作伙伴提供的追踪号码来创建二维码和条形码图像。

如果您有进一步的问题或需要进一步的帮助，请在我们的支持中心提单。