szamlazz-cli
Command-line client for the Számla Agent and local development receiver for IPN and Adatkapcsolat.
Usage
Set an Agent key, then issue or query documents from the shell. Ready-to-edit request files are available as examples/invoice.json and examples/receipt.json.
export SZAMLAZZ_AGENT_KEY=your-agent-key
szamlazz invoice create -f examples/invoice.json --pdf invoice.pdf
szamlazz invoice get E-2026-123
szamlazz invoice download E-2026-123 -o invoice.pdf
szamlazz invoice storno E-2026-123 --comment "Hibás vevő"
szamlazz payment register E-2026-123 --date 2026-07-04 --method átutalás --amount 12700
szamlazz proforma delete D-2026-42
szamlazz receipt create -f examples/receipt.json
szamlazz taxpayer 13421739
szamlazz listen --adatkapcsolat-key KEY
Számla Agent commands support --json for machine-readable output. The listen command does not: it pretty-prints received messages for interactive development.
szamlazz listen serves IPN at POST /ipn. When an Adatkapcsolat key is configured, it also serves POST /adatkapcsolat. Point a tunnel such as cloudflared at the listener to inspect real deliveries during integration work.
The command remains named payment register for shell ergonomics; it registers a credit entry against an invoice through the Számla Agent.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.