发票类型

说明

发票类型中，具有一个特殊字段invoiceInfo，该字段中是一个对象，该对象的数据结构类型需要根据发票类型invoiceType字段来确定。详情可以参考文档发票识别信息说明。

请求参数

参数说明

字段名称	字段类型	是否必填	字段说明
code	String(100)	是	发票编码，唯一标识
invoiceUrl	String(300)	否	发票链接
invoiceFileName	String(150)	否	发票文件名称
validateStatusDesc	String(50)	是	验真状态，未验证 NOT_VALIDATION, 已验证 VALIDATED, 验证失败 VALIDATION_FAILED
invoiceType	String(50)	是	发票类型，不同发票类型识票信息不同
taxRate	number	是	税率
approvedTaxAmount	AmountInput	是	核准税额
approvedDeductionAmount	AmountInput	是	核准抵扣税额
modify	boolean	否	是否修改
invoiceInfo	Json	是	识票信息

参数样例

[
  {
    "code": "CODE001",
    "invoiceUrl": "xxxx",
    "invoiceFileName": "xxxx.png",
    "validateStatusDesc": "xxx",
    "taxRate": "0.10",
    "approvedTaxAmount": "10",
    "approvedDeductionAmount": "10",
    "invoiceType": "xxx",
    "invoiceInfo": {
      //发票识票信息
    }
  }
]

invoiceInfo参数样例

{
  "supplierName": "xx销售公司（销售方名称）",
  "supplierAddress": "浙江省杭州市余杭区XXXXX（销售方地址）",
  "totalPriceAmount": 45.28,
  "invoiceNumber": "xx34302840xx（发票号码）",
  "totalPriceAndTax": 48,
  "buyerName": "每刻科技（购买方名称）",
  "issueDate": "2019年08月242日",
  "totalTaxAmount": 2.72,
  "invoiceCode": "xxx123214123xx（发票代码）",
  "items": [
    {
      "name": "餐饮服务*拿铁",
      "priceAmount": 22.64,
      "taxRate": 0.06,
      "taxAmount": 1.36,
      "unitPrice": 22.640000,
      "num": 1.000000,
      "taxRateMark": ""
    },
    {
      "name": "餐饮服务*摩卡",
      "priceAmount": 22.64,
      "taxRate": 0.06,
      "taxAmount": 1.36,
      "unitPrice": 22.640000,
      "num": 1.000000
    }
  ],
  "taxItems": [
    {
      "detailAmount": 22.64,
      "unTaxAmount": 22.64,
      "taxRate": 0.06,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 1.36,
      "transferOut": false
    }
  ],
  "buyerTaxNumber": "TX213213214324（购买方税号）",
  "checkCode": "xxx123213xx（发票验证码）",
  "invoiceOriginalInfo": {
    "2.jpg": "https://oss-ng-accelerate.maycur.com/458c7605-40c3-4b2e-9f9a-e77ee473c5c8.jpg?Expires=1724054653&OSSAccessKeyId=LTAI4GFjSbZ82hyPuwCBC9Sg&Signature=DJ1PkXFeUbBzZ0kNBrMWQ8Ox7i0%3D&x-oss-process=image%2Fresize%2Cw_1876%2Ch_1239%2Fcrop%2Cx_1%2Cy_11%2Cw_1875%2Ch_1228%2Frotate%2C360%2Fauto-orient%2C0"
  }
}

invoiceInfo 发票识票信息

