当前位置: API文档

logistics.php (物流公司)

¥标准   

1.接口说明

1.1 接口描述:批量获取旺店通ERP内物流档案信息
1.2 适用版本:网页版

2.调用场景

2.1 举例说明:自有商城接入ERP、金蝶接入、用友接入、SAP接入等

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/logistics.php
正式环境https://openapi.huice.com/openapi/logistics.php

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。
接口账号appkeyString
本开放平台“自助对接”功能模块内自助申请,申请流程单击这里
时间戳timestampint
北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。
签名signString
API输入参数签名结果,签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度必须描述
物流编号logistics_idvarchar20

代表物流所有属性的唯一编码,用于物流区分

,ERP内支持自定义(ERP物流界面设置),用于获取指定物流数据信息

页号page_noint

页号,不传默认从0页开始
分页大小page_sizeint
每页返回的数据条数


4.响应参数

   4.1 公共响应参数

名称字段类型长度必须描述
错误码codeint
错误码,0成功
错误描述messagevarchar
错误描述
物流档案列表节点logistics_listdata[ ]
物流档案列表节点

   4.2 业务响应参数


  logistics_list

 字段Y类型长度
是否必须描述
logistics_idbigint(20)
物流公司id
logistics_namestring
物流公司名称
logistics_typesmallint(6)
参考枚举中的系统物流公司编码
logisitcs_code

erp物流类型编码物流代码表
modifieddatetime
最后修改时间
createddatetime
创建时间
statustinyint(4)
0 停用 1 启用

5.请求示例

PHP
<?php
	require_once '../WdtClient.php';
	$c = new WdtClient();
	$c->sid = ''; 
	$c->appkey = '';
	$c->appsecret = ''; 
	$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/unique_code_query.php';

	$c->putApiParam('start_time', '2026-01-30 00:00:00');
	$c->putApiParam('end_time', '2026-02-01 00:00:00');
	$c->putApiParam('page_size', '1');
	$c->putApiParam('page_no', '0');
	
	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "total_count": 451,
    "unique_list": [
        {
            "uniqueCodeId": "2729046462829690910",
            "boxId": "0",
            "providerId": null,
            "tradeId": "2729046462590615582",
            "logisticsId": "2778951368499527691",
            "status": 60,
            "unique_code": "0000021763",
            "box_no": null,
            "pick_seq": "0",
            "modify_date": "2026-01-30T17:42:12",
            "provider_no": null,
            "provider_name": null,
            "goods_no": "133233522992",
            "goods_name": "测试测试22",
            "spec_no": "17773392251",
            "spec_name": "测试测试22",
            "sku_img_url": "",
            "api_goods_name": "测试测试22",
            "api_spec_name": "测试测试22",
            "price": "2099.0000",
            "wholesale_price": "0.0000",
            "trade_no": "JY2508140343",
            "trade_time": "2025-07-31T00:00:00",
            "pay_time": "2025-08-11T00:00:00",
            "cs_remark": "",
            "goods_count": 150,
            "shop_id": 332,
            "shop_name": "renmaolin-test",
            "trade_status": 95,
            "logistics_name": "极兔快递111",
            "logistics_no": "333333333333",
            "warehouse_id": "51",
            "warehouse_name": "发货仓"
        }
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 2220,
    "message": "page_size为正整数,请检查page_size是否为有效值"
}




常用工具