API文档

接口说明

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

汇总维度：默认为店铺+对账状态+SKU,支持业务时间、仓库、是否赠品、订单类型、业务员名称、货品批次、分销商昵称、达人名称。

调用场景

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

请求地址

环境	奇门地址	服务名
测试环境	http://332wh0cyoi.api.taobao.com/router/qmtest	wdt.hjy.recon.fhdz.summary.query
生产环境	http://332wh0cyoi.api.taobao.com/router/qm	wdt.hjy.recon.fhdz.summary.query

请求方式

POST

请求参数

参数名称	参数类型	是否必选	参数描述	示例
hjySign	String	是	慧经营参数签名	e549e097f97123bc7fa3cfc1354796b2
appId	String	是	租户应用标识	b018b1134f854fb48019d47dd424e5f9
sid	String	是	卖家账号	hjy001
nextRequestId	String	否	每页200条，用于分页，查询时返回，下一页查询时传入，返回false，说明查询结束	1760506606618202114
periodMark	Number	否	对账标识，与对账周期时间不能同时为空	1代表最后一个已结账对账周期，最大为3
startDate	String	否	账期开始日期，需要与账期结束日期一起传	2023-03-21
endDate	String	否	账期结束日期，需要与账期开始日期一起传	2023-03-21
shopNo	String[]	否	店铺编码	["Db001"]
warehouseNo	String[]	否	仓库编码	["仓库"]
specNo	String[]	否	商家编码	["Sjbm001"]
summaryNo	String[]	否	汇总单号	["HZDH202202001"]
recoStatus	String[]	否	对账状态	["对账成功","对账失败"]
salesmanName	String	否	业务员	石大哥

响应数据

公共响应数据

参数名称	参数类型	是否必选	参数描述	参数示例
resultCode	String	是	业务响应码	200
message	String	是	业务响应码描述	success
sub_resultCode	String	是	二级响应码	""
sub_detail	String	是	二级响应码描述	""
solution	String	是	解决方案	""
nextRequestId	String	否	默认一页200条。每次查询返回一个值，客户需要用这个值再查，如果返回 false 说明查询结束	1760506606618202114
data	Object[]	是	返回结果数据	[]

业务响应数据：data

参数名称	参数类型	是否必选	参数描述	参数示例
shopNo	String	是	店铺编码	Db001
shopName	String	是	店铺名称	第一个店铺
specNo	String	是	商品编码	Sjbm001
reconStatus	String	是	对账状态	对账成功/对账失败
warehouseNo	String	是	仓库编码	Ck001
warehouseName	String	是	仓库名称	第一个仓库
businessDate	String	是	业务日期，发货口径对账则为发货日期，收货口径对账则为完成日期	2023-03-21
summaryDate	String	是	汇总日期	2023-03-21
periodStartDate	String	是	账期开始日期	2023-03-21
periodEndDate	String	是	账期结束日期	2023-03-22
summaryNo	String	是	汇总单号	HZBH0001
summaryMainNo	String	是	汇总主单号	HZBH0001
salesmanName	String	是	业务员名称	石大哥
fenxiaoNick	String	是	分销商昵称	石大哥
goodsNo	String	是	货品编码	Hpbm001
goodsName	String	是	货品名称	第一个商品
goodsBatchNo	String	是	货品批次号	PC001
giftType	String	是	赠品	是/否
erpOrderType	String	是	订单类型	网店销售、线下零售、售后换货、批发业务、保修换新、保修完成、订单补发、供销补发 .. 自定义类型1、自定义类型2、自定义类型3 、自定义类型4、自定义类型5、自定义类型6 、自定义属性7、自定义属性8
deliveryAmount	String	是	发货金额	30.0000
preSalesRefundAmount	String	是	售前退款金额，发货前退款金额	0.0000
sellsRefundAmount	String	是	售中退款金额，发货后确认收货前退款金额	23.0000
szRefundOnlyAmount	String	是	售中仅退款金额	1.0000
szRefundReturnAmount	String	是	售中退货退款金额	23.0000
adjustAmount	String	是	调整单金额	1.0000
receivedAmount	String	是	收款金额，最终账单实际收款金额	30.0000
deliveryQty	String	是	发货数量	6.0000
refundQty	String	是	售中预计退款数量	4.0000
returnQty	String	是	售中退货入库数量	3.0000
expectQty	String	是	实际数量，发货数量-售中退货入库数量	2.0000
sharePostAmount	String	是	邮费收入	1.0000
authorName	String	是	达人名称	石大哥
signStatus	String	是	签收状态	已签收

请求demo

{
    "salesmanName": "石大哥1",
    "endDate": "2024-03-31",
    "appId": "fa330697b64a49a9a4f6fe6b7fef57a7",
    "specNo": [
        "PJ0011"
    ],
    "periodMark": "1",
    "summaryNo": [
        "FHDZS9830663219138410081"
    ],
    "shopNo": [
        "01000011801"
    ],
    "startDate": "2023-10-01",
    "warehouseNo": [
        "W801"
    ],
    "recoStatus": [
        "对账成功",
        "对账失败"
    ],
    "sid": "hjytest41"
}

响应demo

{
    "response": {
        "data": [
            {
                "preSalesRefundAmount": "90.0",
                "sharePostAmount": "99.9",
                "shopName": "shopname3",
                "specNo": "PJ0011",
                "reconStatus": "对账成功",
                "warehouseName": "售后十分到家不良品仓",
                "periodEndDate": "2023-12-31",
                "szRefundReturnAmount": "20.0",
                "businessDate": "2023-10-04",
                "expectQty": "10",
                "goodsName": "激光投影仪",
                "goodsNo": "A43000000029",
                "periodStartDate": "2023-12-31",
                "salesmanName": "石大哥1",
                "returnQty": "20",
                "sellsRefundAmount": "1999.19",
                "adjustAmount": "1999.19",
                "giftType": "否",
                "summaryDate": "2024-03-05",
                "receivedAmount": "30.0",
                "deliverQty": "40",
                "erpOrderType": "1",
                "warehouseNo": "W801",
                "szRefundOnlyAmount": "1999.19",
                "refundQty": "12",
                "fenxiaoNick": "ffff",
                "goodsBatchNo": "pppp",
                "authorName": "aaaa",
                "deliverAmount": "1340.0",
                "summaryNo": "FHDZS9830663219138410081",
                "shopNo": "01000011801"
                "signStatus": "已签收"
            }
        ],
        "message": "接口调用成功",
        "nextRequestId": "false",
        "resultCode": "200",
        "solution": "",
        "sub_detail": "业务处理成功",
        "sub_resultCode": "SUCCESS"
    }
}