Denmark Invoices (Peppol / NemHandel via Storecove)

Official3 toolsLive

by junter1989k-ai · JavaScript

Denmark Peppol/NemHandel e-invoices for AI agents: send, check recipient, get delivery proof.

Topics

ai-agentclaudedenmarke-invoiceinvoicemcpmcp-serverpeppolstorecovetaxvatwishpool

Captured live from the server via tools/list.

create_invoice

Send a Denmark B2B electronic invoice over the Peppol network in Peppol BIS 3.0 / EN 16931 format via Storecove (a certified Peppol Access Point). Denmark delivers over Peppol / NemHandel; the Bookkeeping Act (Bogforingsloven) phases in mandatory digital bookkeeping and structured e-invoice send/receive: from 2024 for reporting-obligated companies (classes B/C/D), extending from 2026-01 to class A businesses with revenue above DKK 300,000. Builds the structured invoice JSON from seller + buyer (name, Danish VAT DKxxxxxxxx and/or CVR number, address) and line items (description, quantity, net unit price, VAT rate 25/0), computes the Danish VAT (moms) 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. Danish VAT (moms) rates: 25 (single standard rate), 0 (zero-rated/exempt/reverse charge). Amounts in DKK. 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).

Parameters24

seller_legal_entity_id	string	required	REQUIRED. The Storecove legalEntityId of the sender (created in your Storecove account under Senders). Numeric id, passed through to Storecove.
seller_name	string	required	Seller legal/company name.
seller_vat	string	optional	Seller Danish VAT number, format DKxxxxxxxx (DK + 8 digits). Provide this and/or seller_cvr.
seller_cvr	string	optional	Optional seller Danish CVR number (Central Business Register), 8 digits.
seller_address	string	required	Seller street address.
seller_city	string	required	Seller city.
seller_zip	string	required	Seller postal code.
seller_country	string	optional	Seller country code. Default DK.
customer_name	string	required	Buyer legal/company name.
customer_vat	string	optional	Buyer Danish VAT number DKxxxxxxxx. Provide this and/or customer_cvr (used to route on Peppol if no explicit recipient id is given).
customer_cvr	string	optional	Optional buyer Danish CVR number (Central Business Register), 8 digits.
customer_address	string	required	Buyer street address.
customer_city	string	required	Buyer city.
customer_zip	string	required	Buyer postal code.
customer_country	string	optional	Buyer country code. Default DK.
recipient_peppol_scheme	string	optional	Optional explicit Peppol routing scheme (EAS/ISO6523). Denmark: 0184 (DK:CVR). Default 0184 when routing by CVR number.
recipient_peppol_id	string	optional	Optional explicit Peppol participant identifier to route to (overrides deriving from the customer CVR/VAT).
recipient_email	string	optional	Optional email fallback — used if the recipient is not on Peppol (Storecove can email a copy).
invoice_number	string	optional	Invoice number. Auto-generated if omitted.
issue_date	string	optional	Invoice issue date, YYYY-MM-DD. Default: today (UTC).
due_date	string	optional	Optional payment due date, YYYY-MM-DD.
currency	string	optional	Document currency. Default DKK.
note	string	optional	Optional free-text note on the invoice.
lines	array	required	Invoice line items. Each: description, unit_price (net, VAT-exclusive, DKK), vat_rate (25\|0), optional quantity (default 1), optional tax_category (S standard / Z zero-rated / E exempt / AE reverse charge; default S for rate>0, Z for rate 0), optional item_name.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_legal_entity_id": {
      "type": "string",
      "description": "REQUIRED. The Storecove legalEntityId of the sender (created in your Storecove account under Senders). Numeric id, passed through to Storecove."
    },
    "seller_name": {
      "type": "string",
      "description": "Seller legal/company name."
    },
    "seller_vat": {
      "type": "string",
      "description": "Seller Danish VAT number, format DKxxxxxxxx (DK + 8 digits). Provide this and/or seller_cvr."
    },
    "seller_cvr": {
      "type": "string",
      "description": "Optional seller Danish CVR number (Central Business Register), 8 digits."
    },
    "seller_address": {
      "type": "string",
      "description": "Seller street address."
    },
    "seller_city": {
      "type": "string",
      "description": "Seller city."
    },
    "seller_zip": {
      "type": "string",
      "description": "Seller postal code."
    },
    "seller_country": {
      "type": "string",
      "description": "Seller country code. Default DK."
    },
    "customer_name": {
      "type": "string",
      "description": "Buyer legal/company name."
    },
    "customer_vat": {
      "type": "string",
      "description": "Buyer Danish VAT number DKxxxxxxxx. Provide this and/or customer_cvr (used to route on Peppol if no explicit recipient id is given)."
    },
    "customer_cvr": {
      "type": "string",
      "description": "Optional buyer Danish CVR number (Central Business Register), 8 digits."
    },
    "customer_address": {
      "type": "string",
      "description": "Buyer street address."
    },
    "customer_city": {
      "type": "string",
      "description": "Buyer city."
    },
    "customer_zip": {
      "type": "string",
      "description": "Buyer postal code."
    },
    "customer_country": {
      "type": "string",
      "description": "Buyer country code. Default DK."
    },
    "recipient_peppol_scheme": {
      "type": "string",
      "description": "Optional explicit Peppol routing scheme (EAS/ISO6523). Denmark: 0184 (DK:CVR). Default 0184 when routing by CVR number."
    },
    "recipient_peppol_id": {
      "type": "string",
      "description": "Optional explicit Peppol participant identifier to route to (overrides deriving from the customer CVR/VAT)."
    },
    "recipient_email": {
      "type": "string",
      "description": "Optional email fallback — used if the recipient is not on Peppol (Storecove can email a copy)."
    },
    "invoice_number": {
      "type": "string",
      "description": "Invoice number. Auto-generated if omitted."
    },
    "issue_date": {
      "type": "string",
      "description": "Invoice issue date, YYYY-MM-DD. Default: today (UTC)."
    },
    "due_date": {
      "type": "string",
      "description": "Optional payment due date, YYYY-MM-DD."
    },
    "currency": {
      "type": "string",
      "description": "Document currency. Default DKK."
    },
    "note": {
      "type": "string",
      "description": "Optional free-text note on the invoice."
    },
    "lines": {
      "type": "array",
      "minItems": 1,
      "description": "Invoice line items. Each: description, unit_price (net, VAT-exclusive, DKK), vat_rate (25|0), optional quantity (default 1), optional tax_category (S standard / Z zero-rated / E exempt / AE reverse charge; default S for rate>0, Z for rate 0), optional item_name.",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string",
            "description": "Line description."
          },
          "unit_price": {
            "type": "number",
            "description": "Net unit price in DKK, VAT-exclusive."
          },
          "vat_rate": {
            "type": "number",
            "description": "Danish VAT (moms) rate percent: 25 (standard) or 0."
          },
          "quantity": {
            "type": "number",
            "description": "Quantity. Default 1."
          },
          "tax_category": {
            "type": "string",
            "description": "Optional EN 16931 tax category: S / Z / E / AE. Default derived from vat_rate."
          },
          "item_name": {
            "type": "string",
            "description": "Optional item name (defaults to description)."
          }
        },
        "required": [
          "description",
          "unit_price",
          "vat_rate"
        ]
      }
    }
  },
  "required": [
    "seller_legal_entity_id",
    "seller_name",
    "seller_address",
    "seller_city",
    "seller_zip",
    "customer_name",
    "customer_address",
    "customer_city",
    "customer_zip",
    "lines"
  ]
}

