开发文档

所有文档

官方对接地址 文件统计

• 计费记录设计文档
• 验证和错误
• 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

系统信息部分 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 , 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 更正。