@dwast/verifactu-lib 0.1.0-beta.1 → 0.1.0-beta.3

package/src/core/xml/generator.ts

@@ -1,17 +1,25 @@
-import type { Invoice } from '../models/invoice.js';
+import type { Invoice, SistemaInformatico } from '../models/invoice.js';
 
 /**
- * Datos de la factura que se anula.
+ * Datos de un registro de anulación (RegistroFacturacionAnulacionType).
  */
 export interface AnulacionInput {
   /** NIF del emisor de la factura anulada. */
   idEmisorFacturaAnulada: string;
   /** Número y serie de la factura anulada. */
   numSerieFacturaAnulada: string;
-  /** Fecha de expedición de la factura anulada. */
+  /** Fecha de expedición de la factura anulada (DD-MM-YYYY). */
   fechaExpedicionFacturaAnulada: string;
   /** Huella (hash) de la factura anulada. */
   huellaFacturaAnulada: string;
+  /** Sistema informático que genera el registro. */
+  sistemaInformatico: SistemaInformatico;
+  /** Fecha/hora de generación con huso horario. */
+  fechaHoraHusoGenRegistro: string;
+  /** Huella (hash) del propio registro de anulación. */
+  huella: string;
+  /** Versión del esquema (por defecto '1.0'). */
+  idVersion?: string;
 }
 
 /**
@@ -34,64 +42,85 @@ function formatAmount(value: number): string {
 }
 
 /**
- * Genera el XML Verifactu de una factura (registro de alta).
+ * Genera el elemento `<RegistroAlta>` de una factura (registro de alta).
  *
- * Estructura basada en el RD 1007/2023 y la documentación técnica de la
- * AEAT. NOTA: el esquema XSD oficial debe validarse antes de producción;
- * este esqueleto refleja los bloques principales (IDFactura, IDEmisorFactura,
- * TipoFactura, TipoDesglose, Desglose, CuotaTotal, Encadenamiento, Huella).
+ * Estructura según el XSD `SuministroInformacion.xsd` de la AEAT
+ * (`RegistroFacturacionAltaType`). NOTA: validar contra el XSD oficial
+ * antes de producción.
  */
