Autodespachate — Que el ciudadano despache su aduana con la AEAT

El reto

Cuando compras fuera de la UE, el operador postal despacha por ti y te cobra una tarifa de gestión sin consentimiento explícito. Pero el autodespacho es un derecho: el Código Aduanero permite al destinatario presentar su propia declaración. Lo que faltaba no era la norma, sino una herramienta que hiciera el trámite en minutos.

El reto técnico es doble: la AEAT exige firma electrónica cualificada (cualquier SaaS que firme en tu nombre se convierte en prestador de confianza y en un objetivo de ataque de alto valor), y el XML enviado debe ser idéntico byte a byte al firmado, validado contra el XSD real antes de cualquier envío a producción.

Solución

Construimos una arquitectura híbrida SaaS + Bridge local en un monorepo TypeScript de 7 paquetes: el servidor (NestJS) orquesta el trámite, construye el XML H7 determinista —verificado contra el XSD real de la AEAT— y calcula la huella SHA-256; el Bridge local (Fastify, solo en 127.0.0.1) lee el certificado del usuario, muestra lo que se va a firmar y firma sin que la clave privada salga nunca de su equipo.

Seguridad por diseño: solicitudes de firma firmadas con Ed25519, páginas de confirmación con nonce de 144 bits, bloqueo ante fuerza bruta, protección CSRF, sesiones opacas en Redis y un registro append-only que sirve de prueba documental ante la AEAT. La declaración se modela con 13 estados y 15 transiciones. La landing está en producción; el envío y la firma reales quedan pendientes de certificado FNMT de pruebas.