We deployed a small hotfix to address several API description (OAS) issues that were brought to our attention, preventing some clients from easily generating client code from our API specification.

1. Data Access API We have revised the API documentation of our Data Access API to make it clearer and more precise. The following changes are included:
   1. Correction and extension of payment methods.
2. Changes to our Invoice API General fixes: Minor inaccuracies in the documentation have been corrected.
   1. The property paymentInformation is now documented as nullable

Important: The API functionality remains unchanged. Paths and payloads have not been modified - this update affects the documentation only. Minor adjustments to client side generated code may be necessary. If you have any questions, our support team is available to assist you.

• Batch Payments
  Nitrobox now supports Batch Payments, making it easier to assign a single payment to multiple invoices or credit notes.Batch Payments can be processed manually in the web portal, via API, or automatically by uploading a remittance advice, which is matched to the corresponding invoices. For more information, click here.
• PaymentIntentResult-Notification extended with retry ident The PaymentIntentResult Notification has been extended to include new fields called RetryIdent and Final-Retry-Flag. This field allows you to identify whether a failed payment attempt belongs to a specific retry cycle and whether it represents the final retry for that Payment Intent. With this enhancement, payment owners can now monitor failed payment attempts more accurately and take appropriate actions — for example, automatically canceling affected contracts when all retries have failed.
• Accessible Documents To ensure compliance with legal accessibility requirements, Nitrobox now supports the creation of accessible documents. If you require this functionality, please contact your Professional Services representative for more information and enablement.
• Graphical Contract Lifecycle To provide a clearer overview of contracts, Nitrobox now offers a graphical timeline visualization for contracts with monthly billing. The timeline displays all related documents and payments in chronological order. Different icons and colors indicate the current status of each document and whether it represents a payment or payout. This enhancement allows to understand the entire contract history at a glance — without having to navigate through multiple documents.

1. Payment Category in Settlements The Settlement Report no longer displays the payment category. This field never had a functional purpose, but could lead to confusion.
2. Extension of the Payment-Intent-Result-Notification We have extended the Payment-Intent-Result-Notification to include the retry ident and to indicate whether it's the final retry of a failed payment intent. This helps make follow-up decisions, such as terminating a contract after the last retry attempt.
3. Calculation Basis on Templates The calculation basis of Billable Items for recurring options is now available to be used in your PDF templates as well. Now you could show your customers why they only need to pay a pro-rated amount in the first month, for example.
4. Batch Payment Assignment We have introduced the new Batch Payment Assignment feature, allowing a single payment (e.g. a bank transfer) to be assigned to multiple invoices or credit notes at once. Assignments can be done either manually or via CSV import, providing flexibility for different workflows. All further details can be found at https://docs.nitrobox.io/docs/batch-payment-assignment.
5. Performance Status We've added a new status to our contracts, API only for now. It can show you at a glance and allows for quick filtering to see if a contract hasn't yet started, is in its performance phase is no longer being serviced, without having to create difficult search queries checking against the start and end date.
6. Bug Fixes
   1. We fixed a bug where some applicablePurchaseItemTypes were missing in our API documentation.
   2. We fixed a bug where multi-tax rates were displayed incorrectly in the invoice details. The tax rate is now shown as the cumulative value of all applicable taxes. Previously, only the value of the first multi-tax was displayed.
   3. Fixed a bug where the credit billable item endpoint was shown as deprecated

Due to an internal software update by the third-party provider we use to publicly publish our APIs, the way customers access the Open API specification (OAS) files will change slightly. The URL used to retrieve each of the specification files will be updated — transitioning from a purely technical identifier to a human-readable identifier and file name. The structure and content of the specification files remain unchanged.

The entry point for all OAS files remains unchanged as well at https://docs.nitrobox.io/v2/reference/openapi-specification-oas.

Please ensure that any integrations or tools relying on the previous URLs are updated accordingly for continued access and processing of these files. This change will take effect on Wednesday, 24th of September.

For your convenience, we have listed the mapping of changes for each API below:

Example

https://docs.nitrobox.io/v2/openapi/60b8f92103850600379a144c

will change to

https://docs.nitrobox.io/v2/openapi/customer-api.json

1. E-Invoicing Improvements The Avalara mapping configuration now only displays companies and billing countries activated in the Avalara portal, which prevents accidental selection of unconfigured countries.
2. Extended self-managed payment methods We have significantly expanded support for externally managed payment methods in orders and contracts. Instead of the previous 16 methods, around 80 additional payment methods are now available and can be printed on documents. See the full list of supported self-managed payment methods here.
3. Performance improvements
   1. We improved the performance of our outgoing Notifications.
   2. We improved the performance in retrieving contracts by a significant margin.
4. Bug fixes
   1. We fixed a bug where, after reverting a partial or complete assignment, the status incorrectly remained ‘Partial Assigned’ instead of changing back to ‘Unassigned’.
   2. Fixed a bug where Options in status DRAFT that were no yet being used in any contract couldn't be deleted.
   
   

1. Bug Fixes
   1. Fixed a bug where sometimes a dunning document was not sent to the archive solution.
   2. Fixed a bug where searching and sorting for the new seller entity didn't adhere to our API standards

1. Avalara E-Invoicing
   We have made several improvements to Avalara E-Invoicing integration in Nitrobox, making it easier to manage credentials, configurations, and documents directly in the web portal:
   • You can now enter Avalara ELR credentials directly in the web portal and configure all Avalara settings there.
   • The document workflow has been extended so that PDF or XML files can be downloaded directly from a workflow step – no separate Avalara login is required anymore
   • In addition, we have implemented a validation that immediately checks the JSONata mapping for errors, helping to identify and fix issues faster.
