接口地址: http://api.vv-tool.com/tool/erps/express_search
接口介绍: 获查询面单服务订购及面单使用情况点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费:详询: v:vtupaofu8888 联系运营
频率限制: 10 次/秒
请求头参数
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
shop_id | String | 是 | 店铺 ID |
cp_code | String | 否 | 物流公司 code |
vvtype | int | 否 | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2 |
请求示例
shop_id:123456
cp_code:YTO
请求代码示例
cURL请求代码示例PHP请求代码示例JAVA请求代码示例
响应参数
waybill_apply_subscription_cols | WaybillApplySubscriptionInfo [] | x | CP 网点信息及对应的商家的发货信息 |
branch_account_cols | WaybillBranchAccount[] | x | CP 网点信息及对应的商家的发货信息 |
allocated_quantity | Number | 1 | 已用面单数量 |
branch_code | String | 1232 | 网点 Code |
branch_name | String | 杭州网点 | 网点名称 |
branch_status | Number | 1 | 网点状态 |
cancel_quantity | Number | 23 | 取消的面单总数 |
print_quantity | Number | 12 | 已经打印的面单总数 |
quantity | Number | 32 | 电子面单余额数量 |
shipp_address_cols | AddressDto[] | x | 当前网点下的发货地址 |
detail | String | 文一西路 | 详细地址 |
district | String | 余杭区 | 区名称(三级地址) |
city | String | 杭州市 | 市名称(二级地址) |
province | String | 浙江省 | 省名称(一级地址) |
town | String | 仓前街道 | 街道\镇名称(四级地址) |
service_info_cols | ServiceInfoDto[] | x | 可用的服务信息列表 |
service_name | String | 物流产品类型服务 | 服务名称 |
service_code | String | SVC-ANE56-PRODUCT-TYPE | 服务编码 |
service_attributes | ServiceAttributeDto[] | 服务属性定义 | |
attribute_code | String | value | 属性的值,用户实际传入的值 |
attribute_name | String | 产品类型 | 属性的名称,可以用于前端的展示 |
attribute_type | String | enum | 属性的类型,可能值有 [number, string, enum] |
type_desc | String | {"type":"enum","desc":{"95":"Mini 小包, 重量 <=70KG","23":"定时达, 重量 >70KG","270":"普惠达, 重量 >1000KG","211":"易碎品(标准快运), 重量 >70KG","212":"易碎品(定时达),重量 >70KG","213":"易碎品(mini 小包),重量 <=70KG"}} | 枚举类型的枚举值,key 为用户选中的需要传值的数据,value 为对应的描述,可以作为前端的展示 |
service_desc | String | 安能物流产品类型 | 服务的官方描述,可以用作前端展示 |
required | Boolean | true | 该服务是否为必选服务 |
segment_code | String | NORMAL | 号段信息 |
cp_code | String | ZTO | 物流服务商 ID |
withholding_money | int | 11 | 该接口扣费金额(点券) |
返回数据
{ "code": 0, "msg": "操作成功", "msec": 1460, "time": 1617273033, "data": { "withholding_money": 1, "waybill_apply_subscription_cols":{ "waybill_apply_subscription_info":[ { "branch_account_cols":{ "waybill_branch_account":[ { "allocated_quantity":1, "branch_code":"1232", "branch_name":"杭州网点", "branch_status":1, "cancel_quantity":23, "print_quantity":12, "quantity":32, "shipp_address_cols":{ "address_dto":[ { "detail":"文一西路", "district":"余杭区", "city":"杭州市", "province":"浙江省", "town":"仓前街道" } ] }, "service_info_cols":{ "service_info_dto":[ { "service_name":"物流产品类型服务", "service_code":"SVC-ANE56-PRODUCT-TYPE", "service_attributes":{ "service_attribute_dto":[ { "attribute_code":"value", "attribute_name":"产品类型", "attribute_type":"enum", "type_desc":"{\"type\":\"enum\",\"desc\":{\"95\":\"Mini小包, 重量<=70KG\",\"23\":\"定时达, 重量>70KG\",\"270\":\"普惠达, 重量>1000KG\",\"211\":\"易碎品(标准快运), 重量>70KG\",\"212\":\"易碎品(定时达),重量>70KG\",\"213\":\"易碎品(mini小包),重量<=70KG\"}}" } ] }, "service_desc":"安能物流产品类型", "required":true } ] }, "segment_code":"NORMAL" } ] }, "cp_code":"ZTO", "cp_type":1 } ] } }
响应代码
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |
401 | 身份凭证无效 | 在请求头中添加 access_token,重新更新 token |
404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!