Tutto ciò che occorre capire e mostrare, spiegato in modo semplice, con un esempio seguito dall'inizio alla fine: KLS Concept spedisce tre pallet di computer portatili e batterie a Trasporti Bianchi S.r.l. a Trieste, in FCA Trieste, e produce una lettera di vettura CMR, una fattura commerciale e una distinta di imballaggio in italiano.
GTM = Global Trade Management, letteralmente «gestione del commercio internazionale». In concreto, in GSE-Web, è il modulo che prepara tutto ciò che una merce deve avere in regola per attraversare una frontiera: condizioni di consegna, classificazione doganale, imballaggio e documenti di accompagnamento.
GSE-Web gestisce il magazzino: ricevimento, stoccaggio, preparazione, spedizione. Finora, il software si fermava alla porta del magazzino: non appena la merce attraversava una frontiera, tutto andava reinserito in un foglio di calcolo o affidato allo spedizioniere. Il modulo Spedizione internazionale prolunga la spedizione esistente (le EXP-2026-00001 che raggruppano le bolle di movimento) fino ai documenti richiesti dal vettore, dal cliente e dalla dogana, senza alcuna reintroduzione dei dati.
| Termine | Cosa significa, in una frase |
|---|---|
| Incoterm | Un codice di tre lettere (EXW, FCA, DAP, DDP, FOB, CIF…) che indica chi paga cosa e da dove passa il rischio dal venditore all'acquirente. Undici regole nella versione 2020; la versione 2010 resta accettata per i contratti più vecchi (aveva DAT al posto di DPU). |
| Luogo convenuto | Il luogo che completa l'Incoterm. «FCA» da solo non significa nulla; «FCA Trieste, Italia» è completo. L'applicazione rifiuta un Incoterm senza luogo. |
| Nomenclatura doganale | Il codice che classifica la merce: SA a 6 cifre (mondiale), NC a 8 cifre (Unione europea, per l'esportazione), TARIC a 10 cifre (per l'importazione). Rivista ogni 1° gennaio, da cui una versione per anno. |
| Origine (non preferenziale / preferenziale) | Il paese in cui la merce è stata fabbricata in senso doganale — da non confondere con la provenienza (il paese da cui parte). L'origine preferenziale dà diritto a riduzioni dei dazi nell'ambito di un accordo commerciale; deve essere giustificata. |
| EORI | Il numero di identificazione doganale di un'impresa nell'Unione. Obbligatorio sui documenti non appena si esce dal territorio doganale dell'Unione. |
| Valore in dogana | Il valore della fattura, rettificato (trasporto, assicurazione, commissioni, royalty…) in base all'Incoterm. Si calcola al cambio doganale (mensile, fissato dall'amministrazione), diverso dal cambio del giorno. |
| Collo / unità di carico / spedizione | Una spedizione contiene unità di carico (pallet, container) che contengono colli. I documenti non ragionano tutti allo stesso livello: la distinta di imballaggio dettaglia i colli, la CMR conta i colli e pesa la spedizione. |
| CMR | La lettera di vettura internazionale su strada: un modulo standardizzato con 24 caselle, in quattro esemplari (mittente, destinatario, vettore, archivio). Il suo schema è imposto. |
| Fascicolo documentale | Il set di documenti di una spedizione (fattura commerciale, distinta di imballaggio, CMR…) prodotto e trasmesso in blocco. |
| Esemplare specimen | Un documento prodotto da uno studente in un magazzino di esercizio: stessa forma, filigrana «SPECIMEN — esercizio», numerato a parte, mai opponibile. |
Il modulo è chiuso di default per tutte le organizzazioni, comprese quelle nuove: una PMI che non esporta non deve vedere nulla. Si apre in tre gesti.
Il principio che struttura l'intero modulo: ogni dato vive a un solo livello, e i documenti vanno a cercarlo dove si trova.
| Livello | Cosa vive lì | Chi lo mantiene |
|---|---|---|
| Anagrafiche del server | 249 paesi (con appartenenza all'Unione, al territorio doganale e al territorio IVA — la Guyana francese appartiene all'uno ma non all'altro), 22 regole Incoterms 2010 e 2020 (modalità consentite, punto di trasferimento dei rischi e dei costi, ripartizione degli obblighi, assicurazione), tipi di collo, tipi di container, modalità di trasporto, regimi doganali, nomenclatura doganale per anno. | GSE-Web a ogni distribuzione; la nomenclatura ufficiale è importata dalla piattaforma dalla pubblicazione dell'Unione europea. |
| Prodotto (profilo doganale) | Peso netto e lordo, dimensioni e volume, codice di nomenclatura e il suo anno, paese di origine, origine preferenziale e la sua giustificazione, designazione doganale, unità supplementare, merci soggette a controllo, merci pericolose (numero ONU, classe, gruppo di imballaggio). | La classificazione (nomenclatura, origine) e la logistica (peso, dimensioni), scheda per scheda o tramite importazione massiva. |
| Categoria, sottocategoria, famiglia | Valori predefiniti (nomenclatura, origine, designazione) ereditati dai prodotti che non ne hanno di propri. L'applicazione mostra sempre da dove proviene un valore ereditato. | La classificazione. |
| Terzo (profilo internazionale) | EORI, paese ISO, ruoli (vettore, spedizioniere, dichiarante), lingua dei documenti, numeri professionali. | L'amministrazione dei terzi. |
| Spedizione | Modalità di trasporto, Incoterm e luogo convenuto, parti (esportatore, mittente, destinatario, importatore, notify, vettore, spedizioniere, dichiarante) con un'istantanea della loro scheda, paese di destinazione e di provenienza, regime doganale, natura della spedizione (vendita, campione, reso, esportazione temporanea), valuta e cambio, assicurazione, tappe. | La spedizione. |
| Riga doganale | Per ogni prodotto spedito: quantità, valore, nomenclatura, origine, peso — derivati dalle bolle di movimento e dai profili, con la fonte di ogni valore, e modificabili riga per riga. | La spedizione. |
| Colli e unità di carico | Numero, tipo, marche, peso reale, dimensioni, contenuto per riga e per lotto; pallet e container (numero ISO, sigillo, portata). | La banchina, con il telefono. |
| Documento | Un'istantanea completa di tutto quanto precede al momento dell'emissione, il PDF e la sua impronta. | Il server, all'emissione. |
Nell'ordine in cui si presenta meglio: prima i dati di base, poi la spedizione, poi la banchina, poi i documenti.
A cosa serve: compilare il profilo doganale di un prodotto. Due sezioni: Logistica (peso netto e lordo in chilogrammi con tre decimali, lunghezza, larghezza, altezza in centimetri, volume calcolato) e Classificazione doganale (nomenclatura scelta nel navigatore — ricerca per parola chiave, albero SA → NC, anno —, paese di origine e origine preferenziale scelti dall'elenco dei paesi, designazione doganale, unità supplementare, merci soggette a controllo, merci pericolose).
Con l'esempio: ORD-15 riceve 8471 30 00 (2026) e l'origine CN; BAT-LI riceve 8507 60 00, ONU 3480, classe 9, gruppo II.
EORI, paese ISO (la scheda anagrafica storica porta un paese in testo libero; qui è il codice a due lettere a fare fede sui documenti), ruoli vettore, spedizioniere, dichiarante (per poterli proporre tra le parti di una spedizione), lingua dei documenti (la lingua in cui questo terzo riceverà la sua fattura e la sua CMR), numeri professionali.
Con l'esempio: Trasporti Bianchi, EORI IT01234567890, paese IT, vettore, lingua italiano.
Da una spedizione classica (quella che raggruppa bolle di movimento), il pulsante Internazionale apre la pagina a sette schede. Finché la spedizione è in bozza, tutto è modificabile; non appena un documento è emesso, i dettagli sono congelati (banner) fino all'annullamento di quel documento.
Con l'esempio: EXP-2026-00012, stradale, FCA Trieste (Italia), destinazione IT, provenienza FR, esportazione definitiva, vendita, EUR; esportatore KLS Concept, destinatario e vettore Trasporti Bianchi; due righe derivate: 40 × ORD-15 a 850,00 EUR, 40 × BAT-LI a 95,00 EUR.
Concepito per un telefono o un terminale palmare, utilizzabile con i guanti: bersagli ampi, un collo alla volta. Si crea il collo (tipo scelto da una griglia di icone: cartone, pallet, fusto, cassa…), si inseriscono il peso lordo e netto e le dimensioni con il tastierino numerico, gli si assegnano le righe tramite «ancora da imballare» (un tocco = tutto il resto, oppure una quantità), si scansiona il codice a barre del collo (EXP-2026-00012-P001) per riaprirlo. I colli vengono poi raggruppati in unità di carico: pallet o container (tipo ISO, numero con la sua cifra di controllo, sigillo, portata e riempimento).
Con l'esempio: tre pallet, 80 colli da 2 pezzi; totale 212,000 kg lordo, 1,92 m³.
La scheda Documenti presenta una scheda per tipo di documento: proforma, fattura commerciale, distinta di imballaggio, CMR, nota di consegna. Per ciascuno: creare una bozza (lingua proposta = quella del destinatario), anteprima con filigrana, emettere, scaricare o condividere il PDF, verificare l'impronta, trasmettere, accettare, rifiutare, annullare con motivo, sostituire. Emetti il fascicolo produce più documenti in una sola volta, tutto o niente; Scarica il fascicolo li raggruppa in uno ZIP. La pagina Archivio documentale ritrova qualsiasi documento emesso per tipo, stato, periodo e testo — compresi quelli annullati.
Prima di ogni emissione, il server valuta la spedizione. Un controllo bloccante impedisce di emettere; un avviso viene mostrato e lascia procedere comunque. Nessun controllo modifica un dato.
CMR-2026-00007, INV-2026-00003…), istantanea completa dei dati, generazione del PDF nella lingua e nei formati del destinatario (date, numeri), impronta SHA-256, archiviazione, registro di audit. I dettagli della spedizione vengono congelati.Quattro pagine identiche intitolate 1 mittente / 2 destinatario / 3 vettore / 4 archivio, etichette bilingui (francese + lingua del documento), e per ogni casella la sua fonte: 1 mittente e 2 destinatario (parti), 3 luogo di consegna (indirizzo del destinatario e luogo convenuto), 4 luogo e data di presa in carico (organizzazione e tappa di ritiro), 5 documenti allegati (gli altri elementi emessi del fascicolo documentale), 6 marche, 7 numero dei colli, 8 modo di imballaggio, 9 natura della merce (designazioni doganali), 10 codici SA, 11 peso lordo, 12 volume, 13 istruzioni e regime, 14 franco o porto assegnato (dedotto dall'Incoterm), 15 assegno (rimborso), 16 vettore, 19 convenzioni particolari, 20 da pagarsi da (ripartizione Incoterm), 21 luogo e data di emissione, 22 firmatario. Una casella senza dato viene dichiarata vuota nell'istantanea; il software non inventa mai un testo.
Questo progetto è nato da un'analisi del referenziale: sulle 45 competenze del profilo italiano Tecnico dei servizi logistici, sette delle nove lacune di GSE-Web riguardavano la gestione amministrativa e documentale della spedizione. Il modulo è stato quindi concepito affinché il lavoro reale dello studente nell'applicazione sia valutabile, senza mai basarsi sulla sua dichiarazione.
Lo studente vede solo giusto o sbagliato per elemento; la correzione appartiene all'insegnante, che può modificare un voto automatico (il registro lo riporta).
In uno scenario, l'insegnante dichiara azioni di spedizione attese: «Incoterm FCA con un luogo contenente Trieste», «almeno due colli con dimensioni», «tutte le righe classificate e con origine», «nessun controllo bloccante», «CMR emessa con la casella 7 uguale a 3 e la casella 16 contenente Trasporti Bianchi». Il server legge la spedizione che lo studente ha costruito nel suo magazzino di esercizio e confronta campo per campo — comprese le 24 caselle del documento emesso. Una spedizione fatta fuori da un magazzino di esercizio viene rifiutata; un modulo chiuso restituisce «verifica non disponibile», mai «soddisfatto».
I documenti degli studenti sono esemplari specimen: stessa forma, filigrana, numerazione a parte, mai opponibili — e scompaiono con il magazzino di esercizio.
REFERENCE, POIDS_NET_KG, POIDS_BRUT_KG, LONGUEUR_CM, LARGEUR_CM, HAUTEUR_CM, CODE_NOMENCLATURE, ANNEE_NOMENCLATURE, PAYS_ORIGINE, PAYS_ORIGINE_PREFERENTIELLE, REGLE_ORIGINE, JUSTIFICATION_ORIGINE, DESIGNATION_DOUANIERE, UNITE_SUPPLEMENTAIRE, QUANTITE_UNITE_SUPPLEMENTAIRE, MARCHANDISE_DANGEREUSE, NUMERO_ONU, CLASSE_DANGER, GROUPE_EMBALLAGE, QUANTITE_LIMITEE, DESIGNATION_OFFICIELLE_TRANSPORT. Una cella vuota non tocca il valore esistente; la parola VIDE lo cancella. Versione CSV: profils-douaniers-exemple.csv.version_year;code;level;parent_code;label_fr;label_en;label_de;label_es;label_it;supplementary_unit;valid_from;valid_to, una riga per codice, le cinque etichette tutte obbligatorie. La pubblicazione ufficiale della nomenclatura combinata (Gazzetta ufficiale dell'Unione europea, EUR-Lex) viene convertita in questo formato prima dell'importazione.No, e non lo pretende. Prepara e produce i dati e i documenti che un dichiarante doganale o un software di sdoganamento autorizzato riprenderà (l'istantanea di ogni documento si esporta in JSON a questo scopo). La presentazione telematica delle dichiarazioni (Delta in Francia, AIDA in Italia) non rientra nel suo ambito.
No. Un ordine di grandezza indicativo potrà essere aggiunto un giorno, mostrato come tale; un calcolo probante comporterebbe una responsabilità che non è quella di un software di gestione del magazzino.
No: il software incorpora un estratto dimostrativo, contrassegnato come non ufficiale, sufficiente per gli esercizi. La nomenclatura combinata ufficiale, rivista ogni 1° gennaio, viene importata dalla piattaforma dalla pubblicazione dell'Unione europea, anno per anno; gli anni precedenti restano leggibili per i documenti più vecchi.
La riga derivata lo mostra («nessuna fonte»), il controllo «riga senza nomenclatura» blocca l'emissione, e nulla viene indovinato. È la regola di progettazione di GSE-Web: nessun valore sostitutivo silenzioso.
No: se ne emette una nuova, con un nuovo numero, collegata alla vecchia che passa a «annullata — sostituita». Lo storico resta consultabile nell'archivio. È ciò che rende il documento opponibile.
Sì, lato server: una riga doganale può essere inserita a mano, senza bolla. Il modulo corrispondente nell'applicazione arriva in un prossimo lotto; fino ad allora, la proforma si costruisce a partire da una spedizione con le sue bolle di movimento.
Non ancora: l'imballaggio si effettua online in questa versione. La modalità offline di GSE-Web (inserimenti di stock, ricevimenti, bolle di movimento) sarà estesa ai colli in un lotto successivo; i documenti, invece, continueranno a essere prodotti online.
La polizza di carico marittima, la lettera di trasporto aereo, la lettera di vettura ferroviaria, il certificato di origine, l'EUR.1, il carnet ATA, i documenti di transito, i certificati sanitari e la dichiarazione formale di merci pericolose. I dati che li alimentano (origine preferenziale, merci pericolose) sono già inseriti.