通过该接口可以申请生成面单。
请求参数
请求内容格式为 JSON (Content-Type: application/json) 字符编码 UTF-8.
POST-请求, 请求URL:
测试环境 | https://api.edu.cdek.ru/v2/print/barcodes |
---|---|
正式环境 | https://api.cdek.ru/v2/print/barcodes |
中国的环境 | https://int.cdek-express.cn/v2/print/barcodes |
请求内容
序号 | 属性名称 | 描述 | 类型 | 是否必填的 |
---|---|---|---|---|
1 | orders | 订单列表 |
order[ ] | 是 |
1.1 | order_uuid | 订单唯一只别编码 uuid |
UUID | 是, 提交 cdek_number 的话 |
1.2 | cdek_number | CDEK运单号 | long | 是, 提交 order_uuid 的话 |
2 | copy_count | 份数,默认为1 | integer | 否 |
3 | format | 格式,所可能的值: A4, A5, A6(默认值为 A4) | string(2) | 否 |
请求内容JSON例子
{
"orders": [
{
"order_uuid": '7275asdas034-e12d-4d3d-8472-0b11f75aasd9185b'
}
],
"copy_count": 1,
"format": "A6"
}
返回内容
返回的内容为JSON格式:
序号 | 属性名称 | 描述 | 类型 | 是否必填 |
---|---|---|---|---|
1 | entity | 面单 | entity | 否 |
1.1 | uuid | 面单唯一只别编码 uuid | UUID | 否 |
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() | 是 |
返回内容例子:
{
"entity": {
"uuid": "72753034-c617-46ef-b70a-8f5f520b6be4"
},
"requests": [
{
"request_uuid": "72753034-e836-499d-bee7-e02053498521",
"type": "CREATE",
"state": "ACCEPTED",
"date_time": "2020-03-19T11:25:53+0700",
"errors": [],
"warnings": []
}
]
}