Tax reduction (ROT & RUT) is now supported on invoices. You can include tax reduction data when creating or updating an invoice, and the data is returned when fetching invoices.
Improved support for paymentServiceFee type settlements, including correct balancing account usage for bookkeeping.
🎉 Introducing tag management and journal entry tagging, new reference fields for invoices and credit notes, and additional invoice and item improvements.
It is now possible to apply tags to journal entries at the journal entry level (on the journal entry) or at the journal entry item level (on individual line items). You can also update the tags on an existing journal entry. This is currently a preview feature.
API improvements
It is now possible to create a paymentServiceFee type settlement for an invoice. This enables recording payment service fee deductions directly on the invoice.
dueDate is now optional when creating or updating an invoice. If omitted, the due date is automatically calculated from the customer's payment terms.
projectReference, buyerReference, and contractReference are now available on invoices. These fields can be set when creating or updating an invoice and are returned when fetching invoices.
projectReference, buyerReference, and contractReference are now available on credit notes. These fields can be set when updating a credit note and are returned when fetching credit notes.
bookkeepingAccountNumber is now supported on items. You can set it when creating or updating an item, and it is returned when fetching items.
🎉 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.
