开发文档

所有文档

官方对接地址 文件统计

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

常用节点意思介绍

节点	含义	可用值 / 格式	说明
<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

生产环境地址：

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 

开发流程

设置中 添加 加载电子证书按钮 +  密码框    ，    解析  +  使用 

 1 -   解析证书  （ 获取证书中的 ID,  姓名资料 ）   

• CN   ： CERTIFICADO FISICA PRUEBAS -99999910G'       （-  前是公司/个人名字  - 后面是税号）
• SN  ：  公司或者个人名称  
• O :  有这个字段代表公司   否则是个人 
• SERIALNUMBER  - 后面是 税号
  C 是国家  
• NotAfter   证书到期时间
  

参考一下代码

using System;
using System.Security.Cryptography.X509Certificates;
using System.Text.RegularExpressions;

namespace CertInfoExtractor
{
    public enum CertType
    {
        Unknown,
        Personal,
        Organization
    }

    public class CertInfo
    {
        public CertType Type { get; set; }
        public string Name { get; set; }           // 姓名或公司名
        public string TaxNumber { get; set; }      // 税号 / NIF / CIF
        public DateTime NotAfter { get; set; }     // 到期时间
        public int DaysRemaining { get; set; }     // 剩余天数
    }

    public class CertParser
    {
        public static CertInfo Parse(string pfxPath, string password)
        {
            var cert = new X509Certificate2(pfxPath, password,
                X509KeyStorageFlags.Exportable | X509KeyStorageFlags.MachineKeySet);

            string subject = cert.Subject;
            string issuer = cert.Issuer;

            string cn = GetField(subject, "CN");
            string org = GetField(subject, "O");
            string serial = GetField(subject, "SERIALNUMBER");

            // 税号兜底正则
            if (string.IsNullOrEmpty(serial))
            {
                var m = Regex.Match(subject, @"(SERIALNUMBER|NIF|CIF|NIE|UID)\s*=\s*([A-Z0-9\-\/]{6,20})",
                    RegexOptions.IgnoreCase);
                if (m.Success)
                    serial = m.Groups[2].Value.Trim();
            }

            // 判断类型
            CertType type = DetectType(org, serial, issuer);

            // 名称：企业用 O，个人用 CN
            string name = (type == CertType.Organization && !string.IsNullOrEmpty(org))
                ? org
                : cn;

            var notAfter = cert.NotAfter;
            int daysRemaining = (int)(notAfter - DateTime.Now).TotalDays;

            return new CertInfo
            {
                Type = type,
                Name = name,
                TaxNumber = serial,
                NotAfter = notAfter,
                DaysRemaining = daysRemaining
            };
        }

        private static CertType DetectType(string org, string serial, string issuer)
        {
            bool hasOrg = !string.IsNullOrEmpty(org);
            bool looksLikeCompanyId = Regex.IsMatch(serial ?? "", @"^[A-Z]\d{7,8}", RegexOptions.IgnoreCase);
            bool looksLikePersonId = Regex.IsMatch(serial ?? "", @"\d{7,8}[A-Z]$", RegexOptions.IgnoreCase);

            if (hasOrg || looksLikeCompanyId)
                return CertType.Organization;
            if (looksLikePersonId)
                return CertType.Personal;

            if (issuer.Contains("Persona Física", StringComparison.OrdinalIgnoreCase))
                return CertType.Personal;
            if (issuer.Contains("Representante", StringComparison.OrdinalIgnoreCase))
                return CertType.Organization;

            return CertType.Unknown;
        }

        private static string GetField(string subject, string key)
        {
            var m = Regex.Match(subject, key + @"\s*=\s*([^,]+)", RegexOptions.IgnoreCase);
            return m.Success ? m.Groups[1].Value.Trim() : null;
        }

        // 测试入口
        public static void Main()
        {
            string pfxPath = @"C:\certs\yourcert.pfx";
            string password = "yourPassword";

            var info = Parse(pfxPath, password);

            Console.WriteLine("🔍 证书类型: " + info.Type);
            Console.WriteLine("📛 名称: " + info.Name);
            Console.WriteLine("🧾 税号: " + info.TaxNumber);
            Console.WriteLine("📅 到期时间: " + info.NotAfter.ToString("yyyy-MM-dd HH:mm:ss"));
            Console.WriteLine("⏳ 剩余天数: " + info.DaysRemaining);
        }
    }
}

系统信息部分  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> 

 

