2.3 获取地址贴

Owned by tuhao
Last updated: 2024-08-27 by Seven Zhang
1 min read

批量订单创建成功后，等待大约1-3分钟, 下一步是获取面单。

获取面单有两种格式: PDF格式 和 HTML格式

PDF格式是二进制流，可以保存成PDF文件，在不同系统中交换.

HTML格式是可以直接在浏览器中打开的页面，利用浏览器的打印网页功能直接打印.

PDF格式 接口说明

URL

http://<系统域名>/client/Consignment/Get-Label/?id=xxxx

接口功能

获取PDF格式的面单

支持参数格式

URL

开发人员

 

请求方式

GET

发布日期

 

PDF格式 请求参数：

参数

类型

必填

说明

参数

类型

必填

说明

id

STRING

必填

订单ID, 多个订单ID用下划线分隔, 例如 1904210360032233_1904220360050834_1904210360032415

PDF格式 认证方法

在header中加入company_id和api_key, 或者在url中加入company_id和api_key.

PDF格式 返回格式

PDF文件的字节流

PDF格式 注意事项

一次最多返回200张面单 (建议单次100左右, 因为受网络响应时间限制, 请求的越多, 需要的处理时间越长)
多个面单合并成一个pdf, 处理字体比较小的面单时, 容易导致生成的面单打印效果模糊.

 

HTML格式 接口说明

URL

http://<系统域名>/client/Printer/Packing-Slip/?id=xxxx

接口功能

在浏览器中打开HTML格式面单的页面

支持参数格式

URL

开发人员

 

请求方式

GET

发布日期

 

HTML格式 请求参数：

参数

类型

必填

说明

参数

类型

必填

说明

id

STRING

必填

订单ID, 多个订单ID用下划线分隔, 例如 1904210360032233_1904220360050834_1904210360032415

HTML格式 认证方法

在header中加入company_id和api_key, 或者在url中加入company_id和api_key.

HTML格式 返回格式

可在浏览器中打开的HTML页面

HTML格式 注意事项

一次最多返回400张面单 (建议单次100左右, 因为受网络响应时间限制, 请求的越多, 需要的处理时间越长, 浏览器渲染时需要的内存也越多)
响应时间快,每个面单是独立的pdf展示,清晰度不会互相影响
不能存档,每次都要去鸟系统获取. 信赖于浏览器.面单太多浏览器容易卡死