Skip to content
APFerrer
P-LOG-01 · ProductLogistics and customs

Freight forwarding and customs software with a Spanish AEAT connection

Source code for freight forwarders and customs representatives that brings together files, containers and demurrage, rates, warehouse, TARIC classification, a customer portal and a connection to the customs services of Spain's tax and customs agency (AEAT).

Source codeExclusivity availableEmbeddable

A freight forwarder or customs representative handles files, containers whose free days are running out, rates by customer, a warehouse and declarations to Spain's tax and customs agency (Agencia Tributaria, AEAT), almost always with spreadsheets and separate portals. This freight forwarding software brings that work together in one codebase: files, containers and demurrage, rates, warehouse, TARIC classification, a customer portal and a connection to the AEAT's customs web services. It is licensed mainly as source code, so your technical team can adapt it.

Who it is for

  • Freight forwarders and ocean cargo agents who want a tool of their own instead of depending on a closed ERP.
  • Customs representatives looking for a base to automate import declarations with the AEAT.
  • Logistics operators with a warehouse that bill for storage and handling.
  • International trade software companies that need a core that is already modeled.

Customs filing is built for Spain's AEAT.

What freight forwarding and customs software solves

  • Demurrage nobody sees in time. It calculates demurrage, detention, terminal storage and warehouse storage by tiers and free days, and checks them every day.
  • Scattered rates. Customer rates, with their surcharges, generate the quotes and orders.
  • Slow tariff classification. You look up TARIC by date, with its measures, and get an AI classification proposal that a person always reviews.
  • Declarations done by hand. The import declaration is prepared from the shipment documents and sent to the AEAT with a certificate.
  • Customers who call to ask. Each customer checks their files, containers, documents and invoices in their own portal.

What you can do with it

Operations

  • Run files with statuses, tasks, incidents, a calendar and automations.
  • Manage containers as equipment and as usage, with seals, custody and free days, and track them at sea with ShipsGo.
  • Read documents such as the bill of lading, the packing list, the commercial invoice or the Single Administrative Document (DUA) with AI, using your own provider's key.
  • Link email to files.

Sales and finance

  • Keep sales rates and internal rates, and produce quotes and orders in PDF.
  • Apply surcharges by kilometer, zone, tier, diesel, return trip and calendar.
  • Issue invoices in Holded.

Warehouse

  • Record receipts, delivery instructions, dispatches, stock, inventory and appointments.
  • Calculate the storage cost of each container.
  • Draw the warehouse layout with zones, docks and slots, and view it in 3D in the browser.

Customs

  • Generate the H1 import declaration according to the AEAT's official schemas and check it before sending.
  • Send it and check the clearance status with the declarant's certificate, with the preproduction and production environments kept separate.
  • Record powers of representation.
  • Require a person to approve each version of the declaration before it is sent, and reconcile the MRN by hand when needed.
  • Look up the TARIC nomenclature loaded from the European Commission's official files, with its validity dates.

Customer portal and reports

  • Give each customer access to their files, containers, documents, quotes, orders, invoices, rates and incidents.
  • Share reports through a link.

Benefits

  • You see demurrage coming before it turns into an invoice from the shipping line or the terminal.
  • You quote and invoice with the same rates, without parallel spreadsheets.
  • You save time on classification without handing the decision to a machine.
  • Your customers check the status of their cargo without calling.
  • You start from a base with a forwarder's operations already modeled.

Industry context

General industry data with its public source. These are not results of this product.

  • On October 14, 2025, the AEAT shut down its previous DUA-based import system, and the H1 declaration became the only system for declaring imports. Source: Agencia Tributaria, "Novedades de Aduanas 2025" (customs news 2025), 2025.

What you get with each license

Price upon request, depending on license type and scope. Maintenance and support are contracted separately for every license type.

  • The complete source code, for your technical team to adapt, complete with your processes and maintain.
  • Installation documentation and a guide to the parts it is made of.
  • A technical handover session with your team.
  • A warranty against defects for the agreed period.

Technical specifications

Language and runtime: TypeScript 5.9 on Node.js. Minimum supported version: Node.js 20.9 (declared by Next.js 16).

Frameworks: Next.js 16.3 and React 19.3, with three.js for the 3D warehouse layout. Data access with Prisma 7.10.

Database: PostgreSQL with the pg_trgm, btree_gist, citext and pgcrypto extensions. Minimum supported version: 15 (required by the database schema).

Operating systems: A server with Node.js.

Interface languages: Spanish.

