Skip to main content

​
Introduction

Invoices sent to a registered party’s e-invoice address land in that party’s own inbox at the operator the Finland app works through. The operator has no push channel, so the app polls each registered party’s inbox on a schedule, every five minutes by default. Received invoices appear within minutes, not instantly; when testing, allow up to a quarter of an hour before suspecting a problem. Each received document becomes exactly one silo entry carrying the GOBL invoice, the original XML, and a PDF rendering, and your import workflow runs on it, so received invoices show up like any other workflow-processed document. Registering the parties themselves is covered in the companion guide: Finvoice supplier registration.

​
Prerequisites

  • The Finland app connected: navigate to Configuration → Apps, find Finland, and click Connect.
  • A party ready to register: reception is per party, so the setup below has to be in place before you register it. Registration checks the reception configuration and starts polling as soon as it completes.

​
Setup

1

Create the sync workflow

This workflow is pure plumbing: the polling schedule fires it for each registered party, and its one step checks the party’s inbox and queues one import job per new document.
2

Create the import workflow

The import step downloads one received document and files it as a silo entry; everything after it is yours to shape: routing to a folder, setting a state, or any other processing your operation needs.
3

Configure the app with both workflows

Navigate to Configuration → Apps, find the Finland app, tap Configure, and select the sync workflow and the import workflow you just created. Registration checks this configuration, so save it before registering any party.
4

Register the party

Run the registration workflow on the party as described in the supplier registration guide. Registration checks the reception configuration first and fails with “reception not configured” if the workflows aren’t set; polling starts automatically once it completes.

​
Receiving invoices

From then on, reception is automatic. Every few minutes the app checks each registered party’s inbox, and each new document becomes one silo entry processed by your import workflow, filed under Expenses in the example above. A few behaviours worth knowing:
  • The registry catches up overnight. A registered party can receive immediately, but the national registry senders look addresses up in is refreshed once a night. A counterparty who can’t find the address on the day you registered will normally find it the next day.
  • Duplicates collapse. The operator can occasionally deliver the same document twice; the app keys every entry by the document’s own identity, so a repeated delivery updates the existing entry instead of creating a second one.
  • Errors stay visible. A document that fails to import leaves a failed job behind, and the rescue steps of your import workflow run so you can see what went wrong and act on it.
  • Retention at the operator is limited. Received documents stay downloadable at the operator for three calendar months; the silo entry and its attachments are yours permanently.

​
FAQ

Reception is polled, not pushed: each registered party’s inbox at the operator is swept on a schedule, every five minutes by default. Add the time the sender’s own operator takes to deliver, and an invoice normally appears within minutes, but not instantly. If you’re testing, allow up to a quarter of an hour before suspecting a problem.
Each received document becomes one entry in your workspace carrying the GOBL invoice, the original XML as received from the network, and a PDF rendering, whatever format the sender issued.
Two things: the Finland app must be configured with a sync workflow and an import workflow, and the party must be registered. Registration checks the workflow configuration first, so set the workflows up before running it. Once registered, polling starts automatically; received invoices simply appear as new entries processed by your import workflow.
More available in our Finland FAQ section

Participate in our community

Ask and answer questions about invoicing in Finland →