开发文档
所有文档
- 计费记录设计文档
- 验证和错误
- 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 替换 |
AEAT 允许多种类型，根据业务选择 |
<sum1:ClaveRegimen> |
税制代码 | 01 普通制度02 简易制度03 免税 |
取决于发票适用税法 |
<sum1:CalificacionOperacion> |
交易类型 | S1 受IVA约束N1 不受约束E1 免税 |
常见餐饮类一般使用 S1 |
<sum1:TipoImpositivo> |
税率 | 4, 10, 21（典型值） | 西班牙标准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(关键字段串联) |