POST Tạo kiện hàng
Tạo kiện hàng Shop Scope yêu cầu: seller.fulfillment.basic Sử dụng API này để giao đơn hàng (mua nhãn vận chuyển). API này áp dụng riêng cho khu vực US và JP. Phí vận chuyển và thời gian giao hàng chỉ là ước tính và dựa trên kích thước cũng như trọng lượng kiện hàng mà bạn cung cấp. Tùy theo thuộc tính của kiện hàng, các tùy chọn được liệt kê bên dưới có thể khác với các gói đăng ký vận chuyển của bạn. Version 202512
POST/fulfillment/202512/packages
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller lấy 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
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗ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 Required | string | Chữ 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 người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được 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 Required | string | Sử 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
| Properties | Type | Description |
|---|---|---|
| ship_type Required | string | 1:Tất cả sản phẩm trong một đơn hàng được giao trong một kiện hàng với một mã vận đơn 2:Một phần sản phẩm trong một đơn hàng cha được giao trong nhiều kiện hàng với nhiều mã vận đơn 3:Tất cả sản phẩm trong nhiều đơn hàng được giao trong một kiện hàng với một mã vận đơn. |
| order_id | string | TikTok Shop order ID.Nếu ship_type=0&1,đây là trường bắt buộc;Nếu ship_type=2,chúng tôi sẽ không sử dụng |
| order_line_item | []object | Danh sách order line item ID.Nếu ship_type=2,đây là trường bắt buộc;Nếu ship_type=1&3,chúng tôi sẽ không sử dụng trường này |
| order_list_ids | []string | Danh sách order line item ID.Nếu ship_type=3,đây là trường bắt buộc;Nếu ship_type=1&2,chúng tôi sẽ không sử dụng trường này |
| dimension | object | Kích thước kiện hàng. |
| shipping_service_id | string | Chỉ định dịch vụ vận chuyển được sử dụng. Nếu không chỉ định, sử dụng dịch vụ mặc định lấy từ Get Eligible Shipping Service. |
| weight | object | Trọng lượng kiện hàng. |
Example
CurlGoNode.jsJavaEnable word wrap
1234567891011121314151617181920212223curl-X POST 'https://open-api.tiktokglobalshop.com/fulfillment/202512/packages?timestamp=1623812664&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "ship_type": "2", "order_id": "2882335594258860015", "order_line_item": [ { "order_line_id": "2882335594258860015", "sub_item_id": "2882335594258860015" } ], "order_list_ids": [ " " ], "dimension": { "length": "1.2", "width": "0.2", "height": "0.03", "unit": "CM" }, "shipping_service_id": "288233559123860015",
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Thô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_id | string | Request log |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{"dimension":{"length":"1.2","width":"0.2","height":"0.03","unit":"CM"},"shipping_service_info":{"id":"288233559123860015","name":"UPS-first class","price":"10","currency":"dollar","earliest_delivery_days":3,"latest_delivery_days":5,"shipping_provider_id":"2882322591238","shipping_provider_name":"UPS"},"package_id":"2882335594258860015","weight":{"value":"1.2","unit":"GRAM"
Error Code
View common error codes
| Code | Message | | --- | --- | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu sự cố vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ bộ phận hỗ trợ nền tảng. | | 11001002 | invalid param. | | 11001027 | Hệ thống hết thời gian chờ. Nếu lỗi này vẫn tiếp diễn, vui lòng liên hệ nền tảng để được hỗ trợ. | | 11003011 | Lỗi xung đột thao tác dịch vụ vận chuyển, vui lòng kiểm tra lại shipping service ID. | | 11021009 | Không có dịch vụ vận chuyển khả dụng cho yêu cầu này. Vui lòng điều chỉnh trọng lượng kiện hàng hoặc kiểm tra địa chỉ người nhận. Nếu lỗi vẫn tiếp diễn, vui lòng liên hệ nền tảng để được hỗ trợ. | | 11021012 | illegal address | | 11021014 | product oversize | | 11028006 | Mã vận đơn này không khớp với đơn vị vận chuyển nào, vui lòng kiểm tra mã vận đơn và tải lên lại. | | 11050001 | invalid param | | 21001001 | Tham số không hợp lệ. Vui lòng đảm bảo bạn đang truyền đúng tham số yêu cầu. | | 21001011 | Lỗi xử lý hệ thống, vui lòng thử lại sau. | | 21004008 | create label shipping service not found | | 21004010 | Quốc gia của bạn không hỗ trợ sử dụng tính năng này. | | 21008025 | Seller không thể thao tác các đơn hàng được hoàn tất bởi nền tảng | | 21008042 | seller already print shipping label | | 21008106 | Giao diện này không thể sử dụng tại khu vực này. | | 21011001 | Không tìm thấy kiện hàng. Nếu lỗi vẫn tiếp diễn, vui lòng liên hệ nền tảng để được hỗ trợ. | | 21011003 | fulfill_unit action not allowed | | 21011006 | Các đơn hàng này đã được giao. | | 21011007 | Mục trong kiện hàng có yêu cầu hậu mãi, vui lòng xử lý yêu cầu hậu mãi trước. | | 21011012 | not match trade rule | | 21011020 | Các đơn hàng này đã được giao. | | 21011029 | order does not belong to fulfill unit | | 21011033 | order already combined | | 21011035 | split order not allowed | | 21011037 | Không có dịch vụ vận chuyển khả dụng cho yêu cầu này. Vui lòng điều chỉnh trọng lượng kiện hàng, hoặc kiểm tra lại địa chỉ người nhận. Nếu sau nhiều lần thử lại bạn vẫn gặp lỗi này, vui lòng liên hệ nền tảng để được hỗ trợ. | | 21011046 | Order has combine, not allow split order | | 21011048 | Có nhiều kiện hàng có thể được giao, vui lòng chỉ định order line cần giao. | | 21022025 | Nhãn vận chuyển đã được mua. | | 21022026 | Không thể mua nhãn vận chuyển, vui lòng thử lại sau. | | 21022029 | Lỗi xử lý hệ thống, vui lòng thử lại sau. | | 21030005 | Processing create_label_status not allow to operate this action | | 21030006 | Mua nhãn vận chuyển thành công. Thao tác này không được phép trong trạng thái đơn hàng hiện tại. | | 21032001 | fulfill unit status not allow to update pkg attr |
Is this content helpful?Helpful
Not Helpful
PreviousNext