获取发票详情接口

接口： invoice/search POST JSON

请求参数

参数	类型	必须	默认值	主键	描述
exportAtStart	date	Y			发票导出开始时间，返回exportAtStart（包括）之后的数据
exportAtEnd	date	Y			发票导出结束时间，返回exportAtEnd（不包括）之前的数据
forms	List<FormCodeDto>	Y			单据编码参数
employeeId	string	N			员工工号
offset	int	Y	0		分页起始
limit	int	Y	50		分页条数

FormCodeDto(单据编码参数)

参数	类型	描述
formType	string	单据类型 REIMBURSE(对私报销)、CORP_REIMBURSE(对公报销)
formBizCode	string	单据业务编码

#

注意：根据单据号查询发票只查询已关联的发票; 根据导出时间查询则只查询未关联的发票
exportAtStart、exportAtEnd时间的格式为yyyy-mm-dd hh:mm，发票导出时间查询区间最大为一个月
接口最多返回50条记录；可通过offset, limit进行分页；
结果集按照提单时间降序排列
formBizCodes 限50条单据

示例

根据导出时间查询发票

{
  "offset": 0,
  "limit": 10,
  "exportAtStart": "2020-09-20 00:00",
  "exportAtEnd": "2020-09-25 00:00"
}

根据单据号查询发票

{
  "offset": 0,
  "limit": 10,
  "forms": [
    {
      "formType": "REIMBURSE",
      "formBizCode": "BX001"
    }
  ]
}

返回数据

参数	类型	描述
invoiceDataCode	string	业务编码
userCode	string	员工编码
feeCode	string	费用编码
feeTypeBizCode	string	费用类型业务编码
qrCode	string	二维码扫描值
buyerName	string	购买方名称
buyerTaxNumber	string	买方税号
buyerAddressPhone	string	购方地址、电话
buyerBankAccount	string	购方开户行及账号
invoiceCode	string	发票代码
invoiceNumber	string	发票号码
issueDate	string	开票时间
checkCode	string	校验码
totalPriceAmount	bigDecimal	合计金额
totalTaxAmount	string	合计税额
totalPriceAndTax	string	价税合计
supplierName	string	销方名称
supplierAddress	string	销方地址
supplierTaxNumber	string	销售方纳税号
supplierBankAccount	string	销售方账号
type	string	发票类型
consumeType	string	消费类型
invoiceTypeDesc	string	发票类型明细
validateStatus	string	验真状态
validateStatusDesc	string	验真状态明细
jsonProps	string	额外信息。当类型为火车票时，consumeLocation：消费地，consumeDate：消费时间，departureLocation：出发地，destinationLocation：目的地，seat：座位类型，vehicleNumber：班次，passenger：乘客名，departureTime：出发时间，roundWay：是否往返，seatName：座位类型
remark	string	备注
comment	string	描述
importedAt	date	导入时间
importedAtYearMonth	string	导入时间（年、月）
hasQrCodePic	boolean	是否有二维码图片
processing	boolean	是否已处理
invoiceDateStr	string	发票时间
invoiceStatus	string	发票状态
source	string	来源
bizType	string	类型
trafficFeeFlag	boolean	是否交通费发票
lineItems	List<InvoiceItemDto>	发票明细

