Skip to content
Join the community

sunat-cli automates SUNAT from the terminal

An agent-first CLI that wraps ten SUNAT surfaces, from electronic invoices to the SOL mailbox.

sunat-cli lets an AI agent operate Peruvian tax procedures while a human supervises. It is for freelancers and companies that deal with SUNAT and want their agent to do the paperwork safely. It covers electronic invoices, SIRE, dispatch guides, the SOL mailbox, fee receipts and the REST APIs in one binary. Docs are at sunat-cli.crafter.ing.

An agent asks what a command accepts and gets a versioned contract back.

Contracts an agent can read#

sunat-cli schema <resource> describes what a command accepts as data, with required fields, types and defaults. The help output is the contract too, so every command it lists exists in your installed version. Output is JSON whenever stdout is not a terminal, so an agent gets parseable data without passing a flag.

Ten SUNAT surfaces behind one command#

SUNAT exposes SOAP with signed XML, REST with OAuth, a ticket queue, a legacy inbox, a JSON API and form sessions. sunat-cli wraps them under sixteen namespaces, from cpe and sire to buzon and renta. Commands that change something carry a trust level and a dry run.

sunat-cli homepage with the ten SUNAT surfaces and a sample agent session
The docs list every surface and how much of it is covered.

Try it#

It runs on Node. Read-only lookups need no session.

npm install -g @crafter/sunat-cli
sunat-cli doctor
sunat-cli schema f616
sunat-cli padron ruc 20100070970

What it includes#

  • Electronic invoices, notes and dispatch guides (UBL 2.1, XAdES, SOAP)
  • SIRE sales and purchase registers
  • Fee receipts and the monthly 616 form, driven through agent-browser
  • Read-only access to the SOL mailbox, filed declarations and the annual income tax return
  • Frequent releases on GitHub