Software para transitarios y aduanas con conexión a la AEAT
Código para transitarios y representantes aduaneros que reúne expedientes, contenedores y demoras, tarifas, almacén, clasificación TARIC, portal del cliente y conexión con los servicios de aduanas de la AEAT.
Un transitario o un representante aduanero gestiona expedientes, contenedores con días libres que vencen, tarifas por cliente, almacén y declaraciones ante la AEAT, casi siempre con hojas de cálculo y portales distintos. Este software para transitarios y aduanas reúne esa operativa en un solo código: expedientes, contenedores y demoras, tarifas, almacén, clasificación TARIC, portal del cliente y conexión con los servicios web de aduanas de la AEAT. Se licencia sobre todo como código fuente, para que tu equipo técnico lo adapte.
Para quién es
- Transitarios y agentes de carga marítima que quieren una herramienta propia y no depender de un ERP cerrado.
- Representantes aduaneros que buscan una base para automatizar declaraciones de importación con la AEAT.
- Operadores logísticos con almacén que facturan estancias y manipulación.
- Empresas de software de comercio exterior que necesitan un núcleo ya modelado.
Qué problemas resuelve el software para transitarios y aduanas
- Demoras que nadie ve a tiempo. Calcula demurrage, detention, estancia en terminal y en almacén por tramos y días libres, y lo revisa cada día.
- Tarifas dispersas. Las tarifas por cliente, con sus recargos, generan los presupuestos y las órdenes.
- Clasificación arancelaria lenta. Consultas el TARIC por fecha, con sus medidas, y recibes una propuesta de clasificación por IA que siempre revisa una persona.
- Declaraciones a mano. La declaración de importación se prepara desde los documentos del envío y se envía a la AEAT con certificado.
- Clientes que llaman para preguntar. Cada cliente consulta en su portal sus expedientes, contenedores, documentos y facturas.
Qué puedes hacer con él
Operativa
- Llevar expedientes con estados, tareas, incidencias, calendario y automatizaciones.
- Gestionar contenedores como equipo y como uso, con precintos, custodia y días libres, y seguirlos por mar con ShipsGo.
- Leer con IA documentos como el conocimiento de embarque, el packing list, la factura comercial o el DUA, con la clave de tu propio proveedor.
- Vincular el correo a los expedientes.
Comercial y finanzas
- Mantener tarifas de venta y tarifas internas, y sacar presupuestos y órdenes en PDF.
- Aplicar recargos por kilómetro, zona, tramo, gasóleo, retorno y calendario.
- Emitir las facturas en Holded.
Almacén
- Registrar recepciones, instrucciones de entrega, salidas, stock, inventario y citas.
- Calcular el coste de estancia de cada contenedor.
- Dibujar el plano del almacén con zonas, muelles y huecos, y verlo en 3D en el navegador.
Aduanas
- Generar la declaración de importación H1 según los esquemas oficiales de la AEAT y comprobarla antes de enviarla.
- Enviarla y consultar el estado del despacho con el certificado del declarante, con los entornos de preproducción y producción separados.
- Registrar los poderes de representación.
- Exigir que una persona apruebe cada versión de la declaración antes de enviarla y conciliar el MRN a mano cuando haga falta.
- Consultar la nomenclatura TARIC cargada desde los ficheros oficiales de la Comisión Europea, con sus vigencias.
Portal del cliente e informes
- Dar a cada cliente acceso a sus expedientes, contenedores, documentos, presupuestos, órdenes, facturas, tarifas e incidencias.
- Compartir informes mediante un enlace.
Beneficios
- Ves las demoras antes de que se conviertan en una factura de la naviera o de la terminal.
- Presupuestas y facturas con las mismas tarifas, sin hojas de cálculo paralelas.
- Ganas tiempo en la clasificación sin delegar la decisión en una máquina.
- Tus clientes consultan el estado de su carga sin llamar.
- Partes de una base con la operativa de un transitario ya modelada.
Contexto del sector
Datos generales del sector con su fuente pública. No son resultados de este producto.
- La AEAT cerró el 14 de octubre de 2025 el anterior sistema de importación mediante DUA, y la declaración H1 quedó como único sistema para declarar importaciones. Fuente: Agencia Tributaria, «Novedades de Aduanas 2025», 2025.
Qué recibes según la modalidad
Precio a consultar según modalidad y alcance. El mantenimiento y el soporte se contratan aparte en todas las modalidades.
- El código fuente completo, para que tu equipo técnico lo adapte, lo complete con tus procesos y lo mantenga.
- Documentación de instalación y una guía de las partes que lo componen.
- Una sesión de traspaso técnico con tu equipo.
- Garantía frente a defectos durante el periodo pactado.
- Todo lo de la licencia de código.
- Nuestro compromiso de no licenciar el producto a terceros en el sector o el territorio acordados (por ejemplo, transitarios de un puerto) durante el plazo pactado.
- Partes separables para incorporarlas a tu software, como el conector con la AEAT, el cálculo de demoras o el motor de tarifas.
- Documentación para adaptarlas a tu modelo de datos.
- Garantía frente a defectos durante el periodo pactado.
Ficha técnica
Lenguaje y entorno de ejecución: TypeScript 5.9 sobre Node.js. Versión mínima compatible: Node.js 20.9 (la que declara Next.js 16).
Frameworks: Next.js 16.3 y React 19.3, con three.js para el plano 3D del almacén. Acceso a datos con Prisma 7.10.
Base de datos: PostgreSQL con las extensiones pg_trgm, btree_gist, citext y pgcrypto. Versión mínima compatible: 15 (la exige el esquema de la base de datos).
Sistemas operativos: Servidor con Node.js.
Idiomas de la interfaz: Español.
Infraestructura necesaria:
- PostgreSQL 15 o posterior.
- Almacenamiento compatible con Amazon S3.
- Autenticación y almacenamiento de ficheros del portal del cliente mediante Supabase (servicio en la nube o instalación propia).
- Planificador de tareas periódicas (cron).
- Servidor SMTP y buzón IMAP para vincular el correo.
- Certificado electrónico del declarante o del representante aduanero.
- ShipsGo (requiere cuenta propia del comprador).
- Holded (requiere cuenta propia del comprador).
- OpenAI o Anthropic para la lectura de documentos y la propuesta de clasificación (opcional; requiere cuenta propia del comprador).
- Mapbox (opcional; requiere cuenta propia del comprador) o un servicio de teselas abiertas para los mapas.
- Sentry para el registro de errores (opcional; requiere cuenta propia del comprador).
Despliegue privado: Puede funcionar en tu infraestructura con PostgreSQL, almacenamiento compatible con S3 y Supabase en instalación propia. Necesita conexión con los servicios web de la AEAT para declarar, con ShipsGo para el seguimiento marítimo, con Holded para facturar y con la Comisión Europea para actualizar el TARIC. La IA es opcional.
Bibliotecas principales:
| Biblioteca | Versión | Licencia |
|---|---|---|
| next | 16.3.8 | MIT |
| react | 19.3.0 | MIT |
| @prisma/client | 7.10.0 | Apache-2.0 |
| three | 0.186.1 | MIT |
| @react-three/fiber | 9.8.1 | MIT |
| exceljs | 4.4.0 | MIT |
| maplibre-gl | 5.24.0 | BSD-3-Clause |
| mapbox-gl | 3.32.0 | Licencia propia de Mapbox |
| node-forge | 1.4.0 | BSD-3-Clause OR GPL-2.0 |
| nodemailer | 8.0.11 | MIT-0 |
| imapflow | 1.2.16 | MIT |
| openai | 6.32.0 | Apache-2.0 |
Dependencias con condiciones de licencia específicas:
- mapbox-gl 3.32: licencia propia de Mapbox (SEE LICENSE IN LICENSE.txt).
- apexcharts 7.8 y react-apexcharts 2.1: licencia propia de ApexCharts, con Community License y licencias comerciales (SEE LICENSE IN LICENSE); apex-commons 0.8, que instala apexcharts: licencia propia de Apex Commons (SEE LICENSE IN LICENSE).
- react-leaflet 5.0 y @react-leaflet/core 3.0: Hippocratic License 2.1.
- next-mdx-remote 6.0: MPL-2.0.
- @img/sharp-libvips-* 1.2 y 1.3 (binarios de libvips): LGPL-3.0-or-later; @img/sharp-win32-* y @img/sharp-wasm32 0.34 y 0.35: Apache-2.0 AND LGPL-3.0-or-later.
- jszip 3.10: MIT OR GPL-3.0-or-later.
- node-forge 1.3 y 1.4: BSD-3-Clause OR GPL-2.0.
- @zone-eu/mailsplit 5.4: MIT OR EUPL-1.1+.
- @sentry/cli 2.58 (y sus binarios por plataforma): FSL-1.1-MIT, solo en compilación.
Compatibilidades e integraciones: AEAT, servicio web CC415A V1 (declaración H1) y ConsultaImportacionV2 (estado del despacho), con certificado de cliente; extracciones TARIC de la Comisión Europea; ShipsGo API v2; Holded; Anthropic API (versión 2023-06-01) y OpenAI API; correo IMAP y SMTP; almacenamiento con API compatible con Amazon S3; mapas con Mapbox o MapLibre.
Condiciones de redistribución
El código propio admite integración en productos comerciales del licenciatario en las modalidades de licencia de código, licencia en exclusiva y módulo integrable, en los términos del contrato. Tienen condiciones específicas mapbox-gl (licencia propia de Mapbox), apexcharts, react-apexcharts y apex-commons (licencias propias de ApexCharts y Apex Commons), react-leaflet (Hippocratic License 2.1), next-mdx-remote (MPL-2.0), los binarios de libvips (LGPL-3.0-or-later), @sentry/cli (FSL-1.1-MIT, solo en compilación) y jszip, node-forge y @zone-eu/mailsplit (doble licencia); ver la lista de la Ficha técnica.
Requisitos de instalación
Se instala en tu servidor o en tu nube, con una base de datos PostgreSQL y un almacenamiento compatible con Amazon S3, también en plataformas cloud compatibles. Para declarar ante la AEAT hace falta el certificado electrónico del declarante o del representante aduanero. El seguimiento marítimo necesita una cuenta de ShipsGo, la facturación una cuenta de Holded y la IA la clave de tu propio proveedor.
Integraciones
Servicios web de aduanas de la AEAT, TARIC de la Comisión Europea, ShipsGo, Holded, OpenAI y Anthropic con tu clave, correo IMAP y SMTP, y Amazon S3 o compatible.
Preguntas frecuentes
¿Es un producto llave en mano?
No. Está pensado para un equipo técnico que quiera partir de una base amplia y adaptarla a su operativa, no para quien busca un programa listo para usar sin desarrollo.
¿Presenta declaraciones reales ante la AEAT?
Genera la declaración H1, se conecta con el certificado y lee las respuestas de la AEAT. Antes de usarlo con declaraciones reales, tienes que validarlo en el entorno de preproducción de la AEAT con tus propios datos. Un error en una declaración tiene consecuencias para el declarante, así que esa validación corre de tu cuenta.
¿La IA clasifica la mercancía sola?
No. Propone un código TARIC que siempre confirma una persona. Nada se aprueba de forma automática y la responsabilidad de la clasificación es de quien la confirma.
¿Puedo licenciar solo el cálculo de demoras o el conector con la AEAT?
Sí, como módulo integrable. El conector con la AEAT tiene su propia ficha (M-AEAT-01).
¿El mantenimiento está incluido?
No. La AEAT actualiza con frecuencia sus guías técnicas y sus esquemas, y seguir esos cambios forma parte del mantenimiento. El mantenimiento (actualizaciones y corrección de errores) y el soporte (dudas, formación y adaptaciones) se contratan aparte.
Encajan con este activo
- M-AEAT-01Conector AEAT para importación: declaración H1 con certificado electrónico
- P-TRA-01ERP de transporte por carretera con carta de porte digital DeCA y CMR
- M-HOL-01Integración con Holded para facturas, rectificativas y cobros
- M-IA-01Capa LLM multiproveedor con clave propia y cuotas
- M-PII-01Seudonimización y redacción de datos personales para LLM
Solicitud
Solicita información sobre P-LOG-01
Rellena el formulario con la referencia del activo y la modalidad que te interesa. Te respondo por escrito. Si necesitas revisar el código, marca la casilla del NDA y lo preparamos antes de enseñar nada.