How do I fiscalise from my own system with the API?

Any system can fiscalise through the REST API — useful for a custom POS, e-commerce site or bespoke ERP.

Basics

1. In the portal open Integrations → Developer API and create an API key (shown once — copy it).
2. Authenticate each request with the X-Api-Key header.
3. POST the invoice to /api/v1/fiscalise: buyer, currency, and line items with HS codes and tax classes.
4. Read the response: store the returned fiscal number and render the returned document.

Good practice

• Keep your API key secret; rotate it if exposed.
• Handle errors (for example a missing HS code) and surface them to your operator.
• Your fiscalisation data is stored and retrievable while your plan is active.