WIP EUPL-1.2Logistics

PLN Connect

Open-source eFTI XML Gateway for EU Logistics and Supply Chain, licensed under EUPL 1.2.

Status
WIP
License
EUPL-1.2
Category
Logistics
Updated
GitHub source

Project status

Description

PLN Connect is an open-source gateway for exchanging electronic transport documents according to the EU eFTI standard (electronic Freight Transport Information, Regulation 2020/1056 + Implementing Acts 2024), which becomes mandatory in the EU for control authorities from 2027. The problem it solves: logistics operators, carriers, freight forwarders, port and railway authorities must exchange transport documents (CMR, AWB, B/L, digital e-CMR) in eFTI XML format conforming to the TAF TSI specifications, and be able to respond to control authority requests (customs, police, FMA) in real time. PLN Connect implements: an HTTP/REST gateway for uploading/downloading eFTI documents, XSD validation against the official EU schemas (`eu-efti-common`, `eu-efti-road`, `eu-efti-rail`, `eu-efti-iww` for inland waterways, `eu-efti-air`), routing to national authority access points (Italy SARP, Germany BAG, France DGITM) with resolution via a federation registry, an immutable audit log of every exchange for EU compliance, integration with TMS (Transportation Management System) and ERP via REST API + SAP/Oracle/Microsoft Dynamics connectors, multi-modal support (road, rail, inland waterways, maritime, air), UI localization in 24 EU languages. Security is critical for inter-state exchanges: mTLS to authority access points, optional eIDAS qualified signature on documents, a complete audit trail for authority requests, configurable retention (default 3 years for transport documents). Licensed under EUPL-1.2 for explicit alignment with the EU public sector and interoperability with national government systems. Deployment target: cross-border carriers, international freight forwarders, customs authorities, TMS software houses that want to offer eFTI compliance to their customers. The philosophy is 'EU public sector standard': not a proprietary alternative, but the open implementation of a regulatory obligation.

Key Features

  • eFTI XML validation compliant with TAF and TSI

    Schema XSD eu-efti-common, eu-efti-road, eu-efti-rail, eu-efti-iww, eu-efti-air, detailed error report validation before submission.

  • Multi-modal Support

    Mode of transport: road (e-CMR), rail, inland waterways, maritime (e-B/L), air (e-AWB), dedicated module with respective TAF and TSI specifications.

  • Federation Registry Resolution

    Resolution authority access points national via federation registry EU central, fall back to hardcoded URL list for offline operations.

  • MTLS + eIDAS Qualified Signature

    Mutual TLS vs authority access points, optional eIDAS qualified signature on documents via external QSCD (smart card/HSM).

  • Immutable audit log

    Append-only ledger for each eFTI exchange, timeline query for authority audits, configurable retention for Reg 2020/1056 compliance.

  • ERP/TMS Connectors

    API and SOAP Wrapper for Dedicated Logistics Solutions - SAP S/4HANA, Oracle Transportation Management, Microsoft Dynamics 365 SCM.

  • Language Localization for 24 EU Languages

    UI in 24 official EU languages (en, it, de, fr, es, nl, pl, cs, sk, hu, ro, bg, el, sv, da, fi, et, lv, lt, sl, hr, mt, ga, pt), error message localized.

  • Dashboard Authority Access

    UI dedicated for authorities (customs, police, FMA) for document queries by request, vehicle/filter/route/period filters, export evidence.

Tech stack

  • Spring Boot 3.4
  • Java 21
  • eFTI XML
  • EU TAF TSI specs
  • PostgreSQL 16
  • OpenAPI 3.1
  • eIDAS QSCD
  • Docker Compose

Use cases

  • Frontier vectors (Italy-Germany, Italy-France) that must comply with eFTI by 2027.
  • International multimodal freight forwarders (road, rail, sea) with a fleet of 50-500 vehicles.
  • Customs authorities that need an operational access point for controls and eFTI
  • Software house TMS that want to offer compliance and eFTI modules to their logistics clients

Road Map

  1. v0.1.0Scheduled

    Core: e-CMR Road and Validation with Federation

    • Schema XSD for eu-efti-common and eu-efti-road
    • Validation Engine + Report Errors
    • Federation Registry Resolution Base
    • MTLS vs Italy SARP (reference implementation)
  2. v0.5.0Scheduled

    Multi-modal and ERP Connectors

    • Rail, Inland Waterways, and Air Modules
    • Connector for SAP S/4HANA Logistics
    • Immutable audit log and retention policy.
    • MVP Authority Dashboard
  3. v1.0.0Scheduled

    eIDAS plus 24 languages plus production deployment

    • eIDAS Qualified Signature Integration
    • UI Localization for 24 EU Languages
    • Authority access points DE (BAG) + FR (DGITM)
    • Documentation for MkDocs and Compliance Guide

Who is it for

  • For Developer Senior
  • Decision Maker/Founder

Quick start

Start the project locally in just a few commands. 

# Quick start (work-in-progress, repo non ancora pubblicato)
# git clone https://github.com/<tba>/pln-connect.git
# cd pln-connect
# cp .env.example .env  # configura authority endpoints, mTLS certs
# docker compose up -d  # postgres + pln-connect-gateway + pln-connect-ui

Contribute to the project

PLN Connect is open source. Open an issue, propose a pull request or leave a star on GitHub: every contribution, no matter how small, is welcome.

  • ⭐ Leave a star if it's useful
  • 🐛 Report bugs or suggest features via issue
  • 🔧 Send a pull request with fixes or improvements
  • 📣 Share the project if you find it interesting
Star on GitHubOpen an issuePull request
← ⭐ View on GitHub