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

cainiao.global.handover.pdf.get (获取面单PDF文件数据)

返回指定大包面单的PDF文件数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_info UserInfoDto 必须 用户信息
  • └ top_user_key
  • String
  • 可选
  • 123
  • 每个商家在ISV系统的唯一标识,一般为商家ISV账号的id
client String 必须 ISV-xxx 客户端名称,ISV:ISV-ISV英文或拼音名称、商家ERP:SELLER-商家英文或拼音名称
locale String 可选 zh_CN 多语言
handover_content_id Number 必须 70001 大包编号id
type Number 可选 4
  • 默认值:1
  • 打印数据类型,1:面单、4:发货标签、512:交接清单

    响应参数

    名称 类型 示例值 描述
    result HsfResult 请求结果
    • └ success
    • Boolean
    • true
    • 请求处理是否成功
    • └ error_code
    • String
    • P-088-0000-00-99-000
    • 异常码
    • └ error_msg
    • String
    • 系统异常
    • 错误信息
    • └ data
    • String
    • 通过国际订单号获取的body内容用base64转码后生成运单标签的pdf字节流。

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoGlobalHandoverPdfGetRequest req = new CainiaoGlobalHandoverPdfGetRequest();
    CainiaoGlobalHandoverPdfGetRequest.UserInfoDto obj1 = new CainiaoGlobalHandoverPdfGetRequest.UserInfoDto();
    obj1.setTopUserKey("123");
    req.setUserInfo(obj1);
    req.setClient("ISV-xxx");
    req.setLocale("zh_CN");
    req.setHandoverContentId(70001L);
    req.setType(4L);
    CainiaoGlobalHandoverPdfGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_global_handover_pdf_get_response>
        <result>
            <success>true</success>
            <error_code>P-088-0000-00-99-000</error_code>
            <error_msg>系统异常</error_msg>
            <data></data>
        </result>
    </cainiao_global_handover_pdf_get_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-0101-10-10-167 1、传入的大包运单号为空; 2、大包未生成大包运单号.因此打印失败; 1、请检查参数是否正确 2、大包可能还未生成大包运单号,请重新成功获取大包运单号后重试;

    API工具

    如何获得此API

    FAQ

    返回
    顶部