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

package/src/core/xml/generator.ts

@@ -128,16 +128,6 @@ export function generateRegistroAltaXml(invoice: Invoice, previousHash: string |
   return xml;
 }
 
-/**
- * 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;
-}
-
 /**
  * Namespace del esquema `SuministroLR.xsd` de la AEAT.
  */
@@ -282,12 +272,6 @@ export function generateAnulacionXml(
   ].join('\n');
 }
 
-/**
- * Datos de un registro de evento (RegistroEvento).
- *
- * Nota: el `NIF` aparece dos veces: `nifSistemaInformatico` (del sistema
- * informático) y `nifObligado` (del obligado a emitir).
- */
 /**
  * Datos de un registro de evento (RegistroEvento, EventosSIF.xsd).
  */
@@ -302,6 +286,15 @@ export interface EventoInput {
   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;
 }
@@ -311,9 +304,24 @@ export interface EventoInput {
  *
  * 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"?>',
     `<sf:RegistroEvento xmlns:sf="${AEAT_EVENTO_NAMESPACE}">`,
@@ -336,9 +344,7 @@ export function generateEventoXml(evento: EventoInput): string {
     '    </sf:ObligadoEmision>',
     `    <sf:FechaHoraHusoGenEvento>${evento.fechaHoraHusoGenEvento}</sf:FechaHoraHusoGenEvento>`,
     `    <sf:TipoEvento>${escapeXml(evento.tipoEvento)}</sf:TipoEvento>`,
-    '    <sf:Encadenamiento>',
-    '      <sf:PrimerEvento>S</sf:PrimerEvento>',
-    '    </sf:Encadenamiento>',
+    ...encadenamiento,
     '    <sf:TipoHuella>01</sf:TipoHuella>',
     `    <sf:HuellaEvento>${evento.huellaEvento}</sf:HuellaEvento>`,
     '  </sf:Evento>',

package/src/integration/repository.ts

@@ -1,5 +1,4 @@
 import type { Invoice } from '../core/models/invoice.js';
-import type { Event } from '../core/models/event.js';
 
 /**
  * Estado de un registro de facturación en el sistema consumidor.
@@ -29,6 +28,8 @@ export interface StoredRecord {
   previousHash: string | null;
   /** Payload del QR Verifactu (URL de verificación con el hash). */
   qrPayload?: string;
+  /** `true` si la huella devuelta por AEAT coincide con la calculada. */
+  hashVerified?: boolean;
   /** Estado del registro. */
   status: RecordStatus;
   /** Fecha/hora de creación. */
@@ -83,6 +84,4 @@ export interface VerifactuRepository {
   saveResponse(response: StoredResponse): Promise<void>;
   /** Obtiene las respuestas de un registro. */
   getResponses(recordId: string): Promise<StoredResponse[]>;
-  /** Guarda un evento. */
-  saveEvent(event: Event): Promise<void>;
 }

package/src/integration/schema.sql

@@ -32,20 +32,6 @@ CREATE TABLE IF NOT EXISTS verifactu_responses (
     received_at   TIMESTAMP   NOT NULL DEFAULT CURRENT_TIMESTAMP
 );
 
--- Eventos (alta, anulación, modificación, eventos del sistema)
-CREATE TABLE IF NOT EXISTS verifactu_events (
-    id            VARCHAR(64)  PRIMARY KEY,
-    type          VARCHAR(16)  NOT NULL,           -- ALTA | ANULACION | MODIFICACION
-    fecha_hora    TIMESTAMP    NOT NULL,
-    invoice_id    VARCHAR(128),
-    motivo        TEXT,
-    factura_anulada VARCHAR(128),
-    hash          VARCHAR(64),
-    previous_hash VARCHAR(64),
-    created_at    TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP
-);
-
 -- Índices recomendados
 CREATE INDEX IF NOT EXISTS idx_records_invoice   ON verifactu_records (invoice_id);
 CREATE INDEX IF NOT EXISTS idx_responses_record  ON verifactu_responses (record_id);
-CREATE INDEX IF NOT EXISTS idx_events_invoice    ON verifactu_events (invoice_id);

package/src/integration/service.ts

@@ -1,6 +1,6 @@
 import type { Invoice } from '../core/models/invoice.js';
 import { generateInvoiceXml, generateSuministroXml, buildCabecera, generateAnulacionXml, generateEventoXml, type EventoInput } from '../core/xml/generator.js';
-import { computeRegistroAlta, computeRegistroAnulacion, computeRegistroEvento } from '../core/hash/chain.js';
+import { computeRegistroAlta, computeRegistroAnulacion, computeRegistroEvento, verifyRegistroAlta } from '../core/hash/chain.js';
 import { buildQrPayload } from '../core/qr/qr.js';
 import { nowIsoWithOffset } from '../core/utils/date.js';
 import { validateInvoice } from '../core/validation/validate.js';
@@ -90,11 +90,30 @@ export class VerifactuService {
       receivedAt: new Date().toISOString(),
     });
 
-    // 5. Actualizar el estado del registro según la respuesta.
+    // 5. Verificar la huella devuelta por AEAT (integridad del registro).
+    const aeatHash = result.registro?.huella;
+    const hashVerified =
+      result.status === 'OK' && aeatHash !== undefined
+        ? verifyRegistroAlta(
+            {
+              idEmisorFactura: invoice.emisor.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,
+            },
+            aeatHash,
+          )
+        : undefined;
+
+    // 6. Actualizar el estado del registro según la respuesta.
     const status = result.status === 'OK' ? 'CONFIRMED' : 'REJECTED';
     await this.repository.updateRecordStatus(record.id, status);
 
-    return { ...record, status };
+    return { ...record, status, hashVerified };
   }
 
   /**

package/src/core/models/event.ts

@@ -1,25 +0,0 @@
-/**
- * Tipos de evento de registro Verifactu.
- * - ALTA: alta de una factura.
- * - ANULACION: anulación de una factura previamente registrada.
- * - MODIFICACION: modificación de una factura.
- */
-export type EventType = 'ALTA' | 'ANULACION' | 'MODIFICACION';
-
-/**
- * Evento de registro Verifactu.
- */
-export interface Event {
-  /** Tipo de evento. */
-  type: EventType;
-  /** Fecha/hora del evento en formato ISO 8601. */
-  fechaHora: string;
-  /** Referencia a la factura asociada. */
-  invoiceId: string;
-  /** Motivo de anulación (obligatorio si type === 'ANULACION'). */
-  motivoAnulacion?: string;
-  /** Referencia a la factura que se anula (para ANULACION). */
-  facturaAnulada?: string;
-  /** Metadatos adicionales. */
-  metadata?: Record<string, unknown>;
-}