全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
获取云打印加密数据(无界电子面单)
接口地址: http://api.vv-tool.com/tool/erps/jdpullData
接口介绍: 获取京配打印数据
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 请求次数收费,联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
owner_id | String | 是 | 店铺 ownerId | |
vvtype | int | 否 | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2 | |
param1 | com.jd.jcloud.wms.printing.dto.PullDataReqDTO | 是 | 参数描述 | |
objectId | String | 是 | 1606370979791 | 每次请求唯一,本次获取打印数据请求 ID,长度不超过 20 位 |
parameters | java.util.Map | 是 | 参数,key 有文档规范。电子面单商家编码:ewCustomerCode(String)(青龙业主号),商城商家编码:eCustomerCode(String) | |
key1 | String | 是 | ewCustomerCode | map 的 key |
value1 | String | 是 | 1111111 | map 的 value |
wayBillInfos | java.util.List | 是 | 运单信息列表 最多支持 10 条 | |
--- | com.jd.jcloud.wms.printing.dto.WayBillInfo | 是 | ||
orderNo | String | 否 | 00000 | 商城订单号 |
popFlag | Number | 是 | 1 | 是否 pop 订单,1:pop 订单;不填或者 0:非 pop 订单 |
wayBillCode | String | 否 | 0000000 | 运单号 |
jdWayBillCode | String | 是 | 0000000 | 京东运单号 |
cpCode | String | 是 | JD | 物流公司编码。京东快递:JD |
请求示例
{
param1 参数请求示例:
注: wayBillInfos最多支持10条数据(京东官方限制)
{
"cpCode": "ZGYZZHDD", //物流公司编码 详见本页CpCode物流公司编码
"objectId": "637600348960030784", //动态生成唯一识别号 举例:时间戳精确到毫秒 建议别超过20位
"parameters": {
"eCustomerCode": "624092" //VenderId 授权推送或拉取店铺Id接口得到
},
"wayBillInfos": [ //取号数组对象
{
"wayBillCode": "YT3162078214834", //快递单号
"popFlag": 1, //是否pop订单,1:pop订单;不填或者0:非pop订单 默认填1
"orderNo": "201580321722" //订单号
}
]
}
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
returnType | com.jd.jcloud.wms.printing.dto.PullDataRespDTO | 参数描述 | |
message | String | 操作成功 | 响应信息 |
prePrintDatas | java.util.List | 打印数据密文列表 | |
--- | com.jd.jcloud.wms.printing.dto.PrePrintDataInfo | ||
wayBillNo | String | 0000000 | 运单号 |
code | String | 1 | 单个运单查询结果 |
msg | String | 操作成功 | 单个运单查询响应信息 |
perPrintData | String | 9XR7FEUvv/J9BWi | 加密的运单数据,如果 code 不为成功,则没有该字段 |
packageCode | String | str | 包裹号 |
objectId | String | 1606370979791 | 源传入本次打印数据请求 ID |
code | String | 1 | 响应码 |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"withholding_money":4,
"jingdong_printing_printData_pullData_response": {
"returnType": {
"prePrintDatas": [
{
"---": {
"msg": "操作成功",
"code": "1",
"packageCode": "str",
"wayBillNo": "0000000",
"perPrintData": "9XR7FEUvv/J9BWi"
}
}
],
"code": "1",
"message": "操作成功",
"objectId": "1606370979791"
}
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |