Przejdź do treści
Giorgi Eliadze
Projekty: Boxette Group

paź 2025 – obecnie

Deklaracje celne w RS.GE

Przepływy n8n, które śledzą każdą przesyłkę w odprawie celnej RS.GE i uruchamiają e-podpis klienta

  • Automatyzacja
  • Automatyzacja celna
Czas trwania
1 rok
Firma
Boxette Group
Rola
Inżynier automatyzacji: projekt, budowa, debugowanie, dokumentacja

Przegląd

System w n8n, który łączy portal celny gruzińskiej Służby Skarbowej (RS.GE) z tablicami deklaracji Boxette w ClickUp. Sam śledzi status celny każdej przesyłki, dołącza wystawioną deklarację w PDF i uruchamia elektroniczne podpisanie przez klienta oraz powiadomienia, dla obu marek firmy.

Narzędzia

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

Deklaracje obsługiwane ręcznie

Każda przesyłka powyżej limitu zwolnienia z cła wymaga deklaracji celnej w RS.GE, a dział deklaracji śledził je ręcznie na tablicach ClickUp. Przy każdym zadaniu sprawdzano, czy cło zostało opłacone i deklaracja wystawiona, a potem pobierano PDF i wysyłano go klientowi do podpisu. RS.GE nie ma do tego publicznego API, listy przesyłek są w nim podzielone według kont firmowych, a sesje łatwo się zrywają, więc sprawdzanie trwało długo, a zadania trafiały do niewłaściwych statusów.

Odczyt portalu

Menedżer sesji i cztery moduły pobierające, po jednym na kategorię (fizyczne, online, nieznane, eksport), przechodzą strona po stronie przez dane portalu i zapisują je w Postgres. Skanery szczegółów uzupełniają dane osobowe i dane towarów każdej przesyłki, a API wyszukiwania zwraca po numerze śledzenia status przesyłki, towary i PDF deklaracji. Poprawka paginacji podniosła dzienne pobieranie ze sztywnego limitu 500 wierszy do pełnych dni (w testach 878 z 878 i 3 376 z 3 376 wierszy). Skrypty Node.js sprawdzają podpisane zadania w RS.GE i eksportują zatrzymane przesyłki wraz z fakturami na Google Drive do pracy nad kodami HS.

Yellow Check i Green Check

Dla każdej marki dwa symetryczne przepływy uruchamiają się co 30 minut według przesuniętych względem siebie harmonogramów. Yellow Check przenosi zadanie do statusu „cło opłacone”, gdy tylko wszystkie przesyłki w nim zostaną zwolnione. Green Check potwierdza, przesyłka po przesyłce na podstawie wydrukowanego formularza, że deklaracja obejmuje je wszystkie, wgrywa PDF do ClickUp, sprawdza, czy plik rzeczywiście dotarł, i przenosi zadanie do podpisu, co uruchamia wysyłkę koperty Documenso, e-maila i SMS-a z deduplikacją. Zatrzymane przesyłki przechodzą do czerwonego statusu, nieznane numery śledzenia dostają jednorazowy komentarz z ostrzeżeniem, a każdy przepływ zgłasza błędy do wspólnego przepływu obsługi błędów.

Rezultat

Audyt tylko do odczytu w lipcu 2026 r., przeprowadzony przez subagentów Claude Code pod moim kierunkiem, ponownie przeliczył 290 decyzji Yellow Check w 606 zapytaniach i wykazał 0 rozbieżności, a każde z 18 zadań przeniesionych przez Green Check przeszło pełny łańcuch przy 0 zdublowanych podpisach. W 406 uruchomieniach kontrole kończyły się powodzeniem w 99–100% przypadków, a 250 z 250 wysyłek powiadomień zmieściło się w oknie wysyłki 10:00–20:59. Eksport zatrzymanych przesyłek rozpoznał 84 z 84 numerów śledzenia i wgrał 82 faktury.

Projekty: Boxette Group