Vai al contenuto
Giorgi Eliadze
Progetti: Boxette Group

ott 2025 – oggi

Dichiarazioni doganali RS.GE

Workflow n8n che seguono ogni pacco nella dogana di RS.GE e avviano la firma elettronica del cliente

  • Automazione
  • Automazione doganale
Durata
1 anno
Azienda
Boxette Group
Ruolo
Automation engineer: progettazione, sviluppo, debugging, documentazione

Panoramica

Un sistema n8n che collega il portale doganale del Servizio delle entrate della Georgia (RS.GE) alle bacheche ClickUp delle dichiarazioni di Boxette. Controlla lo stato doganale di ogni pacco, allega il PDF della dichiarazione emessa e avvia da solo la firma elettronica e le notifiche per il cliente, per entrambi i marchi dell’azienda.

Strumenti

  • n8n
  • ClickUp
  • PostgreSQL
  • Documenso
  • SendGrid
  • Node.js
  • Telegram

Dichiarazioni a mano

Ogni pacco oltre la soglia di esenzione doganale richiede una dichiarazione su RS.GE, e il team delle dichiarazioni le seguiva a mano sulle bacheche ClickUp. Per ogni task verificava se i dazi erano stati pagati e la dichiarazione emessa, poi scaricava il PDF e lo inviava al cliente da firmare. RS.GE non ha un’API pubblica per tutto questo, i suoi elenchi di pacchi sono divisi per account aziendale e le sue sessioni cadono facilmente: i controlli erano lenti e i task finivano nello stato sbagliato.

Leggere il portale

Un gestore di sessione e quattro moduli di recupero, uno per categoria (fisica, online, sconosciuta, export), scorrono pagina per pagina i dati del portale e li salvano in Postgres. Gli scanner di dettaglio aggiungono i dati personali e le merci di ogni pacco, e un’API di ricerca per tracking restituisce lo stato, le merci e il PDF della dichiarazione di un pacco a partire dal numero di tracking. Una correzione della paginazione ha portato i recuperi giornalieri da un tetto fisso di 500 righe a giornate complete (878 righe su 878 e 3.376 su 3.376 nei test). Script Node.js confrontano i task firmati con RS.GE ed esportano su Google Drive i pacchi trattenuti con le loro fatture, per il lavoro sui codici HS.

Yellow Check e Green Check

Per ogni marchio, due workflow simmetrici girano ogni 30 minuti con orari sfalsati. Yellow Check sposta un task su «dazi pagati» quando tutti i suoi pacchi sono stati sdoganati. Green Check conferma, pacco per pacco e confrontandola con il modulo stampato, che la dichiarazione li copra tutti, carica il PDF su ClickUp, verifica che il caricamento sia andato a buon fine e sposta il task alla firma, che invia una busta Documenso, un’email e un SMS con deduplicazione. I pacchi trattenuti passano a uno stato rosso, i tracking sconosciuti ricevono un solo commento di avviso, e ogni workflow segnala i propri errori a un workflow di errore condiviso.

Risultato

Un audit in sola lettura del luglio 2026, svolto da subagenti Claude Code sotto la mia direzione, ha ricontato 290 decisioni di Yellow Check su 606 ricerche e ha trovato 0 discrepanze, e tutti i 18 task spostati da Green Check avevano completato l’intera catena con 0 firme duplicate. Su 406 esecuzioni i controlli sono riusciti nel 99–100% dei casi, e 250 esecuzioni di notifica su 250 sono rimaste nella finestra di invio 10:00–20:59. Un’esportazione dei pacchi trattenuti ha risolto 84 tracking su 84 e caricato 82 fatture.

Progetti: Boxette Group