淘宝erp、淘宝电子面单云打印接口- v兔电商工具api

淘宝erp、淘宝电子面单云打印接口- v兔电商工具

淘宝erp、淘宝电子面单云打印接口、需要租或者购买淘宝，拼多多，京东，抖音，1688，唯品会等平台的进销存或打单软件的欢迎前来咨询v：vtupaofu8888。v兔祝各位商家大卖！v兔电商工具出品更多干货: http://ask.vv-tool.com/

电子面单云打印接口

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

接口介绍： 电子面单云打印接口点击查看详情

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

请求方式： POST

返回格式： JSON

接口收费：详询： v：vtupaofu8888， 联系运营

频率限制： 10 次/秒

请求头参数

Authorization

string

是

授权 access_token

Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

param_waybill _cloud_print_apply_new_request	WaybillCloudPrintApplyNewRequest	true		入参信息
cp_code	String	true	POSTB	物流公司 Code，长度小于 20
product_code	String	false	目前已经不推荐使用此字段，请不要使用	目前已经不推荐使用此字段，请不要使用
sender	UserInfoDto	true		发货人信息
address	AddressDto	true		发货地址需要通过 search 接口
city	String	false	北京市	城市，长度小于 20
detail	String	true	花家地社区卫生服务站	详细地址，长度小于 256
district	String	false	朝阳区	区，长度小于 20
province	String	true	北京	省，长度小于 20
town	String	false	望京街道	街道，长度小于 30
mobile	String	false	1326443654	手机号码（手机号和固定电话不能同时为空），长度小于 20
name	String	true	Bar	姓名，长度小于 40
phone	String	false	057123222	固定电话（手机号和固定电话不能同时为空），长度小于 20
trade_order_info_dtos	TradeOrderInfoDto[]	true		请求面单信息，数量限制为 10
logistics_services	String	false	如不需要特殊服务，该值为空	物流服务值（详见https://support-cnkuaidi.taobao.com/doc.htm#?docId=106156&docType=1，如无特殊服务请置空）
object_id	String	true	1	请求 ID
order_info	OrderInfoDto	true		订单信息
order_channels_type	String	true	TB	订单渠道平台编码
trade_order_list	String[]	true	1222221	订单号，数量限制 100，订单号（只限传入数字、字母、下划线和中划线，为避免出现冲突，请按电商平台真实订单号传入，请避免使用同个订单号重复取号）
out_trade_order_list	String[]	false	123456,456789	外部电商平台交易单号集合，非必填，数量限制 100
out_trade_sub_order_list	String[]	false	12,34,56,78	外部电商平台交易子单号集合，非必填，数量限制 100
package_info	PackageInfoDto	true		包裹信息
id	String	false	1	包裹 id，用于拆合单场景（只能传入数字、字母和下划线；批量请求时值不得重复，大小写敏感，即 123A,123a 不可当做不同 ID，否则存在一定可能取号失败）
items	Item[]	true		商品信息，数量限制为 100
count	Number	true	1	数量
name	String	true	衣服	名称
volume	Number	false	1	体积，单位 ml
weight	Number	false	1	重量，单位 g
total_packages_count	Number	false	10	子母件模式中的总包裹数/总件数，用于打印当前包裹处于总件数的位置比如 5-2，可以表示总包裹数为 5，当前为第 2 个包裹，只有快运公司需要传入，其他的可以不用传入
packaging_description	String	false	5 纸 3 木 2 拖	大件快运中的包装方式描述
goods_description	String	false	服装	大件快运中的货品描述，比如服装，家具
recipient	RecipientInfoDto	true		收件人信息
address	AddressDto	true		地址
city	String	false	北京市	城市
detail	String	true	花家地社区卫生服务站	详细地址
district	String	false	朝阳区	区
province	String	true	北京	省
town	String	false	望京街道	街道
mobile	String	false	1326443654	手机号码
name	String	true	Bar	姓名
phone	String	false	057123222	固定电话
oaid	String	false	abcdefghijk	淘宝订单收件人 ID (Open Addressee ID)，长度不超过 128 个字符，淘宝订单加密情况用于解密。
tid	String	false	1527014522198024829	电商平台真实交易订单号，针对电商平台订单隐私加密场景使用，非必填，如果填写则必须是电商平台真实的交易订单 ID
caid	String	false	As268woscee	菜鸟解密地址 ID，用于电商平台收件人信息加密的场景使用，非订单加密场景请勿使用。
template_url	String	true	http://cloudprint.cainiao.com/template/standard/101	云打印标准模板 URL（组装云打印结果使用，值格式http://cloudprint.cainiao.com/template/standard/${模板 ID}）
user_id	Number	true	12	使用者 ID（使用电子面单账号的实际商家 ID，如存在一个电子面单账号多个店铺使用时，请传入店铺的商家 ID）
store_code	String	false	553323	仓 code，仓库 WMS 系统对接落地配业务，其它场景请不要使用
resource_code	String	false	DISTRIBUTOR_978324	配送资源 code，仓库 WMS 系统对接落地配业务，其它场景请不要使用
dms_sorting	Boolean	false	false	是否使用智分宝预分拣，仓库 WMS 系统对接落地配业务，其它场景请不要使用
three_pl_timing	Boolean	false	false	订单上是否带 3PLtiming 属性，该属性需要严格与订单上属性保持一致，如果不确定，请使用默认 false。
need_encrypt	Boolean	false	false	设定取号返回的云打印报文是否加密
vvtype	int	false		普通版 1，不传默认 1，增强版 2，增强版的需要传参 2

