Skip to content

Document the Finnish e-invoice address as a party endpoint - #610

Open
rilla wants to merge 1 commit into
mainfrom
fi-party-endpoints
Open

rilla wants to merge 1 commit into
mainfrom
fi-party-endpoints

Conversation

@rilla

@rilla rilla commented Sep 23, 2026

Copy link
Copy Markdown
Contributor

Context

The Finland app now records a registered Finnish party's e-invoice address on the party itself, as an ISO 6523 endpoint (iso6523-actorid-upis::0216:<OVT>). GOBL has deprecated inboxes in favour of endpoints, and the Denmark pages already document endpoints. The Finland pages still tell integrators to set the address as a 0216 inbox, and suggest they have to add it themselves.

Changes

  • Shows endpoints in the Finnish examples. The party snippets and the three invoice inputs use an endpoint in place of the 0216 inbox, and the built invoices drop the inbox they listed next to the endpoint. The inputs rebuild to the committed output.
  • Says registration adds the endpoint. The supplier guide, the app page and the FAQ tell readers they can leave the address out when uploading a Finnish party, and read it from the party entry once registered.
  • Keeps one line on the inbox form. The supplier guide notes that a party with a 0216 inbox still sends as before.
  • Asks for an endpoint in the issuing guide. The receiver prerequisite and the supplier-address-missing fix name an endpoint, with a 0007 example for suppliers outside Finland.

Next

  • Merge once the Finland app release that writes the endpoint is live.

@mintlify

mintlify Bot commented Sep 23, 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, 5:15 PM

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

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 endpoint migration and generated examples are consistent; the remaining wording correction is minor, while merging remains gated on the app release.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Updates Finnish e-invoicing documentation to use GOBL party endpoints instead of deprecated inboxes.

Changes:

  • Migrates Finnish party and invoice examples to ISO 6523 endpoints.
  • Documents automatic endpoint creation during registration.
  • Updates issuing guidance and troubleshooting examples.
File Description
snippets/​parties/​fi/​supplier.mdx Uses an endpoint for the supplier’s OVT address.
snippets/​parties/​fi/​customer.mdx Uses an endpoint for the customer’s OVT address.
snippets/​invoices/​fi/​credit-note.min.mdx Migrates credit-note input parties to endpoints.
snippets/​invoices/​fi/​credit-note.mdx Refreshes the built credit-note output.
snippets/​invoices/​fi/​b2g-invoice.min.mdx Migrates B2G invoice input parties to endpoints.
snippets/​invoices/​fi/​b2g-invoice.mdx Refreshes the built B2G invoice output.
snippets/​invoices/​fi/​b2b-invoice.min.mdx Migrates B2B invoice input parties to endpoints.
snippets/​invoices/​fi/​b2b-invoice.mdx Refreshes the built B2B invoice output.
snippets/​invoices/​fi/​accordion.mdx Explains the endpoint format in invoice examples.
snippets/​faqs/​fi/​leaves/​finvoice/​supplier.mdx Updates Finnish address guidance.
guides/​fi-finvoice.mdx Updates prerequisites and troubleshooting.
guides/​fi-finvoice-supplier.mdx Documents registration-created endpoints.
apps/​finland.mdx Updates the Finland app’s supplier example.

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

Comment thread guides/fi-finvoice.mdx
Three checks run before anything leaves the platform, each failing the job with its own code:

- **`supplier-address-missing`**: the supplier has no electronic address. Add one as an inbox on the supplier party. For a Finnish supplier, that is its OVT code under scheme `0216`. A supplier outside Finland uses its own identifier and scheme, such as a Swedish company's Org.nr under scheme `0007`.
- **`supplier-address-missing`**: the supplier has no electronic address. Add one as an endpoint on the supplier party. For a Finnish supplier, that is the endpoint registration records on its party entry: `iso6523-actorid-upis::0216:` followed by its OVT code. A supplier outside Finland uses its own identifier and scheme, such as `iso6523-actorid-upis::0007:` followed by a Swedish company's Org.nr.

This branch was successfully deployed

1 active deployment
staging — ee90c5d9 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.

2 participants