Skip to content

Scope the Finland docs to the domestic network and open them to suppliers anywhere - #582

Merged
rilla merged 2 commits into
mainfrom
nordic-senders
Sep 23, 2026
Merged

rilla merged 2 commits into
mainfrom
nordic-senders

Conversation

@rilla

@rilla rilla commented Sep 2, 2026 •

Copy link
Copy Markdown
Contributor

Context

Finland consolidation picks up the follow-up work carried over after Finvoice went live.

Two things were wrong on the Finland pages. They said the app covers both of Finland's e-invoicing networks and that you should use it for every Finnish receiver — it delivers on the domestic operator network, and Peppol routing is the Peppol app's job. And they assumed every supplier is Finnish, which gov-fi#20 changes: a company established anywhere can now register and invoice Finnish receivers through the same operator, workflows and formats. Those parties can send but not receive — a Finnish e-invoice address belongs to a Finnish Business ID, so a company established elsewhere is never listed in the national registry and nothing reaches it over the domestic network. They receive through Peppol instead.

This should merge once the app change ships.

Changes

  • Scopes the Finland pages to the domestic operator network — the app page's description, intro, feature bullet and Limitations delivery row; the issuing guide's introduction; and the compliance FAQ, which answered "no" to whether you have to choose between the domestic network and Peppol and now answers yes. Left standing: that Finland runs two networks and that verkkolaskuosoite.fi lists both, which is what tells a reader which app they need.
  • Adds a "Suppliers outside Finland" section to the supplier registration guide — that any country can register, what the operator files the party under, that registration is send-only and why, and where to register for receiving instead.
  • Notes the foreign supplier on the Finland app page, under the supplier document description.
  • Qualifies the Finland-only statements the new case breaks — the Business ID prerequisite, the reception-workflow prerequisite, the completion text that promised an allocated address and polling for every party, the rule to always use an OVT address on party records, and the "Register party in Finland" action card.
  • Limits reception to Finnish parties in the receiving guide and its FAQ. Both said every registered party's inbox is polled. They now say reception covers Finnish parties, and point parties from elsewhere to the Peppol app.
  • Corrects two Finland claims outside the app pages. The Finland timeline listed the domestic network as roadmap, and now shows it covered by the Finland app. The Europe overview grouped Finland with the Peppol-first countries. It now says Peppol serves public bodies and most businesses receive on the domestic network.
  • Updates the registration workflow's description to cover parties from any country, in step with the console template, and asks a foreign supplier for its own address, not a Finnish one.
  • Rewrites the new text in plainer words, following Luis's review. Sentences are shorter and the facts are unchanged.

Verification

Done:

  • Read back against the shipped behaviour in gov-fi#20: what a foreign party is filed under, and what it can and cannot do once registered.
  • Mintlify deployment and link-rot checks pass.

Left:

  • Preview the Finland app page, the three guides, the Finland timeline and the Europe overview, checking the #suppliers-outside-finland anchor resolves from the prerequisites bullet and the app page.

Related

  • The app change: gov-fi#20
  • The registration template's description is rewritten to match console#319. The Finland templates are .mdx, which the console sync doesn't pick up, so the docs copy is kept in step by hand.

@mintlify

mintlify Bot commented Sep 2, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
invopop 🟢 Ready View Preview Sep 23, 2026, 4:28 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@rilla rilla changed the title Document Nordic and Estonian suppliers sending into Finland Document suppliers outside Finland sending into Finland Sep 17, 2026
@rilla rilla changed the title Document suppliers outside Finland sending into Finland Scope the Finland docs to the domestic network and open them to suppliers anywhere Sep 17, 2026
@rilla
rilla requested a review from lucoma September 22, 2026 10:30
@rilla
rilla marked this pull request as ready for review September 22, 2026 10:32
@rilla
rilla requested a balanced review from Copilot September 22, 2026 10:32

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Several existing instructions still contradict the new network scope and foreign-supplier limitations.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 5 Low severity

Open (5)
What changed in this PR

Scopes Finland documentation to the domestic operator network while documenting send-only registration for foreign suppliers.

Changes:

  • Directs Peppol deliveries to the Peppol app.
  • Adds foreign-supplier registration guidance.
  • Qualifies registration, reception, and addressing behavior.
File Description
apps/​finland.mdx Updates Finland app scope and supplier behavior.
guides/​fi-finvoice.mdx Clarifies domestic versus Peppol routing.
guides/​fi-finvoice-supplier.mdx Documents foreign send-only suppliers.
snippets/​faqs/​fi/​leaves/​finvoice/​compliance.mdx Corrects network-selection guidance.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread apps/finland.mdx Outdated
Comment thread apps/finland.mdx Outdated
Comment thread guides/fi-finvoice-supplier.mdx Outdated
Comment thread guides/fi-finvoice.mdx Outdated
Comment thread snippets/faqs/fi/leaves/finvoice/compliance.mdx Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Several rendered pages still contradict the new network scope and send-only behavior for foreign suppliers.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 4 Low severity

Open (4)
Resolved since last review (5)

Comment thread apps/finland.mdx
Comment thread apps/finland.mdx Outdated
Comment thread guides/fi-finvoice-supplier.mdx Outdated
Comment thread snippets/faqs/fi/leaves/finvoice/compliance.mdx Outdated

@lucoma lucoma left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me for a 1st pass, maybe the AI agent can polish a bit more the text here so it looks less AI generated

https://invopop-nordic-senders.mintlify.site/guides/fi-finvoice-supplier#suppliers-outside-finland

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Several registration passages still imply that send-only foreign suppliers receive an address or await reception readiness.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 2 Low severity

Open (2)
Resolved since last review (4)

Comment thread guides/fi-finvoice-supplier.mdx Outdated
Comment thread snippets/faqs/fi/leaves/finvoice/supplier.mdx Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The supplier FAQ still implies OVT addresses apply to generated invoices for foreign suppliers.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
Resolved since last review (2)

Comment thread snippets/faqs/fi/leaves/finvoice/supplier.mdx Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The documentation consistently reflects domestic-network scope and foreign suppliers’ send-only behavior.

Review effort: Balanced
Findings: None

Resolved since last review (1)

@rilla
rilla merged commit ab4a1eb into main Sep 23, 2026
3 checks passed
@rilla
rilla deleted the nordic-senders branch September 23, 2026 16:47

This branch was successfully deployed

1 active deployment
staging — 1d8c6492 Deployed Sep 23, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants