Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

PDF方式打印:

认证方法

在header中加入company_id和api_key,
或者再url中加入company_id和api_key.
两种获取面单方法比较
ps: chrome下测试,pdf版,可导出200个左右.数量再往上的话,稳定性差, 容易出现各种内存报错和网络超时报错.

PDF

PDF文件
200左右 (建议单次100左右, 因为受 网络响应时间 限制, 请求的越多, 需要的处理时间越长)
单个文件,便于存档以及在不同系统之间传递
多个面单合并成一个pdf, 处理字体比较小的面单时, 容易导致生成的面单打印效果模糊.

...

批量订单创建成功后,等待大约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

基本信息

  • 接口状态: 开发中

  • 接口URL: chrome-extension://ibllepbpahcoppkjjllbabhnigcbffpi/https://branch.birdsystem.com/client/Consignment/Get-Label/2107060360039209_2107060360039209

  • 请求方式: GET

  • Content-Type: multipart/form-data

HTML方式打印:

PDF格式 认证方法

在header中加入company_id和api_key,
或者再url中加入company或者在url中加入company_id和api_key.两种获取面单方法比较
ps: chrome下测试, html版可显示400多个.( apache 限制url长度是8192, 所以折算约450个id). 但是此时浏览器打印预览已经很卡了, 需要三四分钟才响应出来.

一. HTML

...

PDF格式 返回格式

PDF文件的字节流

PDF格式 注意事项

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

HTML格式 接口说明

URL

http://<系统域名>/client/Printer/Packing-Slip/

...

?

...

基本信息

  • 接口状态: 开发中

  • 接口URL: http://branch.birdsystem.com/client/Printer/Agent-Direct-Consignment-Address-Label/?id=2107060360039209_07060360039209

  • 请求方式: GET

  • Content-Type: multipart/form-data

请求参数

Header参数及说明

Query参数及说明

参数名

示例值

参数类型

是否必填

参数描述

id

2107060360039209_07060360039209

String

填写需要打印标签的订单ID,多个订单ID用”_"分隔开

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展示,清晰度不会互相影响
不能存档,每次都要去鸟系统获取. 信赖于浏览器.面单太多浏览器容易卡死