Skip to content
English
Log in to support portal
  • There are no suggestions because the search field is empty.

Company settings

This article is for admin users of a Maventa account. It explains how to manage company information, account settings and billing information. It covers basic company details, email reports and notification settings. It also covers how to choose the delivery method for Maventa's own service invoices, add bank accounts and manage users. Where a setting can also be changed through an API connection, the article explains how. The company's Maventa account settings are always the responsibility of the account's admin users. Other user roles cannot change company account settings.

The company's Maventa account settings are always the responsibility of the account's admin user. Other user roles do not have the rights to modify company account settings.

Changing company settings through the API

Most of the settings in this article can also be changed through Maventa's REST API. This is useful when the accounting software or integration manages the company account automatically.

  • View current settings: GET /v1/company/settings. The fields parameter limits the response to certain setting groups, for example details, address, email_reports or billing_details.

  • Change settings: PATCH /v1/company/settings. Only the setting groups included in the request are changed.

The API connection uses the company's API credentials, which are the user API key and the company UUID. More information on authentication and account management through the API is in Maventa's documentation: Companies and settings and Companies and settings API.

ℹ️ Some settings can only be changed in the Maventa account. Each section below says whether the API supports the setting.

Company details

👉 Open the setting directly in Maventa: Company settings > Company details. You’ll need to sign in first if you aren’t already.

To edit basic company information, log in to the service and navigate to the Company details section under account settings. In this section, you can review or modify the following information:

Basic company information

Name, Business ID, E-invoicing Address (EDI/OVT identifier), Country, Company Email.

Name: The company name can be edited by the account admins. If the company name changes, follow these steps to update it:

  1. In the Maventa account, go to: Settings > Company settings > Company details

  2. Correct the company name in the designated Name* text field

  3. Click the Update button at the bottom of the view

Through the API: The company name is updated with the details.name parameter. The name must be at least three characters long.

Business ID: The company's Business ID provided during registration. Once defined, the Business ID cannot be changed. If the ID changes due to a change in legal form or a merger, a completely new account must be created with the up-to-date ID. Detailed instructions on corporate restructurings can be found here: Company mergers and acquisitions.

Through the API: The Business ID can be viewed but not changed.

EIA/EDI code: The company's e-invoicing address generated during account registration.

Country: The company's operating country provided during registration.

Through the API: The country can be viewed but not changed.

Company email: The general contact address for the company, which also appears on invoice details. This is editable by admin users. Follow these steps to update company email:

  1. In the Maventa account, go to: Settings > Company settings > Company details

  2. Update the email address in the Company email* text field

  3. Click the Update button at the bottom of the view

Through the API: The company email is updated with the details.email parameter.

Inbound invoice notification email: The Inbound invoice notification email field allows you to set a separate email address for receiving automated notifications about incoming purchase invoices. This is editable by admin users. If the email address has changed, or needs to be added or deleted, follow these steps to update it:

  1. In the Maventa account, go to: Settings > Company settings > Company details
  2. Enter, update or delete the email address in the Inbound invoice notification email text field
  3. Click the Update button at the bottom of the view

Through the API: The separate address is set in the invoice_notifications.on_receiving block:

  • how_to_send: OTHER_EMAIL sends notifications to a separate address. COMPANY_EMAIL sends them to the company email and removes the separate address

  • other_email: the separate email address. It is only accepted when how_to_send is OTHER_EMAIL in the same request

  • enabled: true or false turns notifications about incoming invoices on or off

ℹ️ Please note: If the setting Disable all notifications is enabled, notification messages for incoming purchase invoices will not be sent, even if an email address is entered in the Inbound invoice notification email field.

Email reports

Enable email reports: The admin users can subscribe to a brief report regarding company account invoice volumes via email. The report includes the number of received, sent, and failed invoices. Frequency can be set to daily, weekly, or monthly. Alternatively, select Off to disable reports.

Report emails: Define the email address(es) where the reports should be sent.

Follow these steps to update email reporting settings:

  1. In the Maventa account, go to: Settings > Company settings > Company details

  2. Select from the drop-down menu under Enable email reports to;

    1. Enable reporting and define how often reports are sent: Daily, Weekly, Monthly
    2. Disable reporting: Off

  3. Enter the recipient address(es) in the Report emails text field. Separate multiple addresses with a comma ( , )

  4. Click the Update button at the bottom of the view

Through the API: Email reports are set in the email_reports block:

  • report_interval: off, daily, weekly or monthly

  • email_reports: a list of recipient email addresses

Disable all notifications

