# 获取云打印加密数据(无界电子面单)


接口地址: http://www.damaijia168.com/vv/external/jdpullData


请求方式: POST


传参方式: JSON


返回格式: JSON


# 请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token 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
edition string 版本 默认:1(不传默认为1)
1:1.0,2:2.0

# 请求示例

{
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请求代码示例

# 响应参数

名称 类型 示例值 描述
data object 数据信息
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 响应码
deduct_money int 1 消耗点券
status int 0 状态码,0为成功

# 返回数据

{
"data": {
        "deduct_money":1,
"jingdong_printing_printData_pullData_response": {
        "returnType": {
            "prePrintDatas": [
                {
                    "---": {
                        "msg": "操作成功",
                        "code": "1",
                        "packageCode": "str",
                        "wayBillNo": "0000000",
                        "perPrintData": "9XR7FEUvv/J9BWi"
                    }
                }
            ],
            "code": "1",
            "message": "操作成功",
            "objectId": "1606370979791"
        }
    },
    "status": 0
}
}
  


# 响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权