openapi-invoicing skill
Italian electronic invoicing and payments through Openapi - send/receive electronic invoices via SDI (Sistema di Interscambio), digital receipts (scontrino elettronico), legal storage, and bill payments (MAV, RAV, PagoPA, car tax). Use for fatturazione elettronica and bill payment tasks.
- GitHub stars
- 16
- Files
- 1
- Last commit
- Sep 15, 2026
- License
- MIT
- Allowed tools
- —
What does the openapi-invoicing skill do?
openapi-invoicing is an agent skill. Italian electronic invoicing and payments through Openapi - send/receive electronic invoices via SDI (Sistema di Interscambio), digital receipts (scontrino elettronico), legal storage, and bill payments (MAV, RAV, PagoPA, car tax). Use for fatturazione elettronica and bill payment tasks.
How to install the openapi-invoicing skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the openapi-invoicing skill in Plugin
/plugin marketplace add openapi/openapi-skills /plugin install openapi-skills@openapi
Install the openapi-invoicing skill in Claude Code
~/.claude/skills/openapi-invoicing/SKILL.md
$ npx degit openapi/openapi-skills/skills/openapi-invoicing ~/.claude/skills/openapi-invoicingInstall the openapi-invoicing skill in Claude Code (project)
.claude/skills/openapi-invoicing/SKILL.md
$ npx degit openapi/openapi-skills/skills/openapi-invoicing .claude/skills/openapi-invoicingInstall the openapi-invoicing skill in Codex
~/.agents/skills/openapi-invoicing/SKILL.md
$ npx degit openapi/openapi-skills/skills/openapi-invoicing ~/.agents/skills/openapi-invoicingInstall the openapi-invoicing skill in Gemini CLI
~/.gemini/skills/openapi-invoicing/SKILL.md
$ npx degit openapi/openapi-skills/skills/openapi-invoicing ~/.gemini/skills/openapi-invoicingInstall the openapi-invoicing skill in Claude.ai
npx degit openapi/openapi-skills/skills/openapi-invoicing openapi-invoicing && zip -r openapi-invoicing.zip openapi-invoicing # claude.ai → Customize → Skills → + → Create skill → Upload a skill → openapi-invoicing.zip
SKILL.md
View on GitHubOpenapi invoicing & payments
Bearer token required (see the openapi-auth skill). Sending invoices/receipts to the Revenue Agency and paying bills are irreversible fiscal/financial actions — always confirm with the user first.
Invoice (preferred) — https://invoice.openapi.com
Full management of Italian electronic invoices (FatturaPA XML) and digital receipts.
POST /IT-invoices— create/send an invoice to the SDI;GET /IT-invoices,GET /IT-invoices/{id}— list and monitor states (delivery, rejection)POST /IT-invoices_import— import externally created invoicesPOST|GET|PATCH|DELETE /IT-configurations[/{fiscal_id}]— per-company configuration (signature, legal storage,receipts_authentication)POST /IT-receipts— send a digital receipt;GET|PATCH|DELETE /IT-receipts/{id}(PATCH returns items from a receipt)
Key constraints:
- Receiving supplier invoices requires registering Openapi's Recipient Code on the Revenue Agency website: code PIC7CPS (Invoice API).
- Receipts cannot be sent 23:55–00:00 Italian time (queued to the next day); the receipt service requires enabling third-party credentials on the Agenzia delle Entrate portal (guide: https://docs.openapi.it/Procedura-manuale-per-incarico.pdf). Freelancers/sole proprietorships cannot delegate and must use their own credentials.
SDI (lower-level) — https://sdi.openapi.it
POST /business_registry_configurations(fiscal_id + email; legal-storage registration email follows)POST /api_configurations— set callbacks for notificationsPOST /invoices— send XML invoice; variants/invoices_signature,/invoices_legal_storage,/invoices_signature_legal_storageGET /invoices/{uuid},GET /invoices_download/{uuid},GET /invoices_notifications/{uuid}- Imports:
POST /customer_invoice_imports,POST /supplier_invoice_imports(+_legal_storagevariants); test withPOST /simulate/{type}
Recipient Code for SDI API: JKKZDGR. If the wallet runs dry the configuration is suspended — reactivate with PATCH /business_registry_configurations/{fiscal_id}/activate after recharging. PA invoices are auto-detected and signed.
Paying Bills — https://ws.pagasubito.it
Pay bollettini, MAV, RAV, PagoPA and car tax (bollo auto) via API in real time.
Full specs: https://console.openapi.com/oas/en/invoice.openapi.json · …/sdi.openapi.json · …/bollettini.openapi.json
Files in this skill
1openapi-invoicing skill questions
How do I install the openapi-invoicing skill in Claude Code?
Run npx degit openapi/openapi-skills/skills/openapi-invoicing ~/.claude/skills/openapi-invoicing. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the openapi-invoicing skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.