Chuyển tới nội dung chính

POST Print Label

In nhãn Shop Scope yêu cầu: seller.fbt.info API này sử dụng mẫu thiết kế thao tác chạy dài bất đồng bộ (Long-Running Operation - LRO) để tạo các tệp nhãn. Mẫu thiết kế này cho phép bạn kích hoạt một tác vụ tạo và theo dõi tiến trình của nó cho đến khi hoàn tất. ** Các bước quy trình **

  1. Khởi tạo Gửi một yêu cầu với order_id và các print_items mong muốn.
  • Phản hồi: API bắt đầu tác vụ in và trả về task_status là PROCESSING.
  1. Thăm dò (Poll) Gửi các yêu cầu tiếp theo sử dụng cùng các trường từ Bước 1. Nếu tác vụ in vẫn đang xử lý, API sẽ tiếp tục trả về PROCESSING.
  • Tần suất: Chúng tôi khuyến nghị thăm dò mỗi 3–5 giây.
  1. Hoàn tất Khi trạng thái trả về SUCCESS, phần thân phản hồi sẽ bao gồm download_url cho tệp ZIP đã được tạo của bạn. Phiên bản 202602

POST/fbt/202602/inbound_orders/label_print

Request

Header

PropertiesTypeDescription
content-type RequiredstringKiểu cho phép: application/json
x-tts-access-token RequiredstringGiá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller.

Query

PropertiesTypeDescription
app_key RequiredstringMỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn.
sign RequiredstringChữ ký được tạo bởi thuật toán gen. Khi bạn gửi yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện được người gửi.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương.
shop_cipher RequiredstringSử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop

Body

PropertiesTypeDescription
order_id RequiredstringĐịnh danh dạng số của inbound order cần cập nhật thông tin theo dõi. Lưu ý: Chỉ cung cấp chuỗi số; không bao gồm tiền tố "IBR" (ví dụ: dùng 123456 thay vì IBR123456).
print_items[]stringChỉ định các loại tài liệu cần tạo trong yêu cầu này. Có thể bao gồm nhiều giá trị để nhận đầu ra kết hợp.Các giá trị cho phép:* CARTON_PALLET_LABEL: Nhãn nhận diện được dán lên ít nhất hai mặt liền kề của mỗi thùng carton.* PACKING_PICKING_LIST: Tài liệu kho để nhận diện và đóng gói các mặt hàng.* FBT_BARCODE: Mã vạch Fulfilled by TikTok.Lưu ý: Nếu danh sách này rỗng hoặc bị bỏ qua, CARTON_LABEL sẽ được tạo theo mặc định.
carton_label_formatstringChỉ định bố cục và kích thước cho các nhãn carton. Nếu tham số này bị bỏ qua hoặc cung cấp giá trị không hợp lệ, hệ thống sẽ sử dụng định dạng nhãn đơn mặc định.Các giá trị cho phép:* DEFAULT_1UP: Định dạng chuẩn (1 nhãn mỗi trang).* A4_4UP: Định dạng giấy A4 (4 nhãn mỗi trang).Lưu ý: Nếu không cung cấp giá trị, DEFAULT_1UP sẽ được dùng làm định dạng mặc định.
barcode_formatstringChỉ định bố cục và kích thước cho tệp PDF nhãn được tạo. Nếu tham số này bị bỏ qua hoặc cung cấp giá trị không hợp lệ, hệ thống sẽ sử dụng định dạng nhãn nhiệt mặc định.Các giá trị cho phép:Chuẩn / Mặc định* DEFAULT_40MM_60MM: Định dạng nhãn nhiệt chuẩn 40mm x 60mmBố cục giấy A4* A4_21UP_60_0MM_40_0MM: 21 nhãn (60.0mm x 40.0mm) trên A4* A4_21UP_63_5MM_38_1MM: 21 nhãn (63.5mm x 38.1mm) trên A4* A4_24UP_63_5MM_33_9MM: 24 nhãn (63.5mm x 33.9mm) trên A4* A4_24UP_64_6MM_33_8MM: 24 nhãn (64.6mm x 33.8mm) trên A4* A4_24UP_66_0MM_33_9MM: 24 nhãn (66.0mm x 33.9mm) trên A4* A4_24UP_66_0MM_35_0MM: 24 nhãn (66.0mm x 35.0mm) trên A4* A4_24UP_70_0MM_36_0MM: 24 nhãn (70.0mm x 36.0mm) trên A4* A4_24UP_70_0MM_37_0MM: 24 nhãn (70.0mm x 37.0mm) trên A4* A4_27UP_63_5MM_29_6MM: 27 nhãn (63.5mm x 29.6mm) trên A4* A4_40UP_52_5MM_29_7MM: 40 nhãn (52.5mm x 29.7mm) trên A4* A4_44UP_48_5MM_25_4MM: 44 nhãn (48.5mm x 25.4mm) trên A4Bố cục giấy US Letter* US_LETTER_30UP_1IN_2_625IN: 30 nhãn (1" x 2-5/8") trên US LetterLưu ý: Nếu không cung cấp giá trị, DEFAULT_40MM_60MM sẽ được dùng làm định dạng mặc định.

Example

CurlGoNode.jsJavaEnable word wrap

1234567891011121314curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202602/inbound_orders/label_print?sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&app_key=38abcd' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "order_id": "5766071177167344427", "print_items": [ "CARTON_PALLET_LABEL", "FBT_BARCODE", "PACKING_PICKING_LIST" ], "carton_label_format": "DEFAULT_1UP", "barcode_format": "DEFAULT_40MM_60MM"}'

Response Parameters

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại được trả về trong phản hồi API.
messagestringThông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong thông báo.
request_idstringNhật ký yêu cầu
dataobjectThông tin trả về cụ thể

Example

JSONEnable word wrap

{"code":0,"data":{"download_url":"https://lf16-oec-sc-sign.tiktokcdn-us.com/obj/tos-useast5-v-6091-tx/bff/upload/c656f0bf-d21c-485a-a130-e2cc4a531aec/inbound_files.zip?lk3s=5375a957&x-expires=1772107010&x-signature=7SD9BUI9UAVZ%2FUFJjddPxi8z4D4%3D","task_status":"PROCESSING"},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

Error Code

Xem các mã lỗi phổ biến

| Code | Message | | --- | --- | | 39001002 | Request or request parameters are empty. Please recheck the input parameters. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 39015007 | Access denied. The API requires the seller to be bound to exactly one merchant. | | 39015009 | SellerId input is invalid | | 39015010 | No inbound orders found for the merchant. |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext