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
Get started Integration Guide Services and Networks API Specification Tutorials Changelogs
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

Finland

Read more about e-invoicing in Finland from our Regional spotlights: Finland.

Finnish company account registration

When registering a new Finnish company via the API, the VAT number or organisation number (y-tunnus) must be used as the company identifier. Visma Sign supports Danish customer authentication using either HETU, Finnish banks and mobile identifier

Sending in Finland

Supported delivery channels in Finland

Currently, we support sending through Finnish operator network, Finnish bank network, Peppol, or Maventa’s internal network. Email and print are also available as fallback delivery options. For consumers

Finnish operator network and bank network

Receiving in Finland

e-invoicing formats used in Finland

Finvoice

The following example PDF is generated when invoice is sent in Finnish market, and the XML is in Finvoice 3.0 format. FIX_EXAMPLE_PENDING Download as PDF

The following example PDF is generated when invoice is sent in other markets, and the XML is in Finvoice 3.0 format. FIX_EXAMPLE_PENDING Download as PDF

Example Finvoice 3.0 XML of above visualisations: FIX_EXAMPLE_PENDING

Finnish market example has <SpecificationDetails> -element given (<SpecificationFreeText> tags). That element has different font and styling. The font is Courier (all the characters are equally wide). The purpose of using this font type in this case is to keep the formatted text as it is given in the XML.

Example usage of <SpecificationDetails> -element and how it would look like in the PDF

<SpecificationDetails>
  <SpecificationFreeText>LASKUN VAPAAMUOTOISET ERITTELYTIEDOT:</SpecificationFreeText>
  <SpecificationFreeText>Sarake-1              Sarake-2                                                             Sarake-3</SpecificationFreeText>
  <SpecificationFreeText>---------------------------------------------------------------------------------------------------</SpecificationFreeText>
  <SpecificationFreeText>1.sarakkeen tieto     2.sarakkeen tieto                                                       10,00</SpecificationFreeText>
  <SpecificationFreeText>Toinen rivi           Toinen rivi                                                          1 000,00</SpecificationFreeText>
  <SpecificationFreeText>Kolmas rivi           3/2                                                                      1,00</SpecificationFreeText>
  <SpecificationFreeText>Muotoituja tietoja voidaan käyttää mm.tarkemman erittelyn esittämiseen:</SpecificationFreeText>
</SpecificationDetails>

FIX_IMAGE_PENDING

TEAPPSXML

The following example PDF is generated when invoice is sent in Finnish market, and the XML is in TEAPPSXML 3.0 format. FIX_EXAMPLE_PENDING Download as PDF

The following example PDF is generated when invoice is sent in other markets, and the XML is in TEAPPSXML 3.0 format. FIX_EXAMPLE_PENDING Download as PDF

FIX_EXAMPLE_PENDING

Back to top