Disable all notifications: The admin users can block or allow automatic notification messages sent by Maventa to the company email. This does not apply to critical notifications, such as invoice delivery failures or notifications regarding newly detected bank account numbers.

Follow these steps to update notification settings:

  1. In the Maventa account, go to: Settings > Company settings > Company details

  2. Toggle the Disable all notifications checkbox:

    • Active: To block all notifications from Maventa to company email

    • Inactive: To receive notifications from Maventa to company email

  3. Click the Update button at the bottom of the view

Through the API: This setting cannot be changed through the API. It can only be changed in the Maventa account.

📌 Notification setting restrictions do not apply to critical exceptions. The system always sends an automated notification for invoices that have failed or contain errors, even if other optional email messages are blocked for the company email address.

This ensures that potential errors are always brought to the user's attention and can be resolved without delay.

💡 If you wish to block notification messages about invoice sending errors or route them to a specific email address, the setting in question is updated from the company account's Invoice settings view according to these instructions: Invoice notifications - Sent invoices.

Through the API: these notifications are set in the invoice_notifications.on_send_errors block. to_user (true or false) controls whether users are notified, and to_emails lists other addresses that receive the notifications.

Automatic e-invoice instruction page

Automatic e-invoice instruction page:  The admin users can enable a setting for invoices sent via the print service which, when active, automatically prints an instruction page with each printed invoice. This page explains how the recipient can receive invoices as e-invoices in the future.

The instruction page is free of charge and is only printed with paper invoices.

Follow these steps to update automatic e-invoice instruction page settings:

  1. In the Maventa account, go to: Settings > Company settings > Company details

  2. Toggle the Automatic e-invoice instruction page checkbox:

    • Active: To include the instruction page

    • Inactive: To disable the instruction page

  3. Click the Update button at the bottom of the view

Through the API: The instruction page is turned on by setting marketing_page to true in the send_invoice_print block.

This is available for Finnish companies only, and the same request must also include "enabled": true for the print service.

More information: Printing service in Finland.

💡 If the company uses Maventa to send paper invoices via print service, it is recommended to keep this setting active.

The language of the invoice image for received invoices

The admin users can use this setting to define the language for invoice images that are automatically generated by Maventa to replace a missing image attachment.

If a language is not separately specified in the company account settings, the operating country provided during account registration is used as the default language.

This setting is useful in situations where a supplier has sent only invoice xml without a invoice image. The setting applies only to received invoices and is active only when the original invoice image is missing. If the supplier has included their own invoice image, that original pdf file is used, and the image created by Maventa is not generated.

Follow these steps to update the language of the invoice image for received invoices settings:

  1. In the Maventa account, go to: Settings > Company settings > Company details

  2. Select from the drop-down menu under The language of the invoice image generated by Maventa for received invoices;

    1. The desired invoice image language, if this is other than the company account's operating country. Options are: EN, FI, SV, NO, DA, NL
    2. 'Select language', if you wish to keep the default language in the setting, i.e. the company account's operating country
  3. Click the Update button at the bottom of the view

Through the API: This setting cannot be changed through the API. It can only be changed in the Maventa account.

ℹ️ The selected language determines the fixed structural text of the invoice image. It does not affect variable content, such as product names, row descriptions, or free-text fields added by the sender.

User API key and company UUID

The right-hand column of the Company details section displays the admin user’s personal API Key and the Company UUID. These identifiers are used to connect the Maventa account to the accounting software.

Detailed instructions can be found here: User API Key and company UUID.

⚠️ To ensure data security, it is extremely important to note that a full user API key must never be shared with outsiders. Sharing the API key to third parties constitutes a significant security risk

Company billing UUID serves as the customer number in situations where Maventa bills the company directly. This can be found in the transaction report attached to invoices sent by Maventa Oy. Detailed information on Maventa's service billing can be found here: Maventa service billing.

Note that the Company UUID and Company billing UUID are two different identifiers.

Software vendor link

When the Maventa account is used through accounting software, the company account should be linked to the software provider’s vendor API key. Maventa uses this link to identify which software the company uses. The link is needed for correct reporting and support handling, and it is required for webhooks.

A company account registered through the accounting software’s API connection is linked to the software provider automatically. If an existing Maventa account is taken into use with new accounting software, the account must be linked to that software provider separately. If the company stops using the software, the link should be removed.

Through the API: The software vendor link can only be managed through the API. It cannot be changed in the Maventa account. The vendor API key is taken from the API connection’s authentication, so the requests have no other parameters.

More information: Companies and settings.

💡 The link is usually managed by the accounting software provider.
If it is unclear whether the company account is linked to the software in use, confirming this with the software provider is recommended.

