How do I install the Openapi Invoicing skill?

Run npx skillmds@latest add openapi/openapi-invoicing in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openapi Invoicing safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openapi Invoicing?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openapi Invoicing free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openapi Invoicing?

openapi (@openapi) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openapi Invoicing by openapi — Agent Skill

Name: Openapi Invoicing
Author: openapi

Openapi Invoicing

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.

openapi e331066 2.7 KB Updated Sep 17, 2026

File contents

Openapi 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 invoices
POST|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 notifications
POST /invoices — send XML invoice; variants /invoices_signature, /invoices_legal_storage, /invoices_signature_legal_storage
GET /invoices/{uuid}, GET /invoices_download/{uuid}, GET /invoices_notifications/{uuid}
Imports: POST /customer_invoice_imports, POST /supplier_invoice_imports (+ _legal_storage variants); test with POST /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

---name: openapi-invoicingdescription: 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.---# Openapi invoicing & paymentsBearer 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 invoices- `POST|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`1. `POST /business_registry_configurations` (fiscal_id + email; legal-storage registration email follows)2. `POST /api_configurations` — set callbacks for notifications3. `POST /invoices` — send XML invoice; variants `/invoices_signature`, `/invoices_legal_storage`, `/invoices_signature_legal_storage`4. `GET /invoices/{uuid}`, `GET /invoices_download/{uuid}`, `GET /invoices_notifications/{uuid}`5. Imports: `POST /customer_invoice_imports`, `POST /supplier_invoice_imports` (+ `_legal_storage` variants); test with `POST /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

Frequently asked questions