Oct 2025 – Present
RS.GE customs declarations
n8n workflows that follow each parcel through RS.GE customs and start the customer’s e-signing
- Automation
- Customs automation
- Duration
- 1 year
- Company
- Boxette Group
- Role
- Automation engineer: design, build, debugging, docs
Overview
An n8n system that links Georgia’s Revenue Service customs portal (RS.GE) to Boxette’s ClickUp declaration boards. It watches each parcel’s customs status, attaches the issued declaration PDF and starts the customer’s e-signing and notifications by itself, for both of the company’s brands.
Tools
- PostgreSQL
- Documenso
- SendGrid
- Node.js
- Telegram
Declarations by hand
Every parcel over the duty-free limit needs a customs declaration on RS.GE, and the declarations team tracked them on ClickUp boards by hand. For each task they checked whether duty was paid and a declaration issued, then downloaded the PDF and sent it to the customer to sign. RS.GE has no public API for this, its parcel lists are split per company account and its sessions break easily, so checking was slow and tasks ended up in the wrong status.
Reading the portal
A session manager and four category fetchers (physical, online, unknown, export) page through the portal’s data into Postgres. Detail scanners add each parcel’s personal and goods data, and a track-lookup API returns a parcel’s status, goods and declaration PDF by tracking number. A pagination fix lifted the daily fetches from a hard 500-row cap to complete days (878 of 878 and 3,376 of 3,376 rows in tests). Node.js scripts check signed tasks against RS.GE and export held parcels with their invoices to Google Drive for HS-code work.
Yellow Check and Green Check
For each brand, two symmetric workflows run every 30 minutes on staggered schedules. Yellow Check moves a task to 'duty paid' once every parcel in it is released. Green Check confirms, parcel by parcel against the printed form, that the declaration covers them all, uploads the PDF to ClickUp, checks that the upload landed and moves the task to signing, which sends a Documenso envelope, an email and an SMS with de-duplication. Held parcels move to a red status, unknown tracks get a one-time warning comment, and every workflow reports to a shared error workflow.
Result
A read-only audit in July 2026, run with Claude Code subagents under my direction, recounted 290 Yellow Check decisions across 606 lookups and found 0 mismatches, and all 18 tasks moved by Green Check had completed the full chain with 0 duplicate signings. Over 406 runs the checks succeeded 99–100% of the time, and 250 of 250 notification runs stayed inside the 10:00–20:59 sending window. A held-parcel export resolved 84 of 84 tracks and uploaded 82 invoices.