全部
淘宝
拼多多
抖音
京东
快手
当当
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 未授权店铺 根据返回链接进行扫码授权