请求示例

{
"shop_id": "227582782",
"param_waybill_cloud_print_apply_new_request": {
"cp_code": "YTO",
"sender": {
"address": {
"detail": "山东省",
"province": "曹县里面的 302"
},
"name": "大哥"
},
"trade_order_info_dtos": [
{
"object_id": "1655",
"order_info": {
"order_channels_type": "TB",
"trade_order_list": [
"5324151342152412421"
]
},
"package_info": {
"items": [
{
"count": "1",
"name": "大风车这样"
}
]
},
"recipient": {
"address": {
"detail": "牛逼 666",
"province": "河南省"
},
"name": "zNXr6j4AMsdafsadassdsadg"
},
"template_url": "http://cloudprint.cainiao.com/template/standard/101",
"user_id": 12

    }]
}

}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/waybill' \
--header 'Authorization: Bearer 762ac11440e85e21weqrqwtwtrwq' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=6ded377bfo53vo6rbd6mk5l2ea; _csrf=e1edda6cb603e3cfad034b10aab40761e1ef1bacca7becf624004fbfe07c32cfa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%228vE5OSCWl31W9ilB6idHM4-ykPG3q10I%22%3B%7D' \
--data-raw '{
    "shop_id": "227582782",
    "param_waybill_cloud_print_apply_new_request": {
        "cp_code": "YTO",
        "sender": {
            "address": {
                "detail": "山东省",
                "province": "曹县里面的302"
            },
            "name": "大哥"
        },
        "trade_order_info_dtos": [
            {
                "object_id": "1655",
                "order_info": {
                    "order_channels_type": "TB",
                    "trade_order_list": [
                        "5324151342152412421"
                    ]
                },
                "package_info": {
                    "items": [
                        {
                            "count": "1",
                            "name": "大风车这样"
                        }
                    ]
                },
                "recipient": {
                    "address": {
                        "detail": "牛逼666",
                        "province": "河南省"
                    },
                    "name": "~zNXr6j4AMsdafsadassdsadg~"
                },
                "template_url": "http://cloudprint.cainiao.com/template/standard/101",
                "user_id": 12
            
        }]
    }
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/waybill',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "shop_id": "227582782",
    "param_waybill_cloud_print_apply_new_request": {
        "cp_code": "YTO",
        "sender": {
            "address": {
                "detail": "山东省",
                "province": "曹县里面的302"
            },
            "name": "大哥"
        },
        "trade_order_info_dtos": [
            {
                "object_id": "1655",
                "order_info": {
                    "order_channels_type": "TB",
                    "trade_order_list": [
                        "5324151342152412421"
                    ]
                },
                "package_info": {
                    "items": [
                        {
                            "count": "1",
                            "name": "大风车这样"
                        }
                    ]
                },
                "recipient": {
                    "address": {
                        "detail": "牛逼666",
                        "province": "河南省"
                    },
                    "name": "~zNXr6j4AMsdafsadassdsadg~"
                },
                "template_url": "http://cloudprint.cainiao.com/template/standard/101",
                "user_id": 12
            
        }]
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 762ac11440e85e21weqrqwtwtrwq',
    'Content-Type: application/json',
    'Cookie: PHPSESSID=6ded377bfo53vo6rbd6mk5l2ea; _csrf=e1edda6cb603e3cfad034b10aab40761e1ef1bacca7becf624004fbfe07c32cfa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%228vE5OSCWl31W9ilB6idHM4-ykPG3q10I%22%3B%7D'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"shop_id\": \"227582782\",\r\n    \"param_waybill_cloud_print_apply_new_request\": {\r\n        \"cp_code\": \"YTO\",\r\n        \"sender\": {\r\n            \"address\": {\r\n                \"detail\": \"山东省\",\r\n                \"province\": \"曹县里面的302\"\r\n            },\r\n            \"name\": \"大哥\"\r\n        },\r\n        \"trade_order_info_dtos\": [\r\n            {\r\n                \"object_id\": \"1655\",\r\n                \"order_info\": {\r\n                    \"order_channels_type\": \"TB\",\r\n                    \"trade_order_list\": [\r\n                        \"5324151342152412421\"\r\n                    ]\r\n                },\r\n                \"package_info\": {\r\n                    \"items\": [\r\n                        {\r\n                            \"count\": \"1\",\r\n                            \"name\": \"大风车这样\"\r\n                        }\r\n                    ]\r\n                },\r\n                \"recipient\": {\r\n                    \"address\": {\r\n                        \"detail\": \"牛逼666\",\r\n                        \"province\": \"河南省\"\r\n                    },\r\n                    \"name\": \"~zNXr6j4AMsdafsadassdsadg~\"\r\n                },\r\n                \"template_url\": \"http://cloudprint.cainiao.com/template/standard/101\",\r\n                \"user_id\": 12\r\n            \r\n        }]\r\n    }\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/waybill")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 762ac11440e85e21weqrqwtwtrwq")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=6ded377bfo53vo6rbd6mk5l2ea; _csrf=e1edda6cb603e3cfad034b10aab40761e1ef1bacca7becf624004fbfe07c32cfa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%228vE5OSCWl31W9ilB6idHM4-ykPG3q10I%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

