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
- 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.