🔒 针对 .NET Framework 4.0 的解决方案

要解决 403 错误（极有可能是 TLS 版本不兼容），您需要执行以下两个关键步骤：

1. 强制启用 TLS 1.2（最关键步骤）

在 .NET Framework 4.0 中，您需要通过代码显式设置 ServicePointManager.SecurityProtocol。但是，TLS 1.1 和 TLS 1.2 枚举值在 .NET Framework 4.5 版本中才被正式引入。

解决方案（通过类型转换）：

您必须使用其底层整数值来引用 TLS 1.1 和 TLS 1.2，以绕过编译时缺少枚举的问题。

using System.Net;

// 检查您的项目是否已经引用了 System.Net.dll

// 1. 定义或使用 TLS 1.2 和 TLS 1.1 的数值
// Tls12 = 3072 (十六进制 0xC00)
// Tls11 = 768 (十六进制 0x300)
const SslProtocols Tls12 = (SslProtocols)3072;
const SslProtocols Tls11 = (SslProtocols)768;
const SslProtocols SystemDefault = (SslProtocols)0; // SystemDefault 是 .NET 4.6.2+ 才有的，在 4.0 中忽略

public static void EnableTls12()
{
    // 强制全局使用 Tls12 和 Tls11（和旧的 Tls/Ssl3 兼容）
    ServicePointManager.SecurityProtocol = 
        (SecurityProtocolType)Tls12 | 
        (SecurityProtocolType)Tls11 | 
        SecurityProtocolType.Tls; 
        // SecurityProtocolType.Tls 对应 TLS 1.0
}

// 在应用程序启动或发送请求前调用此方法
EnableTls12();

注意： 您必须确保您的运行环境（运行您的程序的机器）已经安装了 .NET Framework 4.0 的最新更新，以确保底层操作系统（Windows）支持 TLS 1.2。

---

2. 证书加载和附加到 WebRequest 🔑

由于 .NET Framework 4.0 没有 HttpClient 类（它是在 4.5 引入的），您通常会使用 HttpWebRequest 类来发送请求。

证书加载代码（与之前类似）：

using System.Security.Cryptography.X509Certificates;
using System.Net;

// ... (您的 CertParser.Parse 方法) ...

// 假设这是您获取证书的方法
X509Certificate2 clientCert = new X509Certificate2(
    pfxPath, 
    password, 
    // 再次强调，使用 UserKeySet 确保私钥在当前用户下可访问
    X509KeyStorageFlags.Exportable | 
    X509KeyStorageFlags.PersistKeySet | 
    X509KeyStorageFlags.UserKeySet 
);

if (!clientCert.HasPrivateKey)
{
    throw new InvalidOperationException("Private key is missing/inaccessible.");
}

// ----------------------------------------------------------------

// HTTP 请求发送代码
public void SendVerifactuRequest(string url, X509Certificate2 cert)
{
    // 确保 TLS 1.2 已启用 (见上一步)
    EnableTls12(); 

    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
    request.Method = "POST";
    request.ContentType = "application/json"; // 或 VeriFactu 要求的其他类型

    // ⭐️ 关键：将客户端证书添加到请求中
    request.ClientCertificates.Add(cert);

    try
    {
        // 写入请求体（alta factura 数据）
        using (var stream = request.GetRequestStream())
        {
            // stream.Write(...); 
            // 写入您的 factura XML/JSON 数据
        }

        using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
        {
            if (response.StatusCode == HttpStatusCode.OK)
            {
                // 处理成功响应
                // ...
            }
            // ...
        }
    }
    catch (WebException ex)
    {
        // 处理 Web 异常，特别是 403 错误
        if (ex.Response is HttpWebResponse errorResponse && errorResponse.StatusCode == HttpStatusCode.Forbidden)
        {
            // 错误可能是 TLS 或证书问题，记录详情
            Console.WriteLine("Error 403 Forbidden: Check TLS version and certificate chain.");
        }
        else
        {
            // 其他网络错误
        }
    }
}

请优先尝试 第 1 步（强制启用 TLS 1.2）。如果服务器只支持 TLS 1.2，这是您在 .NET 4.0 中解决 403 错误的关键。

您是否想尝试使用这些修改后的代码，或者您需要我帮助您检查证书链的完整性？

2- 解析证书后 参考文档生成指纹  生成记录指纹或哈希的技术规范详情 

发送发票 /小票 hash 计算

数据需要以以上顺序生成 string 进行连接

