文档中心 > API类目 > 全球速卖通-物流管理

cainiao.global.handover.content.query (查询大包详情)

查询大包详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_info UserInfoDto 必须 用户信息
  • └ top_user_key
  • String
  • 可选
  • 123
  • 每个商家在ISV系统的唯一标识,一般为商家ISV账号的id
order_code String 可选 LP0001 交接物物流订单编码,和交接物运单号参数可以任选其一即可
tracking_number String 可选 CNxxxxxHK 交接物运单号,和交接物物流订单编码参数任选其一即可
client String 必须 ISV-xxx 客户端名称,ISV:ISV-ISV英文或拼音名称、商家ERP:SELLER-商家英文或拼音名称
locale String 可选 zh_CN 多语言

响应参数

名称 类型 示例值 描述
result HsfResult 请求响应
  • └ success
  • Boolean
  • true
  • 请求结果
  • └ error_code
  • String
  • P-088-0000-00-99-001
  • 错误码
  • └ error_msg
  • String
  • 系统异常
  • 错误描述
  • data
  • OpenHandoverContentDetailResponse
  • 大包详情
  • └ order_code
  • String
  • LP0001
  • 交接物物流订单编号
  • └ tracking_number
  • String
  • CNxxxxxHK
  • 交接物运单号
  • └ status
  • String
  • created
  • 交接物状态
  • parcel_order_list
  • OpenParcelOrderDto []
  • 大包关联的小包列表
  • └ order_code
  • String
  • LP00003
  • 小包物流订单编码
  • └ status
  • String
  • normal
  • 小包状态code
  • └ exception_code
  • String
  • less_goods
  • 小包异常码
  • └ status_name
  • String
  • Normal
  • 小包状态名称
  • └ estimate_weight
  • String
  • 1000
  • 预估重量
  • └ actual_weight
  • String
  • 1100
  • 实际重量
  • └ weight_unit
  • String
  • g
  • 重量单位
  • └ estimate_fee
  • String
  • 1000
  • 预估费用
  • └ actual_fee
  • String
  • 1000
  • 实际费用
  • └ fee_currency
  • String
  • CNY
  • 费用币种
  • └ fee_unit
  • String
  • cent
  • 费用单位
  • └ status_name
  • String
  • Created
  • 交接物状态
  • └ handover_order_status
  • String
  • committed
  • 交接物关联的交接单状态code
  • └ handover_order_status_name
  • String
  • Committed
  • 交接物关联的交接单状态名称

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoGlobalHandoverContentQueryRequest req = new CainiaoGlobalHandoverContentQueryRequest();
CainiaoGlobalHandoverContentQueryRequest.UserInfoDto obj1 = new CainiaoGlobalHandoverContentQueryRequest.UserInfoDto();
obj1.setTopUserKey("123");
req.setUserInfo(obj1);
req.setOrderCode("LP0001");
req.setTrackingNumber("CNxxxxxHK");
req.setClient("ISV-xxx");
req.setLocale("zh_CN");
CainiaoGlobalHandoverContentQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_global_handover_content_query_response>
    <result>
        <success>true</success>
        <error_code>P-088-0000-00-99-001</error_code>
        <error_msg>系统异常</error_msg>
        <data>
            <order_code>LP0001</order_code>
            <tracking_number>CNxxxxxHK</tracking_number>
            <status>created</status>
            <parcel_order_list>
                <open_parcel_order_dto>
                    <order_code>LP00003</order_code>
                    <status>normal</status>
                    <exception_code>less_goods</exception_code>
                    <status_name>Normal</status_name>
                </open_parcel_order_dto>
            </parcel_order_list>
            <estimate_weight>1000</estimate_weight>
            <actual_weight>1100</actual_weight>
            <weight_unit>g</weight_unit>
            <estimate_fee>1000</estimate_fee>
            <actual_fee>1000</actual_fee>
            <fee_currency>CNY</fee_currency>
            <fee_unit>cent</fee_unit>
            <status_name>Created</status_name>
            <handover_order_status>committed</handover_order_status>
            <handover_order_status_name>Committed</handover_order_status_name>
        </data>
    </result>
</cainiao_global_handover_content_query_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>

错误码解释

错误码 错误描述 解决方案
P-088-0000-00-15-038 参数中交接单号和大包运单号都为空 填写交接单号和大包运单号中的其中一个后重试
P-088-0101-10-10-136 未找到对应的大包 请确认入参是否正确

API工具

如何获得此API

FAQ

返回
顶部