Search
Getting Started Invoice sending Invoice sending Consumer Invoicing Printing Email Invoicing Invoice Receiving Invoice Receiving Scanning Detect Fraud reporting Integration tools Webhooks Reference implementations Maventa Connector Embeddable User Interface Peppol Peppol Network Document Exchange Invoice Response Self-billing support Invoicing formats Invoicing formats Validation Peppol BIS 3.0 Preview Maventa JSON (table) Preview Maventa JSON (json schema) Account Management Companies and Settings Users Billing

Detect

Detect is an automated service that verifies incoming invoices and their supplier details. Its checks and notifications help companies automate invoice processing, detect potential fraud attempts, and prevent errors in payments and accounting. The service is integrated into the invoice receiving flow, ensuring that notifications can be shown in the right context.

Detect checks available

VAT check

VAT- For invoices that include value-added tax (VAT), Detect verifies that the sender is registered in the relevant VAT register. If the total VAT amount on the invoice is below 1 EUR/NOK/SEK (depending on currency), the sender will not be checked against the VAT register. The data sources used for these checks depend on the sender’s country:

  1. Norway: Brønnøysundregistrene – https://brreg.no
  2. EU countries: VIES – https://ec.europa.eu/taxation_customs/vies/
  3. Other countries: Not supported

Supplier activation check

SUPPLIER_ACTIVATION- For scanned invoices, check if supplier could have sent the invoice electronically

BID check

SENDER_BID_STATUS - Verifies the sender’s business identifier against central business and bankruptcy registers. This check is available for invoices from Norwegian and Finnish senders and, for Finland, also includes a check against the Prepayment Register.

The check validates that the invoice sender’s business ID is registered and active in the national company register. It also returns information about whether the company is undergoing insolvency or bankruptcy proceedings.

The registers used for this verification depend on the sender’s country:

Warning list check

SENDER_WARNING_LIST - Verifies the invoice sender against registers that list suspected fraudsters and businesses involved in scams or swindles.

Bank account changed

BANK_ACCOUNT_CHANGED - Checks whether the sender has updated their bank account number. Applicable for Peppol and scan invoice routes.

Check descriptions

Check descriptions

Close

How does Detect service work

Detect is integrated into the incoming invoice workflow via the REST API.

-Detect checks are activated by the receiving company. Once activated, all incoming invoices for that company in Maventa are automatically checked. When an invoice becomes available for download, the corresponding check results are also available to retrieve and display.

Integration requirements

Process

  1. Activate Detect PATCH/v1/services/detect/checks
  2. Fetch results GET /v1/invoices/{id}/detect_results
  3. Present results

Contractual requirements

Authentication

For Detect, authenticate as a company and select the authentication scope analysis.

Example flow - activation & usage

Step 1. Service activation

To start using Detect for a company, the user activates the checks they want to use.

The user must first be shown and accept the General Service Disclaimer before activating any checks.

Use the GET/v1/definitions/detect/checks endpoint to retrieve and show all available checks and related information to the user, including which registers are used for each check.

Use PATCH/v1/services/detect/checks to activate checks:

Use GET/v1/services/detect/checks to confirm which checks are activated.

Example check activation in our user interface:

Checks activation

Checks activation

Close

Step 2. Checks are run on incoming invoices

Once activated, all incoming invoices for the company are automatically checked. When checks are completed, the invoice is released to the customer’s inbox and check results are available via the REST API. Invoices and attachments are downloaded as usual. Detect results are retrieved via a separate API call:

Use GET /v1/invoices/{id}/detect_results to fetch results for a specific invoice.

Fetch results

Fetch results

Close

Step 3. Notifications are displayed to the User

After fetching the check results, relevant notifications are shown to the user. If an issue is detected on an invoice, a notification message is displayed within the integrated system (e.g., in invoice listings, booking views, or approval screens).

All possible check results can be viewed via GET /v1/definitions/detect/checks.

Example result visualisation in user interface:

detect check results

detect check results

Close

Step 4. Check / service deactivation

The same method used to activate checks can also be used to deactivate them:

General Disclaimer

Visma does not warrant that the customers use of the check services will be uninterrupted or error-free, or that the service and/or the information obtained by the customer through the Services will meet the customers requirements. The customer acknowledges and agrees that the check services will evolve over time and that functionality may be added and removed from time to time.

The customer assumes sole responsibility for results obtained from the use of the check services and for conclusions drawn from them. Visma shall have no liability for any damage caused by errors or omissions in any information, instructions, warnings or flags provided to the customer in connection with the check services, or the customer’s actions or non-actions in response to such information.

Warning list guide

This section provides information about the warning list check, which can be activated for a company’s incoming invoices as part of the Detect service. This guide can be shared directly with customers or used as a basis for creating user support documentation.

What is a warning list?

A warning list is a register containing alerts about suspected fraudsters and companies involved in scams or business swindles.

How does the warning list check work?

When an invoice is received, the sender’s company information is compared against a set of warning lists. If a match is found, a notification can be issued to the invoice receiver.

The check uses the following information from the sender:

I received a notification that my invoice is from a company on a warning list. What does this mean?