如  nombreCampo1=valorCampo1&nombreCampo2=valorCampo2&nombreCampoN=valorCampoN

可参考一下代码 （官方代码 翻译  可能需要操作  合并xml ）

using System;
using System.Security.Cryptography;
using System.Text;

public class GeneradorHuella
{
    /// <summary>
    /// 计算 SHA-256 哈希并输出 Base64（与 Java 逻辑完全一致）
    /// </summary>
    public static string GetHashVerifactu(string msg)
    {
        try
        {
            using (var sha = SHA256.Create())
            {
                byte[] hash = sha.ComputeHash(Encoding.UTF8.GetBytes(msg));
                return Convert.ToBase64String(hash);
            }
        }
        catch (Exception e)
        {
            throw new Exception("生成 SHA 哈希时发生错误", e);
        }
    }

    /// <summary>
    /// 生成 RegistroAlta 记录对应的字段拼接字符串
    /// 顺序与 Java 完全相同
    /// </summary>
    public static string GetReferenciaRegistroAlta(
        string nifEmisor,
        string numFacturaSerie,
        string fechaExpedicion,
        string tipoFactura,
        string cuotaTotal,
        string importeTotal,
        string huellaAnterior,
        string fechaHoraUsoRegistro)
    {
        var sb = new StringBuilder();

        sb.Append(GetValorCampo("IDEmisorFactura", nifEmisor, true))
          .Append(GetValorCampo("NumSerieFactura", numFacturaSerie, true))
          .Append(GetValorCampo("FechaExpedicionFactura", fechaExpedicion, true))
          .Append(GetValorCampo("TipoFactura", tipoFactura, true))
          .Append(GetValorCampo("CuotaTotal", cuotaTotal, true))
          .Append(GetValorCampo("ImporteTotal", importeTotal, true))
          .Append(GetValorCampo("Huella", huellaAnterior, true))
          .Append(GetValorCampo("FechaHoraUsoRegistro", fechaHoraUsoRegistro, false)); // 最后一项不加 &

        return sb.ToString();
    }

    /// <summary>
    /// 生成一个字段的格式：Nombre=Valor 或 Nombre=Valor&
    /// </summary>
    public static string GetValorCampo(string nombre, string valor, bool separador)
    {
        string campo = nombre + "=" + (valor == null ? "" : valor.Trim());

        if (separador)
            return campo + "&";
        else
            return campo;
    }

    /// <summary>
    /// 计算 Alta 记录的 huella（Base64 SHA-256）
    /// </summary>
    public static string CalcularHuellaAlta(
        string nifEmisor,
        string numFacturaSerie,
        string fechaExpedicion,
        string tipoFactura,
        string cuotaTotal,
        string importeTotal,
        string huellaAnterior,
        string fechaHoraUsoRegistro)
    {
        string referencia = GetReferenciaRegistroAlta(
            nifEmisor,
            numFacturaSerie,
            fechaExpedicion,
            tipoFactura,
            cuotaTotal,
            importeTotal,
            huellaAnterior,
            fechaHoraUsoRegistro);

        return GetHashVerifactu(referencia);
    }
}

其他方法：

📌 1. 主入口（你只需要调用这个）

string xml = File.ReadAllText("miFactura.xml");
string huella = VerifactuHashGenerator.CalcularHuellaDesdeXml(xml);

Console.WriteLine("Huella generada = " + huella);

🚀 2. VerifactuHashGenerator.cs（完整可运行）

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Security.Cryptography;
using System.Text;
using System.Xml;

public static class VerifactuHashGenerator
{
    // =============================
    // PUBLIC ENTRY
    // =============================
    public static string CalcularHuellaDesdeXml(string xml)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml(xml);

        // Detectar tipo de registro (Alta / Evento / Anulación)
        string tipo = DetectarTipoRegistro(doc);

        // Obtener campos según el tipo
        var campos = tipo switch
        {
            "RegistroAlta" => ExtraerCamposRegistroAlta(doc),
            "RegistroEvento" => ExtraerCamposRegistroEvento(doc),
            "RegistroAnulacion" => ExtraerCamposRegistroAnulacion(doc),
            _ => throw new Exception("Tipo de registro no reconocido")
        };

        // Construir cadena ordenada
        string cadena = ConstruirCadena(campos);

