接口描述

请求地址： /ticketInterface/invoiceFileSync

所属系统：发票池

所属微服务：zfs-op

接口说明：外系统同步进项发票数据至我方系统后，需将对应的进项发票文件也同步到我方系统，以便在我方系统报销审核时可以查看发票文件，因此需提供一个发票文件的写入接口

单次调用最大条数：1000

报文编码格式：UTF-8

注意事项：

1.外系统通过发票文件同步接口同步文件时，可以传文件对应服务器地址，也可以直接传文件流；两者同时传，以文件流为准。为保证接口正常使用，整体报文需限制大小不超过100M，文件流对象个数不超过20个;

2.电子发票文件格式限制只能为ofd、pdf、xml、jpg、jpeg、png;

3.此接口只支持新增和删除，不支持更新;

4.同一批次，失败的数据不影响成功的数据写入;

5.文件同步不做解析比对，不保证文件和发票结构化数据关联的正确性;

请求参数

参数名	中文名称	类型	是否必填	示例	参数说明
▼data		array	Y
fileName	文件名	string	N	增值税电子普通发票1.pdf	1、当同步类型为2（删除)时，不必填； 2、当同步类型为非2（新增）时必填，文件名中包含的后缀只能为ofd、pdf、xml、jpg、jpeg、png。注意：文件名需包含文件后缀，且后缀必须为真实的文件类型扩展名，否则可能无法查看：
fileData	文件base64字符串	string	N	data:appltion/ofd;base64,UEsKAWU	1、当同步类型为2（删除)时，不必填； 2、当同步类型为非2（新增）时：文件访问路径和文件base64字符串必须有一个参数传值，两个都传值，则默认取文件base64字符串；需按照Data URI scheme规则传值：{数据协议名称}:{数据协议值}/{文件类型名称};base64,{base64编码后的文件内容}
fileUrl	文件路径	string	N	group1/M00/01/09/wKgCs232.pdf	1、当同步类型为2（删除)时，不必填； 2、当同步类型为非2（新增）时：文件路径和文件base64字符串必须有一个参数传值，两个都传值，则默认取文件base64字符串；为文件在共享文件服务中的存储路径；文件后缀只能为ofd、pdf、xml、jpg、jpeg、png
invoiceId	发票id	string	Y	af2e2191	我方系统进项发票id，发票主键
rowId	行ID	string	N	38ffe034b	该参数由接口自动处理，无需传值
rowNum	行号	string	N	1	外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了
syncType	同步类型	string	N	1	枚举值： 1：新增 2：删除非2默认为1，不传值默认为1
expands1	扩展 String 1	string	N	扩展 String 1
expands2	扩展 String 2	string	N	扩展 String 2
expands3	扩展 String 3	string	N	扩展 String 3
expands4	扩展 String 4	string	N	扩展 String 4
expands5	扩展 String 5	string	N	扩展 String 5
expands6	扩展 String 6	string	N	扩展 String 6
expands7	扩展 String 7	string	N	扩展 String 7
expands8	扩展 String 8	string	N	扩展 String 8
expands9	扩展 String 9	string	N	扩展 String 9
expands10	扩展 String 10	string	N	扩展 String 10

返回参数

参数名	中文名称	参数类型	示例	参数说明
code	编码	string	2	0-全部成功;1-全部失败;2-部分成功
msg	信息	string	部分成功	消息提示
successNum	成功条数	string	1	成功条数
failNum	失败条数	string	1	失败条数
▼data	数据	array		返回数据
rowId	行ID	string		接口平台数据同步标识
rowNum	行号	string	1	行号
errMsg	错误信息	string	错误	每行错误消息

请求参数示例

{
  "data": [
    {
      "fileName": "增值税电子普通发票1.pdf",
      "fileData": "data:application/ofd;base64,UEsDBBQAAAAIALCFJlPS5YrwKAIAAMIEAAAHAAAAT0ZELnhtbJWU",
      "expands9": "",
      "rowId": "38ffbdb043f045ed544eb1b9b2ae034b",
      "expands4": "",
      "expands3": "",
      "expands10": "",
      "expands2": "",
      "expands1": "",
      "expands8": "",
      "expands7": "",
      "expands6": "",
      "expands5": "",
      "rowNum": "1",
      "fileUrl": "group1/M00/01/09/wKgCyGOcJOCAGEAVAAKahuF2Hws232.pdf",
      "invoiceId": "af2e480d27f049dfa0c2aa1faeb42191",
      "syncType": "1"
    }
  ]
}

返回参数示例

{
  "msg": "成功",
  "code": "0",
  "failNum": "1",
  "data": [
    {
      "rowNum": "1",
      "errMsg": "错误",
      "rowId": "38ffbdb043f045ed544eb1b9b2ae034b"
    }
  ],
  "successNum": "1"
}

进项发票文件同步接口（3.9.4）

进项发票文件同步接口（3.9.4）

关于作者

目录