modules	WaybillCloudPrintResponse []	xx	系统自动生成
object_id	String	12	请求 id
waybill_code	String	9890000160004	面单号，子母件模式下为子面单号
print_data	String		云打印内容（encryptedData 表示加密结果，data 表示非加密结果）;模板内容，具体解释见链接
parent_waybill_code	String	9890000160004	子母件中的母单号，当为子母件模式时，需要此单号为实际挂载物流详情的单号，需要使用此单号进行发货，查询物流详情，非子母件，此字段为空
withholding_money	int	11	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": 
        {
			 "withholding_money": 1,
            "cainiao_waybill_ii_get_response":{
        "modules":{
            "waybill_cloud_print_response":[
                {
                    "object_id":"12",
                    "waybill_code":"9890000160004",
                    "print_data":"{\\\"data\\\":{\\\"recipient\\\":{\\\"address\\\":{\\\"city\\\":\\\"北京市\\\",\\\"detail\\\":\\\"花家地社区卫生服务站\\\",\\\"district\\\":\\\"朝阳区\\\",\\\"province\\\":\\\"北京\\\",\\\"town\\\":\\\"望京街道\\\"},\\\"mobile\\\":\\\"1326443654\\\",\\\"name\\\":\\\"Bar\\\",\\\"phone\\\":\\\"057123222\\\"},\\\"routingInfo\\\":{\\\"consolidation\\\":{},\\\"origin\\\":{\\\"code\\\":\\\"POSTB\\\"},\\\"sortation\\\":{\\\"name\\\":\\\"杭州\\\"}},\\\"dmsSortingInfo\\\": {\\\"siteAreaCode\\\": \\\"A2\\\"},\\\"sender\\\":{\\\"address\\\":{\\\"city\\\":\\\"北京市\\\",\\\"detail\\\":\\\"花家地社区卫生服务站\\\",\\\"district\\\":\\\"朝阳区\\\",\\\"province\\\":\\\"北京\\\",\\\"town\\\":\\\"望京街道\\\"},\\\"mobile\\\":\\\"1326443654\\\",\\\"name\\\":\\\"Bar\\\",\\\"phone\\\":\\\"057123222\\\"},\\\"shippingOption\\\":{\\\"code\\\":\\\"COD\\\",\\\"services\\\":{\\\"SVC-COD\\\":{\\\"value\\\":\\\"200\\\"}},\\\"title\\\":\\\"代收货款\\\"},\\\"waybillCode\\\":\\\"9890000160004\\\"},\\\"signature\\\":\\\"RSA:hqUkugCY2FFXJK10fRcUE0TsvDppxXuBdOEnPVntF3u4H2yaYiPsPXqjdI1C5oXs60vVCfqd8YC6vZx57TnN9\/u0VYM\/TiFmMtxix9ouPQ2p7G64UyX9BrnRQQCp5ETqJogSzIpxVlz5rx3hy19C+VQrqWgQEw5JqOkoBFXhMi8\\u003d\\\",\\\"templateURL\\\":\\\"http:\/\/cloudprint.cainiao.com\/cloudprint\/template\/getStandardTemplate.json?template_id\\u003d1001\\\"}",
                    "parent_waybill_code":"9890000160004"
                }
            ]
        }
    }
}

