@dwast/verifactu-lib 0.1.0-beta.5 → 0.1.0-beta.7

package/dist/esm/integration/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/esm/integration/p12.d.ts

@@ -46,6 +46,34 @@ export interface CertificateInfo {
     /** Nombre o razón social del titular. */
     nombreRazon: string;
 }
+/**
+ * Campos decodificados de un certificado en PEM (para mostrar/validar).
+ */
+export interface DecodedCertificate {
+    /** NIF del titular. */
+    nif?: string;
+    /** Nombre o razón social del titular. */
+    nombreRazon?: string;
+    /** NIF del obligado representado (si el certificado es de un representante, `(R: X)`). */
+    representedNif?: string;
+    /** Número de serie del certificado. */
+    serialNumber?: string;
+    /** Emisor (CN u O del issuer). */
+    issuer?: string;
+    /** Sujeto (CN). */
+    subject?: string;
+    /** Fecha de validez desde (ISO). */
+    validFrom?: string;
+    /** Fecha de validez hasta (ISO). */
+    validTo?: string;
+    /** `true` si el certificado está caducado. */
+    expired?: boolean;
+}
+/**
+ * Decodifica los campos de un certificado en PEM. Devuelve un objeto vacío si
+ * no se puede parsear.
+ */
+export declare function decodeCertificate(pem: string): DecodedCertificate;
 /**
  * Extrae el NIF y el nombre/razón del titular de un certificado en PEM.
  *

package/dist/esm/integration/p12.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"p12.d.ts","sourceRoot":"","sources":["../../../src/integration/p12.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CA6BpE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBpE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAuC1E"}
+{"version":3,"file":"p12.d.ts","sourceRoot":"","sources":["../../../src/integration/p12.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CA6BpE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBpE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAsBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAuC1E"}

package/dist/esm/integration/p12.js

@@ -65,6 +65,34 @@ export function extractNifFromCertificate(pem) {
         return null;
     }
 }
+/**
+ * Decodifica los campos de un certificado en PEM. Devuelve un objeto vacío si
+ * no se puede parsear.
+ */
+export function decodeCertificate(pem) {
+    try {
+        const cert = forge.pki.certificateFromPem(pem);
+        const info = extractCertificateInfo(pem);
+        const now = new Date();
+        const validTo = cert.validity.notAfter;
+        const cn = cert.subject.getField('CN')?.value;
+        const representedNif = typeof cn === 'string' ? (cn.match(/\(R:\s*([A-Z0-9]{8,9})\)/i)?.[1] ?? undefined) : undefined;
+        return {
+            nif: info?.nif,
+            nombreRazon: info?.nombreRazon,
+            representedNif,
+            serialNumber: cert.serialNumber,
+            issuer: cert.issuer.getField('CN')?.value ?? cert.issuer.getField('O')?.value,
+            subject: cn,
+            validFrom: cert.validity.notBefore.toISOString(),
+            validTo: validTo.toISOString(),
+            expired: validTo.getTime() < now.getTime(),
+        };
+    }
+    catch {
+        return {};
+    }
+}
 /**
  * Extrae el NIF y el nombre/razón del titular de un certificado en PEM.
  *

package/dist/esm/integration/p12.js.map

@@ -1 +1 @@
-{"version":3,"file":"p12.js","sourceRoot":"","sources":["../../../src/integration/p12.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"p12.js","sourceRoot":"","sources":["../../../src/integration/p12.ts"],"names":[],"mappings":"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"}

package/dist/esm/integration/validate.d.ts

@@ -0,0 +1,54 @@
+import { type VerifactuEnv } from '../aeat/client.js';
+import { type DecodedCertificate } from './p12.js';
+/**
+ * Respuesta de AEAT a la factura de prueba de validación.
+ */
+export interface AeatValidationResponse {
+    /** Estado devuelto por AEAT (`OK` | `ERROR`). */
+    status: string;
+    /** Mensaje de AEAT. */
+    message?: string;
+    /** CSV de la factura de prueba (si AEAT la aceptó). */
+    csv?: string;
+    /** Identificador de la operación. */
+    operationId?: string;
+}
+/**
+ * Resultado de la validación de un `.p12` contra AEAT.
+ */
+export interface P12ValidationResult {
+    /** `true` si AEAT aceptó la factura de prueba con este certificado. */
+    valid: boolean;
+    /** Campos decodificados del certificado (para mostrar/validar la pass). */
+    certificate?: DecodedCertificate;
+    /** Respuesta de AEAT a la factura de prueba. */
+    aeat?: AeatValidationResponse;
+    /** Mensaje informativo. */
+    message?: string;
+    /** Descripción del error cuando la validación falla. */
+    error?: string;
+}
+export interface ValidateP12Options {
+    /** Entorno contra el que validar. Por defecto `test` (desarrollo). */
+    env?: VerifactuEnv;
+    /** Timeout de la petición en ms. */
+    timeoutMs?: number;
+}
+/**
+ * Valida un `.p12`/`.pfx` contra el entorno de AEAT indicado (por defecto el
+ * de **pruebas/desarrollo**).
+ *
+ * Pasos:
+ * 1. Lee el `.p12` y extrae certificado + clave privada (valida la contraseña).
+ * 2. Decodifica los campos del certificado (NIF, nombre, validez, emisor...).
+ * 3. Construye un `VerifactuClient` con mTLS y **emite una factura de prueba**
+ *    en el entorno indicado. Si AEAT la acepta, el certificado es válido.
+ *
+ * Devuelve los campos decodificados (para mostrar) y la respuesta de AEAT.
+ *
+ * @param buffer   Contenido del `.p12`/`.pfx`.
+ * @param password Contraseña del `.p12`.
+ * @param options  Entorno y timeout.
+ */
+export declare function validateP12AgainstAEAT(buffer: Buffer, password: string, options?: ValidateP12Options): Promise<P12ValidationResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/esm/integration/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/integration/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAsD,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAMvG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,gDAAgD;IAChD,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAmG9B"}

