电子面单下单
POST
/v1/accountOrder/createBmOrder
接口描述
客户需要打印的自定义信息请放到自定义字段，目前支持2个自定义字段：1.自定义区域1：打印拣货信息或者商品信息，例如订单号，商品名称，规格，数量2.自定义区域2：买家或卖家留言信息商品类型 special 字段
| 类型 | 说明 |
|---|---|
| 0 | 文件类 |
| 1 | 电子产品类(包括家用电器) |
| 2 | 办公用品类, 服装鞋帽，箱包类 |
| 3 | 化妆品，美容产品类 |
| 4 | 珠宝，手表，眼镜，贵重饰品类 |
| 5 | 食品，保健药品类 |
| 6 | 工艺品类(包括瓷器，茶具，烹饪用品) |
| 7 | 玩具乐器类 |
| 8 | 其他类 |
| 参数名 | 说明 |
|---|---|
| common | 普通 |
注：order_type可以为空，当order_type为空时，默认值为common| 增值服务类型 | Value | 解释 |
|---|---|---|
| INSURED | value:金额 | 保价 |
| DF | value:金额 | 到付 |
| RETURN | value:1,2（1：签名，2：盖章，3：登记身份证） | 签单返回(需要哪个，选择哪个，接口返回回执单号receiptNo) |
| COD | value:金额 | 代收货款订单类型会变成cod,609号段 注意cod库存 |
| PRI | 无value | 隐私面单 |
| VIR | 无value | 隐私小号 |
| MUL | value:总单量 | 多票同配 |
| CONTACT | 无value | 派前电联 |
pdf_info重点字段说明
1.pdf_info为加密报文时，可以联系开通大客户账号网点配置为不加密 2.部分用户解析pdf_info取三段码困难，可在帮助中心搜索电子面单接口如何取出三段码，参考给出java 示例
| 参数 | 参数说明 |
|---|---|
| position | 一段码 |
| position_no | 二段码和三段码 |
| tp_status | 四段码 |
| package_wdjc | 集包地 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.yundaex.com/openapi-api/v1/accountOrder/createBmOrder' \
--header 'app-key;' \
--header 'sign;' \
--header 'req-time;' \
--header 'Content-Type: application/json' \
--data-raw '{
"appid": "999999",
"partner_id": "201700101001",
"secret": "123456789",
"orders": [
{
"collect_branch": "",
"collection_value": 126.5,
"cus_area1": "",
"cus_area2": "",
"isProtectPrivacy": "",
"items": [
{
"name": "衣服",
"number": 1,
"remark": "袜子"
}
],
"khddh": 2012121715001,
"node_id": "350",
"order_serial_no": 2012121715001,
"order_type": "common",
"platform_source": "",
"receiver": {
"address": "上海市，青浦区，盈港东路 6679 号",
"city": "上海市",
"company": "",
"county": "青浦区",
"mobile": "17601206977",
"name": "李四",
"province": "上海市"
},
"remark": "",
"sender": {
"address": "上海市，青浦区，盈港东路 7766 号",
"city": "上海市",
"company": "",
"county": "青浦区",
"mobile": "17601206977",
"name": "张三",
"province": "上海市"
},
"size": "0.12,0.23,0.11",
"special": 0,
"value": 126.5,
"weight": 0,
"multi_pack": {
"mulpck": "",
"total": 0,
"endmark": 0
},
"markingInfos": [
{
"type": "INSURED",
"markingValue": {
"value": 2100
}
},
{
"type": "DF",
"markingValue": {
"value": 15
}
},
{
"type": "COD",
"markingValue": {
"value": 15
}
},
{
"type": "RETURN",
"markingValue": {
"value": "1,2"
}
},
{
"type": "PRI"
},
{
"type": "VIR"
},
{
"type": "MUL",
"markingValue": {
"value": 10
}
},
{
"type": "CONTACT"
}
]
}
]
}'响应示例响应示例
200 - 成功 - 成功示例1
{
"code": "0000",
"message": "请求成功",
"result": true,
"data": [
{
"order_serial_no": "0000019876576897",
"pdf_info": "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",
"mail_no": "5300010219368",
"status": "1",
"remark": null,
"msg": "订单创建成功"
}
]
}请求参数
Header 参数
app-key
string
开放平台发放
默认值:
{{app-key}}
sign
string
必需
默认值:
{{sign}}
req-time
string
当前时间戳（毫秒）
默认值:
{{$timestamp}}
Body 参数application/json
返回响应
扫码加入交流群修改于 2021-11-10 04:26:26