小红书API近期有哪些变动？
编辑：点三 时间：2024-04-11 17:37:30
开发者在对接了小红书API之后，为了保障接口的正常使用，需要及时去关注小红书开放平台的接口变动公告，本文为大家收集了两个小红书API在2024年4月比较重要的变动情况，希望能帮助开发者及时进行接口更新。
一、小红书API订单详情接口新增出参
为了更好地支持开发者查询订单信息，小红书开放平台对现有的 order.getOrderDetail接口进行了升级，入参不变，新增出参orderTagList，请开发者按需接入。
|
接口名称
|
接口描述
|
参数名称
|
参数描述
|
|
order.getOrderDetail
|
订单详情
|
orderTagList
|
订单标记，枚举值如下：NEW_YEAR 新年礼PLATFORM_DECLARE 平台报备SELLER_DECLARE 商家报备CONSULT 协商发货MODIFIED_ADDR 已改地址 MODIFIED_PRICE 已改价 NO_LOGISTICS_SHIP 无物流发货PRINTED 部分打单/已打单 URGENT_SHIP 催发货 QIC QIC质检 SAMPLE 拿样 HOME_DELIVERY 送货上门(未上线)
|
具体的接口详情可以前往小红书开放平台的文档中心-API文档中查看。
二、小红书平台送货上门订单对接
小红书平台近期上线送货上门服务，涉及开放平台订单列表接口、订单详情接口、批量取号接口更新，建议服务商在4月30日前按照以下流程完成对接，否则会影响商家实际履约。
STEP1：获取【送货上门】订单
1. 订单列表接口：order.getOrderList
在订单维度增加字段：HOME_DELIVERY，用于判断订单是否为送货上门订单
返回参数：orderList -> orderTagList -> HOME_DELIVERY
报文格式：
2. 订单详情接口：order.getOrderDetail
在订单维度增加字段：HOME_DELIVERY，用于判断订单是否为送货上门订单
返回参数：orderTagList -> HOME_DELIVERY
报文格式：
STEP2：电子面单取号
批量取号接口：express.createEbillOrders
新增一个字段xhsOrderList，在合单发货场景下，三方系统需要把合单发货的小红书订单号集合全部传入。
请求参数：tradeOrderInfoList -> orderInfo -> xhsOrderList
注意：如果是单笔订单取号，即不需要合单的情况下，则无需传入xhsOrderList
常见问题：
1. 送货上门的产品流程是怎么样的？
2. 送货上门订单打印面单时需要传特殊的增值服务标识吗？
不需要。对于送货上门订单，订单上会有相应标签，调用电子面单取号接口即可自动识别，无需额外传入其他字段。
需要注意的是，在合单发货场景下，需要把合单发货的小红书订单号集合全部在xhsOrderList字段传入。
点三信息可以为电商开发者提供小红书API对接及接口维护服务，如有需要可以咨询点三客服。
