🎉 Releasing major enhancements for streamlined invoice management and reconciliation 🎉
API operations added
It is now possible to publish a draft invoice, making it official and ready to be sent to the customer.
You can publish, list, fetch and update credit notes for the company.
You can now create a draft credit note for a specific invoice. The draft can be partially credited, for example, crediting 3 out of 4 items on a line. Once ready, the credit note can be published too.
You can now create a new payment record for a specific invoice. To use an accounting account other than the default (1930), specify it via the bookkeepingAccountNumber field. You can also get all payment records for an invoice or fetch a specific one. It is also possible to delete a specific invoice payment.
It is now possible to create a settlement that will reduce the outstanding amount of the invoice. A negative amount will increase the outstanding amount. For example, in the case of a currency gain. Settlement types that can be created in Bokio API are currency and bankFee. You can also get all settlements for an invoice or fetch a specific one. It is also possible to delete a specific settlement.
API improvements
When adding line items to an invoice, it is possible to add bookkeeping account number to manage bookkeeping for each item efficiently.
Releasing a large set of API changes and announcing the release of v1.
🎉
Announcing Bokio API V1
We've reached a significant milestone and are excited to announce the official release of Bokio API v1! This new version brings major improvements and new features, marking the end of our beta phase.
Please note that;
Bokio API Beta is now deprecated and will be removed on October 1st
Private integrations must get a new API token from API Tokens
Deprecation of the Beta Version
Please be aware that the beta API is now deprecated and will be sunset on October 1st. We encourage all developers to migrate to the new v1 API as soon as possible to avoid any service disruptions.
Important Changes for Integrations
API Versioning
To ensure a smooth transition and future updates, please take a moment to review our API versioning information.
New Scopes
We've introduced new scopes to the API. This allows you to grant your integrations only the specific permissions they need, improving security and control. You can find more details on these new scopes in the API documentation.
New Tokens for Private Integrations
If you have a private integration, you must generate and copy a new API token to remain valid. While your old token may still work for a short time, it will soon return 403 responses. Please update your token to ensure your integration continues to function correctly. Go to API Tokens and use the Copy button to get a new token.
New Functionality and Exposed Data
This release includes a wealth of new features and data to enhance your integrations:
Filtering and Metadata
Filtering: You can now use filtering in list operations, giving you more precise control over the data you retrieve.
Metadata: We've started adding metadata for API resources, beginning with invoices. This allows for more flexible and detailed data handling.
More Data Exposed
Invoices: Invoices now support the cash invoice type. You can also set orderNumberReference and deliveryAddress.
Fiscal Years: It's now possible to retrieve fiscal years directly through the API.
SIE Files: You can now download SIE files programmatically.
We have released improvements to the error handling in the Bokio API. The main changes is for validation errors where we now:
Return all validations errors instead of first encountered error
Validations errors include both a message and a field parameter. We want to highlight that the field parameter used the JSON Pointer which make it possible for you to identify which field within nested objects and/or array that the error is for. For example, the quantity on the second line item using #/lineitems/1/quantity.
Publishing documentation to public integrations and General API. Also releasing improvements to invoices and customer operations.
🎉
Public Integrations and General API
We are now unveiling some documentation for public integrations and the General API. There's no general access to public integrations at this point but we enable early access for key integration partnerships.
It's now possible to create customers by only supplying the name of the customer. Note that before invoices are published additional information is required.
The issue with invoice dates and customer payment terms, mentioned in 2025-04-11, has now been solved.
API specifications available for download
Finally, we are making api specification available for download.
GET companies/{companyId}/items/{itemId} - Get an item
PUT companies/{companyId}/items/{itemId} - Update an item
DELETE companies/{companyId}/items/{itemId} - Remove an item
Known issues
Issue with invoice dates and customer payment terms
There's an issue with invoice dates that makes the dates change when opening an invoice, created through the Bokio API, in the app. The dates will when invoice is opened in the app changes to the match the customer payment terms. We are actively working on a fix for this issue and hope to resolve it soon.
Introducing Bokio API as a Beta for Private Integrations. Please take note of breaking changes may need to be introduce without notice during the Beta.
Checkout: How to set up integration with a company in Bokio via an API to get started
API operations included:
POST companies/{companyId}/journalentries
GET companies/{companyId}/journalentries
GET companies/{companyId}/journalentries/{journalId}
