Your agent syncs Falco invoices from the terminal — no browser.

Install

macOS (Apple Silicon) and Linux. Already installed? Run falcio update. You can also download binaries from GitHub Releases.

The problem

I needed my agent to handle my invoices — without clicking through a web app. My invoicing lives in Falco, like it does for a lot of Belgian independents — Peppol invoices in, sales invoices out, payment status tracked. All of it behind a web and mobile app. Fine for me, useless for my agents.

The only way in was scripting a browser, and I'm not letting a headless browser click around in my accounting.

The solution

falcio talks to Falco directly. It syncs received Peppol invoices, issued sales invoices, and payment status from the terminal — no browser involved.

It's deliberately boring: almost every command is read-only. The one thing it can write is marking an invoice paid or unpaid. Add --json and an agent can work with the results.

When to use it

Use falcio when your agents work with a Falco account and need to:

• Pull incoming Peppol invoices into a folder on a schedule
• Extract the invoice PDFs for archiving
• Check payment status and flag what's unpaid
• Build reports from invoice data without touching the web UI

Features

• List, get, and sync received Peppol invoices, with date and sender filters
• Extract embedded PDFs from Peppol documents
• Sync issued sales invoices and credit notes, with customer filters
• Mark invoices paid or unpaid — the only write operation
• --json output for scripting and agents
• Single self-contained binary for macOS and Linux, with built-in self-update

Source

Source, documentation, and examples: github.com/plosson/falcio