当前位置: API文档
接口说明
查询慧经营的发货明细数据。
汇总维度:默认为店铺+业务时间+SKU,支持仓库、是否赠品、订单类型、业务员名称、货品批次、分销商昵称、达人名称。
调用场景
财务软件对接生成销售出库单。
请求地址
| 环境 | 奇门地址 | 服务名 |
|---|---|---|
| 测试环境 | http://332wh0cyoi.api.taobao.com/router/qmtest | wdt.hjy.recon.delivery.detail.query |
| 生产环境 | http://332wh0cyoi.api.taobao.com/router/qm |
请求方式
POST
请求参数
| 参数名称 | 参数类型 | 是否必选 | 参数描述 | 示例 |
|---|---|---|---|---|
hjySign | String | 是 | 慧经营参数签名 | e549e097f97123bc7fa3cfc1354796b2 |
appId | String | 是 | 租户应用标识 | b018b1134f854fb48019d47dd424e5f9 |
sid | String | 是 | 卖家账号 | hjy001 |
nextRequestId | String | 否 | 每页200条,用于分页,查询时返回,下一页查询时传入,返回false,说明查询结束 | 1760506606618202114 |
startBusinessTime | String | 是 | 发货日期,限制不能超过一周 | 2023-03-21 00:00:00 |
endBusinessTime | String | 是 | 发货日期,限制不能超过一周 | 2023-03-21 00:00:00 |
shopNo | String[] | 否 | 店铺编码 | ["Db001"] |
warehouseNo | String[] | 否 | 仓库编码 | ["仓库"] |
specNo | String[] | 否 | 商家编码 | ["Sjbm001"] |
summaryNo | String[] | 否 | 汇总单号 | ["HZDH202202001"] |
omsStockoutNo | String[] | 否 | 出库单号,可以批量 | ["CK20190908228"] |
| provinceNames | String[] | 否 | 省 | ["北京市"] |
| cityNames | String[] | 否 | 市 | ["北京市"] |
| districtNames | String[] | 否 | 区 | ["北京市"] |
platOrderNo | String[] | 否 | 平台订单号,可以批量 | ["2010293102933124"] |
| authorName | String | 否 | 达人名称 | 石大哥 |
salesmanName | String | 否 | 业务员名称 | 石大哥 |
omsOrderNo | String | 否 | 订单编号,可以批量 | ["JY20190907229"] |
响应数据
公共响应数据
| 参数名称 | 参数类型 | 是否必选 | 参数描述 | 参数示例 |
|---|---|---|---|---|
| resultCode | String | 是 | 业务响应码 | 200 |
| message | String | 是 | 业务响应码描述 | success |
| sub_resultCode | String | 是 | 二级响应码 | "" |
| sub_detail | String | 是 | 二级响应码描述 | "" |
| solution | String | 是 | 解决方案 | "" |
| nextRequestId | String | 否 | 默认一页200条。每次查询返回一个值,客户需要用这个值再查,如果返回 false 说明查询结束 | 1760506606618202114 |
| data | Object[] | 是 | 返回结果数据 | [] |
业务响应数据:data
| 参数名称 | 参数类型 | 是否必选 | 参数描述 | 参数示例 |
|---|---|---|---|---|
detailId | String | 是 | 明细唯一id | 1760506606618202114 |
shopNo | String | 是 | 店铺编码 | Db001 |
shopName | String | 是 | 店铺名称 | 第一个店铺 |
specNo | String | 是 | 商品编码 | Sjbm001 |
warehouseNo | String | 是 | 仓库编码 | Ck001 |
warehouseName | String | 是 | 仓库名称 | 第一个仓库 |
businessTime | String | 是 | 业务日期,发货口径对账则为发货日期,收货口径对账则为完成日期 | 2023-03-21 11:00:19 |
summaryNo | String | 是 | 汇总单号 | HZBH0001 |
platOrderNo | String | 是 | 平台订单号 | 20102931029331249023 |
platSubNo | String | 是 | 平台子订单号 | 20102931029331249023 |
omsOrderNo | String | 是 | 系统订单号 | JY202212312 |
omsStockoutNo | String | 是 | 出库单号 | CK20190908228 |
originalOrderNo | String | 是 | 平台订单号[未处理] | 20102931029331249023(对于手工订单/退单,慧经营会默认截取单号后缀,如7198371239874-1,那么截取之后的订单号为7198371239874,此列展示7198371239874-1) |
| authorName | String | 是 | 达人名称 | 石大哥 |
salesmanName | String | 是 | 业务员名称 | 石大哥 |
fenxiaoNick | String | 是 | 分销商昵称 | 石大哥 |
| tradeLabel | String | 是 | 订单标签 | 标签 |
| csRemark | String | 是 | 客服备注 | 已延迟返货 |
goodsNo | String | 是 | 货品编码 | Hpbm001 |
goodsName | String | 是 | 货品名称 | 第一个商品 |
goodsBatchNo | String | 是 | 货品批次号 | PC001 |
giftType | String | 是 | 赠品 | 是/否 |
erpOrderType | String | 是 | 订单类型 | 网店销售、线下零售、售后换货、批发业务、保修换新、保修完成、订单补发、供销补发 .. 自定义类型1、自定义类型2、自定义类型3 、自定义类型4、自定义类型5、自定义类型6 、自定义属性7、自定义属性8 |
deliveryAmount | String | 是 | 发货金额 | 1.0000 |
| sharePostAmount | String | 是 | 邮费 | 1.0000 |
commission | String | 是 | 佣金 | 12.0000 |
costPrice | String | 是 | 总成本 | 4.0000 |
deliveryQty | String | 是 | 发货数量 | 3.0000 |
| provinceName | String | 否 | 省 | 北京市 |
| cityName | String | 否 | 市 | 北京市 |
| districtName | String | 否 | 区 | 西城区 |
请求demo
{
"salesmanName": "ssss",
"platOrderNo": [
"356684659350035725811"
],
"specNo": [
"PJ0011"
],
"warehouseNo": [
"W801"
],
"sid": "hjytest41",
"startBusinessTime": "2023-10-16 00:00:00",
"omsOrderNo": [
"JY20231016002511"
],
"endBusinessTime": "2023-10-16 12:00:00",
"authorName": "aaa",
"appId": "fa330697b64a49a9a4f6fe6b7fef57a7",
"omsStockoutNo": [
"CK20231016002911"
],
"summaryNo": [
"FHS11251344690525674161"
],
"shopNo": [
"01000011801"
]
}响应demo
{
"response": {
"data": [
{
"platOrderNo": "356684659350035725811",
"deliveryAmount": "1674.8004",
"detailId": "1152910871064509693",
"sharePostAmount": "9.9",
"shopName": "shopname4",
"specNo": "PJ0011",
"businessTime": "2023-10-16 10:15:02",
"warehouseName": "华东成品仓",
"platSubNo": "3566846593500357258",
"omsStockoutNo": "CK20231016002911",
"commission": "10.0",
"goodsNo": "A42000000022",
"salesmanName": "ssss",
"deliveryQty": "1",
"costPrice": "8.8",
"giftType": "否",
"erpOrderType": "1",
"warehouseNo": "W801",
"fenxiaoNick": "fff",
"omsOrderNo": "JY20231016002511",
"originalOrderNo": "3566846593500357258",
"goodsBatchNo": "ppp",
"authorName": "aaa",
"summaryNo": "FHS11251344690525674161",
"shopNo": "01000011801",
"goodsName": "ggg"
}
],
"message": "接口调用成功",
"nextRequestId": "12762766954244244",
"resultCode": "200",
"solution": "",
"sub_detail": "业务处理成功",
"sub_resultCode": "SUCCESS"
}
}