Required infrastructure:

  • PostgreSQL 15 or later.
  • Amazon S3-compatible storage.
  • Authentication and file storage for the customer portal through Supabase (cloud service or self-hosted).
  • A scheduler for periodic tasks (cron).
  • An SMTP server and an IMAP mailbox to link email.
  • The electronic certificate of the declarant or the customs representative.
  • ShipsGo (requires the buyer's own account).
  • Holded (requires the buyer's own account).
  • OpenAI or Anthropic for document reading and the classification proposal (optional; requires the buyer's own account).
  • Mapbox (optional; requires the buyer's own account) or an open tile service for the maps.
  • Sentry for error logging (optional; requires the buyer's own account).

Private deployment: It can run in your infrastructure with PostgreSQL, S3-compatible storage and self-hosted Supabase. It needs a connection to the AEAT's web services to file declarations, to ShipsGo for ocean tracking, to Holded for invoicing and to the European Commission to update TARIC. AI is optional.

Main libraries:

Library Version License
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 Mapbox's own license
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

Dependencies with specific license terms:

  • mapbox-gl 3.32: Mapbox's own license (SEE LICENSE IN LICENSE.txt).
  • apexcharts 7.8 and react-apexcharts 2.1: ApexCharts' own license, with a Community License and commercial licenses (SEE LICENSE IN LICENSE); apex-commons 0.8, which apexcharts installs: Apex Commons' own license (SEE LICENSE IN LICENSE).
  • react-leaflet 5.0 and @react-leaflet/core 3.0: Hippocratic License 2.1.
  • next-mdx-remote 6.0: MPL-2.0.
  • @img/sharp-libvips-* 1.2 and 1.3 (libvips binaries): LGPL-3.0-or-later; @img/sharp-win32-* and @img/sharp-wasm32 0.34 and 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 and 1.4: BSD-3-Clause OR GPL-2.0.
  • @zone-eu/mailsplit 5.4: MIT OR EUPL-1.1+.
  • @sentry/cli 2.58 (and its per-platform binaries): FSL-1.1-MIT, build time only.

Compatibility and integrations: AEAT, web service CC415A V1 (H1 declaration) and ConsultaImportacionV2 (clearance status), with a client certificate; European Commission TARIC extractions; ShipsGo API v2; Holded; Anthropic API (version 2023-06-01) and OpenAI API; IMAP and SMTP email; storage with an Amazon S3-compatible API; maps with Mapbox or MapLibre.

Redistribution terms

The asset's own code can be integrated into the licensee's commercial products under the source code license, the exclusive license and the embeddable module license, on the terms of the contract. mapbox-gl (Mapbox's own license), apexcharts, react-apexcharts and apex-commons (ApexCharts' and Apex Commons' own licenses), react-leaflet (Hippocratic License 2.1), next-mdx-remote (MPL-2.0), the libvips binaries (LGPL-3.0-or-later), @sentry/cli (FSL-1.1-MIT, build time only) and jszip, node-forge and @zone-eu/mailsplit (dual license) have specific terms; see the list under Technical specifications.

Installation requirements

Installed on your server or in your cloud, with a PostgreSQL database and Amazon S3-compatible storage, also on compatible cloud platforms. Filing with the AEAT requires the electronic certificate of the declarant or the customs representative. Ocean tracking needs a ShipsGo account, invoicing a Holded account and AI your own provider's key.

Integrations

The AEAT's customs web services, the European Commission's TARIC, ShipsGo, Holded, OpenAI and Anthropic with your key, IMAP and SMTP email, and Amazon S3 or compatible storage.

FAQ

Frequently asked questions

  • Is it a turnkey product?

    No. It is meant for a technical team that wants to start from a broad base and adapt it to its operations, not for someone looking for a ready-to-use program with no development.

  • Does it file real declarations with the AEAT?

    It generates the H1 declaration, connects with the certificate and reads the AEAT's responses. Before using it for real declarations, you have to validate it in the AEAT's preproduction environment with your own data. An error in a declaration has consequences for the declarant, so that validation is your responsibility.

  • Does the AI classify the goods on its own?

    No. It proposes a TARIC code that a person always confirms. Nothing is approved automatically, and responsibility for the classification lies with whoever confirms it.

  • Can I license just the demurrage calculation or the AEAT connector?

    Yes, as an embeddable module. The AEAT connector has its own listing (M-AEAT-01).

  • Is maintenance included?

    No. The AEAT updates its technical guides and schemas often, and keeping up with those changes is part of maintenance. Maintenance (updates and bug fixes) and support (questions, training and adaptations) are contracted separately.

Request

Request information on P-LOG-01

Fill in the form with the asset reference and the license type you're considering. I reply in writing. If you need to review code, tick the NDA box and we'll sign one before anything is shared.

Controller: APFerrer. Purpose: to answer your request. You can exercise your rights as described in the privacy policy.

Price upon request, depending on license type and scope. Maintenance and support are contracted separately.