Print Inbound Order Labels

This API uses an asynchronous Long-Running Operation (LRO) pattern to generate label files. This pattern allows you to trigger a generation task and track its progress until completion. Workflow Steps

1. Initiate Send a request with order_id and the desired print_items.
2. Response: The API begins the print task and returns a task_status of PROCESSING.
3. Poll Send subsequent requests using the same fields from Step 1. If the print task is still processing, the API will continue to return PROCESSING.
4. Frequency: We recommend polling every 3–5 seconds.
5. Complete When the status returns SUCCESS, the response body will include a download_url for your generated ZIP file.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

"CARTON_PALLET_LABEL",
"FBT_BARCODE",
"PACKING_PICKING_LIST"

] |Specifies the types of documents to be generated in this request. Multiple values can be included to receive a combined output. Allowed Values:

• CARTON_PALLET_LABEL: Identification labels to be stuck on at least two adjacent sides of each carton.
• PACKING_PICKING_LIST: Warehouse document for identifying and packing items.
• FBT_BARCODE: Fulfilled by TikTok barcodes.

Note: If this list is empty or omitted, CARTON_LABEL will be generated by default. | carton_label_format |string |N |DEFAULT_1UP |Specifies the layout and dimensions for the carton labels. If this parameter is omitted or an invalid value is provided, the system will use the default single-label format. Allowed Values:

• DEFAULT_1UP: Standard format (1 label per page).
• A4_4UP: A4 paper format (4 labels per page).

Note: If no value is provided, DEFAULT_1UP will be used as the default format. | barcode_format |string |N |DEFAULT_40MM_60MM |Specifies the layout and dimensions for the generated label PDF. If this parameter is omitted or an invalid value is provided, the system will use the default thermal label format. Allowed Values: Standard / Default

• DEFAULT_40MM_60MM: Standard 40mm x 60mm thermal label format

A4 Paper Layouts

• A4_21UP_60_0MM_40_0MM: 21-up labels (60.0mm x 40.0mm) on A4
• A4_21UP_63_5MM_38_1MM: 21-up labels (63.5mm x 38.1mm) on A4
• A4_24UP_63_5MM_33_9MM: 24-up labels (63.5mm x 33.9mm) on A4
• A4_24UP_64_6MM_33_8MM: 24-up labels (64.6mm x 33.8mm) on A4
• A4_24UP_66_0MM_33_9MM: 24-up labels (66.0mm x 33.9mm) on A4
• A4_24UP_66_0MM_35_0MM: 24-up labels (66.0mm x 35.0mm) on A4
• A4_24UP_70_0MM_36_0MM: 24-up labels (70.0mm x 36.0mm) on A4
• A4_24UP_70_0MM_37_0MM: 24-up labels (70.0mm x 37.0mm) on A4
• A4_27UP_63_5MM_29_6MM: 27-up labels (63.5mm x 29.6mm) on A4
• A4_40UP_52_5MM_29_7MM: 40-up labels (52.5mm x 29.7mm) on A4
• A4_44UP_48_5MM_25_4MM: 44-up labels (48.5mm x 25.4mm) on A4

US Letter Layouts

• US_LETTER_30UP_1IN_2_625IN: 30-up labels (1" x 2-5/8") on US Letter

Note: If no value is provided, DEFAULT_40MM_60MM will be used as the default format. |

Query

https://open-api.tiktokglobalshop.com/fbt/202602/inbound_orders/label_print?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY

Body

{"order_id":"5766071177167344427","print_items":["CARTON_PALLET_LABEL","FBT_BARCODE","PACKING_PICKING_LIST"],"carton_label_format":"DEFAULT_1UP","barcode_format":"DEFAULT_40MM_60MM"}

• SUCCESS: Task is finished. download_url should be included in response |

{"code":0,"data":{"download_url":"https://example.com/fbt/inbound_files.zip?download_token=sample_token","task_status":"PROCESSING"},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code