淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
adjust_fee	String	可选	12.11		调价(元)
app_context_param	AppContextParam	可选			客户端信息
└ app_battery String 可选 45 电池用电量 └ device_type String 可选 ios app是android还是ios └ loc_accuracy String 可选 23 小件员-定位时间 └ loc_auth String 可选 true gps-定位权限授予 └ loc_lat String 可选 123.22 小件员-所在的纬度 └ loc_lng String 可选 123.22 小件员-所在的经度 └ loc_open String 可选 true gps-定位是否打开,GPS定位开启 └ loc_succ String 可选 true gps-定位是否成功 └ loc_time Number 可选 123 小件员-定位时间 └ loc_type String 可选 gps 小件员-定位方式 └ pkg_id String 可选 fsdfId 对应包裹侠的包id └ pkg_name String 可选 fsdf.sdf 对应包裹侠的包名 └ sdk_version String 可选 6.0.1 sdk的版本号
append_fee	String	可选	12.11		附加费(元)
execute_user_list	ExecuteUserDto []	可选		最大列表长度：20	账号list
└ execute_user_id Number 可选 0 参数executeUserId └ execute_user_type String 可选 foo 参数executeUserType
goods_height	String	可选	1.1		货品体积:高
goods_length	String	可选	1.3		货品体积:长
goods_weight	String	可选	12.11		商品重量kg.不能为空
goods_width	String	可选	1.2		货品体积:宽
order_insurance_price	String	可选	12.11		保价费(元)
order_insurance_value	String	可选	12.11		声明价(元)
order_price	String	可选	12.11		寄件基础价(元).不能为空
order_total_price	String	可选	12.11		订单总价(元).不能为空
package_fee	String	可选	12.11		包装费(元)
pass_weight_check	Number	可选	1		是否跳过核价重量校验,1跳过,0不跳过
personal_session	String	必须	dsdf324234234324		个人账号sessionCode不能为空
personal_user_id	Number	必须	324234234324		个人账号ID不能为空
task_order_id	Number	必须	1042423423		履行任务单ID不能为空
un_round_goods_weight	Number	可选	11111		小件员称重重量单位克
pay_way	String	可选	asdasd		支付方式
user_pay_code	String	可选	asdasd		支付编码
dpatch_env	String	可选	1231		环境变量
btype	String	可选	上门		订单类型
offline	Number	可选	1		弱网

名称	类型	示例值	描述
data	OperCheckBillResDto		参数data
└ adjust_fee String 2342 调价(分) └ append_fee String 2342 附加费(分) └ continued_heavy_price String 1231 续重费用-分 └ continued_total_heavy String 1231 续重总重量-g └ continued_total_price String 1231 续重总费用-分 └ cp_delivery_fee String 2342 运费(分) └ goods_height String 234 货品体积:高 └ goods_length String 234 货品体积:长 └ goods_weight String 2342 货物总重量-g └ goods_width String 234 货品体积:宽 └ insurance_fee String 2342 保价费(分) └ order_insurance_value String 2342 声明价(分) └ order_total_price String 2342 订单总价(分) └ package_fee String 2342 包装费(分) └ prompt_info String 本单是代扣订单,请勿支付提示文案 └ receiver_address String 浙江省杭州市收件人地址 └ sender_address String 浙江省杭州市寄件人地址 └ start_price String 1231 首重费用-分 └ start_weight String 1231 首重重量-g └ task_status Number 2342 任务状态 └ weigth_exception Boolean 2342 是否重量异常
status_code	String	PARAMS_CANNOT_BE_NULL	错误码
status_message	String	参数不能为空	错误描述
is_success	Boolean	true	是否成功
trace_id	String	0be4314615320739620257888e18e2	鹰眼ID

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoGuoguoFulfilCheckbillRequest req = new CainiaoGuoguoFulfilCheckbillRequest();
req.setAdjustFee("12.11");
CainiaoGuoguoFulfilCheckbillRequest.AppContextParam obj1 = new CainiaoGuoguoFulfilCheckbillRequest.AppContextParam();
obj1.setAppBattery("45");
obj1.setDeviceType("ios");
obj1.setLocAccuracy("23");
obj1.setLocAuth("true");
obj1.setLocLat("123.22");
obj1.setLocLng("123.22");
obj1.setLocOpen("true");
obj1.setLocSucc("true");
obj1.setLocTime(123L);
obj1.setLocType("gps");
obj1.setPkgId("fsdfId");
obj1.setPkgName("fsdf.sdf");
obj1.setSdkVersion("6.0.1");
req.setAppContextParam(obj1);
req.setAppendFee("12.11");
List<CainiaoGuoguoFulfilCheckbillRequest.ExecuteUserDto> list3 = new ArrayList<CainiaoGuoguoFulfilCheckbillRequest.ExecuteUserDto>();
CainiaoGuoguoFulfilCheckbillRequest.ExecuteUserDto obj4 = new CainiaoGuoguoFulfilCheckbillRequest.ExecuteUserDto();
list3.add(obj4);
obj4.setExecuteUserId(0L);
obj4.setExecuteUserType("foo");
req.setExecuteUserList(list3);
req.setGoodsHeight("1.1");
req.setGoodsLength("1.3");
req.setGoodsWeight("12.11");
req.setGoodsWidth("1.2");
req.setOrderInsurancePrice("12.11");
req.setOrderInsuranceValue("12.11");
req.setOrderPrice("12.11");
req.setOrderTotalPrice("12.11");
req.setPackageFee("12.11");
req.setPassWeightCheck(1L);
req.setPersonalSession("dsdf324234234324");
req.setPersonalUserId(324234234324L);
req.setTaskOrderId(1042423423L);
req.setUnRoundGoodsWeight(11111L);
req.setPayWay("asdasd");
req.setUserPayCode("asdasd");
req.setDpatchEnv("1231");
req.setBtype("上门");
req.setOffline(1L);
CainiaoGuoguoFulfilCheckbillResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<cainiao_guoguo_fulfil_checkbill_response>
    <data>
        <adjust_fee>2342</adjust_fee>
        <append_fee>2342</append_fee>
        <continued_heavy_price>1231</continued_heavy_price>
        <continued_total_heavy>1231</continued_total_heavy>
        <continued_total_price>1231</continued_total_price>
        <cp_delivery_fee>2342</cp_delivery_fee>
        <goods_height>234</goods_height>
        <goods_length>234</goods_length>
        <goods_weight>2342</goods_weight>
        <goods_width>234</goods_width>
        <insurance_fee>2342</insurance_fee>
        <order_insurance_value>2342</order_insurance_value>
        <order_total_price>2342</order_total_price>
        <package_fee>2342</package_fee>
        <prompt_info>本单是代扣订单,请勿支付</prompt_info>
        <receiver_address>浙江省杭州市</receiver_address>
        <sender_address>浙江省杭州市</sender_address>
        <start_price>1231</start_price>
        <start_weight>1231</start_weight>
        <task_status>2342</task_status>
        <weigth_exception>2342</weigth_exception>
    </data>
    <status_code>PARAMS_CANNOT_BE_NULL</status_code>
    <status_message>参数不能为空</status_message>
    <is_success>true</is_success>
    <trace_id>0be4314615320739620257888e18e2</trace_id>
</cainiao_guoguo_fulfil_checkbill_response>

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

菜鸟无线API

cainiao.guoguo.fulfil.checkbill (快递员核价接口checkBill)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