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
Search
Getting started Invoice sending Invoice sending Consumer Invoicing Printing Email Invoicing Invoice Receiving Invoice Receiving Scanning Country Specific Denmark Finland Germany Norway Sweden Document Exchange Document Exchange Peppol Network Invoicing formats Invoicing formats Validation Peppol BIS 3.0 Finvoice 3.0 Account Management Companies and Settings Billing

Scanning

When e-invoicing isn’t an option, scanning solutions can help automate invoice delivery and processing.

With Maventa’s scanning solutions, you can easily receive all invoices through a single pipeline. Additionally, you can enable extra features such as Detect, fraud checks, and reports identifying suppliers who could send e-invoices.

For data interpretation, Maventa works with several third-party service providers. Currently, we offer the following solutions:

Available solutions may vary depending on your company’s country. Note: Regardless of the solution used, it is essential that the recipient always verifies the accuracy of scanned invoices.

Process flow of scan network and AutoScan

  1. The recipient company enables invoice receiving.
  2. The recipient company activates the desired scanning service.
  3. Once the service is activated, the recipient company will be provided with a dedicated scan
    email address. A scan postal address will only be provided for the Scan Network and in certain countries.
  4. The supplier sends invoices to the scanning service either via e-mail or post.
  5. The scan service receives the invoices, processes them, and then delivers the interpreted invoice file along with the original or flattened PDF to Maventa.
  6. Maventa delivers the file to the recipient’s Maventa account.

Expected fields in scan network and Autoscan processed invoices

Invoice Field Scan Network AutoScan
Invoice Number
Invoice Date
Invoice Due Date
Document Type ✔ Support for Invoice, Receipt, Credit Note and Debit Note
Currency ✔ Three-letter currency code
Supplier Organisation Number ✔ NO: Organisation number (for foreign suppliers VAT number is used in the OrgNumber field)
SE: Organisation number
NL: KvK number
DK: CVR number
FI: Organisation number (y-tunnus)
✔ NO/SE: Organisation number, DK: CVR, NL: KvK
Supplier VAT Number
Supplier Name ✔ Searched from a list by organisation number. Not first time when invoice is passed, second time automatic. If name of the company can’t be found by search, organisation number will be shown as the name. If organisation number cannot be interpreted invoice will be passed with UNKNOWN_VENDOR as the supplier name. ✔ Searched from known supplier list
Supplier Address ✔ Available for NL/BE only ✘ Not available
Supplier Country Code ✔ Available for NL/BE only ✔ Two-letter country code
Buyer Organisation Number ✔ Interpreted by the scan network or extracted from the scan email address ✔ Recipient organization number is determined from email routing
Gross Amount (Incl. VAT)
Net Amount (Excl. VAT) ✔ Calculated: Gross amount - VAT amount
Total VAT Amount
VAT Percentage ✔ Calculated from Gross amount and VAT amount, and delivered without decimals. If there are products with different VAT percents on the invoice, the calculated VAT percent will be somewhere between the actual VAT percents. If there is a rounding amount on the invoice, it is not taken into account when calculating the VAT percent. (for NL/BE VAT percentage is provided by scan network) ✔ Scanned or calculated when there is no detailed VAT information
VAT Distribution ✔ Available for NL/BE
IBAN or Account Number ✔ NO: Account number, for foreign suppliers IBAN number is used in the AccountNumber field
SE: BankGiro and PostGiro, for foreign suppliers IBAN number is used in the AccountNumber field
DK: FIK, FI: IBAN or Account number, NL/BE: IBAN
✔ Formats vary by country (SE: BankGiro, PlusGiro DK: FIK, etc.)
Payment Reference ✔ NO: KID, SE: OCR, DK: FIK code, FI: Viitenumero, NL/BE:-
Reference Name/Number ✔ DK: Their reference and order number
FI: Text in “Viitteenne” field
SE: Reference name/number
NO, NL, BE: -
✘ Not available
PO Number ✔ Available for NL/BE only ✘ Not available

How scan network works

The scan network receives invoices either as PDF (by email) or as paper invoices, which are scanned into PDF. An Optical Character Recognition (OCR) system is used to interpret keywords from the invoices.

After the OCR interpretation and validation, all invoices are checked in an extra quality control. If the program finds any deviation, the invoices will be manually checked one more time.

The interpreted invoice file, along with the original or flattened PDF invoice, is delivered to recipient’s Maventa account, from where the recipient’s ERP can fetch them.

It is important that the recipient always checks the accuracy of scanned invoices.

Opening the scan network

The scan account can be opened over the API or through the UI invoice receiving page.

SOAP API: scan_account_order

REST API: POST/v1/services/scan

Before opening the scan account for a company, make sure company has the receiving setting turned on. Company must complete the customer authentication process to enable the receiving of invoices. Scanned invoices from the scanning service are delivered to the Maventa customer like any other incoming e-invoice and for this reason the invoice receiving must be on to enable scanning.

When opening the scanning service, the customer needs to provide a return e-mail address where all other material than invoices are delivered by the scanning service. The return email address is available in Finland, Sweden, Norway and Denmark, but not in the Netherlands or Belgium.

