K5物流软件 API文档
文档首页快件接口（小包/快递）一件代发（仓储）大货中转（仓储）退换标（仓储）设备对接
文档首页快件接口（小包/快递）一件代发（仓储）大货中转（仓储）退换标（仓储）设备对接
  1. K5 API接口
  • API接口文档(K5)
    • 接口说明
    • K5
      • K5 API接口
        • 创建快件订单,仓储订单,快递制单：[createOrder]
          POST
        • 修改快件订单,仓储订单,快递制单：[updateOrder]
          POST
        • 删除快件订单,仓储订单,快递制单：[deleteOrder]
          POST
        • 快递制单取消发货：[cancelDelivery]
          POST
        • 根据公司单号提取转单号：[searchOrderTracknumber]
          POST
        • 查询启用的仓库：[searchStartHouse]
          POST
        • 查询启用渠道：[searchStartChannel]
          POST
        • 查询仓储库存：[ searchStock ]
          POST
        • 查询入仓材积明细
          POST
        • 打印地址标签：[printOrderLabel]
          POST
        • 根据渠道查询支持的打印纸张：[searchPrintPaper]
          POST
        • 查询保险类型：[searchInsuranceType]
          POST
        • 查询价格：[searchPrice]
          POST
        • 查询空运价格：[searchKYPrice]
          POST
        • 查询轨迹：[searchTrack]
          POST
        • 打印订单发票：[printOrderInvoice]
          POST
        • K5 获取快递制单—物流标签接口[getEorderData]
          POST
        • 获取FBA仓库信息：[getFBAHouse]
          POST
        • 查询订单特殊接口[searchOrderXy]
          POST
        • 运单查询收货渠道接口[getRchannel]
          POST
        • 根据单号创建尾程单号 和 尾程面单[pushLastmileOrderNoAndLabel]
          POST
      • K5 仓储API接口-一件代发
        • 创建 SKU：[createProduct]
        • 创建入库单:[createASN]
        • 创建出库单：[createOrder]
        • 一件代发查询入库单:[searchWStorage]
        • 一件代发查询出库：[ searchWSOrder]
        • 一件代发查询库存：[ searchStock ]
        • 一件代发_仓储订单截单：[interceptOrders]
        • 一件代发打印入库单箱唛：[printWStorageBox]
        • 一件代发打印入库单sku标签：[printWStorageSku]
        • 一件代发上传出库标签：[ submitLabel]
      • K5 仓储API接口-大货中转
        • 大货中转创建入库：[ createGStorage]
        • 查询大货中转入库状态：[getGStorageStatus]
        • 大货中转查询入库单:[searchGStorage]
        • 大货中转创建出库：[createGSOrder ]
        • 大货中转查询出库订单：[ searchGSOrder]
        • 大货中转查询库存：[ searchGStock ]
      • K5 仓储API接口-退货换标
        • 退货换标创建入库：[ createSRStorage]
        • 退货换标查询入库：[searchSRStorage]
        • 退货换标创建出库：[createSRSorder]
        • 退货换标查询出库订单：[ searchSRSOrder]
      • K5 仓储API接口-仓储公共 API
        • 查询仓储订单费用：[getAccountsInfo]
        • 查询仓储出库订单信息中转/换标/一件代发:[searchOrders]
    • 设备入仓
      • get
      • post
      • （多台设备） post
  1. K5 API接口

查询订单特殊接口[searchOrderXy]

已测完
POST
http://yqneed.kingtrans.net/PostInterfaceService
特殊接口，查询订单
----增加参数refernumb / billid 2025-06-23

请求参数

