文档中心 > API类目 > 火车票API

taobao.train.agent.express.set (线下票回填物流信息)

线下票回填物流信息服务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
main_order_id Number 必须 1 订单号
express_id String 必须 1 物流单号
addr String 必须 北京 发货地址
mobile String 必须 13900000000 手机号
agent_id Number 必须 123 代理商id
express_name String 可选 SF
  • 默认值:SF
  • 物流公司:SF,EMS

    响应参数

    名称 类型 示例值 描述
    error_msg_code String demo 错误码
    error_msg String demo 错误描述
    extend_params String demo 扩展参数
    is_success Boolean false 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TrainAgentExpressSetRequest req = new TrainAgentExpressSetRequest();
    req.setMainOrderId(1L);
    req.setExpressId("1");
    req.setAddr("北京");
    req.setMobile("13900000000");
    req.setAgentId(123L);
    req.setExpressName("SF");
    TrainAgentExpressSetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <train_agent_express_set_response>
        <error_msg_code>demo</error_msg_code>
        <error_msg>demo</error_msg>
        <extend_params>demo</extend_params>
        <is_success>false</is_success>
    </train_agent_express_set_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>

    错误码解释

    错误码 错误描述 解决方案
    no-expressCode expressCode不支持 快递名称不合法
    no-order-found 未找到订单记录 确认订单号是否正确
    agentId-error 代理商不匹配 确认代理商是否正确
    mobile-error 手机号不能为空 手机号不能为空
    orderType-error 不是线下票订单不能调用发货 订单类型不正确
    status-error 出票失败不能调用发货 确认出票状态是否不能发货
    update db error 更新数据库失败,请重试 数据库更新失败
    isp.service-unavailable 无法获取服务 检查网络
    isv.SYSTEM_ERROR 系统异常 系统异常,请重新调用

    API工具

    如何获得此API

    FAQ

    返回
    顶部