package/dist/esm/integration/validate.js

@@ -0,0 +1,121 @@
+import { VerifactuClient } from '../aeat/client.js';
+import { readP12, decodeCertificate, extractCertificateInfo } from './p12.js';
+import { computeRegistroAlta } from '../core/hash/chain.js';
+import { generateInvoiceXml, generateSuministroXml, buildCabecera } from '../core/xml/generator.js';
+import { nowIsoWithOffset } from '../core/utils/date.js';
+/** Convierte una fecha a `DD-MM-YYYY` (formato XSD `fecha` de AEAT). */
+function toDdMmYyyy(d) {
+    const dd = String(d.getDate()).padStart(2, '0');
+    const mm = String(d.getMonth() + 1).padStart(2, '0');
+    return `${dd}-${mm}-${d.getFullYear()}`;
+}
+/**
+ * Valida un `.p12`/`.pfx` contra el entorno de AEAT indicado (por defecto el
+ * de **pruebas/desarrollo**).
+ *
+ * Pasos:
+ * 1. Lee el `.p12` y extrae certificado + clave privada (valida la contraseña).
+ * 2. Decodifica los campos del certificado (NIF, nombre, validez, emisor...).
+ * 3. Construye un `VerifactuClient` con mTLS y **emite una factura de prueba**
+ *    en el entorno indicado. Si AEAT la acepta, el certificado es válido.
+ *
+ * Devuelve los campos decodificados (para mostrar) y la respuesta de AEAT.
+ *
+ * @param buffer   Contenido del `.p12`/`.pfx`.
+ * @param password Contraseña del `.p12`.
+ * @param options  Entorno y timeout.
+ */
+export async function validateP12AgainstAEAT(buffer, password, options = {}) {
+    const env = options.env ?? 'test';
+    let content;
+    try {
+        content = readP12(buffer, password);
+    }
+    catch (e) {
+        return { valid: false, error: `No se pudo leer el .p12: ${e.message}` };
+    }
+    const cert = content.certificates[0];
+    const key = content.keys[0];
+    if (!cert || !key) {
+        return { valid: false, error: 'El .p12 no contiene certificado y clave privada.' };
+    }
+    const certificate = decodeCertificate(cert);
+    // El emisor de la factura es el OBLIGADO (representado). Si el certificado es
+    // de un representante, el NIF del obligado está en `representedNif`.
+    const obligadoNif = certificate.representedNif ?? certificate.nif ?? '';
+    const nombreRazon = certificate.nombreRazon ?? '';
+    const client = new VerifactuClient({
+        env,
+        cert,
+        key,
+        timeoutMs: options.timeoutMs ?? 15_000,
+    });
+    // Factura de prueba mínima para validar el certificado end-to-end.
+    const now = new Date();
+    const numeroInstalacion = `VAL${Date.now()}`;
+    const invoice = {
+        id: { serie: 'T', numero: `VAL${Date.now()}`, fechaExpedicion: toDdMmYyyy(now) },
+        emisor: { nif: obligadoNif, nombreRazon },
+        tipoFactura: 'F1',
+        tipoDesglose: 'S1',
+        descripcion: 'Factura de prueba de validación de certificado',
+        destinatarios: [{ nombreRazon, nif: obligadoNif }],
+        desglose: {
+            detalles: [
+                { calificacionOperacion: 'S1', claveRegimen: '01', tipoImpositivo: 21, baseImponible: 1, cuotaRepercutida: 0.21 },
+            ],
+            cuotaTotal: 0.21,
+            importeTotal: 1.21,
+        },
+        sistemaInformatico: {
+            nombreRazon,
+            nif: obligadoNif,
+            nombreSistemaInformatico: 'VALIDACION',
+            idSistemaInformatico: '01',
+            version: '1.0',
+            numeroInstalacion,
+        },
+        fechaHoraHusoGenRegistro: nowIsoWithOffset(),
+        huella: '',
+    };
+    try {
+        // El hash se calcula sobre el MISMO `fechaHoraHusoGenRegistro` que va en el
+        // XML (si no, la huella no coincide con el contenido y AEAT lo rechaza).
+        const hash = computeRegistroAlta({
+            idEmisorFactura: obligadoNif,
+            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: null,
+            fechaHoraHusoGenRegistro: invoice.fechaHoraHusoGenRegistro,
+        });
+        invoice.huella = hash;
+        const registroAltaXml = generateInvoiceXml(invoice, null);
+        const cabecera = buildCabecera({ nombreRazon, nif: obligadoNif }, cert, extractCertificateInfo);
+        const xml = generateSuministroXml(registroAltaXml, cabecera);
+        const result = await client.sendRecord(xml);
+        return {
+            valid: result.status === 'OK',
+            certificate,
+            aeat: {
+                status: result.status,
+                message: result.message,
+                csv: result.registro?.csv,
+                operationId: result.operationId,
+            },
+            message: result.status === 'OK'
+                ? `Certificado aceptado por AEAT (${env}). Factura de prueba enviada.`
+                : `AEAT respondió con error: ${result.message ?? result.errorCode ?? ''}`,
+        };
+    }
+    catch (e) {
+        return {
+            valid: false,
+            certificate,
+            error: `AEAT rechazó el certificado: ${e.message}`,
+        };
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/esm/integration/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/integration/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dwast/verifactu-lib",
-  "version": "0.1.0-beta.5",
+  "version": "0.1.0-beta.7",
   "description": "Librería para la gestión de Verifactu (RD 1007/2023): modelo de datos, encadenado hash, generación XML, QR y cliente AEAT.",
   "type": "module",
   "main": "./dist/cjs/index.js",

package/readme.md

@@ -53,7 +53,7 @@ Guía práctica paso a paso. La receta recomendada es **`VerifactuService`** (se
 
 ### 0. Configuración inicial (certificado `.p12` → cliente)
 
-Extrae `cert` + `key` del `.p12` y construye el cliente (aquí en entorno de **pruebas**; en producción usa `baseUrl` y no pases `env`).
+Extrae `cert` + `key` del `.p12` y construye el cliente (aquí en entorno de **pruebas**; en producción no pases `env`).
 
 ```ts
 import { readFileSync } from 'node:fs';
@@ -83,7 +83,7 @@ const repo: VerifactuRepository = /* tu implementación (Mongoose, Prisma...) */
 const service = new VerifactuService(repo, client, certificates[0]);
 ```
 
-> **Entornos:** `env: 'test'`/`'development'` usa la URL de pruebas de AEAT (`AEAT_TEST_SOAP_URL`) por defecto; `env: 'production'` (o no indicar `env`) usa la de producción (`AEAT_PRODUCTION_SOAP_URL`). Puedes sobrescribir con `testBaseUrl`/`baseUrl` si necesitas otra URL.
+> **Entornos:** `env: 'test'`/`'development'` usa la URL de pruebas de AEAT (`AEAT_TEST_SOAP_URL`); `env: 'production'` usa la de producción (`AEAT_PRODUCTION_SOAP_URL`). También puedes fijar `VERIFACTU_ENV`/`NODE_ENV` en el entorno. Si no se determina el entorno, se usa la URL de **pruebas** por defecto.
 
 ### 1. Enviar 1 factura (alta)
 
@@ -439,8 +439,6 @@ const client = new VerifactuClient({
 
 | Campo | Descripción |
 |-------|-------------|
-| `baseUrl` | URL del endpoint SOAP en producción (default `AEAT_PRODUCTION_SOAP_URL`) |
-| `testBaseUrl` | URL del endpoint SOAP en pruebas (default `AEAT_TEST_SOAP_URL`) |
 | `env` | `production` (default) \| `test` \| `development` |
 | `authToken` | Token OAuth alternativo al certificado |
 | `cert` / `key` | Certificado y clave PEM (mTLS) |
@@ -448,7 +446,7 @@ const client = new VerifactuClient({
 | `namespace` | Namespace del servicio |
 | `timeoutMs` | Timeout de petición (default 10s) |
 
-**Regla de entorno:** por defecto se usa **producción**. Si `env` es `production` (o no se indica), usa `baseUrl` o la URL de producción de AEAT. Si `env` es `test`/`development`, usa `testBaseUrl` o la URL de pruebas de AEAT. Así, para hacer pruebas basta con `new VerifactuClient({ env: 'test', cert, key })`.
+**Regla de entorno:** el entorno se resuelve así: `config.env` → `VERIFACTU_ENV` → `NODE_ENV` → **`test`** (por defecto). Si el entorno es `production`, usa `AEAT_PRODUCTION_SOAP_URL`; si es `test`/`development`, usa `AEAT_TEST_SOAP_URL`. Si el valor no es `production`/`test`/`development`, se usa `test` como fallback (nunca lanza error), para no enviar facturas reales a producción por un valor inesperado.
 
 ### Métodos
 
@@ -662,6 +660,23 @@ const info = extractCertificateInfo(certPem);   // { nif, nombreRazon } | null
 const nif = extractNifFromCertificate(certPem); // NIF del certificado | null
 ```
 
+### Validación del `.p12` contra AEAT (`validateP12AgainstAEAT`)
+
+Valida un `.p12`/`.pfx` contra el entorno de AEAT (por defecto **pruebas/desarrollo**): lee el `.p12` (comprueba la contraseña), decodifica los campos del certificado y **emite una factura de prueba** en AEAT. Devuelve los campos decodificados (para mostrar) y la respuesta de AEAT.
+
+```ts
+import { validateP12AgainstAEAT } from '@dwast/verifactu-lib/integration';
+
+const result = await validateP12AgainstAEAT(buffer, password, { env: 'test' });
+
+// result.valid          → true si AEAT aceptó la factura de prueba
+// result.certificate    → { nif, nombreRazon, representedNif, serialNumber, issuer, subject, validFrom, validTo, expired }
+// result.aeat           → { status, message, csv, operationId }
+```
+
+- Si el certificado es de un **representante**, el NIF del obligado se extrae del commonName (`(R: XXXXXXXXX)`) y se usa como emisor de la factura de prueba; `buildCabecera` añade el bloque `Representante` automáticamente.
+- `valid` es `true` solo si AEAT acepta la factura de prueba (`status: 'OK'`).
+
 ### Detección de representante
 
 Si el NIF del certificado difiere del NIF del obligado a emitir, el certificado actúa como **representante** y se añade el bloque `Representante` en la cabecera:

package/src/aeat/client.ts

@@ -98,24 +98,42 @@ export interface VerifactuClientConfig {
   timeoutMs?: number;
 }
 
+/**
+ * Resuelve el entorno efectivo.
+ *
+ * Orden de precedencia:
+ * 1. `config.env` (si se pasa explícito).
+ * 2. Variable de entorno `VERIFACTU_ENV` (si está definida).
+ * 3. Variable de entorno `NODE_ENV` (si está definida).
+ * 4. `test` (por defecto).
+ *
+ * Regla: **solo `production` usa la URL de producción; cualquier otro valor
+ * (o ninguno) usa `test`**. Así nunca se envían facturas reales a producción
+ * por un valor de entorno inesperado.
+ */
+export function resolveEnv(config: Pick<VerifactuClientConfig, 'env'>): VerifactuEnv {
+  const raw = config.env ?? process.env.VERIFACTU_ENV ?? process.env.NODE_ENV ?? 'test';
+  return raw === 'production' ? 'production' : 'test';
+}
+
 /**
  * Resuelve la URL base efectiva según el entorno.
  *
  * Regla: **por defecto se usa producción** (la app real factura en prod).
- * - Si `env` es `production` (o no se indica), usa `baseUrl` o, si no se
- *   aporta, la URL de producción de AEAT (`AEAT_PRODUCTION_SOAP_URL`).
- * - Si `env` es `test`/`development`, usa `testBaseUrl` o, si no se aporta,
- *   la URL de pruebas de AEAT (`AEAT_TEST_SOAP_URL`).
+ * - Si el entorno es `production`, usa `baseUrl` o, si no se aporta, la URL
+ *   de producción de AEAT (`AEAT_PRODUCTION_SOAP_URL`).
+ * - Si el entorno es `test`/`development`, usa `testBaseUrl` o, si no se
+ *   aporta, la URL de pruebas de AEAT (`AEAT_TEST_SOAP_URL`).
  *
  * Así, para hacer pruebas basta con `new VerifactuClient({ env: 'test', cert, key })`
- * sin tener que conocer la URL de desarrollo.
+ * o con `VERIFACTU_ENV=test` en el entorno, sin conocer la URL de desarrollo.
  */
 export function resolveBaseUrl(config: Pick<VerifactuClientConfig, 'baseUrl' | 'testBaseUrl' | 'env'>): string {
-  const env = config.env ?? 'production';
+  const env = resolveEnv(config);
   if (env !== 'production') {
-    return config.testBaseUrl ?? AEAT_TEST_SOAP_URL;
+    return AEAT_TEST_SOAP_URL;
   }
-  return config.baseUrl ?? AEAT_PRODUCTION_SOAP_URL;
+  return AEAT_PRODUCTION_SOAP_URL;
 }
 
 export interface SendResult {

package/src/integration/index.ts

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

package/src/integration/p12.ts

@@ -105,6 +105,58 @@ export interface CertificateInfo {
   nombreRazon: string;
 }
 
+/**
+ * Campos decodificados de un certificado en PEM (para mostrar/validar).
+ */
+export interface DecodedCertificate {
+  /** NIF del titular. */
+  nif?: string;
+  /** Nombre o razón social del titular. */
+  nombreRazon?: string;
+  /** NIF del obligado representado (si el certificado es de un representante, `(R: X)`). */
+  representedNif?: string;
+  /** Número de serie del certificado. */
+  serialNumber?: string;
+  /** Emisor (CN u O del issuer). */
+  issuer?: string;
+  /** Sujeto (CN). */
+  subject?: string;
+  /** Fecha de validez desde (ISO). */
+  validFrom?: string;
+  /** Fecha de validez hasta (ISO). */
+  validTo?: string;
+  /** `true` si el certificado está caducado. */
+  expired?: boolean;
+}
+
+/**
+ * Decodifica los campos de un certificado en PEM. Devuelve un objeto vacío si
+ * no se puede parsear.
+ */
+export function decodeCertificate(pem: string): DecodedCertificate {
+  try {
+    const cert = forge.pki.certificateFromPem(pem);
+    const info = extractCertificateInfo(pem);
+    const now = new Date();
+    const validTo = cert.validity.notAfter;
+    const cn = cert.subject.getField('CN')?.value;
+    const representedNif = typeof cn === 'string' ? (cn.match(/\(R:\s*([A-Z0-9]{8,9})\)/i)?.[1] ?? undefined) : undefined;
+    return {
+      nif: info?.nif,
+      nombreRazon: info?.nombreRazon,
+      representedNif,
+      serialNumber: cert.serialNumber,
+      issuer: cert.issuer.getField('CN')?.value ?? cert.issuer.getField('O')?.value,
+      subject: cn,
+      validFrom: cert.validity.notBefore.toISOString(),
+      validTo: validTo.toISOString(),
+      expired: validTo.getTime() < now.getTime(),
+    };
+  } catch {
+    return {};
+  }
+}
+
 /**
  * Extrae el NIF y el nombre/razón del titular de un certificado en PEM.
  *

package/src/integration/validate.ts

@@ -0,0 +1,171 @@
+import { VerifactuClient, type VerifactuEnv } from '../aeat/client.js';
+import { readP12, decodeCertificate, extractCertificateInfo, type DecodedCertificate } from './p12.js';
+import { computeRegistroAlta } from '../core/hash/chain.js';
+import { generateInvoiceXml, generateSuministroXml, buildCabecera } from '../core/xml/generator.js';
+import { nowIsoWithOffset } from '../core/utils/date.js';
+import type { Invoice } from '../core/models/invoice.js';
+
+/**
+ * Respuesta de AEAT a la factura de prueba de validación.
+ */
+export interface AeatValidationResponse {
+  /** Estado devuelto por AEAT (`OK` | `ERROR`). */
+  status: string;
+  /** Mensaje de AEAT. */
+  message?: string;
+  /** CSV de la factura de prueba (si AEAT la aceptó). */
+  csv?: string;
+  /** Identificador de la operación. */
+  operationId?: string;
+}
+
+/**
+ * Resultado de la validación de un `.p12` contra AEAT.
+ */
+export interface P12ValidationResult {
+  /** `true` si AEAT aceptó la factura de prueba con este certificado. */
+  valid: boolean;
+  /** Campos decodificados del certificado (para mostrar/validar la pass). */
+  certificate?: DecodedCertificate;
+  /** Respuesta de AEAT a la factura de prueba. */
+  aeat?: AeatValidationResponse;
+  /** Mensaje informativo. */
+  message?: string;
+  /** Descripción del error cuando la validación falla. */
+  error?: string;
+}
+
+export interface ValidateP12Options {
+  /** Entorno contra el que validar. Por defecto `test` (desarrollo). */
+  env?: VerifactuEnv;
+  /** Timeout de la petición en ms. */
+  timeoutMs?: number;
+}
+
+/** Convierte una fecha a `DD-MM-YYYY` (formato XSD `fecha` de AEAT). */
+function toDdMmYyyy(d: Date): string {
+  const dd = String(d.getDate()).padStart(2, '0');
+  const mm = String(d.getMonth() + 1).padStart(2, '0');
+  return `${dd}-${mm}-${d.getFullYear()}`;
+}
+
+/**
+ * Valida un `.p12`/`.pfx` contra el entorno de AEAT indicado (por defecto el
+ * de **pruebas/desarrollo**).
+ *
+ * Pasos:
+ * 1. Lee el `.p12` y extrae certificado + clave privada (valida la contraseña).
+ * 2. Decodifica los campos del certificado (NIF, nombre, validez, emisor...).
+ * 3. Construye un `VerifactuClient` con mTLS y **emite una factura de prueba**
+ *    en el entorno indicado. Si AEAT la acepta, el certificado es válido.
+ *
+ * Devuelve los campos decodificados (para mostrar) y la respuesta de AEAT.
+ *
+ * @param buffer   Contenido del `.p12`/`.pfx`.
+ * @param password Contraseña del `.p12`.
+ * @param options  Entorno y timeout.
+ */
+export async function validateP12AgainstAEAT(
+  buffer: Buffer,
+  password: string,
+  options: ValidateP12Options = {},
+): Promise<P12ValidationResult> {
+  const env = options.env ?? 'test';
+
+  let content;
+  try {
+    content = readP12(buffer, password);
+  } catch (e) {
+    return { valid: false, error: `No se pudo leer el .p12: ${(e as Error).message}` };
+  }
+
+  const cert = content.certificates[0];
+  const key = content.keys[0];
+  if (!cert || !key) {
+    return { valid: false, error: 'El .p12 no contiene certificado y clave privada.' };
+  }
+
+  const certificate = decodeCertificate(cert);
+  // El emisor de la factura es el OBLIGADO (representado). Si el certificado es
+  // de un representante, el NIF del obligado está en `representedNif`.
+  const obligadoNif = certificate.representedNif ?? certificate.nif ?? '';
+  const nombreRazon = certificate.nombreRazon ?? '';
+
+  const client = new VerifactuClient({
+    env,
+    cert,
+    key,
+    timeoutMs: options.timeoutMs ?? 15_000,
+  });
+
+  // Factura de prueba mínima para validar el certificado end-to-end.
+  const now = new Date();
+  const numeroInstalacion = `VAL${Date.now()}`;
+  const invoice: Invoice = {
+    id: { serie: 'T', numero: `VAL${Date.now()}`, fechaExpedicion: toDdMmYyyy(now) },
+    emisor: { nif: obligadoNif, nombreRazon },
+    tipoFactura: 'F1',
+    tipoDesglose: 'S1',
+    descripcion: 'Factura de prueba de validación de certificado',
+    destinatarios: [{ nombreRazon, nif: obligadoNif }],
+    desglose: {
+      detalles: [
+        { calificacionOperacion: 'S1', claveRegimen: '01', tipoImpositivo: 21, baseImponible: 1, cuotaRepercutida: 0.21 },
+      ],
+      cuotaTotal: 0.21,
+      importeTotal: 1.21,
+    },
+    sistemaInformatico: {
+      nombreRazon,
+      nif: obligadoNif,
+      nombreSistemaInformatico: 'VALIDACION',
+      idSistemaInformatico: '01',
+      version: '1.0',
+      numeroInstalacion,
+    },
+    fechaHoraHusoGenRegistro: nowIsoWithOffset(),
+    huella: '',
+  };
+
+  try {
+    // El hash se calcula sobre el MISMO `fechaHoraHusoGenRegistro` que va en el
+    // XML (si no, la huella no coincide con el contenido y AEAT lo rechaza).
+    const hash = computeRegistroAlta({
+      idEmisorFactura: obligadoNif,
+      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: null,
+      fechaHoraHusoGenRegistro: invoice.fechaHoraHusoGenRegistro,
+    });
+    invoice.huella = hash;
+
+    const registroAltaXml = generateInvoiceXml(invoice, null);
+    const cabecera = buildCabecera({ nombreRazon, nif: obligadoNif }, cert, extractCertificateInfo);
+    const xml = generateSuministroXml(registroAltaXml, cabecera);
+    const result = await client.sendRecord(xml);
+
+    return {
+      valid: result.status === 'OK',
+      certificate,
+      aeat: {
+        status: result.status,
+        message: result.message,
+        csv: result.registro?.csv,
+        operationId: result.operationId,
+      },
+      message:
+        result.status === 'OK'
+          ? `Certificado aceptado por AEAT (${env}). Factura de prueba enviada.`
+          : `AEAT respondió con error: ${result.message ?? result.errorCode ?? ''}`,
+    };
+  } catch (e) {
+    return {
+      valid: false,
+      certificate,
+      error: `AEAT rechazó el certificado: ${(e as Error).message}`,
+    };
+  }
+}