1. Traceability for the Entity-Ident for Entity "Users" in the audit trail

In the audit trail, the Entity-Ident-column for the ’User’ entity now allows to click on the ident to be redirected directly to the corresponding user detail page. The ident is also displayed in the detail view of an audit trail entry for the ‘User’ entity and is clickable, allowing direct navigation to the corresponding user.
In addition, the ident has been added to the ‘User’ navigation area and is displayed both in the table view and on the user detail page.

2. Traceability for the Entity "Options" in the audit trail

All create, update, and delete actions on options are now fully recorded in the Audit Trail, including changes to prices and other relevant attributes. This applies to all option types and option version updates, ensuring end-to-end traceability and compliance requirements are met.

3. Table csv export function (MVP)

An csv export function is now available for a large number of tables in the webportal. The export is started via a button at the top right of the respective table. Before starting the export, an individual file name can be specified and the desired columns for the export can be selected.

As this is an initial MVP version, the following limitations currently apply:

  • A maximum of 1,000 records can be exported per export
  • Only data that is directly linked to the respective entity is exported. As a result, columns may be displayed in the webportal but not be available for export

4. Deprecated: Data access API

The Data Access API endpoint is now deprecated and should no longer be used for new integrations. For document access, please migrate to the Document API endpoint, which provides the supported and future-proof interface.

5. Go to First Page Button

The pagination in the webportal is expanded to include a ‘Go to first page’ button, which allows to jump directly to the first page from any page starting at page 2

6. Exchange rate in templates

Exchange rates are now available in templates and can be printed on documents if required.

Bug Fixes

  • Adjusted the OpenAPI specification to correct nullable definitions and enforce required fields where applicable, improving consistency and correctness of the API contract.

1. Webportal Improvements

The item list on the document details page now displays the quantity type in addition to the quantity value.

2. Extended Document Provisionig Configuration

Document provisioning configurations can now be activated from a defined invoice creation date, allowing more flexible, criteria-based control of document settings.

3. Enhanced API Access Control with Scopes

We’ve introduced improved access control for our APIs using OAuth2 scopes as part of our role-based access control (RBAC) model. API clients now receive tokens aligned with the specific roles and access rights assigned to their account, ensuring clearer and more granular permission handling across all API operations.

For more details, please refer to our documentation:

Existing API credentials and tokens issued at runtime are not affected by this change and will continue to work as before.

To fully benefit from the improved access control model, we strongly recommend creating new API credentials that reflect the principle of least privilege, ensuring each integration has only the access it requires.

Bug Fixes

  • Corrected nullable fields definitions in the OpenAPI specification. The specification now consistently reflects which fields may return null.
  • Fixed a bug where the OPOS case section disappeared from the document details page after executing an OPOS case decision.

1. Show VAT ID and Company Name for B2C customers

When creating or editing a B2C customer in the web portal, the fields VAT ID and Company name can now be maintained. This allows more complete and accurate customer data management directly within the portal.

2. Show E-Mail in contract details

On the contract details page, the relevant email address now appears under ‘More information’ for invoice and shipping addresses, together with the postal address. This makes the email easily accessible without opening the contact information page.

3. Extensions Document V2 API

We have extended the Document V2 API to include deposits. If an order or contract includes deposits, these are now also output via the Document V2 API. In addition, we now also display the complete data of a customer payment account in the Document V2 API, which is helpful if this data/these fields are to be displayed in the invoice, for example.

4. Late Rated Usage Handling (Billing Group Configuration)

You can now control how late-rated usages are handled on a per Billing Group basis. You can decide whether usages that arrive after an aggregation has already been billed should trigger a correction of the previous invoice or be carried over to the next billing period instead. This reduces unnecessary credit notes and reissued invoices.

Bug Fixes

  • We fixed a bug where the download button for documents in the e-invocing workflow was not working.
  • We fixed a bug that caused the breadcrumb to no longer be responsive.

1. Billing Run Control per Customer (Webportal)

You can now enable or disable the billing run for individual customers directly via the web portal or via API. This allows you to perform complex corrections without generating intermediate credit notes, reducing the number of correction documents created during ongoing adjustments. When the billing run is disabled for a customer, no billing documents will be generated until the billing run is reactivated.

2. Tax Classification Update & Invoice Reissue

You can now update or add a customer’s tax classification retrospectively and reissue a corrected invoice. If a tax classification was missing or incorrect at the time of invoicing, the original invoice can be cancelled and a new invoice will be issued with taxes recalculated based on the updated classification. This ensures correct taxation and compliant invoicing without manual workarounds.

3. API Key Roles

You can now assign roles to API keys, similar to user roles. This enables consistent permission management and improved access control for API-based integrations.

4. New Notification for E-Invoicing

A new notification has been added: "E-Invoicing workflow updated". As soon as there is an update to an e-invoice that has been sent to Avalara, a notification about the update will be sent. You can subscribe to this event with your application and fetch the report immediately.

5. Customer-Level Dunning Block

Dunning blocks can now be set directly on customer level to stop all documents of a customer from being dunned, instead of managing this individually per open item. An optional note can be added, and the customer-level dunning block is visible across all OPOS cases.

6. Document Counter Start Value Configuration

The document counter configuration has been extended with a configurable start value, allowing counters and resets to begin from a defined lower limit instead of always starting at zero.

