小红书 API
  1. 订单 API
小红书 API
  • 开发文档
    • 应用开发
    • 新手指南
    • 应用测试
    • 授权流程(自研)
    • 授权流程(软件服务商)
    • 签名算法
    • 系统参数说明
    • 应用消息推送
    • SDK 使用说明
    • 发布服务
  • API 调用场景
    • 商品基础介绍
    • 订单基础介绍
    • 跨境订单介绍
    • 订单接入方案
    • 售后接入说明
  • 数据加解密
    • 数据加密对接方案
    • 加密算法介绍
  • 电子面单
    • 电子面单对接说明
    • 电子面单打印组件协议
  • 规则中心
    • 小红书开放平台开发者协议
    • 数据安全承诺函
    • 服务市场上架审核标准
    • 开发者角色说明
    • 小红书服务市场服务协议(服务商版)
    • 小红书服务市场管理规范
    • 企业管理类目管理规则
    • 商品管理类目管理规则
    • 订单管理类目管理规则
    • 内容工具类目管理规则
    • 小红书服务市场保证金要求
  • 公共 API
    • 批量获取发货时间规则
    • 获取地址信息(新)
    • 获取商家地址库
    • 获取分类列表
    • 由末级分类获取规格(新)
    • 由末级分类获取属性
    • 由属性获取属性值
    • 获取快递公司信息
    • 获取物流方案列表
    • 运费模版列表
    • 运费模版详情
    • 获取品牌信息
    • 获取物流模式列表
    • 获取地址信息
    • 获取老版本商家授权信息
    • cc资质检查
    • 商品标题类目预测
    • 由末级分类获取规格(旧)
  • 订单 API
    • 带货达人侧详情查询
      POST
    • 查询月度结算单下载地址
      POST
    • 订单列表
      POST
    • 订单详情
      POST
    • 订单收件人信息
      POST
    • 修改订单备注
      POST
    • 订单发货
      POST
    • 修改快递单号
      POST
    • 订单物流轨迹
      POST
    • 海关申报信息
      POST
    • 获取取消申请列表(即将下线)
      POST
    • 取消申请审核(即将下线)
      POST
    • 跨境清关支持口岸
      POST
    • 跨境重推支付单
      POST
    • 跨境商品备案信息同步
      POST
    • 跨境商品备案信息查询
      POST
    • 小包批次创建
      POST
    • 开票列表查询
      POST
    • 开票结果回传(正向蓝票开具)
      POST
    • 发票冲红(逆向冲红)
      POST
    • 批量解密
      POST
    • 批量脱敏
      POST
    • 批量获取索引串
      POST
  • 售后 API
    • 售后换货确认收货并发货
    • 获取售后列表
    • 售后详情
    • 售后审核(新)
    • 售后确认收货(新)
  • 商品 API
    • 商品列表基础版
    • 商品列表完整版(新)
    • 更新物流方案
    • 商品上下架
    • 创建ITEM
    • 更新TEM
    • 删除ITEM
    • 创建SKU
    • 更新SKU
    • 删除SKU
    • 查询Item列表
    • 获取ITEM详情
    • 修改价格
    • 修改商品主图、主图视频
    • 修改规格图
  • 库存 API
    • 获取商品库存
    • 同步库存
    • 增减库存
  • 素材中心 API
    • 素材列表
    • 上传素材
    • 修改素材
    • 删除素材
  • 消息文档
    • 商品新建
    • 商品上下架
    • 商品审核驳回
    • 商品删除
  • 物流 API
    • 查询电子面单订购关系
    • 查询电子面单模板列表
    • 批量取号
    • 更新面单
    • 取消面单
    • 查询面单
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  • 素材中心 API
  1. 订单 API

订单详情