check_recipient

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 Danish B2B: pass the recipient identifier and scheme and learn if they are a registered Peppol participant. For Denmark use scheme 0184 with the 8-digit CVR number (DK:CVR). 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.

Parameters4

identifier	string	required	The recipient Peppol identifier. Denmark: the 8-digit CVR number (scheme 0184).
scheme	string	optional	Peppol/ISO6523 scheme. Default 0184 (Danish CVR number).
network	string	optional	Network to check. Default peppol.
document_types	array	optional	Document types to check receipt for. Default ["invoice"].

Raw schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "The recipient Peppol identifier. Denmark: the 8-digit CVR number (scheme 0184)."
    },
    "scheme": {
      "type": "string",
      "description": "Peppol/ISO6523 scheme. Default 0184 (Danish CVR number)."
    },
    "network": {
      "type": "string",
      "description": "Network to check. Default peppol."
    },
    "document_types": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Document types to check receipt for. Default [\"invoice\"]."
    }
  },
  "required": [
    "identifier"
  ]
}

get_delivery_evidence

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.

Parameters1

guid

string

required

The submission guid returned by create_invoice.

Raw schema

{
  "type": "object",
  "properties": {
    "guid": {
      "type": "string",
      "description": "The submission guid returned by create_invoice."
    }
  },
  "required": [
    "guid"
  ]
}

README.md7 KBView on GitHub

Denmark Invoice MCP 🇩🇰 — How can my AI agent send a Peppol/NemHandel e-invoice in Denmark?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "denmark-invoice": {
      "type": "http",
      "url": "https://inv-dk.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/denmark-invoice-mcp && cd denmark-invoice-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

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

Live endpoint: https://inv-dk.wishpool.app/mcp · Registry: app.wishpool/denmark-invoice-mcp

Why now — the Bookkeeping Act (elektronisk faktura NemHandel)

Denmark's Bookkeeping Act (Bogføringsloven) phases in mandatory digital bookkeeping and structured e-invoice send/receive over Peppol / NemHandel: from 2024 for reporting-obligated companies (accounting classes B/C/D), extending from 2026-01 to class A businesses with revenue above DKK 300,000. Paper and plain-PDF invoices no longer satisfy the B2B obligation for covered businesses.

Quick start

json

{
  "mcpServers": {
    "denmark-invoice": {
      "type": "http",
      "url": "https://inv-dk.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 (CVR number scheme `0184`). Returns `can_receive`. The safe pre-flight.
`create_invoice`	Build a Peppol BIS 3.0 invoice from seller + buyer (Danish VAT `DKxxxxxxxx` / CVR number, address) and line items (description, net unit price, VAT rate 25/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 DKK. Danish VAT (moms) rates: 25 (single standard rate), 0 (zero-rated/exempt/reverse charge). Parties identified by Danish VAT (DKxxxxxxxx) and/or CVR number (8 digits); Peppol routing scheme 0184.

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 @0% → taxable 300.00 / vat 50.00 (50 + 0) / total 350.00
3×33.33 @25% → taxable 99.99 / vat 25.00 (rounded from 24.9975) / total 124.99
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/v2 → 403 {"errors":[{"source":"generic","details":"Not Authorized"}]} (endpoint alive; BYO = the merchant's own key validates).

Develop

bash

node test/serve.js   # local server on :3245
node test/e2e.js     # VAT math + Peppol/NemHandel 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: Norway Peppol/EHF (inv-no) · 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.

Install

Tools (3)

create_invoicecheck_recipientget_delivery_evidence

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://inv-dk.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "denmark-invoice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inv-dk.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.