Key data components
Our new API for invoice creation (V3) is pushing simplicity. Accordingly we can create, and send invoices through several channels with a single API call. (Create invoice V3)
The invoice therefore contain all relevant information in the request body, listed below. To understand how the information is generated on the invoice itself, go to the page Data Mapping - API to PDF Visualization
Request body main components:
- Order details
- Customer data
- Distribution information
- Payment methods available
- Important dates (invoice date, due date, invoice period, etc.)
Invoice states
Draft state:
In draft state, the invoice is not locked, which provides the possibility to manage, validate and update the invoice before sending it. A draft invoice can be sent to end customers and receive payments, acting as a prepayment invoice.
Note: draft parameter needs to be set to true to create an invoice in draft state. Default setting is "draft": "false" and "sendInvoice": "true".
Final state:
A finalized invoice can no longer be edited and is sent directly to the end customer in the create invoice API call (as the default setting according to the note above is "draft": "false" and "sendInvoice": "true"). If something is wrong with an invoice in final state, it should be credited and matched to the credit while a new invoice is also issued with the correct data (Read more about credits in the page Create and use credit invoices).
Validation of invoice data
One of our overall visions is to make B2B payments as simple as in B2C. But for us to provide this value, we have some must have validations of the invoice data. This will help our merchants ensure that all legal requirements are fulfilled, that price calculations are correct and to make sure of flawless invoice delivery success.
Accordingly, some data in the invoice API is validated and cannot be overridden. The API returns clear error validation responses automatically so you know what needs to be adjusted. Examples of validations are listed below,
- Organisational number (regNumber) in combination with the Country Code
- ZIP code in combination with the Country Code
- Item Price and VAT in combination with VAT Rate and Total Amounts
Unlocking value adding services with Order Data
We are continuously adding new functionalities that can help our customers grow. Some of our services like invoicing and receipts require certain amount of order data in order to function as a product. Some services, like card payments, does not require that much data to function, but will unlock new values when included. If for example orderId is added to a card payment, we will automatically generate and distribute a cash invoice/receipt to the Buyer.
Do not hesitate to contact us in order to get more information about the possibilities that comes with enriched data or if there might be any need that is not yet available in our system.