Query 参数
method
string 
可选
示例值:
searchOrderXy
Header 参数
Content-Type
string 
可选
默认值:
application/json;charset=UTF-8
Body 参数application/json
token
string 
对应系统配置
必需
startTime
string 
必需
制单开始时间（有单号可不选时间）
endTime
string 
必需
制单结束时间（有单号可不选时间）
refernumb
integer 
必需
客户订单号 与运单号 二选一
billid
integer 
必需
运单号（服务单号）与客户单号二选一
status
integer 
必需
状态码，不填查询所有（除了待检查、已删除）
指定查询0待检查1已确认2待确认3已预报4已收货5已发货6已退货7已删除8缺货
pagination
array [object {2}] 
分页
必需
pageNo
string 
必需
pageSize
string 
必需
示例
{
    "token": "11111111",
    "startTime": "2025-02-14 00:00:00",
    "endTime": "2025-02-17 00:00:00",
    "billid": [
        "YR007416",
        "MY250623718772"
    ],
    "refernumb": [],
    "status": [],
    "pagination": {
        "pageNo": 1,
        "pageSize": 20
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://yqneed.kingtrans.net/PostInterfaceService?method=searchOrderXy' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "token": "11111111",
    "startTime": "2025-02-14 00:00:00",
    "endTime": "2025-02-17 00:00:00",
    "billid": [
        "YR007416",
        "MY250623718772"
    ],
    "refernumb": [],
    "status": [],
    "pagination": {
        "pageNo": 1,
        "pageSize": 20
    }
}'

返回响应

🟢200成功
application/json
Body
statusCode
string 
状态
必需
message
string 
返回说明
必需
totalPage
integer 
页数
必需
count
integer 
条数
必需
data
array [object {70}] 
必需
billdate
string 
运单时间
可选
billid
string 
运单号
可选
billid2
string 
可选
buyerinfojson
string 
可选
channelid
string 
可选
checkdate
string 
可选
checknote
string 
可选
clientid
string 
可选
contaxno
string 
可选
corpbillid
string 
可选
corpid
string 
可选
country
string 
可选
customsid
string 
可选
declatype
string 
可选
dfOrderid
string 
可选
editdate
string 
可选
fbawarehousecode
string 
可选
flag
string 
可选
goodsname
string 
可选
goodsnum
string 
可选
goodstype
string 
可选
housenum
string 
可选
ifinsurance
string 
可选
innote
string 
可选
insuranceamt
string 
可选
isinsur
string 
可选
ismagnetic
string 
可选
isremote
string 
可选
labelbillid
string 
可选
modidate
string 
可选
mweight
string 
可选
note
string 
可选
ordervalidity
string 
可选
packtype
string 
可选
passportid
string 
可选
recaddr
string 
可选
recaddr1
string 
可选
recaddr2
string 
可选
recarea
string 
可选
reccity
string 
可选
reccorp
string 
可选
recemail
string 
可选
recfax
string 
可选
recmobile
string 
可选
recname
string 
可选
recpost
string 
可选
recprovince
string 
可选
rectel
string 
可选
refernumb
string 
可选
reserve4
string 
可选
rweight
string 
可选
sbvalue
string 
可选
senderaddress
string 
可选
sendercity
string 
可选
sendercorp
string 
可选
sendercountry
string 
可选
senderemail
string 
可选
senderfax
string 
可选
sendermoble
string 
可选
sendername
string 
可选
senderpost
string 
可选
senderprovince
string 
可选
sendertel
string 
可选
sendertown
string 
可选
source
string 
可选
tarifftype
string 
可选
vatnumber
string 
可选
volume
string 
可选
weight
string 
可选
items
array [object {19}] 
可选
示例
{
    "statusCode": "success",
    "message": "",
    "totalPage": 1,
    "count": 1,
    "data": [
        {
            "billdate": "2025-02-17 16:56:50",
            "billid": "EYT502140000248732HGW",
            "billid2": "",
            "buyerinfojson": "",
            "channelid": "ups666",
            "checkdate": "1900-01-01 00:00:00",
            "checknote": "",
            "clientid": "test888",
            "contaxno": "",
            "corpbillid": "EYT502140000248732HGW",
            "corpid": "HDH1",
            "country": "US",
            "customsid": "",
            "declatype": "",
            "dfOrderid": "",
            "editdate": "2025-02-14 15:08:52",
            "fbawarehousecode": "",
            "flag": "4",
            "goodsname": "玩具*1\n手机*1\n",
            "goodsnum": "1",
            "goodstype": "WPX",
            "housenum": "RecNum",
            "ifinsurance": "0",
            "innote": "",
            "insuranceamt": "0.00",
            "isinsur": "1",
            "ismagnetic": "0",
            "isremote": "",
            "labelbillid": "",
            "modidate": "2025-02-17 16:56:50",
            "mweight": "0.00",
            "note": "newlable",
            "ordervalidity": "1900-01-01 00:00:00",
            "packtype": "8009",
            "passportid": "",
            "recaddr": "170 Sisson Ave\r\nBidg. # 3. Apt 503\r\nstring\r\nCT",
            "recaddr1": "170 Sisson Ave\r",
            "recaddr2": "Bidg. # 3. Apt 503\r",
            "recarea": "Lvivska",
            "reccity": "string\r",
            "reccorp": "test",
            "recemail": "",
            "recfax": "",
            "recmobile": "07123456789",
            "recname": "Shumilo Ihor",
            "recpost": "06106",
            "recprovince": "CT",
            "rectel": "380934504647",
            "refernumb": "EYT502140000248732HGW",
            "reserve4": "0",
            "rweight": "0.00",
            "sbvalue": "32",
            "senderaddress": "3740 S MORGAN ST",
            "sendercity": "Los Angeles",
            "sendercorp": "Test",
            "sendercountry": "US",
            "senderemail": "user@example.com",
            "senderfax": "",
            "sendermoble": "01234567890",
            "sendername": "Example Corp",
            "senderpost": "60609",
            "senderprovince": "LA",
            "sendertel": "38163810217",
            "sendertown": "US",
            "source": "Copy",
            "tarifftype": "",
            "vatnumber": "",
            "volume": "[{\"num\":\"1\",\"weight\":\"1.8\",\"log\":\"3\",\"width\":\"4\",\"height\":\"5\"}]",
            "weight": "20.000",
            "items": [
                {
                    "cont": "手机",
                    "customs": "MF-YSSQ",
                    "peihuo": "",
                    "value": "10",
                    "num": "1",
                    "prodno": "8507809098",
                    "phnote": "",
                    "unit": "PCS",
                    "sbprice": "10",
                    "sku": "",
                    "money": "USD",
                    "itemweight": "1.000",
                    "imgurl": " ",
                    "texture": "AES",
                    "application": "PLAY",
                    "transactionurl": " ",
                    "brand": "",
                    "model": "",
                    "origin": ""
                },
                {
                    "cont": "玩具",
                    "customs": "MF-YSSQ",
                    "peihuo": "",
                    "value": "22",
                    "num": "1",
                    "prodno": "8507809090",
                    "phnote": "",
                    "unit": "PCS",
                    "sbprice": "22",
                    "sku": "",
                    "money": "USD",
                    "itemweight": "0.500",
                    "imgurl": " ",
                    "texture": "AES",
                    "application": "PLAY",
                    "transactionurl": " ",
                    "brand": "",
                    "model": "",
                    "origin": ""
                }
            ]
        }
    ]
}
修改于 2025-06-23 07:01:41
上一页
获取FBA仓库信息：[getFBAHouse]
下一页
运单查询收货渠道接口[getRchannel]
Built with