-export function generateInvoiceXml(invoice: Invoice, previousHash: string | null): string {
-  const { id, emisor, desglose, tipoFactura, tipoDesglose } = invoice;
-
-  const detalles = desglose.tipoOperaciones
-    .map((op) => {
-      const iva = op.detallesIva
-        .map(
-          (d) =>
-            `      <DetalleIVA>` +
-            `<TipoImpositivo>${formatAmount(d.tipoImpositivo)}</TipoImpositivo>` +
-            `<BaseImponible>${formatAmount(d.baseImponible)}</BaseImponible>` +
-            `<CuotaRepercutida>${formatAmount(d.cuotaRepercutida)}</CuotaRepercutida>` +
-            `</DetalleIVA>`,
-        )
-        .join('\n');
-      return (
-        `    <DesgloseTipoOperacion>` +
-        `<TipoOperacion>${escapeXml(op.tipoOperacion)}</TipoOperacion>` +
-        `\n      <DesgloseIVA>\n${iva}\n      </DesgloseIVA>` +
-        `\n    </DesgloseTipoOperacion>`
-      );
-    })
+export function generateRegistroAltaXml(invoice: Invoice, previousHash: string | null): string {
+  const { id, emisor, desglose, tipoFactura, sistemaInformatico } = invoice;
+  const idVersion = invoice.idVersion ?? '1.0';
+  const descripcion = invoice.descripcion ?? '';
+
+  const detalles = desglose.detalles
+    .map(
+      (d) =>
+        `      <sf:DetalleDesglose>` +
+        (d.claveRegimen !== undefined
+          ? `<sf:ClaveRegimen>${escapeXml(d.claveRegimen)}</sf:ClaveRegimen>`
+          : '') +
+        `<sf:CalificacionOperacion>${escapeXml(d.calificacionOperacion)}</sf:CalificacionOperacion>` +
+        (d.tipoImpositivo !== undefined
+          ? `<sf:TipoImpositivo>${formatAmount(d.tipoImpositivo)}</sf:TipoImpositivo>`
+          : '') +
+        `<sf:BaseImponibleOimporteNoSujeto>${formatAmount(d.baseImponible)}</sf:BaseImponibleOimporteNoSujeto>` +
+        (d.cuotaRepercutida !== undefined
+          ? `<sf:CuotaRepercutida>${formatAmount(d.cuotaRepercutida)}</sf:CuotaRepercutida>`
+          : '') +
+        `</sf:DetalleDesglose>`,
+    )
     .join('\n');
 
+  const encadenamiento = previousHash
+    ? `    <sf:RegistroAnterior><sf:IDEmisorFactura>${escapeXml(emisor.nif)}</sf:IDEmisorFactura><sf:NumSerieFactura>${escapeXml(id.serie ?? '')}${escapeXml(id.numero)}</sf:NumSerieFactura><sf:FechaExpedicionFactura>${id.fechaExpedicion}</sf:FechaExpedicionFactura><sf:Huella>${previousHash}</sf:Huella></sf:RegistroAnterior>`
+    : `    <sf:PrimerRegistro>S</sf:PrimerRegistro>`;
+
   const xml = [
     '<?xml version="1.0" encoding="UTF-8"?>',
-    '<RegistroFactura>',
-    '  <IDFactura>',
-    '    <IDEmisorFactura>',
-    `      <NIF>${escapeXml(emisor.nif)}</NIF>`,
-    `      <NombreRazon>${escapeXml(emisor.nombreRazon)}</NombreRazon>`,
-    emisor.pais ? `      <Pais>${escapeXml(emisor.pais)}</Pais>` : '',
-    emisor.codigoPostal ? `      <CodigoPostal>${escapeXml(emisor.codigoPostal)}</CodigoPostal>` : '',
-    emisor.municipio ? `      <Municipio>${escapeXml(emisor.municipio)}</Municipio>` : '',
-    emisor.direccion ? `      <Direccion>${escapeXml(emisor.direccion)}</Direccion>` : '',
-    '    </IDEmisorFactura>',
-    id.serie ? `    <SerieFactura>${escapeXml(id.serie)}</SerieFactura>` : '',
-    `    <NumeroFactura>${escapeXml(id.numero)}</NumeroFactura>`,
-    `    <FechaExpedicionFactura>${id.fechaExpedicion}</FechaExpedicionFactura>`,
-    id.fechaOperacion ? `    <FechaOperacion>${id.fechaOperacion}</FechaOperacion>` : '',
-    '  </IDFactura>',
-    `  <TipoFactura>${tipoFactura}</TipoFactura>`,
-    `  <TipoDesglose>${tipoDesglose}</TipoDesglose>`,
-    '  <Desglose>',
+    `<sf:RegistroAlta xmlns:sf="${AEAT_INFORMACION_NAMESPACE}">`,
+    `  <sf:IDVersion>${idVersion}</sf:IDVersion>`,
+    '  <sf:IDFactura>',
+    `    <sf:IDEmisorFactura>${escapeXml(emisor.nif)}</sf:IDEmisorFactura>`,
+    `    <sf:NumSerieFactura>${escapeXml(id.serie ?? '')}${escapeXml(id.numero)}</sf:NumSerieFactura>`,
+    `    <sf:FechaExpedicionFactura>${id.fechaExpedicion}</sf:FechaExpedicionFactura>`,
+    '  </sf:IDFactura>',
+    `  <sf:NombreRazonEmisor>${escapeXml(emisor.nombreRazon)}</sf:NombreRazonEmisor>`,
+    `  <sf:TipoFactura>${tipoFactura}</sf:TipoFactura>`,
+    `  <sf:DescripcionOperacion>${escapeXml(descripcion)}</sf:DescripcionOperacion>`,
+    ...(invoice.destinatarios && invoice.destinatarios.length
+      ? [
+          '  <sf:Destinatarios>',
+          ...invoice.destinatarios.map(
+            (d) =>
+              `    <sf:IDDestinatario><sf:NombreRazon>${escapeXml(d.nombreRazon)}</sf:NombreRazon><sf:NIF>${escapeXml(d.nif)}</sf:NIF></sf:IDDestinatario>`,
+          ),
+          '  </sf:Destinatarios>',
+        ]
+      : []),
+    '  <sf:Desglose>',
     detalles,
-    '  </Desglose>',
-    `  <CuotaTotal>${formatAmount(desglose.cuotaTotal)}</CuotaTotal>`,
-    '  <Encadenamiento>',
-    `    <HashAnterior>${previousHash ?? ''}</HashAnterior>`,
-    '  </Encadenamiento>',
-    '</RegistroFactura>',
+    '  </sf:Desglose>',
+    `  <sf:CuotaTotal>${formatAmount(desglose.cuotaTotal)}</sf:CuotaTotal>`,
+    `  <sf:ImporteTotal>${formatAmount(desglose.importeTotal)}</sf:ImporteTotal>`,
+    '  <sf:Encadenamiento>',
+    encadenamiento,
+    '  </sf:Encadenamiento>',
+    '  <sf:SistemaInformatico>',
+    `    <sf:NombreRazon>${escapeXml(sistemaInformatico.nombreRazon)}</sf:NombreRazon>`,
+    `    <sf:NIF>${escapeXml(sistemaInformatico.nif)}</sf:NIF>`,
+    `    <sf:NombreSistemaInformatico>${escapeXml(sistemaInformatico.nombreSistemaInformatico)}</sf:NombreSistemaInformatico>`,
+    `    <sf:IdSistemaInformatico>${escapeXml(sistemaInformatico.idSistemaInformatico)}</sf:IdSistemaInformatico>`,
+    `    <sf:Version>${escapeXml(sistemaInformatico.version)}</sf:Version>`,
+    `    <sf:NumeroInstalacion>${escapeXml(sistemaInformatico.numeroInstalacion)}</sf:NumeroInstalacion>`,
+    '    <sf:TipoUsoPosibleSoloVerifactu>S</sf:TipoUsoPosibleSoloVerifactu>',
+    '    <sf:TipoUsoPosibleMultiOT>N</sf:TipoUsoPosibleMultiOT>',
+    '    <sf:IndicadorMultiplesOT>N</sf:IndicadorMultiplesOT>',
+    '  </sf:SistemaInformatico>',
+    `  <sf:FechaHoraHusoGenRegistro>${invoice.fechaHoraHusoGenRegistro}</sf:FechaHoraHusoGenRegistro>`,
+    '  <sf:TipoHuella>01</sf:TipoHuella>',
+    `  <sf:Huella>${invoice.huella}</sf:Huella>`,
+    '</sf:RegistroAlta>',
   ]
     .filter((line) => line !== '')
     .join('\n');
@@ -100,34 +129,244 @@ export function generateInvoiceXml(invoice: Invoice, previousHash: string | null
 }
 
 /**
- * Genera el XML Verifactu de un registro de anulación.
+ * Namespace del esquema `SuministroLR.xsd` de la AEAT.
+ */
+export const AEAT_SUMINISTRO_NAMESPACE =
+  'https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/SuministroLR.xsd';
+
+/**
+ * Namespace del esquema `SuministroInformacion.xsd` de la AEAT.
+ */
+export const AEAT_INFORMACION_NAMESPACE =
+  'https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/SuministroInformacion.xsd';
+
+/**
+ * Namespace del esquema `EventosSIF.xsd` de la AEAT (registro de eventos).
+ */
+export const AEAT_EVENTO_NAMESPACE =
+  'https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/EventosSIF.xsd';
+
+/**
+ * Cabecera del suministro (CabeceraType del XSD).
+ */
+export interface Cabecera {
+  /** Nombre o razón social del obligado a emitir. */
+  nombreRazon: string;
+  /** NIF del obligado a emitir. */
+  nif: string;
+  /** Representante del obligado (solo si el envío lo hace un representante). */
+  representante?: {
+    /** Nombre o razón social del representante. */
+    nombreRazon: string;
+    /** NIF del representante. */
+    nif: string;
+  };
+}
+
+/**
+ * Genera el elemento `<RegFactuSistemaFacturacion>` completo (operación SOAP),
+ * con la `Cabecera` y el `RegistroFactura` que envuelve el registro.
+ */
+export function generateSuministroXml(registroXml: string, cabecera: Cabecera): string {
+  const body = registroXml.replace(/^<\?xml[^>]*\?>\s*/, '');
+  const representante = cabecera.representante
+    ? [
+        '    <sf:Representante>',
+        `      <sf:NombreRazon>${escapeXml(cabecera.representante.nombreRazon)}</sf:NombreRazon>`,
+        `      <sf:NIF>${escapeXml(cabecera.representante.nif)}</sf:NIF>`,
+        '    </sf:Representante>',
+      ].join('\n')
+    : '';
+  return [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    `<sfLR:RegFactuSistemaFacturacion xmlns:sfLR="${AEAT_SUMINISTRO_NAMESPACE}" xmlns:sf="${AEAT_INFORMACION_NAMESPACE}">`,
+    '  <sfLR:Cabecera>',
+    '    <sf:ObligadoEmision>',
+    `      <sf:NombreRazon>${escapeXml(cabecera.nombreRazon)}</sf:NombreRazon>`,
+    `      <sf:NIF>${escapeXml(cabecera.nif)}</sf:NIF>`,
+    '    </sf:ObligadoEmision>',
+    representante,
+    '  </sfLR:Cabecera>',
+    '  <sfLR:RegistroFactura>',
+    body,
+    '  </sfLR:RegistroFactura>',
+    '</sfLR:RegFactuSistemaFacturacion>',
+  ].join('\n');
+}
+
+/**
+ * Construye la `Cabecera` del suministro, detectando si el certificado es de
+ * un representante.
+ *
+ * Si se proporciona el certificado en PEM y su NIF difiere del NIF del
+ * obligado, se añade el bloque `Representante` (el certificado actúa como
+ * representante del obligado), usando el nombre del titular del certificado.
+ */
+export function buildCabecera(
+  obligado: { nombreRazon: string; nif: string },
+  certificatePem?: string,
+  extractInfo?: (pem: string) => { nif: string; nombreRazon: string } | null,
+): Cabecera {
+  const cabecera: Cabecera = { nombreRazon: obligado.nombreRazon, nif: obligado.nif };
+  if (certificatePem && extractInfo) {
+    const info = extractInfo(certificatePem);
+    if (info && info.nif !== obligado.nif) {
+      cabecera.representante = { nombreRazon: info.nombreRazon, nif: info.nif };
+    }
+  }
+  return cabecera;
+}
+
+/**
+ * Genera el XML Verifactu de una factura (registro de alta).
+ *
+ * Alias de `generateRegistroAltaXml` por compatibilidad.
+ */
+export function generateInvoiceXml(invoice: Invoice, previousHash: string | null): string {
+  return generateRegistroAltaXml(invoice, previousHash);
+}
+
+/**
+ * Genera el XML Verifactu de un registro de anulación (`<sf:RegistroAnulacion>`).
  *
- * Referencia la factura anulada (IDFactura + Huella) y encadena con el hash
- * anterior. Estructura basada en el RD 1007/2023; validar contra el XSD
- * oficial antes de producción.
+ * Referencia la factura anulada (IDFactura) y encadena con el hash anterior.
+ * Estructura según el XSD `SuministroInformacion.xsd` (`RegistroFacturacionAnulacionType`).
  */
 export function generateAnulacionXml(
   anulacion: AnulacionInput,
   previousHash: string | null,
 ): string {
+  const idVersion = anulacion.idVersion ?? '1.0';
+  const si = anulacion.sistemaInformatico;
+  const encadenamiento = previousHash
+    ? `    <sf:RegistroAnterior><sf:IDEmisorFactura>${escapeXml(anulacion.idEmisorFacturaAnulada)}</sf:IDEmisorFactura><sf:NumSerieFactura>${escapeXml(anulacion.numSerieFacturaAnulada)}</sf:NumSerieFactura><sf:FechaExpedicionFactura>${anulacion.fechaExpedicionFacturaAnulada}</sf:FechaExpedicionFactura><sf:Huella>${previousHash}</sf:Huella></sf:RegistroAnterior>`
+    : `    <sf:PrimerRegistro>S</sf:PrimerRegistro>`;
+
+  return [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    `<sf:RegistroAnulacion xmlns:sf="${AEAT_INFORMACION_NAMESPACE}">`,
+    `  <sf:IDVersion>${idVersion}</sf:IDVersion>`,
+    '  <sf:IDFactura>',
+    `    <sf:IDEmisorFacturaAnulada>${escapeXml(anulacion.idEmisorFacturaAnulada)}</sf:IDEmisorFacturaAnulada>`,
+    `    <sf:NumSerieFacturaAnulada>${escapeXml(anulacion.numSerieFacturaAnulada)}</sf:NumSerieFacturaAnulada>`,
+    `    <sf:FechaExpedicionFacturaAnulada>${anulacion.fechaExpedicionFacturaAnulada}</sf:FechaExpedicionFacturaAnulada>`,
+    '  </sf:IDFactura>',
+    '  <sf:Encadenamiento>',
+    encadenamiento,
+    '  </sf:Encadenamiento>',
+    '  <sf:SistemaInformatico>',
+    `    <sf:NombreRazon>${escapeXml(si.nombreRazon)}</sf:NombreRazon>`,
+    `    <sf:NIF>${escapeXml(si.nif)}</sf:NIF>`,
+    `    <sf:NombreSistemaInformatico>${escapeXml(si.nombreSistemaInformatico)}</sf:NombreSistemaInformatico>`,
+    `    <sf:IdSistemaInformatico>${escapeXml(si.idSistemaInformatico)}</sf:IdSistemaInformatico>`,
+    `    <sf:Version>${escapeXml(si.version)}</sf:Version>`,
+    `    <sf:NumeroInstalacion>${escapeXml(si.numeroInstalacion)}</sf:NumeroInstalacion>`,
+    '    <sf:TipoUsoPosibleSoloVerifactu>S</sf:TipoUsoPosibleSoloVerifactu>',
+    '    <sf:TipoUsoPosibleMultiOT>N</sf:TipoUsoPosibleMultiOT>',
+    '    <sf:IndicadorMultiplesOT>N</sf:IndicadorMultiplesOT>',
+    '  </sf:SistemaInformatico>',
+    `  <sf:FechaHoraHusoGenRegistro>${anulacion.fechaHoraHusoGenRegistro}</sf:FechaHoraHusoGenRegistro>`,
+    '  <sf:TipoHuella>01</sf:TipoHuella>',
+    `  <sf:Huella>${anulacion.huella}</sf:Huella>`,
+    '</sf:RegistroAnulacion>',
+  ].join('\n');
+}
+
+/**
+ * Datos de un registro de evento (RegistroEvento, EventosSIF.xsd).
+ */
+export interface EventoInput {
+  /** Sistema informático que genera el evento. */
+  sistemaInformatico: SistemaInformatico;
+  /** Obligado a emitir (persona física o jurídica española). */
+  obligadoEmision: { nombreRazon: string; nif: string };
+  /** Fecha/hora de generación con huso horario (ISO 8601). */
+  fechaHoraHusoGenEvento: string;
+  /** Tipo de evento (01–10, 90). */
+  tipoEvento: string;
+  /** Huella (hash) del evento. */
+  huellaEvento: string;
+  /** Evento anterior de la cadena (obligatorio para el 2º evento en adelante). */
+  eventoAnterior?: {
+    /** Tipo de evento del evento anterior. */
+    tipoEvento: string;
+    /** Fecha/hora de generación del evento anterior. */
+    fechaHoraHusoGenEvento: string;
+    /** Huella (hash) del evento anterior. */
+    huellaEvento: string;
+  };
+  /** Versión del esquema (por defecto '1.0'). */
+  idVersion?: string;
+}
+
+/**
+ * Genera el XML Verifactu de un registro de evento (RegistroEvento).
+ *
+ * Estructura basada en `EventosSIF.xsd` (namespace `sf`). El evento se envía
+ * como un suministro independiente (no dentro de `RegFactuSistemaFacturacion`).
+ *
+ * El encadenado emite `<sf:PrimerEvento>S</sf:PrimerEvento>` si es el primer
+ * evento, o `<sf:EventoAnterior>` con los datos del evento previo si se
+ * proporciona `eventoAnterior`.
+ */
+export function generateEventoXml(evento: EventoInput): string {
+  const si = evento.sistemaInformatico;
+  const encadenamiento = evento.eventoAnterior
+    ? [
+        '    <sf:Encadenamiento>',
+        '      <sf:EventoAnterior>',
+        `        <sf:TipoEvento>${escapeXml(evento.eventoAnterior.tipoEvento)}</sf:TipoEvento>`,
+        `        <sf:FechaHoraHusoGenEvento>${evento.eventoAnterior.fechaHoraHusoGenEvento}</sf:FechaHoraHusoGenEvento>`,
+        `        <sf:HuellaEvento>${evento.eventoAnterior.huellaEvento}</sf:HuellaEvento>`,
+        '      </sf:EventoAnterior>',
+        '    </sf:Encadenamiento>',
+      ]
+    : ['    <sf:Encadenamiento>', '      <sf:PrimerEvento>S</sf:PrimerEvento>', '    </sf:Encadenamiento>'];
   const xml = [
     '<?xml version="1.0" encoding="UTF-8"?>',
-    '<RegistroFactura>',
-    '  <RegistroAnulacion>',
-    '    <IDFactura>',
-    '      <IDEmisorFactura>',
-    `        <NIF>${escapeXml(anulacion.idEmisorFacturaAnulada)}</NIF>`,
-    '      </IDEmisorFactura>',
-    `      <NumeroFactura>${escapeXml(anulacion.numSerieFacturaAnulada)}</NumeroFactura>`,
-    `      <FechaExpedicionFactura>${anulacion.fechaExpedicionFacturaAnulada}</FechaExpedicionFactura>`,
-    '    </IDFactura>',
-    `    <Huella>${anulacion.huellaFacturaAnulada}</Huella>`,
-    '  </RegistroAnulacion>',
-    '  <Encadenamiento>',
-    `    <HashAnterior>${previousHash ?? ''}</HashAnterior>`,
-    '  </Encadenamiento>',
-    '</RegistroFactura>',
+    `<sf:RegistroEvento xmlns:sf="${AEAT_EVENTO_NAMESPACE}">`,
+    `  <sf:IDVersion>${escapeXml(evento.idVersion ?? '1.0')}</sf:IDVersion>`,
+    '  <sf:Evento>',
+    '    <sf:SistemaInformatico>',
+    `      <sf:NombreRazon>${escapeXml(si.nombreRazon)}</sf:NombreRazon>`,
+    `      <sf:NIF>${escapeXml(si.nif)}</sf:NIF>`,
+    `      <sf:NombreSistemaInformatico>${escapeXml(si.nombreSistemaInformatico)}</sf:NombreSistemaInformatico>`,
+    `      <sf:IdSistemaInformatico>${escapeXml(si.idSistemaInformatico)}</sf:IdSistemaInformatico>`,
+    `      <sf:Version>${escapeXml(si.version)}</sf:Version>`,
+    `      <sf:NumeroInstalacion>${escapeXml(si.numeroInstalacion)}</sf:NumeroInstalacion>`,
+    '      <sf:TipoUsoPosibleSoloVerifactu>S</sf:TipoUsoPosibleSoloVerifactu>',
+    '      <sf:TipoUsoPosibleMultiOT>N</sf:TipoUsoPosibleMultiOT>',
+    '      <sf:IndicadorMultiplesOT>N</sf:IndicadorMultiplesOT>',
+    '    </sf:SistemaInformatico>',
+    '    <sf:ObligadoEmision>',
+    `      <sf:NombreRazon>${escapeXml(evento.obligadoEmision.nombreRazon)}</sf:NombreRazon>`,
+    `      <sf:NIF>${escapeXml(evento.obligadoEmision.nif)}</sf:NIF>`,
+    '    </sf:ObligadoEmision>',
+    `    <sf:FechaHoraHusoGenEvento>${evento.fechaHoraHusoGenEvento}</sf:FechaHoraHusoGenEvento>`,
+    `    <sf:TipoEvento>${escapeXml(evento.tipoEvento)}</sf:TipoEvento>`,
+    ...encadenamiento,
+    '    <sf:TipoHuella>01</sf:TipoHuella>',
+    `    <sf:HuellaEvento>${evento.huellaEvento}</sf:HuellaEvento>`,
+    '  </sf:Evento>',
+    '</sf:RegistroEvento>',
   ].join('\n');
 
   return xml;
 }
+
+/**
+ * Envuelve un elemento de operación Verifactu en el sobre SOAP que la AEAT
+ * espera en el envío. El XML de entrada DEBE ser ya el elemento de operación
+ * (p. ej. `<RegFactuSistemaFacturacion>` o `<ConsultaFactuSistemaFacturacion>`).
+ */
+export function buildRemisionEnvelope(operationXml: string): string {
+  const body = operationXml.replace(/^<\?xml[^>]*\?>\s*/, '');
+  return [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">',
+    '  <soap:Body>',
+    body,
+    '  </soap:Body>',
+    '</soap:Envelope>',
+  ].join('\n');
+}

package/src/integration/accountability.ts

@@ -0,0 +1,125 @@
+import type { Invoice } from '../core/models/invoice.js';
+import { generateInvoiceXml } from '../core/xml/generator.js';
+import { computeRegistroAlta } from '../core/hash/chain.js';
+import { buildQrPayload } from '../core/qr/qr.js';
+import { nowIsoWithOffset } from '../core/utils/date.js';
+import { VerifactuClient } from '../aeat/client.js';
+import { readP12 } from './p12.js';
+import type { VerifactuRepository, StoredRecord } from './repository.js';
+
+/**
+ * Configuración de la integración de accountability (contabilidad).
+ *
+ * Se puede aportar el material TLS ya extraído (`cert`/`key`) o el `.p12`
+ * en bruto (`p12Buffer` + `p12Password`). El NIF del emisor se aporta
+ * siempre en `nif` (la librería no interpreta los campos del certificado).
+ */
+export interface AccountabilityConfig {
+  /** URL base del servicio AEAT. */
+  baseUrl: string;
+  /** NIF del emisor. */
+  nif: string;
+  /** Certificado de cliente en PEM (mTLS). */
+  cert?: string;
+  /** Clave privada del cliente en PEM (mTLS). */
+  key?: string;
+  /** Contenido del `.p12` (alternativa a `cert`/`key`). */
+  p12Buffer?: Buffer;
+  /** Contraseña del `.p12`. */
+  p12Password?: string;
+}
+
+/**
+ * Integración de accountability (contabilidad) para Verifactu.
+ *
+ * Une las credenciales del certificado (`.p12`) con el cliente mTLS y la
+ * persistencia, para registrar facturas de forma verificable ante la AEAT.
+ */
+export class AccountabilityService {
+  private readonly client: VerifactuClient;
+  private readonly nif: string;
+
+  constructor(
+    private readonly repository: VerifactuRepository,
+    config: AccountabilityConfig,
+  ) {
+    let cert: string | undefined;
+    let key: string | undefined;
+
+    if (config.p12Buffer && config.p12Password) {
+      const content = readP12(config.p12Buffer, config.p12Password);
+      cert = content.certificates[0];
+      key = content.keys[0];
+    } else if (config.cert && config.key) {
+      cert = config.cert;
+      key = config.key;
+    }
+
+    if (!cert || !key) {
+      throw new Error(
+        'AccountabilityService requiere un .p12 (p12Buffer + p12Password) o cert/key PEM.',
+      );
+    }
+
+    this.nif = config.nif;
+    this.client = new VerifactuClient({ baseUrl: config.baseUrl, cert, key });
+  }
+
+  /**
+   * Registra una factura (alta) ante la AEAT, usando el certificado del
+   * emisor para autenticar el envío.
+   */
+  async registerInvoice(invoice: Invoice): Promise<StoredRecord> {
+    // El NIF del emisor se toma del certificado (o del config).
+    const invoiceConNif: Invoice = {
+      ...invoice,
+      emisor: { ...invoice.emisor, nif: this.nif },
+    };
+
+    const last = await this.repository.getLastRecord();
+    const previousHash = last?.hash ?? null;
+
+    const xml = generateInvoiceXml(invoiceConNif, previousHash);
+    const fechaHoraHusoGenRegistro = nowIsoWithOffset();
+    const hash = computeRegistroAlta({
+      idEmisorFactura: this.nif,
+      numSerieFactura: `${invoice.id.serie ?? ''}${invoice.id.numero}`,
+      fechaExpedicionFactura: invoice.id.fechaExpedicion,
+      tipoFactura: invoice.tipoFactura,
+      cuotaTotal: invoice.desglose.cuotaTotal.toFixed(2),
+      importeTotal: invoice.desglose.importeTotal.toFixed(2),
+      huellaAnterior: previousHash,
+      fechaHoraHusoGenRegistro,
+    });
+
+    const now = new Date().toISOString();
+    const record: StoredRecord = {
+      id: `${invoice.id.serie ?? ''}${invoice.id.numero}`,
+      invoiceId: `${invoice.id.serie ?? ''}${invoice.id.numero}`,
+      emisorNif: this.nif,
+      xml,
+      hash,
+      previousHash,
+      qrPayload: buildQrPayload(hash),
+      status: 'PENDING',
+      createdAt: now,
+      updatedAt: now,
+    };
+    await this.repository.saveRecord(record);
+
+    const result = await this.client.sendRecord(xml);
+    await this.repository.saveResponse({
+      id: `${record.id}-${Date.now()}`,
+      recordId: record.id,
+      operationId: result.operationId,
+      status: result.status,
+      message: result.message,
+      receivedAt: new Date().toISOString(),
+    });
+
+    const status = result.status === 'OK' ? 'CONFIRMED' : 'REJECTED';
+    await this.repository.updateRecordStatus(record.id, status);
+
+    return { ...record, status };
+  }
+}

package/src/integration/index.ts

@@ -1,2 +1,4 @@
 export * from './repository.js';
 export * from './service.js';
+export * from './p12.js';
+export * from './accountability.js';