当前位置： API文档

接口说明

查询慧经营的发货+售中对账成功明细数据。（仅限于能找到SKU的对账结果数据，只有收款未发货数据则无法统计到此接口）。

调用场景

财务软件对接生成应收单。

请求地址

环境奇门地址服务名
测试环境

http://332wh0cyoi.api.taobao.com/router/qmtest

wdt.hjy.fhdzs.details.query

生产环境

http://332wh0cyoi.api.taobao.com/router/qm

请求方式

 POST

请求参数

参数名称参数类型是否必选参数描述示例

hjySign

String

是

慧经营参数签名

e549e097f97123bc7fa3cfc1354796b2

appId

String

是

租户应用标识

b018b1134f854fb48019d47dd424e5f9

sid

String

是

卖家账号

hjy001

nextRequestId

String

否

每页200条，用于分页，查询时返回，下一页查询时传入，返回false，说明查询结束

1760506606618202114

reconTime

String

是

对账成功日期

2023-03-21

shopName

String[]

否

店铺名称

["Db001"]

shopNo

String[]

否

店铺编码

["Db001"]

warehouseName

String[]

否

仓库名称

["仓库"]

specNo

String[]

否

商家编码

["Sjbm001"]

summaryNo

String[]

否

汇总单号

["HZDH202202001"]

platOrderNo

String[]

否

平台订单号

["2010293102933124"]

salesmanName  

String

否

业务员

石大哥

响应数据

公共响应数据

参数名称参数类型是否必选参数描述参数示例
resultCodeString是业务响应码200
messageString是业务响应码描述success
sub_resultCodeString是二级响应码""
sub_detailString是二级响应码描述""
solutionString是解决方案""
nextRequestIdString否默认一页200条。每次查询返回一个值，客户需要用这个值再查，如果返回 false 说明查询结束1760506606618202114
dataObject[]是返回结果数据[]

业务响应数据：data

参数名称参数类型是否必选参数描述参数示例

detailId

String

是

明细唯一id

1760506606618202114

shopNo

String

是

店铺编码

Db001

shopName

String

是

店铺名称

第一个店铺

specNo

String

是

商品编码

Sjbm001

recoStatus

String

是

对账状态

对账成功/对账失败

warehouseNo

String

是

仓库编码

Ck001

warehouseName

String

是

仓库名称

第一个仓库

businessTime

String

是

业务日期，发货口径对账则为发货日期，收货口径对账则为完成日期

2023-03-21 11:00:19

oldGoodsNo

String

是

变更前货品编码

OHpbm001

goodsBatchNo

String

是

货品批次号

PC001

summaryNo

String

是

汇总单号

HZBH0001

platOrderNo

String

是

平台订单号

20102931029331249023

platSubNo

String

是

平台子订单号

20102931029331249023

sysOrderNo

String

是

系统订单号

JY202212312

originalOrderNo

String

是

平台订单号[未处理]

20102931029331249023（对于手工订单/退单，慧经营会默认截取单号后缀，如7198371239874-1，那么截取之后的订单号为7198371239874，此列展示7198371239874-1）

periodStartDate

String

是

账期开始时间

2023-03-21

periodEndDate

String

是

账期结束时间

2023-03-21

salesmanName

String

是

业务员名称

石大哥

fenxiaoNick

String

是

分销商昵称

石大哥

goodsNo

String

是

货品编码

Hpbm001

goodsName  

String

是

货品名称

第一个商品

giftType  

String

是

赠品

是/否

erpOrderType  

String

是

订单类型

网店销售、线下零售、售后换货、批发业务、保修换新、保修完成、订单补发、供销补发 .. 自定义类型1、自定义类型2、自定义类型3 、自定义类型4、自定义类型5、自定义类型6 、自定义属性7、自定义属性8

deliveryAmount

String

是

发货金额

30.0000

sqtAmount

String

是

售前退款金额，发货前退款金额

0.0000

sztAmount

String

是

售中退款金额，发货后确认收货前退款金额

23.0000

szJtkAmount

String

是

售中仅退款金额

1.0000

szThtkAmount

String

是

售中退货退款金额  

23.0000

adjustAmount

String

是

调整单金额

1.0000

collectionAmount

String

是

收款金额，最终账单实际收款金额

30.0000

diffAmount

String

是

差异金额，发货金额-售中退款金额+调整单金额-收款金额

12.0000

deliveryQty

String

是

发货数量

6.0000

refundQty

String

是

售中预计退款数量

4.0000

returnQty

String

是

售中退货入库数量

3.0000

expectQty

String

是

实际数量，发货数量-售中退货入库数量

2.0000

reconTime

String

是

对账成功日期

2023-03-21 00:00:00

请求demo

{
    "salesmanName": "石大哥",
    "reconTime": "2024-03-26",
    "platOrderNo": [
        "3581660918443169849222"
    ],
    "appId": "fa330697b64a49a9a4f6fe6b7fef57a7",
    "shopName": [
        "shopname31"
    ],
    "specNo": [
        "A4300000002122"
    ],
    "summaryNo": [
        "FHDZSS374914900464743134222"
    ],
    "shopNo": [
        "0100001180111"
    ],
    "warehouseNo": [
        "W6011"
    ],
    "sid": "hjytest41"
}

响应demo

{
    "response": {
        "data": [
            {
                "platOrderNo": "3581660918443169849222",
                "deliveryAmount": "20.0",
                "detailId": "1150940552182360819",
                "shopName": "shopname31",
                "specNo": "A4300000002122",
                "businessTime": "2023-11-09 01:39:37",
                "warehouseName": "华东返修仓",
                "periodEndDate": "2024-03-31",
                "expectQty": "21",
                "platSubNo": "3581660918443169849",
                "szJtkAmount": "20.0",
                "sqtAmount": "30.0",
                "sztAmount": "2034.03",
                "goodsName": "光投影仪（黑色）",
                "goodsNo": "A43000000021",
                "sysOrderNo": "123143234123120",
                "periodStartDate": "2023-10-01",
                "salesmanName": "sssss",
                "deliveryQty": "20",
                "collectionAmount": "30.0",
                "reconTime": "1711446141000",
                "returnQty": "11",
                "adjustAmount": "220.0",
                "diffAmount": "-2034.03",
                "giftType": "否",
                "oldGoodsNo": "A43000000021",
                "erpOrderType": "1",
                "warehouseNo": "W6011",
                "refundQty": "1",
                "fenxiaoNick": "fffff",
                "originalOrderNo": "3581660918443169849",
                "goodsBatchNo": "ppppp",
                "szThtkAmount": "2034.03",
                "summaryNo": "FHDZSS374914900464743134222",
                "shopNo": "0100001180111",
                "recoStatus": "对账成功"
            }
        ],
        "message": "接口调用成功",
        "nextRequestId": "236872778757637076",
        "resultCode": "200",
        "solution": "",
        "sub_detail": "业务处理成功",
        "sub_resultCode": "SUCCESS"
    }
}


常用工具