查询智能签收的扫描发票数据
说明
查看到发票抵扣联等多联发票影像
注意事项
- 分页查询,根据标识判断是否有下页数据
接口地址
/api/openapi/sign/list-invoice
请求类型
POST
请求参数
参数说明
字段名称 |
字段类型 |
是否必填 |
字段说明 |
formCode |
string |
是 |
单据号 |
formDataCode |
string |
否 |
单据code |
pageStart |
long |
是 |
分页查询起始页 |
pageSize |
long |
是 |
每页数据大小 |
参数样例
{
"formCode": "MK22100013",
"formDataCode": "",
"pageStart": 0,
"pageSize": 10
}
响应参数
响应参数说明
字段名称 |
字段类型 |
字段说明 |
invoiceDataCode |
string |
发票内码 |
entCode |
string |
企业编码 |
invoiceCode |
string |
发票代码 |
invoiceNumber |
string |
发票号码 |
invoiceBagCode |
String(25) |
否 |
发票袋号码[包含系统自动生成的] |
manualInvoiceBagCode |
String(25) |
否 |
用户手动填写的发票袋号码 |
issueDate |
Date |
开票时间 |
checkCode |
string |
校验码 |
buyerName |
string |
购买方名称 |
buyerTaxNumber |
string |
购方税号 |
buyerAddressPhone |
string |
购方地址and 电话 |
buyerAccount |
string |
购买方开户行及账号 |
totalPriceAmount |
BigDecimal |
合计金额 |
totalTaxAmount |
BigDecimal |
合计税额 |
totalPriceAndTax |
BigDecimal |
价税合计 |
supplierName |
string |
销方名称 |
supplierTaxNumber |
string |
销方税号 |
supplierAddress |
string |
销方地 |
supplierAccount |
string |
销方开户行及账号 |
invoiceType |
InvoiceTypeEnum |
发票类型编码 |
validateStatus |
InvoiceValidateStatusEnum |
验真状态 NOT_VALIDATION("未验真"), VALIDATED("已验真"), VALIDATION_FAILED("验真失败"), NOT_SUPPORT_VALIDATION("不支持验真"), ZHEJIANG_GOV("浙里办查询发票") |
remark |
string |
备注 |
companySeal |
string |
是否加盖专用章 |
ticketData |
MkJSONObject |
发票ticketData信息 |
invoiceRemark |
string |
发票备注 |
passengers |
string |
乘车人(乘机人)(火车票、飞机票此字段才有值) |
idCard |
string |
身份证号码 |
attachmentFiles |
List< FileInfo > |
文件对象,见下表 |
发票类型
字段名称 |
字段类型 |
字段说明 |
code |
string |
类型code |
desc |
string |
解释 |
defaultExpenseType |
string |
defaultExpenseType |
dataHubCode |
string |
dataHubCode |
supportBuyerValidate |
boolean |
是否支持智能审核购买方信息vs公司抬头校验 |
dynaFormCode |
string |
类型对应的表单 code |
FileInfo 附件信息
字段名称 |
字段类型 |
是否必填 |
字段说明 |
code |
String(25) |
是 |
内部code |
mimeType |
String(50) |
是 |
文件类型:image/png |
filename |
String(25) |
是 |
文件名称 |
type |
String |
是 |
文件类型:image/png |
downloadUrl |
String |
是 |
源文件下载地址,有时效性,7天有效期 |
originalUrl |
String |
是 |
预览图地址,有时效性,7天有效期 |
thumUrl |
String |
是 |
缩略图地址,有时效性,7天有效期 |
imageUrl |
String |
是 |
发票图片地址,有时效性,7天有效期(用户上传的原始图片),若上传的文件是pdf,此参数返回“images/pdf.png”) |
验真状态
字段名称 |
字段类型 |
字段说明 |
desc |
string |
解释 |
响应参数样例
{
"code": "ACK",
"message": "成功",
"errorCode": "",
"data": {
"hasNextPage": true,
"list": [
{
"invoiceDataCode": "",
"entCode": "",
"invoiceCode": "",
"invoiceNumber": "",
"issueDate": "",
"checkCode": "",
"buyerName": "",
"buyerTaxNumber": "",
"buyerAddressPhone": "",
"buyerAccount": "",
"totalPriceAmount": 12.21,
"totalPriceAndTax": 13.33,
"totalPriceAndTax": 14.21,
"supplierName": "",
"supplierTaxNumber": "",
"supplierAddress": "",
"supplierAccount": "",
"invoiceType": {
"code": "",
"desc": "",
"defaultExpenseType": "",
"dataHubCode": "",
"supportBuyerValidate": true,
"dynaFormCode": ""
},
"validateStatus": {
"desc": ""
},
"remark": "",
"companySeal": "",
"ticketData": "",
"invoiceRemark": "",
"attachmentFiles": [
{
"code": "ATT1807051YCYYUBK",
"resourceKey": "OSS1807051OM923NK/6c89c484-3da8-4f00-9184-258668ac696c.png",
"mimeType": "image/png",
"originalUrl": "https://dd-uat.oss-cn-hangzhou.aliyuncs.com/OSS1807051OM923NK/6c89c484-3da8-4f00-9184-258668ac696c.png?Expires=1594276388&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=FI4lQ8soBEmw3L6nsf%2FOUrjdS00%3D&x-oss-process=image%2Fauto-orient%2C1",
"thumUrl": "https://dd-uat.oss-cn-hangzhou.aliyuncs.com/OSS1807051OM923NK/6c89c484-3da8-4f00-9184-258668ac696c.png?Expires=1594276388&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=dcUuR6JHu%2BUe6V5VXHOteZ%2FWkHU%3D&x-oss-process=image%2Fresize%2Cm_fixed%2Cw_100%2Ch_100",
"filename": "屏幕快照 2018-05-21 下午2.35.51.png",
"type": "image/png",
"imageUrl": "https://dd-uat.oss-cn-hangzhou.aliyuncs.com/OSS1807051OM923NK/6c89c484-3da8-4f00-9184-258668ac696c.png?Expires=1594276388&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=FI4lQ8soBEmw3L6nsf%2FOUrjdS00%3D&x-oss-process=image%2Fauto-orient%2C1",
"size": 200483,
"isQrCodePic": false,
"withHandSignUrl": null,
"qrCodePic": false
}
]
}
]
}
}
修改记录
2023-12-11 新增发票接口能查到智能签收的扫描发票数据
2024-09-23 智能签收的扫描发票数据结构中增加文件获取路径