alibaba.damai.mz.b.ticket.state.callback (门店票打印状态回流API)

麦座-门店-票打印状态回流API;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
mz_order_id String 必须 77490100015203 麦座订单号;非空;只传订单号时对订单下所有票进行打印状态回流;若订单存在退票等已作废票,则回流会失败;
operator_id String 必须 12312321 麦座操作员id;必须;由麦座小二提供
ticket_code_no_list String [] 可选 312321,49321321
  • 最大列表长度:999
  • 单票票号List;可空;可对一个订单下选择的一个或多个票进行打印状态回流;

    响应参数

    名称 类型 示例值 描述
    result ResultData api返回结果
    • └ msg
    • String
    • 成功
    • 提示
    • └ code
    • String
    • 200
    • 状态码
    • └ success
    • Boolean
    • true
    • api请求是否成功
    • data
    • TicketPrintState4bVO
    • 返回数据
    • ticket_callback_error_info_list
    • TicketCallbackErrorInfo []
    • 回流失败票单提示
    • └ error_reason
    • String
    • 退票中
    • 单票回流失败原因;
    • └ ticket_code_no
    • String
    • 112331
    • 单票票号
    • └ mz_order_id
    • String
    • 3123213
    • 麦座订单号;

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaDamaiMzBTicketStateCallbackRequest req = new AlibabaDamaiMzBTicketStateCallbackRequest();
    req.setMzOrderId("77490100015203");
    req.setOperatorId("12312321");
    req.setTicketCodeNoList("312321,49321321");
    AlibabaDamaiMzBTicketStateCallbackResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_damai_mz_b_ticket_state_callback_response>
        <result>
            <msg>成功</msg>
            <code>200</code>
            <success>true</success>
            <data>
                <ticket_callback_error_info_list>
                    <ticket_callback_error_info>
                        <error_reason>退票中</error_reason>
                        <ticket_code_no>112331</ticket_code_no>
                    </ticket_callback_error_info>
                </ticket_callback_error_info_list>
                <mz_order_id>3123213</mz_order_id>
            </data>
        </result>
    </alibaba_damai_mz_b_ticket_state_callback_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>

    错误码解释

    错误码 错误描述 解决方案
    40100000 api未知错误 通用系统异常
    40100001 api请求失败 通用业务异常
    40100006 请求必须的参数麦座会员id不能为空 请求必须的参数麦座会员id不能为空
    15010014 请求参数不能为空 请求参数不能为空
    15010017 票数据不存在 票数据不存在

    API工具

    如何获得此API

    FAQ

    返回
    顶部