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

taobao.bus.invoice.return (发票回调接口)

汽车票发票回调接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
invoice_param ReceiptDo 必须 入参对象
  • └ agent_id
  • Number
  • 必须
  • 123456
  • 代理商ID
  • └ receipt_date_time
  • Date
  • 必须
  • 2019-11-01 00:00:00
  • 开票时间
  • └ receipt_number
  • String
  • 可选
  • M112323
  • 发票流水号。成功时必填
  • └ receipt_status
  • Number
  • 必须
  • 1
  • 发票状态1成功0失败-1异常
  • └ receipt_url
  • String
  • 可选
  • http://ip:port/test
  • 发票链接.status为1时必填
  • └ fail_reason
  • String
  • 可选
  • sys-error
  • 失败原因.status为0时必填
  • └ fail_code
  • String
  • 可选
  • 系统异常
  • 失败码

响应参数

名称 类型 示例值 描述
result_code String system-error 错误码
result_msg String 系统异常 错误信息
is_success Boolean false 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusInvoiceReturnRequest req = new BusInvoiceReturnRequest();
BusInvoiceReturnRequest.ReceiptDo obj1 = new BusInvoiceReturnRequest.ReceiptDo();
obj1.setAgentId(123456L);
obj1.setReceiptDateTime(StringUtils.parseDateTime("2019-11-01 00:00:00"));
obj1.setReceiptNumber("M112323");
obj1.setReceiptStatus(1L);
obj1.setReceiptUrl("http://ip:port/test");
obj1.setFailReason("sys-error");
obj1.setFailCode("系统异常");
req.setInvoiceParam(obj1);
BusInvoiceReturnResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<bus_invoice_return_response>
    <result_code>system-error</result_code>
    <result_msg>系统异常</result_msg>
    <is_success>false</is_success>
</bus_invoice_return_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

返回
顶部