taobao.life.booking.trade.deliver.notice (订单发货通知)

1、商户出票成功后,通过该结果通知我方 2、根据接口内当出票结果对应当修改我方订单为【待消费】or【已退款】 3、每个订单只能通知一种结果,如果处理了前一个请求,后一个请求回归报错 4、若我方确认成功,会返回成功结果,若出现【TRADE_HAS_REFUND】请合作方作废凭证,其他异常可再次重试

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
trade_no String 必须 132131 订单号
deliver_result String 必须 SUCCESS 出票结果
vouchers String [] 可选 ["1232","q231"]
  • 最大列表长度:999
  • 门票凭证码集合
    out_order_no String 可选 12321 外部订单号
    voucher_urls String [] 可选 ["http://www.taobao.com/1.png","http://www.taobao.com/2.png"]
  • 最大列表长度:999
  • 门票凭证码url集合
    ticket_count Number 必须 1 票数量
    voucher_type String 必须 1 凭证码类型:0为不需要码核销,1为需要码核销。 0时可以不用传vouchers,后续核销也直接按照数量进行核销 1时必须传vouchers,后续核销请按照码进行核销(目前只有整单核,一个码核了会全部订单都核销)

    响应参数

    名称 类型 示例值 描述
    result Result 接口返回model
    • └ trace_id
    • String
    • 12321
    • traceId
    • └ success
    • Boolean
    • false
    • 是否成功
    • error
    • TribeError
    • 错误
    • └ view
    • String
    • 系统错误
    • 错误可读性描述
    • └ code
    • String
    • SYSTEM_ERROR
    • 错误代码
    • └ message
    • String
    • 系统错误
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    LifeBookingTradeDeliverNoticeRequest req = new LifeBookingTradeDeliverNoticeRequest();
    req.setTradeNo("132131");
    req.setDeliverResult("SUCCESS");
    req.setVouchers(""1232","q231"");
    req.setOutOrderNo("12321");
    req.setVoucherUrls(""http://www.taobao.com/1.png","http://www.taobao.com/2.png"");
    req.setTicketCount(1L);
    req.setVoucherType("1");
    LifeBookingTradeDeliverNoticeResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <life_booking_trade_deliver_notice_response>
        <result>
            <trace_id>12321</trace_id>
            <success>false</success>
            <error>
                <view>系统错误</view>
                <code>SYSTEM_ERROR</code>
                <message>系统错误</message>
            </error>
        </result>
    </life_booking_trade_deliver_notice_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

    返回
    顶部