        // Calcular hash HEX
        return Sha256Hex(cadena);
    }

    // =============================
    // DETECCIÓN DE TIPO DE REGISTRO
    // =============================
    private static string DetectarTipoRegistro(XmlDocument doc)
    {
        if (doc.GetElementsByTagName("RegistroAlta").Count > 0) return "RegistroAlta";
        if (doc.GetElementsByTagName("RegistroEvento").Count > 0) return "RegistroEvento";
        if (doc.GetElementsByTagName("RegistroAnulacion").Count > 0) return "RegistroAnulacion";

        throw new Exception("No se encontró nodo RegistroAlta / RegistroEvento / RegistroAnulacion");
    }

    // =============================
    // CAMPO EXTRACTION (ALTA)
    // =============================
    private static List<(string, string)> ExtraerCamposRegistroAlta(XmlDocument doc)
    {
        var lista = new List<(string, string)>();

        lista.Add(("IDEmisorFactura", Get(doc, "IDEmisorFactura")));
        lista.Add(("NumSerieFactura", Get(doc, "NumSerieFactura")));
        lista.Add(("FechaExpedicionFactura", Get(doc, "FechaExpedicionFactura")));
        lista.Add(("TipoFactura", Get(doc, "TipoFactura")));
        lista.Add(("CuotaTotal", NormalizarNumero(Get(doc, "CuotaTotal"))));
        lista.Add(("ImporteTotal", NormalizarNumero(Get(doc, "ImporteTotal"))));
        lista.Add(("Huella", Get(doc, "Huella")));
        lista.Add(("FechaHoraUsoRegistro", Get(doc, "FechaHoraUsoRegistro")));

        return lista;
    }

    // =============================
    // CAMPO EXTRACTION (EVENTO)
    // =============================
    private static List<(string, string)> ExtraerCamposRegistroEvento(XmlDocument doc)
    {
        var lista = new List<(string, string)>();

        lista.Add(("IDEmisorFactura", Get(doc, "IDEmisorFactura")));
        lista.Add(("NumSerieFactura", Get(doc, "NumSerieFactura")));
        lista.Add(("TipoEvento", Get(doc, "TipoEvento")));
        lista.Add(("DescripcionEvento", Get(doc, "DescripcionEvento")));
        lista.Add(("Huella", Get(doc, "Huella")));
        lista.Add(("FechaHoraUsoRegistro", Get(doc, "FechaHoraUsoRegistro")));

        return lista;
    }

    // =============================
    // CAMPO EXTRACTION (ANULACION)
    // =============================
    private static List<(string, string)> ExtraerCamposRegistroAnulacion(XmlDocument doc)
    {
        var lista = new List<(string, string)>();

        lista.Add(("IDEmisorFactura", Get(doc, "IDEmisorFactura")));
        lista.Add(("NumSerieFactura", Get(doc, "NumSerieFactura")));
        lista.Add(("FechaExpedicionFactura", Get(doc, "FechaExpedicionFactura")));
        lista.Add(("TipoFactura", Get(doc, "TipoFactura")));
        lista.Add(("MotivoAnulacion", Get(doc, "MotivoAnulacion")));
        lista.Add(("Huella", Get(doc, "Huella")));
        lista.Add(("FechaHoraUsoRegistro", Get(doc, "FechaHoraUsoRegistro")));

        return lista;
    }

    // =============================
    // XML GETTER
    // =============================
    private static string Get(XmlDocument doc, string tag)
    {
        var list = doc.GetElementsByTagName(tag);
        if (list.Count == 0) return "";
        return list[0].InnerText.Trim();
    }

    // =============================
    // STRING BUILDING
    // =============================
    private static string ConstruirCadena(List<(string campo, string valor)> lista)
    {
        var sb = new StringBuilder();

        for (int i = 0; i < lista.Count; i++)
        {
            bool addAmp = i < lista.Count - 1;
            sb.Append(lista[i].campo)
              .Append("=")
              .Append(lista[i].valor);

            if (addAmp) sb.Append("&");
        }

        return sb.ToString();
    }

    // =============================
    // NORMALIZACIÓN DE NUMEROS
    // =============================
    private static string NormalizarNumero(string raw)
    {
        if (decimal.TryParse(raw, NumberStyles.Any, CultureInfo.InvariantCulture, out var d))
            return d.ToString("G29", CultureInfo.InvariantCulture);

        return raw?.Trim();
    }

    // =============================
    // SHA256 → HEX
    // =============================
    private static string Sha256Hex(string input)
    {
        using var sha = SHA256.Create();
        byte[] bytes = sha.ComputeHash(Encoding.UTF8.GetBytes(input));
        var sb = new StringBuilder();

        foreach (var b in bytes)
            sb.Append(b.ToString("X2"));

        return sb.ToString();
    }
}

