申请发票

简介

申请多个行程发票。一次请求中包含多个行程的订单号，每张发票包含了其有效的订单号列表（invoiced_orders）。所有的无效发票统一记录在invlid_orders中。接口实现幂等。

服务提供方

享道

接口URL

/openapi/invoice/apply

请求方式

POST

请求频次

单次

请求参数

参数名称	类型	必选	说明
timestamp	long	是	请求时间，Unix Timestamp单位毫秒
title	string	是	发票抬头（最多50个中文字符）
buyer_type	int	是	开票类型，1：个人，2：单位
tax_number	string	否	税号（单位发票必填，个人发票不填；15、18、20位大写字母或者数字）
receive_name	string	否	收件人姓名（最多10个中文字符）
receive_mobile	string	否	收件人手机号（最多13个字符）
receive_email	string	否	收件人邮箱
receive_orders	string	是	享道订单号列表，订单间使用英文逗号（ASCII值0x2C）分割
invoice_type	int	是	发票类型，2：电子
register_address	String	否	注册地址（最多50个中文字符）
register_phone	String	否	注册手机号（最多13个字符）
open_bank	String	否	开户银行（最多60个中文字符）
bank_account	String	否	银行账户号码（最多30个字符）
remark	String	否	备注（最多50个中文字符）
issendtriplist	int	否	是否发送行程单 1:是 其他:否
ext	String	否	调用上下文参数
apply_type	int	否	开票金额计算方式，1: 金额，2: 行程。默认为2
amount	int	否	开票金额，apply_type：1必传(单位：分)

响应参数

参数名称	类型	必有	说明
errCode	int	是	服务响应状态，参见附录5
errMsg	string	是	服务响应状态说明，参见附录5
content	object	是
content.invoices	list	是	发票信息
content.invoices.invoice_id	string	是	发票ID
content.invoices.amount	int	是	发票总金额，单位分
content.invoices.invoiced_orders	list	是	有效发票的享道订单列表
content.invoices.invalid_orders	list	否	无效订单列表

请求事例

请求

curl --request POST \
  --url https://open-sit.saicmobility.com/merchant/v1/openapi/invoice/apply \
  --header 'content-type: application/json' \
  --header 'x-merchantid: open_mer_test' \
  --header 'x-sign: 01d030856649e445b9cb480056876e1b76dcaa5c' \
  --header 'x-signalgorithm: 1' \
  --header 'x-timestamp: 20201022144700' \
  --data '{"appId":"open_app_BwH96b6vfFgBtsaa","buyer_type":1,"invoice_type":2,"is_send_triplist":1,"merchantId":"open_mer_test","receive_email":"test_mail@saicmobility.com","receive_mobile":"11831019090","receive_name":"test_mail","receive_orders":"U4b3y6n9w162a0969a72a94434ba10dc8f3b2badb4","title":"上海赛可出行","timestamp":20201022144700}'

响应

{
  "errCode": 10000,
  "errMsg": "successful",
  "content": {
    "invoices": [
      {
        "invoice_id": "I1857beced2114d27b51b2b4fece6626d",
        "amount": 2700,
        "invoiced_orders": [
          "U4b3y6n9w162a0969a72a94434ba10dc8f3b2badb4"
        ]
      }
    ]
  }
}