2. Credit Card Type in Customer Payment Account
   You can now specify the credit card type used by your customers in the customer payment account. This can be used, for example, to print more specific information on your documents.
3. Cancellation of Payment Intents
   It is now possible to cancel payment intents before they are processed. This allows you to stop the transaction entirely, rather than charging the customer and then issuing a refund. The change helps avoid unnecessary payment processing steps, improves the overall customer experience, and reduces PSP costs.
4. API
   • You can now provide a sellerOperatingSiteIdent in the document v2 API. This allows you to specify a different seller on a document than your tenant, allowing for a basic marketplace setup.
   • We've added a new endpoint where invoiced recurring and one-time option items can be corrected. This should help handle support cases more easily. You can find the endpoint here: https://docs.nitrobox.io/reference/correctbillableitem
     We aim to soon enable this feature in the web portal as well.
   • Our notifications have been extended to include the timestamp when an API call to your system is being made. This can help you order and process the notifications in the correct order.
5. Bug Fixes
   • Fixed an issue in the voucher process via TalonOne where the character “/” in the documentIdent was not handled correctly. The system now fully supports this character, ensuring smoother voucher creation and redemption.
   • Fixed a bug where optional usage options were sometimes not displayed in the contract details page.
   • Fixed a bug where picking a different language during order creation didn't work correctly.
   • Fixed a bug where 0-value rated usages could not be sent via API.
6. Webportal
   • You can now change the correction mode (item-based vs document-based) on billing group level in the UI.
   • When adding new usage options to plans you can decide if you want to enable them automatically for all existing contracts or if you want to enable them later on a per contract basis.

1. Extended data available for our booking rules
   We are now consuming more information in our booking engine, which will allow for even more flexible booking rules and enhance our ability to provide more data in accounting reports.
2. Document-level corrections
   Until now, when an invoice contained multiple items and only one required correction, we would issue a credit note and a new invoice for just that specific item. However, we've found that this approach can lead to confusion—especially when invoices include hundreds of items. Reviewing and reconciling documents across a single month often requires combing through dozens of credit notes and partial invoices, which is time-consuming for both your support team and your customers.
   To address this, we’re introducing document-level corrections. Going forward, if any item on an invoice needs to be corrected, the entire original invoice will be credited, and a new invoice will be issued with the corrected data. Even if 99 out of 100 items remain unchanged, the revised invoice will reflect the complete and up-to-date version of the document.
   This change ensures there is always one clear, current invoice to refer to—simplifying communication and improving transparency for everyone involved.
   Changing this config, which is available on Billing Group level, can currently only be done by API, but we are looking forward to enabling this via webportal self-service.
3. Avalara E-Invoicing
   Avalara ELR workflows are now visible in the web portal. You can see the current processing status, status history, and detailed API logs (requests and responses) for each electronic invoice.
4. Payment Provider Extension
   You can now configure Stripe credentials (API keys) and retry settings directly in the web portal. This allows for faster and more flexible PSP integration without technical support.
5. API
   1. We've published the new "Seller Entity" to be used later for diverging sellers needed for marketplace functionality.
   2. We’ve added a new validation to the Document API v2: All items on an invoice must now have the same Tax Location Country to ensure accurate tax calculation.
6. Webportal
   1. The Billable Item details page was redesigned to improve the user experience. A card for the pricing structure was added to reflect how the price is calculated, for example, based on usage.
   2. Payment Intent details page was also redesigned to improve the grouping of information on the page.

1. Avalara E-Invoicing
   The Avalara integration for electronic invoicing is now available. Nitrobox enables the creation and transmission of e-invoices via Avalara ELR, supporting compliance with legal requirements for all supported countries.
   Further enhancements – including configuration options in the web portal – will be added soon.
2. E-Invoicing: Extended Recipient Code Parameters
   Recipient code settings have been extended based on the official Peppol specifications. The configuration now includes all countries with specific recipient code requirements. These codes can now be added directly in the customer configuration under E-Invoicing Parameters. A detailed guide is available here: E-Invoicing Recipient Codes
3. Payment Provider Stripe
   You can now set up and manage your Stripe integration without developer support – including activation, deactivation, and management of payment retry logic directly via the Nitrobox Webportal. This makes it easier to adjust payment behavior for different use cases, such as e-commerce or subscriptions.
4. Retire your plans
   You can now retire your plans. Contracts for retired plans continue functioning as usual, but you won't be able to create new contracts for retired plans. This feature should help you manage your plans better and see which ones are still relevant for your daily operations.
5. Improvement in notification retries
   We've updated our notification retry logic to allow for longer offsets (last notification retry will be attempted ~72 hours after the first) and are now also retrying other HTTP Error Codes, such as 429. This will improve the number of notification failures that the automated retry feature will catch.
6. API
   1. Removed an API description bug for our Customer API that insinuated that properties were mandatory.

1. Update to billable items when tax rule changes
   When using the NBX tax provider and changing a tax rule, all associated planned billable items will now be recalculated to reflect the tax change. Previously, the new tax rate was only applied at the time of final invoicing
   This allows for greater clarity of what will be invoiced in the future and allows you to provide more accurate information to your customers ahead of time.
2. Adding usage options to an active plan
   Previously, when adding a new usage option to a plan already in use, you had to additionally activate the usage option on all contracts as well. We've enabled you via API to enable the new option for all active contracts automatically. This improves the ease of managing and evolving your plans.
3. Webportal improvements:
   1. We reworked our manual billing flow. The feature, previously only available to users with "beta" rights, can now be accessed by all. You will now also see a list of billable items that will be invoiced when executing the billing run manually.
4. Bug Fixes
   1. Fixed a bug where contract renewal notifications were sometimes not published
   2. Fixed a bug in the web portal where creating a single-phased plan without autorenewal was no longer possible.