文档中心 > API类目 > 菜鸟无线API

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

checkBill

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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工具

    如何获得此API

    FAQ

    返回
    顶部