发票申请

接口说明

  1. 仅支持电子发票
  2. 仅支持按行程(订单)开票(新增按照金额开票需要特殊处理)
  3. 仅支持一年内的订单申请开票
  4. 每张发票行程不超过30个行程
  5. 电子发票单张发票最高不超过10000元(按照金额开票无此限制,扣企业额度)
  6. 仅支持渠道个人用车开发票;企业用车是线下对账开票
  7. 即时用车的高速费、停车费暂不支持开发票;一口价内已经包含高速费、停车费,可以开发票
  8. 发票字段做好限制
  9. 发票抬头:长度不能超过80个字符,不能包含特殊字符,如:∏,¥,§,℅,€,℃,£,℉,№,℡,‰,$,¢,∮,※,?,?,<,>,[,],',&,/r,/n,/t; 不能有空格
  10. 纳税人识别号:
    1. 渠道需要提示用户:非政府部门用户不填纳税人识别号可能无法正常报销(发票抬头是政府机构的没有纳税人识别号)
    2. 位数限制:只能是15、18、20位
    3. 不能有中文
    4. 不能有空格
  11. 发票备注:长度小于80个字

接口地址

https:// <SQYC_DOMAIN>/touch/partner/postInvoiceTravel

请求方式

POST

请求参数

名称 类型 是否必选 说明
invoiceTitle string yes 发票抬头
invoiceContent Integer yes 发票内容:5-客运服务费。
phone string yes 联系电话:是必填的;
orderNo string yes(按订单) 订单号(多个订单将合并成一个发票,逗号分割最大30条)P12345,P12346。
invoiceType Integer yes 2-电子发票
invoiceEmail string yes 邮箱(电子发票为必传),校验:前后不能有空格
taxIDNumber string no 纳税人识别号
invoiceNum Integer no 发票张数,按订单开票可不传,默认为1
perAmount BigDecimal yes(按金额) 发票金额。Ps:按金额开票为必传。按行程开票可不传。
sign string yes 参见sign生成算法
channel string yes 渠道名称,首汽提供
registAddress string no 注册地址(长度小于255个字)
registPhone string no 注册电话(长度小于255个字)
openBank string no 开户银行(长度小于255个字)
bankAccount string no 银行账号(长度小于255个字)
invoiceRemark string no 发票备注(长度小于80个字)
isSendMail Integer no 是否发送邮件(0-发送,1-不发送)
routeInvoice Integer no 1.按金额开票;2、按订单开票, 默认2
requestNo String no routeInvoice=1时(需要按照requestNo幂等)
cpRequestNo String no 高德发票申请幂等请求编号

返回数据

名称 类型 说明
result string 0:成功非0 :失败原因编号
errmsg string 失败原因描述,若成功则值为空
data json 成功时不为空
trackNum string 发票跟踪码

返回示例

{
    "result": "0",
    "errmsg": "SUCCESS",
    "data": {
        "trackNum": "TEC85289B0236B2FF"
    }
}

返回码说明

code 说明
0 成功
1000 开票失败
7001 入参验证失败
7003 失败,部分订单重复申请
7007 申请开票金额小于10
7009 申请开票金额小于等于0
7015 所有订单已存在发票申请
7016 部分订单重复申请
7020 请求流水号已存在发票申请
7021 机构账户不存在
7023 账户可开票额度不足
7024 查询订单开票金额异常
7028 订单开票时间超限
7200 订单可开票金额小于等于0
8001 企业不存在
Copyright © 首约科技(北京)有限公司 2020 all right reserved,powered by Gitbook该文件修订时间: 2024-09-10 08:31:45

results matching ""

    No results matching ""