参数名	类型	备注
supplierName	String	销方名称
supplierAddress	String	销方地址+电话
supplierAccount	String	销方账户(销方开户行+账户）非增值税发票和未验真的发票：该字段内容为空字符串
totalPriceAmount	String	不含税金额
supplierTaxNumber	String	销方税号
buyerName	String	购方名称
buyerTaxNumber	String	购方税号
invoiceCode	String	发票代码
invoiceNumber	String	发票号码
issueDate	String	开票日期
issueDateDesc	String	开票日期格式化
checkCode	String	校验码
taxItems	List	抵扣税额合计
taxRate	String	税率
ticketData	json	发票的一些相关信息，见下表
buyerAccount	String	购方账户(购方开户行+账户）非增值税发票和未验真的发票：该字段内容为空字符串
totalPriceAndTax	String	价税合计
totalTaxAmount	String	税额
items	List	货物明细，详细信息见下表
buyerAddressPhone	String	购方地址和电话

taxItemsDto抵扣税额合计

参数名	类型	备注
detailAmount	BigDecimal	明细金额
taxRate	BigDecimal	税率
approvedDeductionAmount	BigDecimal	抵扣税额
approvedTaxAmount	BigDecimal	税额
transferOut	boolean	是否转出
unTaxAmount	BigDecimal	未税金额

itemDto货物明细

参数名	类型	备注
name	String	货物名称
priceAmount	BigDecimal	金额
taxRate	BigDecimal	税率
taxAmount	BigDecimal	税额
num	float	数量
specificationModel	String	规格型号
unit	String	单位
unitPrice	BigDecimal	单价
taxRateMark	String	税率标记
taxRateMarkDesc	String	税率标记描述

各种发票格式说明（部分发票特殊说明）

1. 纸质发票或电子发票：

以下发票类型ticketData为空

发票类型编码	发票类型名称
VAT_PAPER	增值税普通发票(纸质)
VAT_ELECTRONIC	增值税普通发票(电子)
SPECIAL_VAT_PAPER	增值税专用发票(纸质)
SPECIAL_VAT_ELECTRONIC	增值税专用发票(电子)
QUOTA_PAPER	定额发票)
OTHER	其他发票
RECEIPT_PAPER	小票
TOLLS_VAT	增值税通行费发票
SHIPMENT_VAT	增值税电子普票(运输服务)
MACHINE_PAPER	机打发票
VAT_PAPER_VOLUME	增值税普通发票（卷票）
BLOCK	区块链发票
MACHINE_PAPER_ELECTRONIC	机打电子发票
MEDICAL_ELECTRONIC	财政发票-医疗（电子）
MEDICAL_PAPER	财政发票-医疗（纸质）
ELECTRONIC_SPECIAL_VAT_INVOICE	电子发票（增值税专用发票）
ELECTRONIC_VAT_INVOICE	电子发票（普通发票）
ELECTRONIC_SHIPMENT_VAT_INVOICE	(电子发票（普通发票）（客运服务）

2. PASSENGER_PAPER 客运汽车票

{
  "code": "6300161320",
  "number": "15064112",
  "time": "2017年11月21日 21:53",
  "departureStation": "杭州",
  "arrivalStation": "金华",
  "total": "74.00",
  "name": "张三",
  "kind": "交通",
  "taxItems": [
    {
      "detailAmount": 22.64,
      "unTaxAmount": 22.58,
      "taxRate": 0.06,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 1.36,
      "transferOut": false
    }
  ]
}

参数说明

参数名	类型	备注
code	String	发票代码
number	String	发票号码
time	String	时间
departureStation	String	出发车站
arrivalStation	String	达到车站
total	String	总金额
name	String	姓名
kind	String	发票消费类型
taxItems	String	抵扣税额明细，见taxItemsDto

3. TRAIN_PAPER 火车票

{
  "number": "Z125C004574",
  "time": "2017年11月21日 21:53",
  "name": "张三",
  "departureStation": "珠海",
  "arrivalStation": "深圳北",
  "trainNumber": "G7383",
  "seatType": "二等座",
  "total": "74.00",
  "kind": "交通",
  "taxItems": [
    {
      "detailAmount": 22.64,
      "unTaxAmount": 22.58,
      "taxRate": 0.06,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 1.36,
      "transferOut": false
    }
  ]
}

参数说明

参数名	类型	备注
number	String	发票号码
time	String	时间
departureStation	String	出发车站
arrivalStation	String	达到车站
trainNumber	String	车次
seatType	String	座位类型
total	String	总金额
name	String	姓名
kind	String	发票消费类型
taxItems	String	抵扣税额明细，见taxItemsDto

4. TAXI_PAPER 出租车票

{
  "code": "133011680478",
  "number": "01670989",
  "date": "2017年08月29日",
  "getOnTime": "12:47",
  "getOutTime": "12:52",
  "mileage": "1.9",
  "totalPriceAmount": "11.00",
  "totalPriceAndTax": "46.00",
  "place": "浙江省杭州市",
  "taxItems": [
    {
      "detailAmount": 22.64,
      "unTaxAmount": 22.58,
      "taxRate": 0.06,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 1.36,
      "transferOut": false
    }
  ]
}

参数说明

参数名	类型	备注
code	String	发票代码
number	String	发票号码
date	String	乘车日期
getOnTime	String	上车时间
getOutTime	String	下车时间
mileage	String	里程
totalPriceAmount	String	不含税金额
totalPriceAndTax	String	含税金额
name	String	姓名
place	String	发票所在地
taxItems	String	抵扣税额明细，见taxItemsDto

4. FLIGHT_PAPER 航空运输电子客票行程单

{
  "userName": "张三",
  "identityCardNo": "256548545211254523",
  "number": "1506498784112",
  "checkCode": "2345",
  "date": "2018年04月04日",
  "agentcode": "XMN098,0987677",
  "fillUnit": "上海XXXXXX旅行社有限公司",
  "fare": "730.00",
  "tax": "10.00",
  "fuelSurcharge": "10.00",
  "caacDevelopmentFund": "50.00",
  "insurance": "10.00",
  "total": "800.00",
  "printNumber": "29466448465",
  "flights": [
    {
      "from": "上海",
      "to": "北京",
      "flight_number": "GS7563",
      "date": "2018年02月20日",
      "time": "12:34",
      "seat": "N"
    },
    {
      "from": "北京",
      "to": "伦敦",
      "flight_number": "QR890",
      "date": "2018年02月21日",
      "time": "15:06",
      "seat": "S"
    }
  ],
  "kind": "交通",
  "taxItems": [
    {
      "detailAmount": 22.64,
      "unTaxAmount": 22.58,
      "taxRate": 0.06,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 1.36,
      "transferOut": false
    },
    {
      "detailAmount": 50,
      "unTaxAmount": 50,
      "taxRate": 0.00,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 0.00
    }
  ]
}

参数说明

参数名	类型	备注
userName	String	乘机人姓名
identityCardNo	String	身份证号
number	String	电子客票号码
checkCode	String	验证码
date	String	填开日期
agentcode	String	销售单位代号
fillUnit	String	填开单位
fare	String	票价
tax	String	税费
fuelSurcharge	String	燃油附加费
caacDevelopmentFund	String	民航发展基金
insurance	String	保险费
total	String	总金额
printNumber	String	印刷序号
kind	String	发票消费类型
flights	String	航班信息，见flightsDto
taxItems	String	抵扣税额明细，见taxItemsDto

flightsDto航班信息

参数名	类型	备注
from	String	出发站
to	String	到达站
flight_number	String	航班号
date	String	乘机日期
time	String	乘机时间
seat	String	座位等级

5. TOLLS_PAPER 通行费发票

{
  "code": "6300161320",
  "number": "15064112",
  "date": "2018年01月10日",
  "time": "2017年11月21日 21:53",
  "entrance": "4001",
  "exit": "6754",
  "totalPriceAndTax": "74.00",
  "kind": "交通",
  "taxItems": [
    {
      "detailAmount": 22.64,
      "unTaxAmount": 22.64,
      "taxRate": 0.06,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 1.36
    }
  ]
}

参数说明

参数名	类型	备注
code	String	发票代码
number	String	发票号码
date	String	日期
time	String	时间
entrance	String	入口
exit	String	出口
totalPriceAndTax	String	价税合计金额
kind	String	发票消费类型
taxItems	String	抵扣税额明细，见taxItemsDto

6. SHIP_PAPER 船票

{
  "code": "6300161320",
  "number": "15064112",
  "departureStation": "蛇口",
  "arrivalStation": "香港",
  "total": "74.00",
  "name": "张三",
  "time": "2017年11月21日 21:53",
  "date": "2018年01月10日",
  "currencyCode": "CNY"
}

参数说明

参数名	类型	备注
code	String	发票代码
number	String	发票号码
date	String	日期
time	String	时间
departureStation	String	起始车站
arrivalStation	String	到达车站
total	String	总金额
name	String	乘车人姓名
currencyCode	String	币种

7. USED_CAR_PAPER 二手车销售统一发票

{
  "code": "6300161320",
  "number": "15064112",
  "date": "2018年01月10日",
  "supplierName": "xx销售公司（销售方名称）",
  "supplierId": "XX销售公司代码",
  "buyerName": "每刻科技（购买方名称）",
  "buyerId": "购买方代码",
  "carCode": "LVSHKAXXXXX61612",
  "carModel": "丰田牌CAF7150N4",
  "companyName": "xxx二手车交易管理有限公司",
  "companyTaxNumber": "15260000000000000G",
  "licensePlate": "浙A88888",
  "registrationNumber": "320027731473"
}

参数说明

参数名	类型	备注
code	String	发票代码
number	String	发票号码
date	String	日期
supplierName	String	销售方名称
supplierId	String	销售方代码
buyerName	String	购买方名称
buyerId	String	购买方代码
carCode	String	车架号/车辆识别代码
carModel	String	厂牌型号
companyName	String	二手车市场
companyTaxNumber	String	二手车市场纳税人识别号
licensePlate	String	车牌号
registrationNumber	String	登记证号

8. VEHICLE_PAPER 机动车销售统一发票

{
  "code": "6300161320",
  "number": "15064112",
  "date": "2018年01月10日",
  "supplierName": "xx销售公司（销售方名称）",
  "buyerName": "每刻科技（购买方名称）",
  "buyerId": "购买方代码",
  "carCode": "LVSHKAXXXXX1612",
  "carModel": "丰田牌CAF7150N4",
  "machineCode": "123001221606",
  "machineNumber": "00213744",
  "taxAuthoritiesCode": "144030613",
  "certificateNumber": "YE80X1001351257",
  "total": "1000000.00",
  "taxRate": "7%"
}

参数说明

参数名	类型	备注
code	String	发票代码
number	String	发票号码
date	String	日期
carCode	String	车架号/车辆识别代码
carModel	String	厂牌型号
buyerName	String	购买方名称
buyerId	String	购买方纳税人识别号
machineCode	String	机打代码
machineNumber	String	机打号码
taxAuthoritiesCode	String	主管税务机关代码
certificateNumber	String	合格证号
total	String	总金额
taxRate	String	税率

9. SHIPMENT_VAT 增值税电子发票-运输服务

{
  "supplierName": "北京XX科技有限公司",
  "supplierAddress": "北京市XXXXX楼二层208号010-62682929",
  "totalPriceAmount": 245.97,
  "supplierTaxNumber": "91110108MA01G0FB09",
  "buyerName": "深圳市XXXX科技有限公司",
  "invoiceCode": "011001900711",
  "checkCode": "12785712140226992584",
  "taxItems": [
    {
      "detailAmount": 245.97,
      "unTaxAmount": 245.97,
      "taxRate": 0.0,
      "approvedDeductionAmount": 0.0,
      "approvedTaxAmount": 0.0,
      "transferOut": false
    }
  ],
  "invoiceNumber": "11252818",
  "totalPriceAndTax": 245.97,
  "issueDate": "2020年08月14日",
  "totalTaxAmount": 0.0,
  "items": [
    {
      "name": "*运输服务*客运服务费",
      "priceAmount": 245.97,
      "taxRate": 0.0,
      "taxAmount": 0.0,
      "unitPrice": 245.970000,
      "num": 1.000000,
      "taxRateMark": ""
    }
  ],
  "buyerTaxNumber": "91440300MA5DN8GX7L"
}

10. 系统生成发票

该类型发票并不是真实存在的，当财务在费用上新增税行，或者某些特殊场景下，会自动生成新的税行，该税行会使用下方的两个发票类型，存储在空发票上。

TAX_DEDUCTION
SYS_TAX_DEDUCTION

{
  "taxItems": [
    {
      "detailAmount": 22.64,
      "unTaxAmount": 22.64,
      "taxRate": 0.06,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 1.36
    }
  ]
}

11. ELECTRONIC_TRAIN_PAPER 电子发票（铁路电子客票）

{
  "number": "24339190041000003148",
  "electronicTicketNumber": "9004174086102099316322024",
  "passengerName": "林晖",
  "name": "林晖",
  "identityCardNo": "3424011997****2676",
  "time": "2024年11月04日 11:47",
  "departureTime": 1730519220000,
  "departureStation": "杭州东",
  "arrivalStation": "温岭",
  "trainNumber": "G7713",
  "seatType": "二等座",
  "totalPriceAndTax": 131.00,
  "totalTaxAmount": 0.00,
  "taxItems": [
    {
      "detailAmount": 120.18,
      "taxRate": 0.09,
      "approvedDeductionAmount": 10.82,
      "approvedTaxAmount": 10.82,
      "freeTax": false,
      "transferOut": false,
      "unTaxAmount": 120.18
    }
  ]
}

参数说明

参数名	类型	备注
number	String	发票号码
electronicTicketNumber	String	电子客票号
name	String	乘车人姓名
passengerName	String	乘车人姓名[name取不到就取这个值]
identityCardNo	String	乘车人身份证号
time	String	发车时间
departureTime	Long	发车时间戳
departureStation	String	出发车站
arrivalStation	String	达到车站
trainNumber	String	车次
seatType	String	座位类型
totalPriceAndTax	String	票面金额
taxItems	String	抵扣税额明细，见taxItemsDto

12. ELECTRONIC_FLIGHT_PAPER 电子发票（航空运输电子客票行程单）

{
  "number": "23448784110000000648",
  "electronicTicketNumber": "7842169154624",
  "userName": "高艳琼",
  "identityCardNo": "430426******19670X",
  "date": "2022年07月15日",
  "checkCode": "0648",
  "agentCode": "CAN011/00001704",
  "totalPriceAndTax": 100.00,
  "totalPriceAmount": 99.00,
  "caacDevelopmentFund": "100.00",
  "insurance": "0.00",
  "otherTaxAmount": 0.0,
  "fuelSurcharge": "0.00",
  "flights": [
    {
      "date": "2022年07月15日",
      "time": "00:00",
      "departure_time": "20220715000000",
      "carrier": "南航",
      "airLineName": "中国南方航空公司",
      "flight_number": "CZ3379",
      "flight_no": "CZ3379",
      "departure": "CSX 长沙",
      "destination": "CAN 广州",
      "seat": "Z",
      "from": "CSX 长沙",
      "to": "CAN 广州"
    },
    {
      "date": "2022年07月11日",
      "time": "00:00",
      "departure_time": "20220711000000",
      "carrier": "南航",
      "airLineName": "中国南方航空公司",
      "flight_number": "CZ3129",
      "flight_no": "CZ3129",
      "departure": "CAN 广州",
      "destination": "CAN 广州",
      "seat": "Z",
      "from": "CAN 广州",
      "to": "CAN 广州"
    }
  ],
  "taxItems": [
    {
      "detailAmount": 22.64,
      "unTaxAmount": 22.58,
      "taxRate": 0.06,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 1.36,
      "transferOut": false
    },
    {
      "detailAmount": 50,
      "unTaxAmount": 50,
      "taxRate": 0.00,
      "approvedDeductionAmount": 0.00,
      "approvedTaxAmount": 0.00
    }
  ]
}

参数说明

参数名	类型	备注
userName	String	乘机人姓名
identityCardNo	String	身份证号
number	String	发票号码
electronicTicketNumber	String	电子客票号
checkCode	String	验证码
date	String	填开日期
agentcode	String	销售单位代号
fillUnit	String	填开单位
totalPriceAndTax	String	合计
totalPriceAmount	String	票价
otherTaxAmount	String	其它税费
fuelSurcharge	String	燃油附加费
caacDevelopmentFund	String	民航发展基金
insurance	String	保险费
flights	String	航班信息，见flightsDto
taxItems	String	抵扣税额明细，见taxItemsDto

flightsDto航班信息

参数名	类型	备注
from	String	出发站
to	String	到达站
carrier	String	承运商
airLineName	String	航空公司名称
flight_number	String	航班号
flight_number	String	航班号
date	String	乘机日期
time	String	乘机时间
departure_time	Long	乘机时间戳
seat	String	座位等级

修改记录

2023-02-08  新增发票类型文档
2024-11-20  更新全电机票相关数据

发票类型

说明

请求参数

参数说明

参数样例

invoiceInfo参数样例

invoiceInfo 发票识票信息

taxItemsDto抵扣税额合计

itemDto货物明细

各种发票格式说明（部分发票特殊说明）

1. 纸质发票或电子发票：

2. PASSENGER_PAPER 客运汽车票

参数说明

3. TRAIN_PAPER 火车票

参数说明

4. TAXI_PAPER 出租车票

参数说明

4. FLIGHT_PAPER 航空运输电子客票行程单

参数说明

flightsDto航班信息

5. TOLLS_PAPER 通行费发票

参数说明

6. SHIP_PAPER 船票

参数说明

7. USED_CAR_PAPER 二手车销售统一发票

参数说明

8. VEHICLE_PAPER 机动车销售统一发票

参数说明

9. SHIPMENT_VAT 增值税电子发票-运输服务

10. 系统生成发票

11. ELECTRONIC_TRAIN_PAPER 电子发票（铁路电子客票）

参数说明

12. ELECTRONIC_FLIGHT_PAPER 电子发票（航空运输电子客票行程单）

参数说明

flightsDto航班信息

修改记录

results matching ""

No results matching ""

results matching ""

No results matching ""