发票账单数据回写接口
接口: /invoice/specialSearch POST JSON
请求参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
billCode | string | Y | 子账单编码 | ||
invoiceType | string | N | 发票类型 | ||
entCode | string | Y | 企业号 | ||
offset | int | N | 0 | 分页起始 | |
limit | int | N | 500 | 分页条数 |
注意
- 接口最多返回500条记录;可通过offset, limit进行分页;
示例
根据签收发票时间查询发票
{
"offset":0,
"limit":10,
"billCode":"123123123",
"invoiceType":"PAPER",
"entCode":"asdasda"
}
返回数据
参数 | 类型 | 描述 |
---|---|---|
invoiceDataCode | string | 业务编码 |
invoiceCode | string | 发票代码 |
invoiceNumber | string | 发票号码 |
issueDate | string | 开票时间 |
checkCode | string | 校验码 |
totalPriceAmount | bigDecimal | 不含税金额 |
totalTaxAmount | bigDecimal | 合计税额 |
totalPriceAndTax | bigDecimal | 价税合计 |
type | string | 发票类型 |
remark | string | 备注 |
jsonProps | string | 额外信息。当类型为火车票时,consumeLocation:消费地,consumeDate:消费时间,departureLocation:出发地,destinationLocation:目的地,seat:座位类型,vehicleNumber:班次,passenger:乘客名,departureTime:出发时间,roundWay:是否往返,seatName:座位类型 ticketNo:电子客单号 |
lineItems | List<InvoiceItemDto> | 发票明细 |
attachmentFiles | List<AttachmentFile> | 附件 |
BillInfos | List<BillInfo> | 账单信息 |
AttachmentFile.class
参数 | 类型 | 描述 |
---|---|---|
filename | string | 文件名 |
type | string | 文件类型 |
size | string | 文件大小 |
code | string | code |
resourceKey | string | resourceKey |
mimeType | string | mimeType |
originalUrl | string | 文件URL |
BillInfo.class
参数 | 类型 | 描述 |
---|---|---|
billlCode | string | 子账单编码 |
bussinessTypeName | string | 商旅平台名称 |
company | string | 账单所属公司 |
billTypeName | string | 账单分类名称 |
orderId | string | 订单ID |
operationId | string | 操作人ID |
InvoiceItemDto.class
参数 | 类型 | 描述 |
---|---|---|
name | string | 明细名称 |
priceAmount | string | 金额 |
taxRate | string | 税率 |
taxAmount | string | 税额 |
发票类型
VAT_PAPER 增值税普通发票,
VAT_ELECTRONIC, 增值税普通发票(电子)
VAT_FULL_ELECTRONIC,电子发票(增值税普通发票)
SPECIAL_VAT_PAPER,增值税专用发票
SPECIAL_VAT_ELECTRONIC,增值税专用发票(电子)
OTHER 其他,
SPECIAL_VAT_FULL_ELECTRONIC,电子发票(增值税专用发票)
VAT_FLIGHT,机票
VAT_TRAIN,火车票
ELECTRONIC_FLIGHT_PAPER 电子发票(航空运输电子客票行程单),
SPECIAL_VAT_MOTOR_VEHICLE 增值税机动车专用发票,
VAT_PAPER_ROLL 增值税卷票,
VAT_TAXI 出租车票,
PRINTED 机打发票,
BLOCKCHAIN 区块链发票
VAT_PASSAGE 过路费发票,
VAT_TOLL 增值税过路费发票
SPECIAL_VAT_SECOND_HAND_CAR 增值税二手车专用发票
返回数据(成功)
{
"code":"ACK",
"message":"",
"data":[
{
"invoiceDataCode":"INV2009231AV99XQ8",
"userCode":"UI1707201NIOCWLC",
"invoiceCode":"asa",
"invoiceNumber":"as",
"issueDate":1600790400000,
"totalPriceAmount":1,
"totalTaxAmount":0,
"totalPriceAndTax":1,
"invoiceTypeDesc":"增值税普通发票(纸质)",
"remark":"",
"invoiceDateStr":null,
"passenger" : "xiaoming",
"seat": "一等座",
"consumeDate": "2024-11-04 12:36:48",
"lineItems": [
{
"name": "*医疗仪器器械*输尿管支架",
"priceAmount": 7135.40,
"taxRate": 0.13,
"taxAmount": 927.60
}
],
"attachments":null,
"attachmentFiles":null
}
],
"last": true
}