当前位置: API文档

接口说明

查询慧经营已结账的售中对账明细数据(仅限于对账结果数据,只有收款无应收数据则无法统计到此接口)。

调用场景

--

请求地址

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

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

wdt.hjy.recon.sztrecondetail.query

生产环境

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

请求方式 

POST

请求参数

参数名称参数类型是否必选参数描述示例
hjySignString是慧经营参数签名e549e097f97123bc7fa3cfc1354796b2
appIdString是租户应用标识b018b1134f854fb48019d47dd424e5f9
sidString是卖家账号hjy001
nextRequestIdString否每页200条,用于分页,查询时返回,下一页查询时传入,返回false,说明查询结束1760506606618202114
periodMarkString否对账标识,与对账周期时间不能同时为空1代表最后一个已结账对账周期,最大为3
startDateString否账期开始日期,需要与账期结束日期一起传2023-03-21
endDateString否账期结束日期,需要与账期开始日期一起传2023-03-21
refundTypeString[]否退款类型["退款不退货","退货退款"]
shopNoString[]否店铺编码["Db001"]
warehouseNoString[]否仓库编码["仓库"]
specNoString[]否商家编码["Sjbm001"]
summaryNoString[]否汇总单号["HZDH202202001"]
recoStatusString[]否对账状态["对账成功","对账失败"]
platOrderNoString[]否平台订单号["2010293102933124"]
sysOrderNoString[]否业务单号["321565489465464"]

响应数据

公共响应数据

参数名称参数类型是否必选参数描述参数示例
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

reconStatus

String

是

对账状态

对账成功/对账失败

warehouseNo

String

是

仓库编码

Ck001

warehouseName

String

是

仓库名称

第一个仓库

businessTime

String

是

业务日期,退款完成时间

2023-03-21 11:00:19

periodStartDate

String

是

账期开始日期

2023-03-21

periodEndDate

String

是

账期结束日期

2023-03-22

deliveryTime  

String

是

发货日期

2023-03-21 10:00:01

returnTime 

String

是

入库日期,对应入库单的实际入库时间

2023-03-21 10:00:01

summaryNo

String

是

汇总单号

HZBH0001

platOrderNo

String

是

平台订单号

20102931029331249023

platSubNo

String

是

平台子订单号

20102931029331249023

sysOrderNo

String

是

系统订单号

JY202212312

originalOrderNo

String

是

平台订单号[未处理]

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

recoTime

String

是

对账时间,对账执行时间

2023-03-21 10:00:01

goodsNo

String

是

货品编码

Hpbm001

goodsName  

String

是

货品名称

第一个商品

giftType  

String

是

赠品

是/否

erpOrderType  

String

是

订单类型

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

refundType

String

是

退款类型

退款不退货、退货退款

refundableAmount

String

是

应退款金额,退款单退款金额

30.0000

refundQty

String

是

退款数量,申请退款数量

4.0000

returnQty

String

是

退货入库数量,实际退货入库数量

3.0000

defectType

String

是

是否残次品

是/否

omsStockinNoString是入库单号RK123
omsOrderNoString是发货系统单号10001
tradeLabelNameString

是

订单标签名称马年大吉

请求DEMO

{
    "sysOrderNo": [
        "TK231112040322"
    ],
    "salesmanName": "石大哥",
    "endDate": "2024-03-31",
    "platOrderNo": [
        "35979733475592523791"
    ],
    "specNo": [
        "PJ0011"
    ],
    "periodMark": "1",
    "warehouseNo": [
        "W801"
    ],
    "sid": "hjytest41",
    "refundType": [
        "退货退款"
    ],
    "appId": "fa330697b64a49a9a4f6fe6b7fef57a7",
    "summaryNo": [
        "SHDZS7944593372854206781"
    ],
    "shopNo": [
        "01000011801"
    ],
    "startDate": "2023-10-01",
    "recoStatus": [
        "对账成功"
    ]
}

响应demo

{
    "response": {
        "data": [
            {
                "recoTime": "2024-05-17 17:59:34",
                "deliveryTime": "2023-11-02 10:12:18",
                "platOrderNo": "35979733475592523791",
                "detailId": "1151255698261254315",
                "shopName": "shopname3",
                "specNo": "PJ0011",
                "businessTime": "2023-11-25 01:39:36",
                "reconStatus": "对账失败",
                "warehouseName": "售后十分到家不良品仓",
                "periodEndDate": "2024-03-31",
                "refundType": "退货退款",
                "returnDate": "2023-11-14 10:17:28",
                "platSubNo": "3597973347562252379",
                "goodsName": "定制款雨伞",
                "goodsNo": "G10050004000",
                "refundableAmount": "20.0",
                "sysOrderNo": "TK231112040322",
                "periodStartDate": "2023-10-01",
                "returnQty": "10",
                "giftType": "是",
                "returnTime": "1699928248000",
                "erpOrderType": "1",
                "warehouseNo": "W801",
                "refundQty": "12",
                "originalOrderNo": "3597973347559252379",
                "authorName": "aaaaa",
                "omsStockinNo": "RK123",
                "omsOrderNo": "10001",
                "summaryNo": "SHDZS7944593372854206781",
                "shopNo": "01000011801"
            }
        ],
        "message": "接口调用成功",
        "nextRequestId": "188370805114259323",
        "resultCode": "200",
        "solution": "",
        "sub_detail": "业务处理成功",
        "sub_resultCode": "SUCCESS"
    }
}




常用工具