POST Tạo FBT MCF Order
Tạo FBT MCF Order Shop Scope bắt buộc: seller.fbt.info Đối với các đơn hàng được tạo trên các kênh bán hàng khác cần được fulfillment thông qua FBT, API này cho phép bạn tạo các đơn hàng tương ứng (sau đây gọi là MCF Order). Sau khi MCF Order được tạo thành công, chúng sẽ tự động được gửi đến hệ thống FBT để fulfillment. Phiên bản 202601
POST/fbt/202601/mcf_outbound_orders
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 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 các API request đế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 sử dụng cho tất cả các API request. Nhà phát triển có thể dùng giá trị này để 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ề response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| external_order_id Required | string | ID đơn hàng tương ứng trong OMS của bạn. |
| goods Required | []object | Các item ID và số lượng có trong đơn hàng, trong đó các item phải là những item được quản lý trong hệ thống FBT. |
| consignee Required | object | Thông tin liên hệ của người nhận |
Example
CurlGoNode.jsJavaEnable word wrap
1234567891011121314151617181920212223curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202601/mcf_outbound_orders?timestamp=1623812664&app_key=38abcd&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "external_order_id": "shopify202208291503530001100220033", "goods": [ { "id": "1234567", "quantity": 1 } ], "consignee": { "name": "username", "phone_number": "(+1)1211223910", "email": "username@example.com", "address": { "country_code": "US", "state_or_region": "Alabama", "district_or_county": "Baldwin", "city": "Bay Minette", "address_line_1": "Apt. 302, 5th Ave", "address_line_2": "San Jose",
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 API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log của request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{"mcf_order":{"external_order_id":"shopify202208291503530001100220033","mcf_order_id":"7136104329798256386","create_time":1661756811}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | 177001001 | Thiếu tham số hoặc tham số có định dạng không chính xác | | 177001002 | Dữ liệu item không tồn tại trong hệ thống FBT. Bạn phải cung cấp các item ID hợp lệ; nếu không, hệ thống FBT không thể fulfillment đơn hàng. | | 177001003 | Thông tin địa chỉ không vượt qua được xác minh. Vui lòng kiểm tra tính hợp lệ của địa chỉ, vì hệ thống FBT không thể giao đến các địa chỉ không hợp lệ. | | 177001004 | Không đủ tồn kho; không thể fulfillment đơn hàng. Vui lòng bổ sung tồn kho hoặc sắp xếp giao hàng qua các phương thức khác. | | 177001006 | Merchant không có quyền tạo external order; vui lòng kiểm tra quyền của bạn hoặc liên hệ với nền tảng. | | 177001007 | external_order_number đã được liên kết với một MCF Order đang hoạt động. Hệ thống FBT hiện đang xử lý việc giao đơn hàng, và không cho phép tạo đơn hàng trùng lặp. | | 177001008 | Đã vượt quá giới hạn tốc độ tạo đơn hàng; vui lòng giảm tần suất gọi hoặc thử lại sau. | | 177001009 | 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ợ của nền tảng. | | 177001010 | Không thể truy xuất thông tin đơn hàng qua mcf_order_id mà bạn cung cấp; vui lòng kiểm tra xem ID của bạn có chính xác không. | | 177001011 | địa chỉ không thể giao đến | | 177001012 | đơn hàng đã được đẩy đến hệ thống fulfillment, không thể đẩy lại | | 177001013 | không có quyền, vui lòng thanh toán FBT billing trước |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext