小红书 API

订单详情

POST/ark/open_api/v3/common_controller

	错误码	错误码描述
	-2000101	包裹不存在或不属于此商家
	-2000500	系统调用异常

请求参数

orderId

string

订单号

必需

{
  "orderId": "P194****4183"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

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：其他

{
  "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
}

最后修改时间： 1 年前