Ir al contenido

Enviar a la AEAT

La AEAT solo acepta conexiones que presenten un certificado emitido a tu nombre o al de tu empresa. La biblioteca no lee certificados. En su lugar, le pasas un fetch que presenta el tuyo.

En Node, puedes hacerlo con undici y tu archivo de certificado (.p12 o .pfx):

Ventana de terminal
npm install undici
import { Agent } from "undici";
function createCertificateFetch(pfx: Buffer, passphrase: string): typeof fetch {
const dispatcher = new Agent({ connect: { pfx, passphrase } });
return (url, init) => fetch(url, { ...init, dispatcher } as RequestInit & { dispatcher: Agent });
}

Carga el archivo y su contraseña desde donde guardes tus secretos y luego llama a createCertificateFetch(file, passphrase). Pruébalo con el entorno de pruebas de la AEAT antes de usarlo en producción.

Elige la dirección según el tipo de certificado que tengas. Cada una tiene una dirección de production y otra de preproduction (pruebas).

Certificado Direcciones
Un certificado personal o de representante SOAP_ENDPOINTS
Un certificado de sello de entidad SOAP_ENDPOINTS_SELLO

La cabecera indica el emisor cuyas facturas envías. El emisor de cada registro debe coincidir con él. Un lote admite hasta 1.000 registros, facturas y anulaciones mezcladas, en el orden en que los creaste.

import {
buildAnulacionRecord,
createClient,
MAX_REGISTROS_POR_ENVIO,
SOAP_ENDPOINTS,
type EnvioRegistro,
} from "@waitron/verifactu";
const cancellation = buildAnulacionRecord({
IDEmisorFacturaAnulada: record.IDFactura.IDEmisorFactura,
NumSerieFacturaAnulada: record.IDFactura.NumSerieFactura,
FechaExpedicionFacturaAnulada: sale.FechaExpedicionFactura,
Encadenamiento: { RegistroAnterior: { ...record.IDFactura, Huella: record.Huella } },
SistemaInformatico: software,
generadoEn: new Date("2026-07-20T12:05:00Z"),
offsetMinutes: 120,
});
const batch: EnvioRegistro[] = [{ RegistroAlta: record }, { RegistroAnulacion: cancellation }];
console.log(batch.length <= MAX_REGISTROS_POR_ENVIO); // true
const client = createClient({ endpoint: SOAP_ENDPOINTS.preproduction, fetch: certificateFetch });
const reply = await client.submit({ ObligadoEmision: seller }, batch);
console.log(reply.RespuestaLinea.length); // 2

submitRecords de @waitron/verifactu/facade hace lo mismo en una sola llamada, y recibe los registros tal cual, sin envolverlos en RegistroAlta y RegistroAnulacion.

En modalidad Veri*Factu, envía cada registro cuando emitas la factura. Tras cada envío, la AEAT te indica cuántos segundos esperar antes del siguiente (TiempoEsperaEnvio). Los registros que crees mientras tanto esperan en tu cola. Solo puedes enviar antes si la cola llega a 1.000 registros.

Si envías en nombre del emisor, añádete como Representante en la cabecera:

import type { Cabecera } from "@waitron/verifactu";
const header: Cabecera = {
ObligadoEmision: seller,
Representante: { NombreRazon: "Advisor SL", NIF: "B12345674" },
};

Este campo por sí solo no te da derecho a enviar. También necesitas la autorización del emisor, en la forma que la AEAT acepta, y un certificado que la AEAT acepte para representarlo.

La biblioteca no admite el servicio aparte de la AEAT para enviar registros cuando te los pide formalmente (un requerimiento). Solo lo usan los sistemas que no funcionan en modo VERI*FACTU.