以下是针对西班牙税务局 (AEAT) Verifactu SOAP 服务的完整实现，使用 XML 和客户端证书发送请求：

对接流程： 

可直接用于 Veri*factu（AEAT tikeV1.0）发送 XML 的 C# 代码模板，包括：

• 加载 p12 客户端证书

• 创建 HttpClient

• 构造 SOAP XML

• 发送到 AEAT（测试 / 生产）

• 读取返回结果

• 兼容 Veri*factu Alta（RegistroAlta）、Envio、Consulta 等所有操作

1. 初始化 HttpClient（含证书）

using System.Net.Http;
using System.Security.Cryptography.X509Certificates;
using System.Net.Security;
using System.Text;

public class VeriFactuClient
{
    private readonly HttpClient _client;

    public VeriFactuClient(string certPath, string certPassword, bool ignoreSsl = false)
    {
        var handler = new HttpClientHandler();

        // 加载 p12证书
        var cert = new X509Certificate2(certPath, certPassword, X509KeyStorageFlags.MachineKeySet);
        handler.ClientCertificates.Add(cert);

        // 忽略 SSL（仅测试环境）
        if (ignoreSsl)
        {
            handler.ServerCertificateCustomValidationCallback = 
                HttpClientHandler.DangerousAcceptAnyServerCertificateValidator;
        }

        _client = new HttpClient(handler);
    }

HASH sha-256 加密方法

using System;
using System.Security.Cryptography;
using System.Text;

public class GeneradorHuella
{
    // =========================
    // SHA256 HEX (Base16)
    // =========================
    public static string GetHashVerifactu(string msg)
    {
        try
        {
            using (SHA256 sha = SHA256.Create())
            {
                byte[] digest = sha.ComputeHash(Encoding.UTF8.GetBytes(msg));
                return BytesToHex(digest); // 等效 Base16
            }
        }
        catch (Exception e)
        {
            throw new ArgumentException("Error al generar la huella SHA", e);
        }
    }

    private static string BytesToHex(byte[] data)
    {
        StringBuilder sb = new StringBuilder(data.Length * 2);
        foreach (byte b in data)
            sb.AppendFormat("{0:x2}", b);
        return sb.ToString();
    }

    // =========================
    // 生成 RegistroAlta 引用字符串
    // =========================
    public static string GetReferenciaRegistroAlta(
        string nifEmisor,
        string numFacturaSerie,
        string fechaExpedicion,
        string tipoFactura,
        string cuotaTotal,
        string importeTotal,
        string huellaAnterior,
        string fechaHoraUsoRegistro)
    {
        StringBuilder sb = new StringBuilder();

        sb.Append(GetValorCampo("IDEmisorFactura", nifEmisor, true))
          .Append(GetValorCampo("NumSerieFactura", numFacturaSerie, true))
          .Append(GetValorCampo("FechaExpedicionFactura", fechaExpedicion, true))
          .Append(GetValorCampo("TipoFactura", tipoFactura, true))
          .Append(GetValorCampo("CuotaTotal", cuotaTotal, true))
          .Append(GetValorCampo("ImporteTotal", importeTotal, true))
          .Append(GetValorCampo("Huella", huellaAnterior, true))
          .Append(GetValorCampo("FechaHoraUsoGenRegistro", fechaHoraUsoRegistro, false));

        return sb.ToString();
    }

    // =========================
    // 拼接 X="value";
    // =========================
    public static string GetValorCampo(string nombre, string valor, bool separador)
    {
        string campo = nombre + "=" + (valor == null ? "" : valor.Trim());
        return separador ? campo + ";" : campo;
    }

    // =========================
    // 拼接并 URL 编码
    // =========================
    public static string GetValorCampoEncoded(string nombre, string valor, bool separador)
    {
        string campo = nombre + "=" + Uri.EscapeDataString(valor ?? "");
        return separador ? campo + ";" : campo;
    }

