API文档

接口说明

查询慧经营参与对账的店铺的退货入库汇总数据，区分售中、售后。

调用场景

财务软件对接生成销售退货单。

请求地址

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

请求方式

POST

请求参数

参数名称	参数类型	是否必选	参数描述	示例
hjySign	String	是	慧经营参数签名	e549e097f97123bc7fa3cfc1354796b2
appId	String	是	租户应用标识	b018b1134f854fb48019d47dd424e5f9
sid	String	是	卖家账号	hjy001
nextRequestId	String	否	每页200条，用于分页，查询时返回，下一页查询时传入，返回false，说明查询结束	1760506606618202114
businessDate	String	是	退货入库日期	2023-03-21
shopNo	String[]	否	店铺编码	["Db001"]
warehouseNo	String[]	否	仓库编码	["仓库"]
specNo	String[]	否	商家编码	["Sjbm001"]
summaryNo	String[]	否	汇总单号	["HZDHJ0002123"]
refundStage	String	否	退款阶段	售中/售后
salesmanName	String	否	业务员名称	石大哥
authorName	String	否	达人名称	石大哥
goodsBatchNo	String	否	货品批次号	PC001

响应数据

公共响应数据

参数名称	参数类型	是否必选	参数描述	参数示例
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
warehouseNo	String	是	仓库编码	Ck001
warehouseName	String	是	仓库名称	第一个仓库
originalWarehouseNo	String	是	原单仓库编码	Ck001
originalWarehouseName	String	是	原单仓库名称	第一个仓库
businessDate	String	是	退货入库日期	2023-03-21
deliveryDate	String	是	发货日期	2023-03-21
summaryNo	String	是	汇总单号	HZBH0001
summaryMainNo	String	是	汇总主单号	HZBH0001
refundStage	String	是	退款阶段	售中、售后
salesmanName	String	是	业务员名称	石大哥
authorName	String	是	达人名称	石大哥
fenxiaoNick	String	是	分销商昵称	石大哥
goodsNo	String	是	货品编码	Hpbm001
goodsName	String	是	货品名称	第一个商品
goodsBatchNo	String	是	货品批次号	PC001
giftType	String	是	赠品	是/否
defectType	String	是	是否残次品	是/否
erpOrderType	String	是	订单类型	网店销售、线下零售、售后换货、批发业务、保修换新、保修完成、订单补发、供销补发 .. 自定义类型1、自定义类型2、自定义类型3 、自定义类型4、自定义类型5、自定义类型6 、自定义属性7、自定义属性8
returnAmount	String	是	退款金额	1.0000
returnQty	String	是	入库数量	12.0000
costPrice	String	是	总成本	4.0000
shareRefundAmount	String	是	原单发货金额	3.0000
fenxiaoNickNo	String	是	分销商编码	111

请求demo

{
    "businessDate": "2023-12-12",
    "salesmanName": "sss",
    "goodsBatchNo": "ppp",
    "authorName": "aaaa",
    "appId": "fa330697b64a49a9a4f6fe6b7fef57a7",
    "specNo": [
        "PJ00111"
    ],
    "summaryNo": [
        "THRKS691648801956357567111"
    ],
    "shopNo": [
        "010000118011"
    ],
    "refundStage": "售中",
    "warehouseNo": [
        "W8011"
    ],
    "sid": "hjytest41"
}

响应demo

{
    "response": {
        "data": [
            {
                "goodsNo": "A45000000058",
                "salesmanName": "sss",
                "returnQty": "1",
                "costPrice": "10.0",
                "shopName": "shopname4",
                "giftType": "是",
                "specNo": "PJ00111",
                "shareRefundAmount": "10.89",
                "warehouseName": "华东返修仓",
                "originalWarehouseName": "华东返修仓",
                "erpOrderType": "1",
                "warehouseNo": "W8011",
                "originalWarehouseNo": "W8011",
                "businessDate": "2023-12-12",
                "fenxiaoNick": "ffff",
                "goodsBatchNo": "ppp",
                "authorName": "aaaa",
                "defectType": "是",
                "deliveryDate": "2023-11-01",
                "summaryNo": "THRKS691648801956357567111",
                "shopNo": "010000118011",
                "refundStage": "售中",
                "returnAmount": "20.0",
                "fenxiaoNickNo": "111",
                "goodsName": "gggg"
            }
        ],
        "message": "接口调用成功",
        "nextRequestId": "false",
        "resultCode": "200",
        "solution": "",
        "sub_detail": "业务处理成功",
        "sub_resultCode": "SUCCESS"
    }
}