Polish Invoicing API
This is a set of APIs meant for managing electronic invoicing in Poland.
A-Cube API PL helps you handle the interaction with KSeF (Krajowy System e-Faktur) through simple REST APIs.
When you get onboard the A-CUBE API Platform, you will receive:
- username and password for the authentication
You will also need to register a Legal Entity in A-Cube API PL and get KSeF Authorization Token.
This is the process to create and send a new invoice explained in a few steps:
- Login into the platform to obtain a JWT token
- Create an invoice payload in JSON or XML format
- The invoice payload is sent to
POST /invoices - The invoice payload is validated, translated into FA(3) XML format and sent to the KSeF
- Every notification from the KSeF will be dispatched in real time to the configured endpoints.
Environments
- sandbox is the environment where you can test the entire platform without paying at any time; the communication with KSeF is simulated. The base URL is https://pl-sandbox.api.acubeapi.com
- production is the environment where the communication with KSeF is real; you can't send an invoice to test. The base URL is https://pl.api.acubeapi.com
We support the following TLS protocols: TLSv1_2016, TLSv1.1_2016, TLSv1.2_2018
Authentication
You can find all the information about the authentication here.
Invoice UUID
Every invoice in the platform is identified by a UUID. This key is received for both created and received invoices.
Webhooks
All the messages sent to your endpoint are sent with a POST request.
We manage to send the messages to your endpoints with a queue:
if your endpoint fails (we don't get a 200 response) then we will retry every 15 minutes for 8 hours.
Find out more here