Bug Fixes

  • Fixed an issue where metered usage items were missing a price calculation basis on customer invoices
  • Fixed duplicate parameters in the Customer (Tax Classification) OpenAPI specification

  1. Tax Exemptions
    You can now create Tax Exemptions and assign them to tax rules. This is especially important for e-invoicing, as invoices with a 0% tax rate must include a valid Tax Category Code and a Tax Exemption Reason Code to be considered compliant.

    With this feature, you can define your own Tax Exemptions and link them to existing tax rules to ensure correct tax classification and compliant invoice creation across different countries and regulations.

    This improves validation, reduces rejection rates from tax authorities, and ensures your e-invoices meet mandatory legal requirements. Learn more.

  2. Expert Mode for Document Provisioning
    The Webportal now offers an Expert Mode for document provisioning configuration. When enabled, an additional JSONATA field becomes available, allowing advanced routing logic based on custom conditions.

    This enables complex use cases such as: • Routing based on invoice amount thresholds (e.g. only apply rule if amount > 250) • Industry- or region-specific routing logic

    All JSONATA conditions are evaluated within the Document Provisioning Service and are also respected by the e-invoicing workflow, ensuring consistent behavior across all document formats.

    This enhancement increases flexibility and supports advanced compliance requirements.

  3. Default Jsonata Mapping for E-Invoicing Configurations
    When creating a new e-invoicing mandate, a default JSONata mapping is provided automatically. This helps you get started faster without having to build the mapping from scratch.

  4. Added Business Segments to OPOS-Cases
    We added visibility of business segments in the OPOS cases to support correct account splitting and posting.

  5. Billing Run Control per Customer (API only) You can now enable or disable the billing run for individual customers directly via API. This allows you to perform complex corrections without generating intermediate credit notes, reducing the number of correction documents created during ongoing adjustments. When the billing run is disabled for a customer, no billing documents will be generated until the run is reactivated.

  6. Bug Fixes

    1. We fixed a bug where some required mappings for a correct ZUGFeRD invoice were missing, such as Payment Instructions (BG-16 / BT-21) and Payment Reference (BT-83).
    2. Fixed an issue where tax rules with a classification were incorrectly applied even when no valid customer tax classification existed.
  7. Announcement instellix Rebranding
    As part of the rebranding of our company from Nitrobox to instellix, the webportal will undergo a rebranding in the coming weeks to reflect our new brand identity. This includes adjustments to colours, typography and visual elements to align them with our revised design and vision for the future. Stay tuned.

    1. As part of the instellix rebranding, we are also refining the user interface to make it cleaner and more intuitive. To keep frequently used actions easy to access while reducing visual clutter, we will introduce a consistent “three dots” action menu across the webportal. Actions that go beyond the standard options like viewing, editing, or deleting are no longer shown as separate buttons. Instead, these additional options can be found by clicking the three‑dots icon next to the relevant item, which opens a small menu with all available actions for that context. This helps the interface feel more modern and organized, while ensuring that all familiar actions remain easy to find.

  1. Download of E-invoicing Documents within the Workflow
    All e-invoicing documents generated within the workflow can now be downloaded directly. This is especially useful when multiple invoice formats (e.g. XML, PDF) are created in parallel, giving you full visibility of all transmitted documents and formats within each workflow.
  2. Advanced JSONata Configuration for E-invoicing
    Within Document Provisioning, the expert mode now supports JSONata expressions for even more granular e-invoicing configurations. This allows you to define complex conditions — for example, ensuring that only invoices with a total amount above €250 are processed as e-invoices, while lower amounts continue to be issued as PDFs. This enhancement offers maximum flexibility for implementing custom e-invoicing strategies.
  3. Bug Fixes
    1. Fixed a bug that prevented 0-value rated usages from being aggregated.
    2. Fixed a bug where the recalculation of billable items failed.

  1. Payment Provider Adyen You can now set up and manage your Adyen 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. Webhook configuration will follow shortly.
  2. Accessible Documents All documents can now be generated as accessible PDFs. This feature helps businesses comply with digital accessibility regulations (e.g. the EU Accessibility Act / German BFSG). Please get in touch with your Professional Service representative if you are interested in enabling this feature.
  3. Customer Tax Classification
    You can now define custom customer tax classifications, assign them to customers, and use them within tax rules. This enables more advanced tax scenarios, such as fiscal unities or reseller relationships. Classifications can also include an end date, enabling time-bound assignments automatically.
  4. Webportal
    1. Internationalization Enhancements As part of our ongoing internationalization efforts, we’ve improved translations across multiple areas of the platform — including the DataGrid component to ensure consistent language handling across the interface.
  5. Bug Fixes
    1. Refunds now correctly display the original Customer Payment Account, even if it has been overwritten in the meantime. The refund itself was always processed to the original account – this was only a display issue in the web portal.
  6. Upcoming API Changes
    We would like to inform you about upcoming changes to deprecated endpoints that will be removed in the upcoming (2025-11-17) deployment in accordance with our sunsetting policy https://docs.nitrobox.io/reference/api-lifecycle-versioning.
    1. We will be removing the deprecated 'Purchase Item' endpoints from our Contract APIs that are part of the Billing API. Line Item endpoints replaced this feature.
    2. We will be hiding the deprecated 'Purchase Item' endpoints from our Orders API spec that are part of the Billing API. We aim to remove them by March 2026. Line Item endpoints replaced this feature.
    3. In the request and responses of both Orders and Contracts, the Purchase Items will be hidden in the API spec from now on.

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