返回数据(成功）

{
  "code": "ACK",
  "message": "",
  "data": [
    {
      "invoiceDataCode": "INV2009231AV99XQ8",
      "userCode": "UI1707201NIOCWLC",
      "feeCode": "FD123456",
      "feeTypeBizCode": "MK_FT_123",
      "qrCode": "",
      "buyerName": "",
      "buyerTaxNumber": "",
      "buyerAddressPhone": "",
      "buyerBankAccount": "",
      "invoiceCode": "asa",
      "invoiceNumber": "as",
      "issueDate": 1600790400000,
      "totalPriceAmount": 1,
      "totalTaxAmount": 0,
      "totalPriceAndTax": 1,
      "supplierName": "",
      "supplierAddress": "",
      "supplierTaxNumber": "",
      "supplierBankAccount": "",
      "consumeType": null,
      "invoiceTypeDesc": "增值税普通发票(纸质)",
      "attachments": null,
      "attachmentFiles": null,
      "validateStatus": "NOT_VALIDATION",
      "validateStatusDesc": "未验真",
      "remark": "",
      "importedAt": 1600840215328,
      "importedAtYearMonth": "202009",
      "hasQrCodePic": false,
      "processing": false,
      "auditLogs": null,
      "invoiceDateStr": null,
      "invoiceStatus": null,
      "invoiceTitleConflict": false,
      "invoiceTitleConflictWithFee": false,
      "invoiceTaxNumberConflictWithFee": false,
      "source": "",
      "orientation": null,
      "exportAt": 1600840225513,
      "comment": "",
      "coordinates": null,
      "bizType": "PERSONAL",
      "bizTypeDesc": "对私发票",
      "forceUpdate": false,
      "jsonProps": null,
      "skipIdentify": false,
      "reimburseDataCode": null,
      "userName": null,
      "checksum": "12",
      "type": "04",
      "lineItems": [
        {
          "name": "*医疗仪器器械*输尿管支架",
          "priceAmount": 7135.40,
          "taxRate": 0.13,
          "taxAmount": 927.60
        }
      ]
    }
  ],
  "args": null,
  "linkDetail": false,
  "last": true,
  "nonBizError": false
}

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

json
{
  "code": "ACK",
  "message": "",
  "data": [
    {
      "invoiceDataCode": "INV24112612IJ4MWW",
      "userCode": "UI2403271MS7TRLS",
      "feeCode": "FD2411181BLZAUKA",
      "feeTypeBizCode": "by train",
      "qrCode": "",
      "buyerName": "中国南方航空股份有限公司测试",
      "buyerTaxNumber": "91440000100017600N",
      "buyerAddressPhone": "",
      "buyerBankAccount": "",
      "invoiceCode": "",
      "invoiceNumber": "23448784110000000649",
      "issueDate": 1677772800000,
      "totalPriceAmount": 50.00,
      "totalTaxAmount": 0.00,
      "totalPriceAndTax": 50.00,
      "supplierName": "中国南方航空股份有限公司",
      "supplierAddress": "",
      "supplierTaxNumber": "",
      "supplierBankAccount": "",
      "consumeType": "FLIGHT",
      "invoiceTypeDesc": "电子发票（航空运输电子客票行程单）",
      "attachments": null,
      "attachmentFiles": null,
      "validateStatus": "VALIDATED",
      "validateStatusDesc": "已验真",
      "remark": "",
      "importedAt": 1732591336633,
      "importedAtYearMonth": "202411",
      "hasQrCodePic": false,
      "processing": false,
      "auditLogs": null,
      "invoiceDateStr": null,
      "invoiceStatus": null,
      "invoiceTitleConflict": false,
      "invoiceTitleConflictWithFee": false,
      "invoiceTaxNumberConflictWithFee": false,
      "source": "",
      "orientation": null,
      "exportAt": null,
      "comment": "",
      "trafficFeeFlag": false,
      "coordinates": null,
      "bizType": "PERSONAL",
      "bizTypeDesc": "对私发票",
      "forceUpdate": false,
      "jsonProps": "{\"consumeLocation\":\"CAN 广州\",\"consumeDate\":\"2023-03-03\",\"departureLocation\":\"CAN 广州\",\"destinationLocation\":\"XIY 西安\",\"seat\":\"BUSINESS\",\"vehicleNumber\":\"CZ3201\",\"passenger\":\"刘儒强\",\"departureTime\":\"2023-02-10 00:00\",\"issueBy\":\"中国南方航空股份有限公司\",\"roundWay\":true,\"insurance\":0,\"fare\":0,\"fuelSurcharge\":0,\"caacDevelopmentFund\":50,\"ticketNo\":\"7842472952068\",\"seatName\":\"商务舱\"}",
      "skipIdentify": false,
      "reimburseDataCode": null,
      "userName": null,
      "checksum": "",
      "type": "10019",
      //发票类型代码10019为电子发票（航空运输电子客票行程单）
      "lineItems": null
    }
  ],
  "args": null,
  "linkDetail": false,
  "last": true,
  "nonBizError": false
}

电子发票（航空运输电子客票行程单）jsonProps 内容

参数	类型	描述
consumeLocation	string	消费地
consumeDate	string	消费时间
departureLocation	string	出发地
destinationLocation	string	目的地
seat	string	舱位等级
seatName	string	舱位等级中文
departureTime	string	航班时间
issueBy	string	填开单位名称
vehicleNumber	string	航班号
passenger	string	乘机人姓名
identityNo	string	乘机人身份证号
ticketNo	string	电子客票号
caacDevelopmentFund	BigDecimal	民航发展基金
fuelSurcharge	BigDecimal	燃油附加费
taxAmount	BigDecimal	增值税税额
otherTaxAmount	BigDecimal	其他税费
insurance	BigDecimal	保险费
fare	BigDecimal	票价
taxRate	BigDecimal	税率
carrier	string	承运人
agentCode	string	销售单位代号

#### 电子发票(铁路电子客票)

{
  "code": "ACK",
  "message": "",
  "data": [
    {
      "invoiceDataCode": "INV2411201O4I0K5C",
      "userCode": "UI2403271MS7TRLS",
      "feeCode": "FD2411181BLZAUKA",
      "feeTypeBizCode": "by train",
      "qrCode": "",
      "buyerName": "杭州沃镭智能科技股份有限公司",
      "buyerTaxNumber": "9133010067675905XR",
      "buyerAddressPhone": "",
      "buyerBankAccount": "",
      "invoiceCode": "",
      "invoiceNumber": "24319166100000023794",
      "issueDate": 1730995200000,
      "totalPriceAmount": 47.71,
      "totalTaxAmount": 4.29,
      "totalPriceAndTax": 52.00,
      "supplierName": "",
      "supplierAddress": "",
      "supplierTaxNumber": "",
      "supplierBankAccount": "",
      "consumeType": "TRAIN",
      "invoiceTypeDesc": "电子发票(铁路电子客票)",
      "attachments": null,
      "attachmentFiles": null,
      "validateStatus": "VALIDATED",
      "validateStatusDesc": "已验真",
      "remark": "",
      "importedAt": 1732095905792,
      "importedAtYearMonth": "202411",
      "hasQrCodePic": false,
      "processing": false,
      "auditLogs": null,
      "invoiceDateStr": null,
      "invoiceStatus": null,
      "invoiceTitleConflict": false,
      "invoiceTitleConflictWithFee": false,
      "invoiceTaxNumberConflictWithFee": false,
      "source": "",
      "orientation": null,
      "exportAt": null,
      "comment": "",
      "trafficFeeFlag": false,
      "coordinates": null,
      "bizType": "PERSONAL",
      "bizTypeDesc": "对私发票",
      "forceUpdate": false,
      "jsonProps": "{\"consumeLocation\":\"上海虹桥\",\"consumeDate\":\"2024-11-08\",\"departureLocation\":\"上海虹桥\",\"destinationLocation\":\"桐乡\",\"seat\":\"SECOND\",\"trainNumber\":\"G7589\",\"seatNo\":\"13车06C号\",\"vehicleNumber\":\"G7589\",\"passenger\":\"何明明\",\"departureTime\":\"2024-11-08 10:33\",\"roundWay\":false,\"identityNo\":\"152923******070012\",\"ticketNo\":\"6610078086110895878472024\",\"taxRate\":0.09,\"seatName\":\"二等座\"}",
      "skipIdentify": false,
      "reimburseDataCode": null,
      "userName": null,
      "checksum": "",
      "type": "10018",
      //发票类型代码10018为电子发票(铁路电子客票)
      "lineItems": null
    }
  ],
  "args": null,
  "linkDetail": false,
  "last": true,
  "nonBizError": false
}

电子发票(铁路电子客票) jsonProps 内容

参数	类型	描述
consumeLocation	string	消费地
consumeDate	string	消费时间
departureLocation	string	出发地
destinationLocation	string	目的地
seat	string	座位等级
seatName	string	座位等级中文
departureTime	string	航班时间
issueBy	string	填开单位名称
trainNumber	string	车次号
passenger	string	乘客姓名
identityNo	string	乘客身份证号
ticketNo	string	电子客票号
taxRate	BigDecimal	税率

```

results matching ""

No results matching ""