文档中心 > API类目 > 天猫国际API

tmall.hk.clearance.distribution.get (分销供应商获取清关材料)

供销体系下,提供供应商可以直接获取其订单身份证信息的接口,以使其完成清关。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 必须 1460536261312998 订单号
need_image Boolean 可选 false
  • 默认值:false
  • 是否需要身份证图片,不需要可以缩短接口响应时间

    响应参数

    名称 类型 示例值 描述
    result CertifyQueryResult 查询结果对象
    • module
    • ConsigneeCertifyInfo
    • 清关对象
    • └ credential1
    • String
    • url
    • 身份证正面
    • └ credential2
    • String
    • url
    • 身份证反面
    • └ ocr_exp
    • String
    • 20240101
    • 有效期截止时间
    • └ ocr_id
    • String
    • 412921198810201123
    • 身份证号
    • └ ocr_name
    • String
    • 张三
    • 姓名
    • └ order_id
    • Number
    • 1460536261312998
    • 订单号
    • └ type
    • Number
    • 1
    • 证件类型
    • └ err_msg
    • String
    • 错误原因
    • └ err_code
    • String
    • Wrong order_id
    • 错误代码
    • └ success
    • Boolean
    • true
    • success

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallHkClearanceDistributionGetRequest req = new TmallHkClearanceDistributionGetRequest();
    req.setOrderId(1460536261312998L);
    req.setNeedImage(false);
    TmallHkClearanceDistributionGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_hk_clearance_distribution_get_response>
        <result>
            <module>
                <credential1>url</credential1>
                <credential2>url</credential2>
                <ocr_exp>20240101</ocr_exp>
                <ocr_id>412921198810201123</ocr_id>
                <ocr_name>张三</ocr_name>
                <order_id>1460536261312998</order_id>
                <type>1</type>
            </module>
            <err_msg>无</err_msg>
            <err_code>Wrong order_id</err_code>
            <success>true</success>
        </result>
    </tmall_hk_clearance_distribution_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部