Finland Invoices (Peppol BIS 3.0 via Storecove) MCP server

Send a Finland B2B/B2G electronic invoice (verkkolasku) over the Peppol network in Peppol BIS 3.0 / EN 16931 format via Storecove (a certified Peppol Access Point). Finland mandates structured e-invoicing for public-sector suppliers (B2G) since 2020-04-01, and a business has the right to require an e-invoice from another business (turnover over EUR 10,000) under the Act on Electronic Invoicing (241/2019) — not a blanket B2B mandate, but Peppol/Finvoice is the Finnish rail. Builds the structured invoice JSON from seller + buyer (name, Finnish VAT FIxxxxxxxx and/or Y-tunnus business ID, address) and line items (description, quantity, net unit price, VAT rate 25.5/14/10/0), computes the Finnish VAT (ALV) breakdown, and submits it under YOUR OWN Storecove credentials. Bring your own credential as header x-storecove-key. You must also pass seller_legal_entity_id — the legalEntityId of the sender you created in your Storecove account. Finnish VAT rates: 25.5 (standard, decimal, since 2024-09-01), 14 (food/restaurant), 10 (books/pharmaceuticals/passenger transport), 0 (zero-rated/exempt/reverse charge). Amounts in EUR. Delivery over Peppol is asynchronous: this returns a submission guid — use get_delivery_evidence with it to fetch the delivery proof/status. Tip: call check_recipient first to confirm the buyer is reachable on Peppol. There is no cancel over Peppol: to reverse an invoice you issue a credit note (a new invoice).

Check whether a business can receive electronic invoices on the Peppol network before you send (Storecove POST /discovery/receives). This is the safe pre-flight for Finnish B2B/B2G: pass the recipient identifier and scheme and learn if they are a registered Peppol participant. For Finland use scheme 0037 with the Y-tunnus business ID (OVT), or 0213 with the VAT number FIxxxxxxxx. Returns can_receive=true when the party is reachable (Storecove code OK). If can_receive is false, the recipient is not on Peppol — fall back to recipient_email in create_invoice or ask them to register.

Fetch the delivery evidence for an invoice sent by create_invoice, using its submission guid (Storecove GET /document_submissions/{guid}/evidence). Peppol delivery is asynchronous — this returns the proof of what was sent and the delivery status/receipt from the recipient Access Point. Call it shortly after create_invoice and poll until it reports delivery. Safe to call anytime.