POST
/ark/open_api/v3/common_controller
错误码错误码描述
-2000101包裹不存在或不属于此商家
-2000500系统调用异常
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \
--header 'Content-Type: application/json;charset=utf-8' \
--data-raw '{
    "orderId": "P194****4183"
}'
响应示例响应示例
{
  "orderId": "P321***4012",
  "orderType": 1,
  "orderStatus": 1,
  "orderAfterSalesStatus": 1,
  "cancelStatus": 1,
  "createdTime": 1612518379000,
  "paidTime": 1612518379000,
  "updateTime": 1612518379000,
  "deliveryTime": 1612518379000,
  "cancelTime": 1612518379000,
  "finishTime": 1612518379000,
  "promiseLastDeliveryTime": 1612518379000,
  "planInfoId": "601a***fb49",
  "planInfoName": "不包邮-默认模板",
  "receiverCountryId": "null",
  "receiverCountryName": "中国",
  "receiverProvinceId": "null",
  "receiverProvinceName": "江苏",
  "receiverCityId": "null",
  "receiverCityName": "苏州",
  "receiverDistrictId": "null",
  "receiverDistrictName": "相城区",
  "customerRemark": "请尽快送达",
  "sellerRemark": "请尽快送达",
  "sellerRemarkFlag": 1,
  "presaleDeliveryStartTime": 1612518379000,
  "presaleDeliveryEndTime": 1612518379000,
  "skuList": [
    {
      "skuId": "603c****0b0a",
      "skuName": "商品1号",
      "erpcode": "null",
      "skuSpec": "null",
      "skuImage": "null",
      "skuQuantity": 1,
      "skuDetailList": [
        {
          "skuId": "690***466",
          "erpCode": "null",
          "barcode": "690***466",
          "scSkuCode": "620***301",
          "quantity": 100,
          "registerName": "商品1号",
          "skuName": "商品1号",
          "pricePerSku": 100,
          "taxPerSku": 10,
          "paidAmountPerSku": 100,
          "depositAmountPerSku": 30,
          "merchantDiscountPerSku": 10,
          "redDiscountPerSku": 5,
          "rawPricePerSku": 115
        }
      ],
      "totalPaidAmount": 115,
      "totalMerchantDiscount": 10,
      "totalRedDiscount": 5,
      "totalTaxAmount": 10,
      "totalNetWeight": 2000,
      "skuTag": 1,
      "isChannel": "",
      "deliveryMode": 1
    }
  ],
  "originalOrderId": "null",
  "totalNetWeightAmount": 2000,
  "totalPayAmount": 10000,
  "totalShippingFree": 1000,
  "unpack": true,
  "expressTrackingNo": "1021***1412",
  "expressCompanyCode": "shunfeng",
  "receiverName": "null",
  "receiverPhone": "null",
  "receiverAddress": "null",
  "boundExtendInfo": {
    "payNo": "null",
    "payChannel": "null",
    "productValue": "",
    "payAmount": "",
    "taxAmount": "",
    "shippingFee": "",
    "discountAmount": "",
    "zoneCodes": [
      "string"
    ]
  },
  "transferExtendInfo": {
    "internationalExpressNo": "null",
    "orderDeclaredAmount": "",
    "paintMarker": "null",
    "collectionPlace": "null",
    "threeSegmentCode": "null"
  },
  "openAddressId": "null",
  "simpleDeliveryOrderList": [
    {
      "deliveryOrderIndex": "",
      "status": 1,
      "expressTrackingNo": "null",
      "expressCompanyCode": "shunfen",
      "skuIdList": [
        "string"
      ]
    }
  ],
  "logistics": "red_express",
  "totalDepositAmount": 10000,
  "totalMerchantDiscount": 1000,
  "totalRedDiscount": 1000,
  "merchantActualReceiveAmount": 1000,
  "totalChangePriceAmount": 1000,
  "paymentType": 1
}

请求参数

Header 参数
Content-Type
string 
可选
默认值:
application/json;charset=utf-8
Body 参数application/json
orderId
string 
订单号
必需
示例

返回响应

