全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

获查询面单服务订购及面单使用情况


接口地址: http://api.vv-tool.com/tool/erps/express_search


接口介绍: 获查询面单服务订购及面单使用情况点击查看详情


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 联系运营


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
shop_id String 店铺 ID
cp_code String 物流公司 code
vvtype int 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2,标准版 3,需要标准版的传 3

请求示例

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 请求路径或请求方式错误 请更换请求方式或者检查路径是否正确