Answer: The invoice sender has been identified in either a third-party register or a Visma user-generated warning list used for the warning list check.

Receiving a warning means that the company name or business ID matches information in at least one of the registers.

In the notification message, the “Source” field indicates the register where the sender was found. If the sender appears on multiple registers, all matching register names are included in the notification.

See the list of registers used and the criteria for listing companies below.

Sources

The warning list check uses a combination of well-known third-party warning lists and user-reported warnings from Visma customers.

  • This set of registers is not exhaustive, and a company not appearing on a list does not guarantee the invoice or sender is legitimate.
  • The information provided by the registers varies; some may include example invoices, descriptions of past fraud attempts, or other details about reported cases.

EUIPO

European Union Intellectual Property Office list contains warnings focused on companies doing trademark and design services scams. Usually name/logo/service appear very similar to a real organisation.

Svenskhandel Varningslistan

Svenskhandel Varningslistan contains warnings for fraudulent invoices, companies with unscrupulous sales practices and of offers or mailings that may be perceived as misleading.

Trygg Handel

Trygg Handel warning list contains warnings against active fraudsters and business scams/swindles.

Visma

Visma users can report an invoice if they suspect sender to be fraudulent. Warning message states how many different invoice receivers have reported the company as suspected fraudster.

How to work with warnings?

It is recommended to have a routine in place for handling the situations where fraud is suspected. This includes for example confirming if the supplier has actually sent the invoice, as well as to dispute the invoice in case the basis for it is not legit. To establish your routine, check the relevant ways of operating in relation to your country and area of business.

Financial supervising authorities

Norway: Finanstilsynet

Finland: FIN-FSA Finanssivalvonta

Sweden: FinansInspektionen

Denmark: Finanstilsynet

Netherlands: Autoriteit Financiële Markten

Central Business Registers

Norway: Brønnøysundregistrene

Finland: YTJ / PRH

Sweden: Bolagsverket

Denmark: CVR - Det Centrale Virksomhedsregister

Netherlands: KVK Chamber of Commerce

Visma warning list criteria

The Visma invoice sender warning list contains a user generated/crowdsourced list of companies suspected by users of the invoice service, or by a business partner of the sender, to be engaged in suspicious or fraudulent activities.

As part of the warning list check Detect uses fraud reports from customers. See more details of fraud reporting and how to integrate to it.

The companies have been listed based on one or several of the following criteria. The overall selection to enter a company to the list is done on a case by case automated and manual evaluation.

If you suspect a company is listed by mistake, please contact Visma through regular Visma support channels, or contact support.maventa@visma.com.

Back to top

AI Chat Support 24/7

  • Get help via AI chat available 24/7 whenever it suits you
  • Chat extensively uses Maventa support pages, websites, and blogs in its answers
  • If you need assistance that the AI cannot provide, you can also ask a customer service agent to join the conversation
  • Support requests processed Monday to Friday
Cancel Open chat

Got feedback?

Did you not find what you were looking for? Or was something explained unclearly? Or just want to share your thoughts? We are happy to hear your feedback!

Note: This form is not a way to get support, this is only for feedback for the documentation website. If you need support, please contact Maventa support.

Integration Guide Services & Reach API Specification Changelogs Integration guide Getting Started Invoice sending Consumer Invoicing Printing Email Invoicing Invoice Receiving Scanning Detect Fraud reporting Webhooks Reference implementations Maventa Connector Embeddable User Interface Peppol Network Document Exchange Invoice Response Self-billing support Invoicing formats Validation Peppol BIS 3.0 Maventa JSON (table) Maventa JSON (json schema) Companies and Settings Users Billing Services and reach Maventa services and reach e-invoicing in Belgium e-invoicing in Denmark e-invoicing in Estonia e-invoicing in Finland Mass Printing Service Amili Kassavirta Amili Perintä Ropo Perintä e-invoicing in Germany e-invoicing in Italy e-invoicing in the Netherlands e-invoicing in Norway e-invoicing in Poland e-invoicing in Sweden Api specification API overview Getting Started Common & authentication API Invoices API Documents API Companies & settings API Lookups API Detect API Validator API Receivables API Billing API Scanning API B2CFI API B2CNO API B2CSE API Partner API Getting Started API Methods Overview Account Configuration API Methods Invoice Sending API Methods Invoice Receiving API Methods B2C Norway API Methods B2C Finland API Methods Other API Methods Changelogs Product changelog Developer Changelog
Clear Send

Enter your credentials to Maventa testing environment, to authenticate and try things out with the Swagger UI. This will fetch a Bearer token using OAuth2 with the endpoint POST https://ax-stage.maventa.com/oauth2/token. The token is stored in your browser's session storage (cleared when you close the tab) and used in Swagger calls done from this documentation website. The token is valid for 1 hour.

Never use your production credentials here. This is only for testing the Maventa test environment in the Swagger UI.
All None
eui global company lookup document:receive document:send invoice:receive invoice:send company:read company:write validate receivables:assignments analysis billing:reports partner:invoice_delivery_actions partner:lookups partner:takeovers partner:lyanthe_scan_service fi_bank_message:send fi_bank_message:receive
Cancel Sign In