Billing information

👉 Open the setting directly in Maventa: Company settings > Billing information. You’ll need to sign in first if you aren’t already.

The admin users of the company account can define and update the billing information for the Maventa service. These settings are used when Maventa bills the company directly for the use of the service. Detailed information on Maventa's service billing can be found here: Maventa service billing.

The billing method is defined by filling in the details according to the desired delivery method. The system follows an automatic order of priority, which determines the channel through which the invoice is sent. The order of priority for the billing method is as follows:

  1. Billing through another company (Consolidated billing)

  2. Maventa account / E-invoice

  3. E-mail

  4. Billing address

If multiple sets of information have been entered, the system always selects the delivery method in the order of this list. If a method lower in the priority order is selected in the settings, the data for methods with higher priority will be automatically cleared. For example, selecting email billing will remove saved e-invoice details.

Instructions for different billing methods

Follow these steps to update the company's billing method or information on the company Maventa account:

  1. In the Maventa account, go to: Settings > Company settings > Billing information

  2. Select the billing method from the Billing information view by clicking the radio button for the desired billing method: Maventa account, E-invoice, E-mail, Billing address, or Billing through another company

  3. Fill in the required fields for the chosen method

  4. Click the Save button at the bottom of the view

Billing method Requirements and effects Through the API
(billing_details block)
Maventa account Invoice receiving must be active on the company's Maventa account.
The address information and method appear automatically. Overrides email and post.		 No separate parameter. Select this method in the Maventa account.
E-invoice Enter the e-invoice address and operator code. Overrides email and post. electronic_invoicing_details.invoicing_eia and electronic_invoicing_details.invoicing_operator.
Both values must be given together, or both left empty.
Email Enter the email address. Will retain postal address information but will clear all other billing information. invoicing_email
Billing address Enter the postal details. Will clear all other billing information. invoicing_street_address1, invoicing_street_address2, invoicing_post_code, invoicing_post_office
Billing through another company
 Select the billing company from the dropdown menu. Consolidated billing is available for Finnish and Swedish companies only. Requires all accounts to be managed by the same admin. Overrides other methods. billing_company_id:
the UUID of the billing company.
A partner company cannot be billed through another company, a company cannot be its own billing company, and a company that is already the billing company for other companies cannot be billed through another company.

 

ℹ️ Through the API, other billing details are not cleared automatically when a new method is set. When changing the billing method through the API, clear the details of the previous method (for example by setting them to null). The order of priority then selects the intended method.

Postal address

The admin users can update the company's postal address through this setting.

👉 Open the setting directly in Maventa: Company settings > Postal address. You’ll need to sign in first if you aren’t already.

Follow these steps to update the company's postal address information on the company Maventa account:

  1. In the Maventa account, go to: Settings > Company settings > Postal address

  2. Fill in the required postal address information in the designated text fields. The mandatory fields are: Street address, Postal code, Post office, City, Country

  3. Click the Save button at the bottom of the view

Through the API: The postal address is updated in the address block with the parameters street_address, post_code, post_office, city and country. The country is given as a two-letter country code, for example FI.

Bank accounts

The admin users of the company account can add or update the company's bank account details through this setting if necessary. Bank account details should only be added to Maventa if the accounting software in use retrieves account number information for the invoice data directly from Maventa.

👉 Open the setting directly in Maventa: Company settings > Bank accounts. You’ll need to sign in first if you aren’t already.

Follow these steps to update or add bank account details to the company's Maventa account:

  1. In the Maventa account, go to: Settings > Company settings > Bank accounts

  2. A new account is added in the Add bank account view. Existing information can be edited in the same view

  3. Complete the following details on the form:

    1. Bank: Name of the bank

    2. Account number: Account number in other format than IBAN

    3. IBAN: Account number in international format

    4. SWIFT: The bank's unique identification code (BIC)

    5. Define the bank account as the default account if necessary by clicking the Default? checkbox active. If the company has multiple bank accounts, this selection determines which account is primarily transmitted to the outgoing invoice data

  4. Click the Add button at the bottom of the view

Through the API: Bank accounts cannot be added or changed through the company settings API. They can only be managed in the Maventa account.

💡 If it is unclear where the accounting software retrieves bank account details from, it is recommended to confirm this with the software provider before entering the information.

Users

👉 Open the setting directly in Maventa: Company settings > Users. You’ll need to sign in first if you aren’t already.

The addition of new users and the management of access rights is always the responsibility of the company account's admin users.

Detailed information and instructions on managing company account users can be found here: User account - Creating and managing users.