响应代码

0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权
401	身份凭证无效	在请求头中添加 access_token，重新更新 token
404	请求路径或请求方式错误	请更换请求方式或者检查路径是否正确
614	生成面单号出现未知异常	重试或联系电子面单技术支持
614	账户余额不足	请联系快递网点充值
614	发货地址没有匹配的电子面单服务	请检查取号时的发货地址是否商家订购的地址，可通过订购关系查询接口获取
614	字段长度超过限制	请参见白皮书字段长度限制
614	必选字段不能为空	请检查代码
614	字段长度超过限制	请参见白皮书字段长度限制
614	物品个数必须大于 0	请检查代码
614	字段长度超过限制	请参见白皮书字段长度限制
614	必选字段不能为空，收件人电话和收件人手机至少要有一个。	请检查代码
614	必选字段不能为空	请检查代码
614	必选字段不能为空	请检查代码
614	商家请求参数非法，同一个交易订单不能申请多个网点的面单	检查参数是否错误，或取消操作
614	必选字段不能为空	请检查代码
614	必选字段不能为空	请检查代码
614	面单订购服务不存在	确认是否已订购，已订购请联系菜鸟排查
614	商家请求参数错误，申请的交易订单和已经存在的交易订单号存在交叉	检查入参是否错误
614	订单号出现重复	检查入参
614	商品名称太长(最长 128)	检查入参的商品名称长度，缩减长度
614	必选字段不能为空	请检查代码
614	模板 URL 格式错误	检查入参的云打印模板 URL 是否合法
614	必选字段不能为空	请检查代码
614	收货地址城市信息过长(最长 20)	检查参数中收货人城市信息长度，缩减长度
614	object id 不能重复	检查入参是否错误
614	商家请求参数非法，交易订单号太长(最长为 40)	检查入参是否错误
614	商家请求参数非法，交易订单号包含非 ASCII 字符	检查参数是否错误
614	收货人姓名长度超过限制(最长 40)	检查参数中收货人姓名长度，缩减长度
614	收货地址省份信息过长(最长 20)	检查参数中收货人省份信息长度，缩减长度
614	找不到服务描述	入参的 product_code 字段请不要传任何值
614	必选字段不能为空	请检查代码
614	收货地址长度太长	请减少收货详细地址长度
614	ERP 订单号/包裹号包含非 ASCII 字符	检查入参
614	必选字段不能为空	请检查代码
614	发件人手机号长度超过限制(最大长度 20)	检查入参中发件人的手机号是否错误
614	模板 URL 错误，需要菜鸟域名	检查入参
614	发件人固话长度超过限制(最长 20)	检查参数中收货人固话长度，缩减长度
614	必选字段不能为空	请检查代码
614	收货地址城镇信息过长(最长 30)	检查参数中收货人城镇信息长度，缩减长度
614	收货地址详细地址信息过长	减少详细地址长度
614	ERP 订单号/包裹号太长	PackageId 长度限制 40 个字符
614	模板 URL 错误，没有找到对应模板 URL	检查入参，确认模板 URL 是否正确
614	请求的面单交易来源信息非法，请只用指定的渠道来源值	查看接入文档中的订单渠道枚举值
614	当前传入的快递公司编号代表的快递公司打印服务暂不开放	检查 cpCode 是否错误，或开通服务
614	物流服务能力值不是有效的 JSON 格式	检查入参
614	必选字段不能为空	请检查代码
614	发件人姓名长度超过限制(最大长度 40)	检查入参的发件人姓名是否超长
614	订单渠道不能为空	请检查代码
614	cpCode, cpId 不能同时为空	检查入参
614	商家没有订购物流服务	访问卖家中心，订购对应的物流服务，并联系对应快递公司网点审核通过。
614	物流服务传值错误	联系对应软件服务商，按照菜鸟接口对接标准透传服务。
614	系统临时错误	稍候重试
614	对应物流服务不允许批量取号	联系软件商修改接口调用方式
614	该订单超出物流商承运范围	联系当地物流承运商
614	无效的 OAID	根据错误消息中的 tid 列表，调用 taobao.trade.fullinfo.get 获取最新的 OAID。错误消息格式类似"参数 oaid 无效，tid:123,456,789"。

作者：v兔链接：http://ask.vv-tool.com 来源：v兔电商知识库著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

发表于 11/10/2021 11:07:07
阅读 ( 732 )
分类：API接口