开发文档
所有文档
- 计费记录设计文档
- 验证和错误
- 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.1.5）
- 无法核实的计费记录验证服务说明文档（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
系统信息部分 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>
<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
生产地址：
https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=XXXXXXXXY&numserie=YYYY...YYYY&fecha=DD- DD-AAAA&importe=NNNNNNNNN.DD
XML 返回的资料进行拼接 " &" = " 链接 xia
nif= XXXXXXXXXXXX &numseria= 123456 &fecha= &importe=
URL base: https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?
Parámetro nif: 89890001K
Parámetro numserie: 12345678&G33
Parámetro fecha: 01-01-2024
Parámetro importe: 241.4