🟢200成功
application/json
Body
packageId
string 
订单号
必需
packageType
integer 
必需
订单类型,1普通 2定金预售 3全款预售 4延迟发货 5换货补发
packageStatus
integer 
必需
订单状态,1已下单待付款 2已支付处理中 3清关中 4待发货 5部分发货 6待收货 7已完成 8已关闭 9已取消 10换货申请中
packageAfterSalesStatus
integer 
必需
售后状态,1无售后 2售后处理中 3售后完成(含取消) 4售后拒绝 5售后关闭 6平台介入中
cancelStatus
integer 
必需
申请取消状态,0未申请取消 1取消处理中
createdTime
integer 
创建时间 单位ms
必需
paidTime
integer 
支付时间 单位ms
必需
updateTime
integer 
更新时间 单位ms
必需
deliveryTime
integer 
必需
订单发货时间 单位ms
cancelTime
integer 
必需
订单取消时间 单位ms
finishTime
integer 
必需
订单完成时间 单位ms
promiseLastDeliveryTime
integer 
必需
承诺最晚发货时间 单位ms
planInfoId
string 
物流方案id
必需
planInfoName
string 
物流方案名称
必需
receiverCountryId
string 
收件人国家id
必需
receiverCountryName
string 
目前仅 中国
必需
receiverProvinceId
string 
收件人省份id
必需
receiverProvinceName
string 
收件人省份
必需
receiverCityId
string 
收件人城市id
必需
receiverCityName
string 
收件人城市
必需
receiverDistrictId
string 
收件人区县id
必需
receiverDistrictName
string 
收件人区县名称
必需
customerRemark
string 
用户备注
必需
sellerRemark
string 
商家标记备注
必需
sellerRemarkFlag
integer 
必需
商家标记优先级,ark订单列表展示旗子颜色 1灰旗 2红旗 3黄旗 4绿旗 5蓝旗 6紫旗
presaleDeliveryStartTime
integer 
必需
预售最早发货时间 单位ms
presaleDeliveryEndTime
integer 
必需
预售最晚发货时间 单位ms
itemList
array [object {15}] 
必需
item列表 相同itemid聚合 金额为相同item下sku价格总和 单位 分
itemId
string 
商品id
可选
itemName
string 
商品名称
可选
erpcode
string 
可选
商家编码(若为组合品,暂不支持组合品的商家编码,但skulist会返回子商品商家编码)
itemSpec
string 
规格
可选
itemImage
string 
商品图片url
可选
itemQuantity
integer 
商品数量
可选
skuList
array [object {14}] 
可选
商品sku信息列表(可能出现相同skuCode不同价格的状况)
totalPaidAmount
integer 
可选
总支付金额(考虑总件数)商品总实付
totalMerchantDiscount
integer 
商家承担总优惠
可选
totalRedDiscount
integer 
平台承担总优惠
可选
totalTaxAmount
integer 
商品税金
可选
totalNetWeight
integer 
商品总净重
可选
itemTag
integer 
可选
是否赠品,1 赠品 0 普通商品
isChannel
string 
是否是渠道商品
可选
channel
string 
可选
originalPackageId
string 
必需
原始关联订单号(退换订单的原订单)
totalNetWeightAmount
integer 
必需
订单商品总净重 单位g
totalPayAmount
integer 
必需
订单实付金额(包含运费) 单位分
totalShippingFree
integer 
订单运费 单位分
必需
unpack
boolean 
必需
是否拆包 true已拆包 false未拆包
expressTrackingNo
string 
快递单号
必需
expressCompanyCode
string 
快递公司编码
必需
receiverName
string 
必需
收件人姓名 暂不返回 详情通过getReceiverInfo获取
receiverPhone
string 
必需
收件人手机 暂不返回 详情通过getReceiverInfo获取
receiverAddress
string 
必需
收件人地址 暂不返回 详情通过getReceiverInfo获取
boundExtendInfo
object 
必需
三方保税节点 金额单位 分
payNo
string 
交易流水号
必需
payChannel
string 
必需
交易渠道,AliPay=支付宝,TP=微信
productValue
string 
必需
订单价值(货值,订单商品申价之和(税前价))
payAmount
string 
必需
订单支付金额(含运费)
taxAmount
string 
订单税金
必需
shippingFee
string 
运费 含运费税
必需
discountAmount
string 
订单优惠
必需
zoneCodes
array[string]
必需
海关三级地址区域编码
transferExtendInfo
object 
小包转运节点
必需
internationalExpressNo
string 
国际快递单号
必需
orderDeclaredAmount
string 
订单申报金额
必需
paintMarker
string 
大头笔
必需
collectionPlace
string 
集包地
必需
threeSegmentCode
string 
三段码
必需
openAddressId
string 
必需
收件人姓名+手机+地址等计算得出,用来查询收件人详情
simpleDeliveryPackageList
array [object {5}] 
拆包信息节点
必需
deliveryPackageIndex
string 
可选
发货订单索引标识 修改快递单号会使用
status
integer 
可选
发货订单状态,1:已下单待付款 2:已支付处理中 3:清关中 4:待发货 6:待收货 7:已完成 8:已关闭 9:已取消 10:换货申请中
expressTrackingNo
string 
拆包快递单号
可选
expressCompanyCode
string 
快递公司代码
可选
itemIdList
array[string]
可选
此发货订单中有哪些商品,status=4待发货时,列表中的item可以拆包发货。status=6时,列表中的item共享相同的快递公司和单号,修改时一起修改
logistics
string 
必需
物流模式red_express三方备货直邮(备货海外仓),red_domestic_trade(三方备货内贸),red_standard(三方备货保税仓),red_auto(三方自主发货),red_box(三方小包),red_bonded(三方保税)
totalDepositAmount
integer 
订单定金 单位分
必需
totalMerchantDiscount
integer 
必需
商家承担总优惠金额 单位分
totalRedDiscount
integer 
必需
平台承担总优惠金额 单位分
merchantActualReceiveAmount
integer 
必需
商家实收(=用户支付金额+定金+平台优惠) 单位分
totalChangePriceAmount
integer 
改价总金额 单位分
必需
paymentType
integer 
必需
支付方式 1:支付宝 2:微信 3:apple 内购 4:apple pay 5:花呗分期 7:支付宝免密支付 -1:其他

【小红书】API开发者 微信交流群

用微信扫右侧二维码,加入【小红书】API开发者 交流群,互助沟通

扫码加入交流群
上一页
订单列表
下一页
订单收件人信息
Built with