当前位置： API文档

接口说明

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

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

调用场景

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

请求地址

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

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

wdt.hjy.recon.delivery.details.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
shopNoString[]否店铺编码["Db001"]
warehouseNoString[]否仓库编码["Ck001"]
specNoString[]否商家编码["Sjbm001"]
summaryNoString[]否汇总单号["HZDH202202001"]
recoStatusString[]否对账状态["对账成功","对账失败"]
platOrderNoString[]否平台订单号["2010293102933124"]
salesmanName  String否业务员石大哥

响应数据

公共响应数据

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

业务响应数据：data

参数名称参数类型是否必选参数描述参数示例
detailIdString是明细唯一id1760506606618202114
shopNoString是店铺编码Db001
shopNameString是店铺名称第一个店铺
specNoString是商品编码Sjbm001
recoStatusString是对账状态对账成功/对账失败
warehouseNoString是仓库编码Ck001
warehouseNameString是仓库名称第一个仓库
businessTimeString是业务日期，发货口径对账则为发货日期，收货口径对账则为完成日期2023-03-21 11:00:19
periodStartDateString是账期开始日期2023-03-21
periodEndDateString是账期结束日期2023-03-22
summaryNoString是汇总单号HZBH0001
platOrderNoString是平台订单号20102931029331249023
platSubNoString是平台子订单号20102931029331249023
sysOrderNoString是系统订单号JY202212312
omsStockoutNoString是销售出库单号CK20240506

omsRefundNo

String是退单号TK20240506
originalOrderNoString是平台订单号[未处理]20102931029331249023（对于手工订单/退单，慧经营会默认截取单号后缀，如7198371239874-1，那么截取之后的订单号为7198371239874，此列展示7198371239874-1）
recoTimeString是对账时间，对账执行时间2023-03-21 10:00:01
salesmanNameString是业务员名称石大哥
fenxiaoNickString是分销商昵称石大哥
goodsNoString是货品编码Hpbm001
goodsName  String是货品名称第一个商品
goodsBatchNo  String是货品批次号  PC001
giftType  String是赠品是/否
erpOrderType  String是订单类型网店销售、线下零售、售后换货、批发业务、保修换新、保修完成、订单补发、供销补发 .. 自定义类型1、自定义类型2、自定义类型3 、自定义类型4、自定义类型5、自定义类型6 、自定义属性7、自定义属性8
deliveryAmountString是发货金额30.0000
sqtAmountString是售前退款金额，发货前退款金额0.0000
sztAmountString是售中退款金额，发货后确认收货前退款金额23.0000
szRefundOnlyAmount  String是售中仅退款金额1.0000
szRefundReturnAmount  String是售中退货退款金额  23.0000
adjustAmountString是调整单金额1.0000
collectionAmountString是收款金额，最终账单实际收款金额30.0000
diffAmountString是差异金额，发货金额-售中退款金额+调整单金额-收款金额12.0000
deliveryQtyString是发货数量6.0000
refundQtyString是售中预计退款数量4.0000
returnQtyString是售中退货入库数量3.0000
expectQtyString是实际数量，发货数量-售中退货入库数量2.0000
sharePostAmountString是邮费收入1.0000
authorNameString是达人名称石大哥
signStatusString是签收状态已签收


请求demo

{
    "salesmanName": "石大哥",
    "endDate": "2024-03-31",
    "platOrderNo": [
        "2009607495090063699"
    ],
    "appId": "fa330697b64a49a9a4f6fe6b7fef57a7",
    "specNo": [
        "PJ001"
    ],
    "periodMark": "1",
    "summaryNo": [
        "FHDZS607406862565988372"
    ],
    "shopNo": [
        "01000011801"
    ],
    "startDate": "2023-10-01",
    "warehouseNo": [
        "W80"
    ],
    "recoStatus": [
        "对账成功"
    ],
    "sid": "hjytest41"
}

响应demo

{
    "response": {
        "data": [
            {
                "recoTime": "1709633322000",
                "platOrderNo": "3536483617874832101",
                "deliveryAmount": "1000.0",
                "detailId": "1115607483679493938",
                "sharePostAmount": "9.99",
                "shopName": "shopname3",
                "specNo": "A43000000017",
                "businessTime": "2023-10-08 01:39:36",
                "warehouseName": "售后十分到家不良品仓",
                "periodEndDate": "2023-12-31",
                "szRefundReturnAmount": "4199.0",
                "expectQty": "10",
                "platSubNo": "3536483617875832101",
                "sqtAmount": "88.0",
                "sztAmount": "4199.0",
                "goodsName": "投影仪（G）",
                "goodsNo": "A43000000017",
                "sysOrderNo": "999999999",
                "periodStartDate": "2023-12-31",
                "salesmanName": "石大哥",
                "deliveryQty": "10",
                "collectionAmount": "20.0",
                "returnQty": "1",
                "adjustAmount": "4199.0",
                "diffAmount": "90.0",
                "giftType": "否",
                "erpOrderType": "1",
                "warehouseNo": "CK028",
                "szRefundOnlyAmount": "30.0",
                "refundQty": "21",
                "fenxiaoNick": "aAAAAA",
                "originalOrderNo": "3536483617874832101",
                "goodsBatchNo": "ppppp",
                "authorName": "是主播",
                "summaryNo": "FHDZS780449434425888645",
                "shopNo": "01000011801",
                "recoStatus": "对账成功",
                "omsStockoutNo": "CK20240506",
                "signStatus": "已签收"
            }
        ],
        "message": "接口调用成功",
        "nextRequestId": "false",
        "resultCode": "200",
        "solution": "",
        "sub_detail": "业务处理成功",
        "sub_resultCode": "SUCCESS"
    }
}


常用工具