通过该接口可以获取已经生成好的面单。

下单请求

请求内容格式为 JSON (Content-Type: application/json) 字符编码 UTF-8.

GET-请求， 请求URL:

测试环境 https://api.edu.cdek.ru/v2/print/barcodes/{uuid}
正式环境 https://api.cdek.ru/v2/print/barcodes/{uuid}
中国的环境 https://int.cdek-express.cn/v2/print/barcodes/{uuid}

{uuid} - 申请生成面单请求返回的 entity.uuid
entity.uuid的时效是创建订单的一个小时（60分钟）

返回内容

返回的内容为JSON格式:

序号 属性名称 属性描述 类型 是否必填
1 entity 面单信息 entity нет
1.1 uuid 面单文件唯一识别码 UUID да
1.2 orders 订单列表 order[ ] да
1.2.1 order_uuid 订单唯一识别码 UUID нет
1.2.2 cdek_number CDEK运单号 long нет
1.1.3 copy_count 份数 integer нет
1.1.4 format 面单格式 string(2) нет
1.1.5 url1 PDF面单链接 （仅面单状态READY才有）
格式: https://api.cdek.ru/v2/print/barcodes/{uuid}.pdf		 string() нет
1.1.6 statuses 面单状态 status[ ] да
1.1.6.1 code 状态编码
[

](https://confluence.cdek.ru/pages/viewpage.action?pageId=36967298#id-ПолучениеШКместакзаказу-PrintBarStatuses) | string() | да | | 1.1.6.2 | name | 状态名称 | string() | да | | 1.1.6.3 | date_time | 状态日期已经时间 (格式 yyyy-MM-dd’T’HH:mm:ssZ) | datetime | да | | 1.2 | requests | 订单对应的请求列表 | request[] | 是 | | 1.2.1 | request_uuid | CDEK数据库的请求ID | UUID | 否 | | 1.2.2 | type | 请求类型，所可能的类型：CREATE, UPDATE, DELETE, AUTH, GET | string() | 是 | | 1.2.3 | date_time | 状态日期 (格式为：yyyy-MM-dd’T’HH:mm:ssZ) | datetime | 是 | | 1.2.4 | state | 目前的状态所可能的状态: ACCEPTED, WAITING, SUCCESSFUL, INVALID | string() | 是 | | 1.2.5 | errors | 进行请求中发生的错误列表 | error[] | 否 | | 1.2.5.1 | code | 错误编码 | string() | 是 | | 1.2.5.2 | message | 错误描述 | string() | 是 | | 1.2.6 | warnings | 警告列表 | warning[] | 否 | | 1.2.6.1 | code | 警告编码 | string() | 是 | | 1.2.6.2 | message | 警告描述 | string() | 是 | | 2 | requests | 订单对应的请求列表 | request[] | 是 | | 2.1 | request_uuid | 订单唯一识别码 | UUID | 否 | | 2.2 | type | 请求类型，所可能的类型：CREATE, UPDATE, DELETE, AUTH, GET | string() | 是 | | 2.3 | date_time | 状态日期 (格式为：yyyy-MM-dd’T’HH:mm:ssZ) | datetime | 是 | | 2.4 | state | 目前的状态所可能的状态: ACCEPTED, WAITING, SUCCESSFUL, INVALID | string() | 是 | | 2.5 | errors | 进行请求中发生的错误列表 | error[] | 否 | | 2.5.1 | code | 错误编码 | string() | 是 | | 2.5.2 | message | 错误描述 | string() | 是 | | 2.6 | warnings | 警告列表 | warning[] | 否 | | 2.6.1 | code | 警告编码 | string() | 是 | | 2.6.2 | message | 警告描述 | string() | 是 |

1 为了下载面单文件需要发送GET-请求并且headers中填验证参数

状态编码

编码 名称 描述
ACCEPTED 已接收 生成面单的请求已经成功接收
PROCESSING 生成中 面单PDF文件正在生成中
READY 生成完成 PDF生成结束，可以通过连接下载生成好的面单
REMOVED 已被删除 下载PDF连接已经过期了
INVALID 请求有误 生成面单请求有错误

返回内容例子

  1. {
  2.     "entity": {
  3.         "uuid": "72753034-c617-46ef-b70a-8f5f520b6be4",
  4.         "orders": [
  5.             {
  6.                 "order_uuid": "72753034-bd61-45fc-be66-da4a03ed2ed8"
  7.             }
  8.         ],
  9.         "copy_count": 1,
  10.         "type": "barcode",
  11.         "format": "A4",
  12.         "url": "http://api.cdek.ru/v2/print/barcodes/72753034-c617-46ef-b70a-8f5f520b6be4.pdf",
  13.         "statuses": [
  14.             {
  15.                 "code": "ACCEPTED",
  16.                 "name": "Принят",
  17.                 "date_time": "2020-03-19T11:25:53+0700"
  18.             },
  19.             {
  20.                 "code": "PROCESSING",
  21.                 "name": "Формируется",
  22.                 "date_time": "2020-03-19T11:25:53+0700"
  23.             },
  24.             {
  25.                 "code": "READY",
  26.                 "name": "Сформирован",
  27.                 "date_time": "2020-03-19T11:25:54+0700"
  28.             }
  29.         ]
  30.     },
  31.     "requests": [
  32.         {
  33.             "request_uuid": "72753034-e836-499d-bee7-e02053498521",
  34.             "type": "CREATE",
  35.             "date_time": "2020-03-19T11:25:54+0700",
  36.             "state": "SUCCESSFUL"
  37.         }
  38.     ]
  39. }