当前位置： API文档

接口说明

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

调用场景

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

请求地址

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

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

wdt.hjy.recon.thrk.detail.query

生产环境

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

请求方式

POST

请求参数

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

hjySign

String

是

慧经营参数签名

e549e097f97123bc7fa3cfc1354796b2

appId

String

是

租户应用标识

b018b1134f854fb48019d47dd424e5f9

sid

String

是

卖家账号

hjy001

nextRequestId

String

否

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

1760506606618202114

startBusinessTime

String

是

退货入库日期，限制不能超过一周

2023-03-21 00:00:00

endBusinessTime

String

是

退货入库日期，限制不能超过一周

2023-03-21 00:00:00

shopNo

String[]

否

店铺编码

["Db001"]

warehouseNo

String[]

否

仓库编码

["仓库"]

specNo

String[]

否

商家编码

["Sjbm001"]

summaryNo

String[]

否

汇总单号

["HZDH202202001"]

omsOrderNo

String[]

否

订单编号，可以批量

["JY20190908228"]

omsStockinNoString[]否入库单号，可以批量["RK20190907229"]
omsRefundNoString[]否退换单号，可以批量["TK20190907229"]
refundStageString否退款阶段售中、售后

platOrderNo

String[]

否

平台订单号，可以批量

["2010293102933124"]

salesmanName  

String否

业务员名称

石大哥

authorNameString否达人名称石大哥

goodsBatchNo  

String

否

货品批次号

PC001

响应数据

公共响应数据

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

warehouseNo

String

是

仓库编码

Ck001

warehouseName

String

是

仓库名称

第一个仓库

originalWarehouseNo

String

是

原单仓库编码

Ck001

originalWarehouseName

String

是

原单仓库名称

第一个仓库

businessTime

String

是

业务日期，退货入库的入库时间

2023-03-21 11:00:19

deliveryTime  

String

是

发货时间

2023-03-21 11:00:19

summaryNo

String

是

汇总单号

HZBH0001

platOrderNo

String

是

平台订单号

20102931029331249023

omsRefundNo

String

是

退款单号

TK20190907229

omsOrderNo

String

是

系统订单号

JY202212312

omsStockinNo

String

是

入库单号

RK20190907229

originalOrderNo

String

是

平台订单号[未处理]

20102931029331249023-1

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

请求demo

{
    "salesmanName": "sss",
    "platOrderNo": [
        "203301293112865139311"
    ],
    "specNo": [
        "PJ00111"
    ],
    "warehouseNo": [
        "W801"
    ],
    "sid": "hjytest41",
    "startBusinessTime": "2023-12-19 00:00:00",
    "omsStockinNo": [
        "RK231219005811"
    ],
    "omsOrderNo": [
        "JY20231215016011"
    ],
    "goodsBatchNo": "石大哥",
    "endBusinessTime": "2023-12-20 00:00:00",
    "authorName": "石大哥",
    "appId": "fa330697b64a49a9a4f6fe6b7fef57a7",
    "omsRefundNo": [
        "TK231216012311"
    ],
    "summaryNo": [
        "THRKS75158071979758971111"
    ],
    "shopNo": [
        "0100001180111"
    ],
    "refundStage": "售中"
}

响应demo

{
    "response": {
        "data": [
            {
                "deliveryTime": "1702627521000",
                "platOrderNo": "203301293112865139311",
                "shopName": "shopname4",
                "specNo": "PJ00111",
                "businessTime": "2023-12-19 14:13:22",
                "shareRefundAmount": "9.9",
                "warehouseName": "售后十分到家不良品仓",
                "originalWarehouseName": "售后十分到家不良品仓",
                "omsRefundNo": "TK231216012311",
                "returnAmount": "1259.0",
                "goodsNo": "A42000000007",
                "salesmanName": "sss",
                "returnQty": "1",
                "costPrice": "10.0",
                "giftType": "否",
                "erpOrderType": "1",
                "warehouseNo": "W801",
                "originalWarehouseNo": "W801",
                "fenxiaoNick": "fff",
                "omsOrderNo": "JY20231215016011",
                "omsStockinNo": "RK231219005811",
                "originalOrderNo": "203301293112865139311-1",
                "goodsBatchNo": "pppp",
                "authorName": "aaa",
                "defectType": "是",
                "summaryNo": "THRKS75158071979758971111",
                "shopNo": "0100001180111",
                "refundStage": "售中",
                "goodsName": "gggg",
                "detailId": "996418660911330583"
            }
        ],
        "message": "接口调用成功",
        "nextRequestId": "false",
        "resultCode": "200",
        "solution": "",
        "sub_detail": "业务处理成功",
        "sub_resultCode": "SUCCESS"
    }
}


常用工具