开发文档

所有文档

官方对接地址文件统计

计费记录设计文档
验证和错误
Web 服务描述文档（v1.0.3）（1.673 KB）
Web 服务描述文档（v1.0.3，英文版）（1,715 KB）
Web 服务的 WSDL
Web 服务示意图
生成记录指纹或哈希的技术规范详情（v0.1.2）（1.11 MB）
发票二维码技术规格说明文档（v0.4.7）（1.9 MB）
生成账单记录电子签名的技术规范
- 生成账单记录电子签名的技术规范（v0.1.5）（1.46 MB）这个暂不开发 NO VERIFACTU
- ZIP文件：包含账单记录签名样本的附件（5.74 KB）
无法核实的计费记录验证服务说明文档（v0.2）（576 KB）这个暂不开发 NO VERIFACTU
开发公司常见问题解答（更新于 2025 年 9 月 19 日）（666 KB）
负责任声明示例（708 KB）

测试环境（带证书）

发送票务地址：

https://prewww10.aeat.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP

生产环境（带证书）

发送票务地址：

https://www10.agenciatributaria.gob.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP

系统信息部分 SistemaInformatico XML

<sum1:SistemaInformatico>
<sum1:NombreRazon>JIECHENG INFORMATICA SL</sum1:NombreRazon>
<sum1:NIF>B67287789</sum1:NIF>
<sum1:NombreSistemaInformatico>JIECHENG TPV</sum1:NombreSistemaInformatico>
<sum1:IdSistemaInformatico>J2</sum1:IdSistemaInformatico>
<sum1:Version>1.0.03</sum1:Version>
<sum1:NumeroInstalacion>383</sum1:NumeroInstalacion> // 主机1 副机 2
<sum1:TipoUsoPosibleSoloVerifactu>N</sum1:TipoUsoPosibleSoloVerifactu>
<sum1:TipoUsoPosibleMultiOT>S</sum1:TipoUsoPosibleMultiOT>
<sum1:IndicadorMultiplesOT>S</sum1:IndicadorMultiplesOT>
</sum1:SistemaInformatico>

常用节点意思介绍

节点	含义	可用值 / 格式	说明
`<sum1:Subsanacion>`	修正标志	`S` 或省略	`S` 表示此记录为修正（例如纠正错误或重新提交）
`<sum1:TipoFactura>`	发票类型	`F1` 普通发票`F2` 简易发票`R1` 作废`R2` 更正`R3` 替换	可以参见 TipoFactura 段落
`<sum1:ClaveRegimen>`	税制代码	`01` 普通制度`02` 简易制度`03` 免税	取决于发票适用税法
`<sum1:CalificacionOperacion>`	交易类型	`S1` 受IVA约束`N1` 不受约束`E1` 免税	常见餐饮类一般使用 `S1`
`<sum1:TipoImpositivo>`	税率	4, 10, 21 , 0 几种税率	西班牙标准IVA税率
`<sum1:TipoHuella>`	指纹类型	`01`	表示 SHA-256 Base64
`<sum1:TipoUsoPosibleSoloVerifactu>`	是否专属VeriFactu	`S` 或 `N`	如果你的系统只用于VeriFactu，则为 `S`
`<sum1:TipoUsoPosibleMultiOT>`	是否支持多义务人	`S` 或 `N`	SaaS类一般 `S`
`<sum1:IndicadorMultiplesOT>`	是否有多个义务人使用中	`S` 或 `N`	如果服务器下多家餐厅，则为 `S`
`<sum1:NumeroInstalacion>`	安装编号	数字或字符串	每个部署/门店唯一
`<sum1:Huella>`	指纹	Base64 编码字符串	SHA-256(关键字段串联)

TipoFactura 的几种类型

Código	名称	适用情形	关键点
F1	Factura completa (Art. 6, 7.2 y 7.3 del RD 1619/2012)	标准完整发票，识别买方、含增值税细节。	是最常见的发票类型。必须包含： - 客户身份（NIF / NombreRazon） - 分项税额 (Desglose)
F2	Factura simplificada (Art. 6.1.d RD 1619/2012)	金额较小、无需识别买方的发票（小票、餐饮等）。	通常对应 Ticket。买方信息可选。
F3	Factura emitida en sustitución de facturas simplificadas	当企业把之前已申报的简易发票（F2）替换为完整发票（F1）。	属于更正性质的“补开发票”，用于“由 ticket 转发票”。这正是你现在在做的情况。
R1	Factura rectificativa (Art. 80.1 y 80.2 y error fundado en derecho)	纠正税基、税率或金额错误（因判决、行政原因等）。	Rectificación 依据法条 80.1 / 80.2。
R2	Factura rectificativa (Art. 80.3)	因退货、折扣、无效合同等导致的修正。	对应业务更改（例如取消销售）。
R3	Factura rectificativa (Art. 80.4)	客户破产或无力偿付引起的修正。	专用于破产情形。
R4	Factura rectificativa (Resto)	其他未涵盖情形的更正发票。	一般性修正用途。
R5	Factura rectificativa simplificada	针对简易发票的修正。	通常用于 ticket 更正。

QR 生成地址以及规则

QR 尺寸 40*40 mm

以地址为准生成 QR 码，并在下方打印： Factura verificable en la sede electrónica de la AEAT

测试环境地址：

https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=XXXXXXXXY&numserie=YYYY...YYYY&fecha=DD- DD-AAAA&importe=NNNNNNNNN.DD

生产环境地址：