    // =========================
    // 计算 huellaAlta
    // =========================
    public static string CalcularHuellaAlta(
        string nifEmisor,
        string numFacturaSerie,
        DateTime fechaExpedicion,
        string tipoFactura,
        string cuotaTotal,
        string importeTotal,
        string huellaAnterior,
        string fechaHoraUsoRegistro)
    {
        string fecha = fechaExpedicion.ToString("yyyy-MM-dd"); // Java 的 formatea()

        string refStr = GetReferenciaRegistroAlta(
            nifEmisor,
            numFacturaSerie,
            fecha,
            tipoFactura,
            cuotaTotal,
            importeTotal,
            huellaAnterior,
            fechaHoraUsoRegistro
        );

        return GetHashVerifactu(refStr);
    }
}

 Excel 中的 发送错误处理以及解释 以及决策 ：

表格总体说明

这是一张 “发票记录 ALTA（新增）类型操作” 的决策表，用于说明在不同情况下，SIF（Sistema Informático de Facturación）向 AEAT 上报发票信息时，应如何处理“Alta”（新增登记）、“Alta por rechazo”（因被拒绝而重新新增）、“Alta de subsanación”（因更正而新增）等操作。

表格横向分为：

• Operación：操作类型（Alta、Alta por rechazo、Alta de subsanación…）

• Descripción：该操作在什么情况下使用

• Operativa：该操作对应的字段（Subsanación / RechazoPrevio）

• Tipo SIF：适用于 VERIFACTU 或非 VERIFACTU 系统

• Condiciones：触发此类操作的条件

• Consecuencias：执行后的效果

• Situación en la AEAT：AEAT 当前是否已有相关记录 → 决定本次操作是否 OK 或 ERROR

最右侧三栏为 关键判断依据（仅适用于 VERI*FACTU）：

1. No existe registro de facturación：AEAT 中不存在记录

2. Existe registro de alta：AEAT 已存在一个 Alta 记录

3. Existe registro de anulación：AEAT 中存在该发票的 Anulación 记录

底部有 LEYENDA（图例），说明 OK(1)、ERROR(2)… 等含义。

---

🟨 第一部分：ALTA DE REGISTRO（普通新增）

✔ 用途：

正常开票时的新增登记。

🔧 Operativa：

• 不应发送 <Subsanacion> 或 <RechazoPrevio>

🔍 Condiciones：

• AEAT 中不应已有该发票的记录。

🎯 结果：

新增发票记录。

📊 决策：

• AEAT 无记录 → OK（1）

• AEAT 已有 Alta → ERROR（2）

• AEAT 有 Anulación → ERROR（2）

---

🟧 ALTA POR RECHAZO（因被拒重新提交）

当你之前发送的记录被 AEAT 拒绝后，需要重新发送，此时为“Alta por rechazo”。

🔧 Operativa：

• <Subsanacion> = S

• <RechazoPrevio> = X

🔍 Condiciones：

• 之前确实被 AEAT 拒绝

• AEAT 中不能存在已注册记录

📊 决策：

• AEAT 无记录 → Alta OK

• AEAT 已有 Alta → ERROR（2）

• AEAT 有 Anulación → ERROR（2）

---

🟩 ALTA DE SUBSANACIÓN（错误更正的新增）

用于更正已有记录的情况。

类型 1：有原记录且需更正（正常场景）

• AEAT 中应已有此发票记录

决策：

• AEAT 无记录 → ERROR（3）

• AEAT 有 Alta → OK（4）

• AEAT 有 Anulación → OK（5）

类型 2：原记录不存在且允许更正（特殊情况）

用于以下情形，例如：

• 在非 VERI*FACTU 状态下发票未按要求发送

• 系统切换后需补发

• 之前未上报但现在需要以“更正方式”上报

Operativa 可能包含：

• Subsanación = S

• RechazoPrevio = X（可选）

决策：

• AEAT 无记录 → OK（1）

• AEAT 有 Alta → ERROR（2）

• AEAT 有 Anulación → ERROR（2）

---

🟥 ALTA POR RECHAZO DE SUBSANACIÓN（更正也被拒绝后再次提交）

当你发送“更正记录”也被 AEAT 拒绝后，要再次发送。

Operativa：

• Subsanación = S

• RechazoPrevio = X

条件：

• 原记录不应存在于 AEAT

决策同前：

• AEAT 无记录 → OK（1）

• AEAT 有 Alta → ERROR（2）

• AEAT 有 Anulación → ERROR（2）

---

🟦 LEYENDA（图例解释）

---

📌 总结（简单理解）

---

如果你需要，我可以为你 将此表格转换为程序逻辑（if/else 或 flowchart），用于实现 Veri*factu 的自动决策。