文档中心 > API类目 > 天猫新零售

tmall.nr.order.logis.info (区域零售订单获取取件码)

区域零售订单获取取件码,方便商家系统接入,获取取件码打印信息进行打印。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
seller_id Number 必须 123 卖家ID
main_order_ids Number [] 必须 123,1234
  • 最大列表长度:20
  • 主订单号
    channel String 必须 "TB" 来源标识

    响应参数

    名称 类型 示例值 描述
    result NewRetailResult 返回结果实体
    • result_data
    • NrFetchCodeQueryRespDto
    • 返回数据实体
    • nr_fetch_code_d_t_o_list
    • NrFetchCodeDto []
    • 实体信息
    • └ main_order_id
    • Number
    • 主订单号
    • └ consign_company_name
    • String
    • 发货公司名称
    • └ biz_type
    • String
    • 业务标识(fn/cn)
    • └ consign_company_code
    • String
    • 发货公司编码
    • └ printdata
    • String
    • 打印内容
    • └ short_id
    • Number
    • 对货码
    • └ fetch_code
    • String
    • 取件码
    • └ face_sheet_id
    • String
    • 面单号
    • └ tag_no
    • String
    • 菜鸟生成的标签号
    • └ cp_out_id
    • String
    • 物流cp内部的ID号
    • └ receive_phone
    • String
    • 收货人的手机号
    • └ receive_addr
    • String
    • 收货地址
    • └ receive_name
    • String
    • 收货人名称
    • └ send_province
    • String
    • 发货省份
    • └ send_city
    • String
    • 发货城市
    • └ send_addr
    • String
    • 发货详细地址
    • └ write_off_code
    • String
    • 核销码
    • err_msg
    • Errmsg
    • 返回的订单错误信息映射
    • └ key
    • Number
    • 订单号
    • └ value
    • String
    • 错误编码
    • └ error_message
    • String
    • 服务错误信息
    • └ error_code
    • String
    • 服务错误编码
    • └ success_flag
    • Boolean
    • 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallNrOrderLogisInfoRequest req = new TmallNrOrderLogisInfoRequest();
    req.setSellerId(123L);
    req.setMainOrderIds("123,1234");
    req.setChannel("\"TB\"");
    TmallNrOrderLogisInfoResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_nr_order_logis_info_response>
        <result>
            <result_data>
                <nr_fetch_code_d_t_o_list>
                    <nr_fetch_code_dto>
                        <main_order_id></main_order_id>
                        <consign_company_name></consign_company_name>
                        <biz_type></biz_type>
                        <consign_company_code></consign_company_code>
                        <printdata></printdata>
                        <short_id></short_id>
                        <fetch_code></fetch_code>
                        <face_sheet_id></face_sheet_id>
                        <tag_no></tag_no>
                        <cp_out_id></cp_out_id>
                        <receive_phone></receive_phone>
                        <receive_addr></receive_addr>
                        <receive_name></receive_name>
                        <send_province></send_province>
                        <send_city></send_city>
                        <send_addr></send_addr>
                        <write_off_code></write_off_code>
                    </nr_fetch_code_dto>
                </nr_fetch_code_d_t_o_list>
                <err_msg>
                    <key></key>
                    <value></value>
                </err_msg>
            </result_data>
            <error_message></error_message>
            <error_code></error_code>
            <success_flag></success_flag>
        </result>
    </tmall_nr_order_logis_info_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

    返回
    顶部