Invoice export to Fennoa

Last updated: 16 March 2026

In this article

You can export customer information and invoices from Opter to the Fennoa accounting system. The integration creates and updates customer records and generates invoices in Fennoa.

Conditions

User account with Fennoa

In order to export invoices, you must have an API user account with Fennoa, as well as a client user ID and a client key. Please contact Fennoa or your Fennoa supplier if you need help obtaining this information.

Mandatory information in OPTER

To be able to export from Opter to Fennoa, the following information must be available in Opter for all customers whose invoices are exported to Fennoa:

  • The customer's Corporate ID number in the General tab of the customer registry.

  • The customer's invoice address on the Invoice information tab in the Information box in the customer registry.

  • If the invoices are to be sent as e-invoices in Finvoice format (with "DeliveryMethod=finvoice"): The customer's OVT number and EDI code must be in the Details tab of the customer registry.

  • If the invoices are to be sent as PDF attachments by email (with "DeliveryMethod=email"): The customer's email address (to which invoices are to be sent) must be entered in the Email invoice export field on the Invoice information tab in the Invoice information box in the customer registry.

Invoice number series

To use the export, an invoice number series in Fennoa that matches the series in Opter has to be created. (If this is not done, Fennoa will assign exported invoices the first available number from the first available invoice number series).

Step 1: Create an invoice export in Opter

Click Economy > Invoices > Invoice export and create a new invoice export by clicking New.

The following fields must be filled in on the General tab:

  • Name: For example “Fennoa API”.

  • Type: Fennoa API.

  • Encoding: UTF-8.

  • User id: Enter the client user ID provided by Fennoa.

  • Password: Enter the client key provided by Fennoa.

  • Start text: ExportInvoice=true.

The File transfer and Codes tabs are not relevant for this export, so do not change anything on these tabs.

Optional settings

In the Start text field, you can configure settings that affect the information exported to Fennoa. The economic units in Fennoa are also mapped to economic units in Opter here.

You must set “ExportInvoice=true” for the export to work at all.

Enter each setting on a separate line, as shown in the example below.

PlainText
ExportInvoice=true
ApproveInvoice=false
SendInvoice=false
FennoaCustomerNo=cusNo
DeliveryMethod=finvoice
Eu1-DimensionTypeId=2
Eu2-DimensionTypeId=1

The default value is the one that applies if you do not specify a value for the setting.

Setting

Description

ApproveInvoice=true/false

Set ApproveInvoice to "false" initially, to transfer the invoices to Fennoa as drafts. They can then be reviewed and edited and, if necessary, even removed from Fennoa (or approved manually).

This is important to ensure that, for example, the customer master data is correct and that the invoice is assigned the same invoice number as in Opter before it is finalised in Fennoa.

If ApproveInvoice is set to “true”, the invoice is approved in Fennoa during export and cannot subsequently be deleted from Fennoa.

ApproveInvoice can be set to "true" or "false" as follows:

  • true: the invoice created in Fennoa is automatically approved immediately upon export.

  • false (default): the invoice must be manually approved in Fennoa.

DeliveryMethod=

postal/manual/email/finvoice/consumerfinvoice/consumerdirect

DeliveryMethod is used to configure how invoices are sent if they are sent from Fennoa. This setting overrides any automatic distribution method settings determined based on data in Fennoa.

The following options are available:

  • postal: The invoice is printed and can be sent by post.

  • manual (standard): The invoice is not sent automatically.

  • email: The invoice is sent in a PDF file attached to an email.

    All Opter customers invoiced with this integration must have a valid email address in the Email invoice export field of the customer registry. If they do not, the delivery method will be “postal”.

  • finvoice: The invoice is sent as an e-invoice in Finvoice format.

    All Opter customers invoiced with this integration must have OVT number and EDI code in the customer registry. If they do not, the delivery method will be “postal”.

  • consumerfinvoice: The invoice is sent as an e-invoice in Finvoice format directly to the recipient's bank or payment service.

  • consumerdirect: The invoice is sent as an e-invoice in Finvoice format to the supplier, and at the same time an invoice in another format is sent to the payer. This method is used if the payer cannot receive e-invoices in their bank or payment service.

Eu1-DimensionTypeId=<economic unit’s ID in Fennoa>

Eu2-DimensionTypeId=<economic unit’s ID in Fennoa>

Eu3-DimensionTypeId=<economic unit’s ID in Fennoa>

Eu4-DimensionTypeId=<economic unit’s ID in Fennoa>

Eu5-DimensionTypeId=<economic unit’s ID in Fennoa>

If you use cost centres, map cost centres 1–5 in Opter to economic units in Fennoa.

In Opter, you can view your economic units on the Economy tab in the office settings.

If you do not use cost centres, this setting should be omitted.

ExportInvoice=true/false

ExportInvoice must be set to “true” for the export to work.

  • true: customer information is transferred and the invoice is created in Fennoa.

  • false (default): The invoice is not created in Fennoa.

FennoaCustomerNo=cusNo/cusCode/orgNo

You can choose which field in the customer registry in Opter (on the tab General) will be used as the customer number in Fennoa.

  • cusNo (default, recommended): Sales ledger number

  • cusCode: Customer code

  • orgNo: Corporate ID number

Example: ”FennoaCustomerNo=cusNo”

SendInvoice=true/false

Set SendInvoice to "false" initially if you first want to check that the invoice export set-up works properly. Next, set SendInvoice to "true" if invoices are to be sent out automatically.

Specify whether invoices should be sent automatically from Fennoa after they have been exported from Opter.

  • true: The invoice is sent out automatically by Fennoa.

    "ApproveInvoice=true" must have been entered for the invoice to be sent automatically.

    With the setting “SendInvoice=true”, invoices are sent in accordance with the settings in Fennoa, unless you have selected a delivery method using the DeliveryMethod setting here in Start text (see above).

  • false (default): The invoice is not sent out.

Step 2: Add the invoice export in the invoice export settings

Click on Economy > Invoices > Invoice export settings and select “Fennoa” (or the name you gave the invoice export) for the groups that should be able to generate an export to Fennoa.

Click on Save to save all changes.

Step 3: Export to Fennoa

The invoice information can be exported from Opter when closing an invoice period, or subsequently when choosing whether to export entire invoice periods or individual invoices. Customer information and account coding are exported to Fennoa as specified in the transform.

How to export invoices retrospectively:

  1. Click on Economy > Invoices > Invoices.

  2. Right-click on an invoice period or individual invoice and select Export.

  3. Click on Export and send.

The number of invoices to be exported and the number of invoices exported are displayed, as well as a progress bar.

Troubleshooting

If the transfer to Fennoa does not work, a message is displayed (in English) in the invoice export log. The message is generated by Fennoa, not Opter. Any errors are usually due to one of the following:

  • The customer’s Corporate ID number is incorrect or missing in Opter, on the General tab in the customer registry.

  • The customer’s invoice address is incorrect or missing in Opter, on the Invoice information tab in the Information box in the customer registry.

  • The customer’s OVT number or EDI code are incorrect or missing in Opter, on the Details tab in the customer registry. If "DeliveryMethod=finvoice" has been selected, OVT number and EDI code are mandatory fields in Opter for all customers invoiced with this integration.

  • The customer's email address (to which invoices are to be sent) is incorrect or missing in Opter, in the Email invoice export field on the Invoice information tab in the customer registry. If "DeliveryMethod=email" has been selected, Email invoice export is a mandatory field in Opter for all customers invoiced with this integration.

  • The Fennoa web service is currently down.

See also