-
背景（谁？什么问题？有什么影响？为什么？）
对接文档：https://bytedance.sg.larkoffice.com/docx/UGOXdv1BBo8iQQxBDzXl7ZhXg5f
-
需求（做什么？怎么做？有什么要注意的？）
中台需求：https://devops.aliyun.com/projex/project/4d96c1a04647a9dc32ca5eaca6/req/664389cfaa3508041b4619a635
UI图：https://www.figma.com/design/N82uEWKZkUVXWmS8BGcFzI/%E6%97%A5%E5%B8%B8%E9%9C%80%E6%B1%82?node-id=564-158&p=f&t=7zXP4mfIU10PCvmy-0
1、在所有平台的待发货审核、问题件状态下【更多操作】按钮下新增按钮【转FBT配送】，弹窗如下：
|
系统字段
|
取值方式
|
？提示内容
|
接口字段 / Parameter
|
数据类型 / Type
|
是否必传 / Required
|
长度 / Length
|
字段描述 / Description
|
|
tiktok店铺
|
系统内授权的店铺
|
|
|
|
|
|
用户点击店铺的时候通过以下接口校验店铺是否有权限。
MCF Subscription Query / MCF鉴权查询（https://partner.tiktokshop.com/docv2/page/get-fbt-merchant-mcf-status-202601）判断此店铺有无MCF的权限，需要按照店铺维度保存。
如果有权限就可以选择，没有权限的情况下则提示如下：
|
|
tiktok单号
|
默认取值系统订单号。
支持用户选择使用订单参考号。
根据用户选择订单号类型将原单数据填充到titkok单号内
|
|
external_order_id
|
string
|
Y
|
<=128
|
The corresponding order ID in your OMS.
|
|
发货仓以及运输方式
|
默认为空。
|
参考转cg配送
|
|
|
|
|
|
|
|
|
|
|
|
goods
|
List[object]
|
|
|
The item IDs and quantities included in the order, where the items must be those managed in the FBT system. The sum of the quantity of all goods must not exceed 50.
|
|
goods id
|
同cg配送支持3种取值方式
-
默认取仓库SKU
-
取SKU关系映射
-
无需默认值
处理方式同cg配送
|
参考转cg配送
|
|
id
|
string
|
Y
|
|
Identifier for goods generated by Fulfilled by TikTok system
|
|
发货数量
|
默认值为1.支持用户手动编辑发货数量
|
|
|
quantity
|
int
|
Y
|
sum(number)<50
|
The total number of this item.
|
|
|
|
|
consignee
|
object
|
|
|
The consignee contact info
|
|
地址-邮编
|
取值原单中的邮编
|
|
|
postal_code
|
string
|
Y
|
<=20
|
postal code
|
|
地址-收件人
|
取值原单中的收件人名称
|
|
|
name
|
string
|
Y
|
<=40
|
The consignee name
|
|
地址-手机号码
|
取值原单中的手机号码
|
|
|
phone_number
|
string
|
Y
|
|
The phone number of consignee
|
|
地址-邮箱
|
取值原单中的邮箱
|
|
|
email
|
string
|
Y
|
|
The email of consignee
|
|
|
|
|
|
address
|
object
|
|
|
The consignee address must be a valid address; if the address verification fails, no order will be created.
|
|
地址-国家
|
取值原单中的国家
|
|
|
|
country_code
|
string
|
Y
|
<=20
|
Consignee addresses country code in two-character ISO 3166-1 alpha-2 format.
|
|
地址-省洲
|
取值原单中的省洲
|
|
|
|
state_or_region
|
stirng
|
Y
|
<=20
|
Consignee address state or region
|
|
地址-区县
|
取值原单中的区县
|
|
|
|
district_or_county
|
stirng
|
N
|
<=20
|
Consignee address district or county
|
|
地址-城市
|
取值原单中的城市
|
|
|
|
city
|
stirng
|
Y
|
<=20
|
Consignee address city
|
|
地址-地址1
|
取值原单中的地址1
|
|
|
|
address_line_1
|
stirng
|
Y
|
<=35
|
The detail address line 1
|
|
地址-地址2
|
取值原单中的地址2
|
|
|
|
address_line_2
|
stirng
|
N
|
<=35
|
The detail address line 2
|
|
地址-邮编
|
取值原单中的邮编
|
|
|
|
postal_code
|
string
|
Y
|
<=20
|
The postal code
|
手动选择goodsid的弹窗如下
支持按照商品名称和googs id维度进行搜索，多个的情况下精确搜索，单个的情况下精确搜索。
|
系统字段
|
取值方式
|
接口
|
|
goods id
|
选中店铺的tiktok FBT库存页面中的goodsid
|
通过tiktok FBT库存页面获取
|
|
商品名称
|
选中店铺的tiktok FBT库存页面中的商品名称
|
通过tiktok FBT库存页面获取
|
|
转FBT可售库存
|
goods_inventory_list.available_qty
通过接口直接获取。通过googsid定期去查询（这个数据维度和tiktok FBT库存页面不一样，fbt库存列表是平台仓库+googsid出数的，但是此接口仅有googsid维度）
|
/fbt/202601/mcf/goods/inventory/search
|
（1）如果订单操作转FBT成功则提示：“此订单已转FBT配送，待订单审核后将会向平台推送。”
（2）如果缺失以上必填项缺失填写内容的话，则前端在输入框下红字提示：请输入xxxxx。
（3）勾选多个订单的时候提示：“一次只能操作一个订单.”
3、在所有平台的待发货审核、问题件状态下【更多操作】按钮下新增按钮【批量转FBT配送】，弹窗如下：
数据入参同上
（1）如果订单操作转FBT成功则提示：“订单已转FBT配送，待订单审核后将会向平台推送。”
（2）如果缺失以上必填项缺失填写内容的话，则前端在输入框下红字提示：请输入xxxxx。
4、在所有平台的待发货审核、问题件状态下【更多操作】按钮下新增按钮【取消FBT配送】，弹窗如下：
5.参考转FBA功能，获取从仓配返回的异常信息显示在问题件。
6.所有平台列表上新增筛选项：转FBT配送订单。全部/是/否
