3.getBagLabel
服务能力:获取包袋面单 ---->获取大箱标签(含清关条码)
请求地址:host:/getBagLabel
请求方式:POST
Header 请求参数(用于token校验):
参数名 | 示例值 |
---|---|
token | 4e411a926e7a33ca9d04cd1942ac54a2 |
Body 请求参数:
参数名 | 描述 | 是否必填 | 数据类型 | 字段长度 |
---|---|---|---|---|
bagRefNo | 大箱参考号 客户自定义大箱号 |
是 | String | 30 |
productCode | 服务编码 取Product Code的值 |
是 | String | 10 |
请求示例:
{
"bagRefNo":"BOX123456789",
"productCode":"TWYCS-PP"
}
响应:
字段名 | 描述 | 数据类型 |
---|---|---|
success | true 或者 false | Boolean |
code | 200:成功 其他:失败 |
Integer |
message | 请求返回信息 | String |
requestId | 请求ID | String |
data | Object | |
bagRefNo | 大箱参考号 | String |
productCode | 服务编码 | String |
cclBarcodeNo | 并袋海关编码 | String |
labelUrl | 面单url地址,pdf格式 | String |
成功响应示例:
{
"success": true,
"code": 200,
"message": "success",
"requestId": "66b07711c9fff13126",
"data": {
"bagRefNo": "BOX-TEST20240805001",
"productCode": "TWFMART-COD",
"cclBarcodeNo": "0V3GE001",
"labelUrl": "https://openapi.ycs.express/pdf-file/0V3GE001/84181be4-52f7-11ef-94b9-00163e0cad28.pdf"
}
}
错误代码说明:
错误代码 | 错误描述 |
---|---|
1001 | Token验证错误,请检查传入的Token是否正确 |
1002 | 请求参数数据结构错误,请检测后重新传入 |
1003 | 传入参数长度不符合要求 大箱参考号/服务编码不能为空 |
1004 | 接口异常 |
错误示例返回:
{
"success":false,
"code":1001,
"message":"Token验证错误,请检查传入的Token是否正确",
"requestId":"655c00af45b3a785"
}
最后修改时间: 4 个月前