WIP EUPL-1.2Logistics

PLN Connect

eFTI XML gateway open-source per logistics + supply chain EU, license EUPL-1.2

Stato
WIP
Licenza
EUPL-1.2
Categoria
Logistics
Aggiornato
Source GitHub

Stato del progetto

Descrizione

PLN Connect è un gateway open-source per scambiare documenti di trasporto elettronici secondo lo standard EU eFTI (electronic Freight Transport Information, Regulation 2020/1056 + Implementing Acts 2024), che diventa obbligatorio nell'EU per autorità di controllo a partire dal 2027. Il problema risolto: operatori logistic, vettori, spedizionieri, autorità portuali e ferroviarie devono scambiarsi documenti di trasporto (CMR, AWB, B/L, e-CMR digitale) in formato eFTI XML conforme alle TAF TSI specifications, e poter rispondere a richieste di autorità di controllo (dogana, polizia, FMA) in tempo reale. PLN Connect implementa: gateway HTTP/REST per upload/download eFTI documents, validazione XSD secondo schemi EU ufficiali (`eu-efti-common`, `eu-efti-road`, `eu-efti-rail`, `eu-efti-iww` per inland waterways, `eu-efti-air`), routing verso authority access points nazionali (Italy SARP, Germany BAG, France DGITM) con resolution via federation registry, audit log immutabile di ogni scambio per compliance EU, integration verso TMS (Transportation Management System) e ERP via API REST + connectors SAP/Oracle/Microsoft Dynamics, supporto multi-modal (road, rail, inland waterways, maritime, air), localizzazione UI in 24 lingue EU. La sicurezza è critica per scambi inter-stato: mTLS verso authority access points, eIDAS qualified signature opzionale su documenti, audit trail completo per richieste autorità, retention configurabile (default 3 anni per documenti trasporto). License EUPL-1.2 per allineamento esplicito EU public sector e interoperabilità con sistemi gov nazionali. Deploy target: vettori transfrontalieri, spedizionieri internazionali, autorità doganali, software house TMS che vogliono offrire conformità eFTI ai propri clienti. La filosofia è 'EU public sector standard': non un'alternativa proprietaria, ma l'implementazione open di un obbligo regolatorio.

Funzionalità chiave

  • eFTI XML validation conforme TAF TSI

    Schema XSD `eu-efti-common`, `eu-efti-road`, `eu-efti-rail`, `eu-efti-iww`, `eu-efti-air`, validation pre-submission con report errori dettagliato.

  • Multi-modal support

    Road (e-CMR), rail, inland waterways, maritime (e-B/L), air (e-AWB), modulo dedicato per ogni modalità con specifiche TAF TSI rispettive.

  • Federation registry resolution

    Resolution authority access points nazionali via federation registry EU centrale, fallback a hardcoded URL list per offline operation.

  • mTLS + eIDAS qualified signature

    Mutual TLS verso authority access points, eIDAS qualified signature opzionale su documenti via QSCD esterno (smart card/HSM).

  • Audit log immutabile

    Append-only ledger per ogni scambio eFTI, query timeline per audit autorità, retention configurabile per compliance Reg 2020/1056.

  • ERP/TMS connectors

    REST API + SOAP wrapper, connector dedicati SAP S/4HANA logistics, Oracle Transportation Management, Microsoft Dynamics 365 SCM.

  • Localizzazione 24 lingue EU

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

  • Dashboard authority access

    UI dedicata per autorità (dogana, polizia, FMA) per query documenti su richiesta, filtri per veicolo/route/period, export evidenza.

Tech stack

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

Casi d'uso

  • Vettori transfrontalieri (Italia-Germania, Italia-Francia) che devono conformarsi eFTI dal 2027
  • Spedizionieri internazionali multimodali (road+rail+sea) con flotta 50-500 veicoli
  • Autorità doganali nazionali che hanno bisogno di un access point operativo per controlli eFTI
  • Software house TMS che vogliono offrire modulo conformità eFTI ai propri clienti logistic

Roadmap

  1. v0.1.0 Pianificata

    Core: e-CMR road + Validation + Federation

    • Schema XSD eu-efti-common + eu-efti-road
    • Validation engine + report errori
    • Federation registry resolution base
    • mTLS verso Italy SARP (reference impl)
  2. v0.5.0 Pianificata

    Multi-modal + ERP connectors

    • Rail + inland waterways + air modules
    • Connector SAP S/4HANA logistics
    • Audit log immutabile + retention policy
    • Authority dashboard MVP
  3. v1.0.0 Pianificata

    eIDAS + 24 lingue + Production deploy

    • eIDAS qualified signature integration
    • Localizzazione UI 24 lingue EU
    • Authority access points DE (BAG) + FR (DGITM)
    • Documentazione MkDocs + compliance guide

A chi è rivolto

  • Pro Dev senior
  • Decision Maker / Founder

Quick Start

Avvia il progetto localmente in pochi comandi. 

# 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

Contribuisci al progetto

PLN Connect è open source. Apri una issue, proponi una pull request o lascia una stella su GitHub: ogni contributo, anche piccolo, è benvenuto.

  • ⭐ Lascia una stella se ti è utile
  • 🐛 Segnala bug o proponi feature via issue
  • 🔧 Invia pull request con fix o miglioramenti
  • 📣 Condividi il progetto se lo trovi interessante
Star su GitHubApri una issuePull request
← ⭐ Vedi su GitHub