Norway Invoice

by junter1989k-ai

259 downloads
Not rated
GitHub Website

About

Send Norwegian EHF/Peppol e-invoices (2027 mandate) via your Storecove account — check recipient, send, delivery evidence

Details

Author
junter1989k-ai
Downloads
259
Categories
AI

- 100 + 50 both @25% → taxable 150.00 / vat 37.50 / total 187.50
- 200 @25% + 100 @15% → taxable 300.00 / vat 65.00 (50 + 15) / total 365.00
- rounding: 33.33 @25% → 33.33 × 0.25 = 8.3325 → vat 8.33 / total 41.66
- Base: https://api.storecove.com/api/v2 (single base URL; auth = HTTP Bearer with your API key)
- Evidence: GET /document_submissions/{guid}/evidence — proof of what was sent + Peppol delivery status

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Norway Invoice
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

The README includes setup instructions such as node test/serve.js # local server on :3247.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "norway invoice": {
            "norway-invoice": {
                "type": "http",
                "url": "https://inv-no.wishpool.app/mcp",
                "headers": {
                    "x-storecove-key": "your_storecove_api_key"
                }
            }
        }
    }
}

McpServers

{
    "norway-invoice": {
        "type": "http",
        "url": "https://inv-no.wishpool.app/mcp",
        "headers": {
            "x-storecove-key": "your_storecove_api_key"
        }
    }
}

Norway Invoice MCP 🇳🇴 — How can my AI agent send a Peppol/EHF e-invoice in Norway?

Remote MCP server that lets any AI agent send Norway B2B electronic invoices over the Peppol network in Peppol BIS 3.0 / EHF (EN 16931) format via Storecove, a certified Peppol Access Point. It builds the structured invoice, computes the Norwegian VAT (MVA) breakdown, and delivers it under the merchant's own Storecove account. Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-no.wishpool.app/mcp · Registry: app.wishpool/norway-invoice-mcp

Why now — the mandate (elektronisk faktura EHF)

Norway is moving to mandatory structured e-invoicing over Peppol BIS 3.0 / EHF for domestic B2B: the parliament (Stortinget) has adopted the reform and the sending obligation applies from 2027-01-01. EHF (Elektronisk Handelsformat) is Peppol BIS Billing 3.0 based. Paper and plain-PDF invoices no longer satisfy the B2B obligation.

Quick start

{
  "mcpServers": {
    "norway-invoice": {
      "type": "http",
      "url": "https://inv-no.wishpool.app/mcp",
      "headers": {
        "x-storecove-key": "your-storecove-api-key"
      }
    }
  }
}

Sign up at storecove.com — the merchant is the Peppol Access Point account holder. Request a free 30-day sandbox account from Storecove for a test key (sandbox does not need production onboarding). Create your sender under Senders to get the legalEntityId you pass as seller_legal_entity_id. Sandbox vs production is determined by the account your key belongs to — the base URL is the same. Authentication is HTTP Bearer with your key. Your key stays with you and travels per-request; this server never stores it.

Tools

| Tool | What it does |
|---|---|
| check_recipient | Peppol participant discovery — is the buyer reachable on Peppol before you send? Pass the identifier (organisasjonsnummer scheme 0192). Returns can_receive. The safe pre-flight. |
| create_invoice | Build a Peppol BIS 3.0 / EHF invoice from seller + buyer (Norwegian VAT NO<9 digits>MVA / organisasjonsnummer, address) and line items (description, net unit price, VAT rate 25/15/12/0, quantity), then submit over Peppol via Storecove. Returns a submission guid + computed VAT totals (taxable, vat, total). |
| get_delivery_evidence | Fetch the proof of what was sent and the Peppol delivery status by guid. |

Amounts are in NOK. Norwegian VAT (MVA) rates: 25 (standard), 15 (food/groceries), 12 (transport/accommodation and other low-rate services), 0 (zero-rated/exempt/reverse charge). Parties identified by Norwegian VAT (NO<9 digits>MVA) and/or organisasjonsnummer (9 digits); Peppol routing scheme 0192.

No cancel over Peppol — to reverse an invoice you issue a credit note (a new invoice). create_invoice needs seller_legal_entity_id (your Storecove sender id). Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them.

VAT math (deterministic)

Per line amountExcludingVat = round2(quantity × unit_price); grouped by (rate, category) into taxSubtotals (taxableAmount, taxAmount = round2(taxable × rate / 100)); gross amountIncludingVat = taxable + tax. Examples:

- 100 + 50 both @25% → taxable 150.00 / vat 37.50 / total 187.50
- 200 @25% + 100 @15% → taxable 300.00 / vat 65.00 (50 + 15) / total 365.00
- 2×50 @25% + 3×10 @15% + 1×40 @12% + 1×25 @0% → taxable 195.00 / vat 34.30 (25 + 4.50 + 4.80 + 0) / total 229.30
- rounding: 33.33 @25% → 33.33 × 0.25 = 8.3325 → vat 8.33 / total 41.66

Endpoints wrapped (Storecove REST)

- Base: https://api.storecove.com/api/v2 (single base URL; auth = HTTP Bearer with your API key)
- Send: POST /document_submissions — JSON { legalEntityId, routing, document:{ documentType:"invoice", invoice:{…} } }{ guid }
- Evidence: GET /document_submissions/{guid}/evidence — proof of what was sent + Peppol delivery status
- Discovery: POST /discovery/receives — JSON { documentTypes, network, metaScheme, scheme, identifier }{ code:"OK", email }
- Verified probe: a fake Bearer key really hits api.storecove.com/api/v2403 {"errors":[{"source":"generic","details":"Not Authorized"}]} (endpoint alive; BYO = the merchant's own key validates).

Develop

node test/serve.js   # local server on :3247
node test/e2e.js     # VAT math + Peppol/EHF JSON structure + protocol + validation + policy + fake-key live probe

Safety

Pure stateless translation layer over the Storecove REST API. Storecove is the certified Peppol Access Point under the merchant's own account; this service never signs, never onboards, and never stores anything. The API key travels per-request in a header, and funds are never touched — this issues tax invoices, it does not move money. Privacy policy.

Sister servers

Local invoices, one family: Denmark Peppol/NemHandel (inv-dk) · Belgium Peppol BIS (inv-be) · Italy FatturaPA (inv-it) · Malaysia MyInvois (inv-my) · Mexico CFDI (inv-mx) · Brazil NF-e (inv-br) · India GST (inv-in). Storecove also covers the Nordics, the Netherlands and Luxembourg on Peppol — those sister countries replicate this exact server. Local logistics: logi.wishpool.app. Local payments in 81 countries: mcp.wishpool.app.

MIT licensed.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.