快递发货单打印技术文档

一、发货单接口

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://poll.kuaidi100.com/print/billparcels.do 请求参数：

param数据结构：

settings数据结构：

1.3 请求参数示例

发货单模板示例：

注，发货单模板内容都可以自定义实现，实现规则如下：
1、自定义参数命名格式：#{xxxx}
2、表格标题的设置，右键选择表格属性->标题单元格->第一行
3、表格边框线的显示，右键->表格属性->边框设置为1->间距和边距设置为0

param参数示例：

{
  "tempid": "129906826866200576",
  "siid": "L2204140087",
  "callBackUrl": "http://www.baidu.com/fhd/callback",
  "petName": "kd100",
  "recName": "小百",
  "recPhone": "10086",
  "payTime": "2021-01-15 15:40:55",
  "expressName": "德邦快递",
  "printTime": "2021-01-15 15:41:30",
  "printCount": "1",
  "address": "广东省深圳市南山区金蝶软件园",
  "total": "21",
  "remark": "购物小票作为购物凭证，请妥善保管，您有任何疑问，请咨询服务热线 123456798",
  "img0": {
    "type": "CODE_128",
    "content": "887921256577",
    "width": 350,
    "height": 100
  },
  "tab0": [
    {
      "prodName": "热敏纸",
      "count": "5",
      "specs": "76*130",
      "unitPrice": "30",
      "price": "150"
    },
    {
      "prodName": "热敏纸",
      "count": "10",
      "specs": "100*180",
      "unitPrice": "50",
      "price": "500"
    },
    {
      "prodName": "续打纸",
      "count": "5",
      "specs": "",
      "unitPrice": "40",
      "price": "200"
    },
    {
      "prodName": "云打印机",
      "count": "1",
      "specs": "二代",
      "unitPrice": "499",
      "price": "499"
    }
  ]
}

settings参数示例

{
  "pageWidth": 100,
  "pageHeight": 180,
  "margins": {
    "top": 5,
    "bottom": 5,
    "left": 5,
    "right": 5
  }
}

输出效果如下：

1.4 返回结果

data数据结构

1.5 返回结果示例

{
  "result": true,
  "returnCode": "200",
  "message": "提交成功",
  "data": {
      "taskId":""   // 任务ID
  }
} 

1.6 信息代码含义

二、打印回调接口

打印状态变更是会触发回调，回调后如果没有得到合作方正确返回，会重复回调多2次，即最多回调3次。每次回调间隔30分钟。

2.1 接口格式

提供统一格式的HTTP POST,并返回统一格式JSON数据。 请求报头：Content-Type=application/x-www-form-urlencoded;charset=UTF-8

2.2 请求地址

请求参数：

param数据结构：

2.3 返回结果

2.4 返回结果示例

{
    "result":true,
    "returnCode":"200",
    "message":"成功"
} 

2.5 信息代码含义

其他信息快递100会忽略。