WIP EUPL-1.2Logistics and Supply Chain Management

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 and Supply Chain Management
Updated
GitHub is not a UI string to be translated from Italian into English.

Project status

Description

PLN Connect is an open-source gateway for exchanging electronic transport documents according to the EU and eFTI (electronic Freight Transport Information) standards. The problem it solves: operators of logistics, carriers, freight forwarders, port authorities, and railway authorities must exchange transport documents (CMR, AWB, B/L, and digital CMR) in eFTI XML format conforming to TAF TSI specifications, and be able to respond to control authority requests in real-time. PLN Connect implements: an HTTP/REST gateway for uploading and downloading eFTI documents, validation according to 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 federation registry, immutable audit log of every exchange for EU compliance, integration with TMS and ERP via API REST + connectors SAP/Oracle/Microsoft Dynamics, 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, eIDAS qualified signature optional on documents, 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. Deploy target: international carriers, international freight forwarders, customs authorities, software houses TMS that want to offer eFTI compliance to their clients. 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.

Angular + Spring Boot on top of a PostgreSQL database hosted in the cloud via AWS or Google Cloud Platform

  • 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
    • Access Points for Authority Access: Germany (DE - BAG), France (FR - DGITM)
    • Documentation for MkDocs and Compliance Guide

Who is it for

  • For Developer Senior
  • Decision Maker/Founder

Quick start

Start the project locally with four commands, requires Docker and GitHub Desktop is not required but a git client like SourceTree or Visual Studio Code's built-in one will do just fine though. 

# 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
← Back to list⭐ View on GitHub