文档

测试

批量上传

websocket测试

POST

http://pzhscm.cn/api/logistics/upload.php

接口描述

出口运单，批量上传

请求头

参数名

类型

描述

必填

Content-Type

string

请求头配置参数，示例：application/x-www-form-urlencoded

必填

请求参数

参数名

类型

描述

必填

logistics_upload_request

string

示例：{"key":"123456","list":[{"logisticsNo":"202006031629001234","freight":"0","insuredFee":"0","currency":"142","grossWeight":"0.128","packNo":"1","goodsInfo":"Iphone SE <2020> 128G 星空灰","orderNo":"202006031344561234"}]}

必填

key

string

平台分配给客户的 key，示例：123456

必填

list

array[object]

数据列表

必填

logisticsNo

string

物流企业运单的包裹单号，示例：202006031629001234

必填

freight

number

货物运输费用，示例：0

必填

insuredFee

number

货物保险费用，示例：0

必填

currency

integer

海关标准的参数代码《JGS-20 海关业务代码集》- 货币代码，示例：142

必填

grossWeight

number

毛重，单位千克，示例：0.128

必填

packNo

integer

单个运单下包裹数，示例：1

必填

goodsInfo

number

物流企业可验视的商品信息，示例：Iphone SE <2020> 128G 星空灰

必填

orderNo

string

客户订单编号，示例：202006031344561234

必填

sign

string

签名，详见签名算法，示例：EDFD3722C26BDC2F53E0874BB5CF60A6EF38B1A2D8A3F0633E8EA79E77BCECCC

必填

debug

number

调试，为 1 时仅验证，不处理业务，示例：1

可选

响应参数

参数名

类型

描述

必填

logistics_upload_response

object

数据字典

必填

code

number

状态码，详见公共状态码，示例：20000

必填

msg

string

示例：接口调用成功

必填

sign

string

示例：50BADCA0672906472B3641E6551D22100EEC8974F01E19B6C540CAF511830106

必填

说明 / 示例

## PHP 代码示例 #### 请求示例 ```PHP ... // 待处理数据 $request = [ 'key' => '123456', 'list' => [ [ 'logisticsNo' => '202006031629001234', 'freight' => '0', 'insuredFee' => '0', 'currency' => '142', 'grossWeight' => '0.128', 'packNo' => '1', 'goodsInfo' => 'Iphone SE <2020> 128G 星空灰', 'orderNo' => '202006031344561234', ] ], ]; // 签名 $secret = 'a1b2c3'; $sign_str = urldecode(http_build_query($request)); $sign = strtoupper(hash_hmac('sha256', $sign_str, $secret)); // 上传数据 $data = [ 'logistics_upload_request' => json_encode($request, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE), 'sign' => $sign, 'debug' => 1 ]; $data = http_build_query($data); // 上传 $url = 'http://pzhscm.cn/api/logistics/upload.php'; $options = [ CURLOPT_URL => $url, CURLOPT_HEADER => false, CURLOPT_HTTPHEADER => ['Content-type: application/x-www-form-urlencoded'], CURLOPT_POST => true, CURLOPT_POSTFIELDS => $data, CURLOPT_RETURNTRANSFER => true, ]; $ch = curl_init(); curl_setopt_array($ch, $options); // 同步回执 $response = curl_exec($ch); curl_close($ch); ... ```

上一篇签名算法

nextDoc 批量查询