Updating the scan network

The scan account can be updated over the API or through the UI invoice receiving page.

SOAP API: scan_account_order

REST API: PUT/v1/services/scan

How suppliers can send invoices to scan service

Company informs their suppliers about their scan address they have received when service is activated. Scan address contains the company’s scan ID number that is used to identify the recipient.

There are two ways suppliers can send invoices to the scanning service to be scanned; by e-mail or by post.

By E-mail

Finland, Sweden, Norway, Denmark, Netherlands and Belgium

Requirements for sending

By Post

Finland

Scan service identifies the recipient using following information found from the invoice image if invoice is sent by post:

Sweden

Scan service identifies the recipient using the FeAddress (Postal scan address) and company name on the envelope

Scan ID and Scan addresses

Country Scan ID Email scan address Postal scan address
Finland Company business ID invoice-BID@kollektor.fi e-mail address without “-“ in business identity code (e.g. invoice-12345678@kollektor.fi) Company name, Scan ID, PL 100, 80020 Kollektor
Sweden Company business ID BID@autoinvoice.se Company name, AISEXXXX Scancloud, SE-831 90 ÖSTERSUND, Sweden (XXXX = customer number assigned to the company)
Norway Company business ID BID@autoinvoice.no -
Denmark CVR number CVRnumber@autoinvoice.dk -
Netherlands VAT number or KvK number KvKnumber@autoinvoice.nl or VATnumber@autoinvoice.nl Depending which one was used when the company was registered to Maventa -
Belgium Company business ID BE-ENnumber@scan.maventa.com -

Delivery of materials

Scan service delivers only invoices and credit notes electronically. When a customer opens the scan service they need to specify a scan return address that is used to deliver none invoice materials. Marketing materials are not delivered.

Delivered as e-invoices:

Delivered via e-mail:

Delivered via post:

Thrown away:

See your used price list for the relevant delivery prices.

Error handling

End users can report interpretation errors by email to support@maventa.com. Support contacts the validation teams at scan service provider to use auto learning process, where interpretation is manually changed so that invoices are correctly interpreted the next time.

If there are problems on the invoice, users can also request rescanning.

Closing the scan network

The service can be closed (disabling the scanning service) either by calling the API or through the invoice receiving page in the UI.

SOAP API: scan_account_disable

REST API: DELETE/v1/services/scan

For customers in FI, NO, SE, and DK, when a scan account is disabled, it enters a 60-day grace period. During this time:

After the 60-day grace period:

It is the company’s responsibility to inform their suppliers about alternative methods for sending invoices moving forward when closing their scan account.

For customers in NL and BE, there is no grace period or return email functionality.

AutoScan

AutoScan is a fully automated solution for receiving PDF invoices. Powered by machine learning technology, it interprets invoice data without manual verification or quality control. Compare to our scan networks, AutoScan is ideal for customers who prioritize quick delivery, place less emphasis on data verification and completeness, and are looking for a cost-effective scan solution.

AutoScan is currently available in our main market countries including Norway, Sweden, Demmark and the Netherlands. However, it is not yet available in Finland at the momemnt. Finnish companies interested in this feature can contact Maventa support for further information.

Opening AutoScan

AutosSan can be opened via REST api method: PUT /v1/services/autoscan or the user interface.

Request Example:

{}

Response Example:

{
  "status": "active",
  "scan_email_address": "NO-987654321@autoscan.maventa.com",
  "features": {}
}

Once AutoScan is successfully opened, the customer will be provided with an AutoScan email address.

Format: countrycode-bid@autoscan.maventa.com Example: NO-987654321@autoscan.maventa.com

Updating AutoScan

You can update an existing AutoScan account using the same REST API method: PUT /v1/services/autoscan or via the user interface.

Closing the AutoScan

To disable AutoScan, use the following API method: DELETE /v1/services/autoscan or via the user interface.

To ensure successful delivery, supplier should make sure:

If processing fails, an error email is sent to the email sender. Non-PDF emails and emails containing viruses are automatically discarded.

AutoScan Invoice line scaning

AutoScan also provides a feature to interprete the invoice line level data such as: Item number, Product code, Unit, Unit price, VAT etc. This feature is currently in pilot mode. Integrators interested in enabling invoice line scanning can reach out to Maventa Support for more details.

Visma Scanner and DocScan

Maventa has integration to Visma Scanner and DocScan scan applications. Visma Scanner is a mobile application for scanning and DocScan is a web application (Visma Home). Both applications can be used to forward invoices and vouchers and to get data interpreted from them into an accounting system.

Scanning is based on machines only, which means both products use machine learning based technology (SmartScan) for interpreting the data. Benefits of using Visma Scanner and DocScan are easy and quick usage combined with lower cost.

Visma Scanner and DocScan can be integrated directly to ERPs or accounting systems or the integration can work through Maventa.

What is needed for enabling Visma Scanner or DocScan integration

Receiver company needs to have Maventa account and receiving activated. Sender needs to have Visma Scanner mobile app or use DocScan web app (from Visma Home).

Back to top