Sweden Invoices (Peppol BIS 3.0 via Storecove)

Official3 toolsLive

by junter1989k-ai · JavaScript

Sweden Peppol BIS 3.0 e-invoices for AI agents: send, check recipient, get delivery proof.

Topics

ai-agentclaudedgie-invoiceinvoicemcpmcp-serverpeppolstorecoveswedentaxvatwishpool

Captured live from the server via tools/list.

create_invoice

Send a Sweden B2B/B2G electronic invoice over the Peppol network in Peppol BIS 3.0 / EN 16931 format via Storecove (a certified Peppol Access Point). Sweden mandates Peppol e-invoicing for public-sector suppliers (B2G) since 2019-04-01; B2B is voluntary today and expected to follow the EU ViDA timeline, so Peppol is already the Swedish rail. Builds the structured invoice JSON from seller + buyer (name, Swedish VAT SExxxxxxxxxx01 and/or organisationsnummer, address) and line items (description, quantity, net unit price, VAT rate 25/12/6/0), computes the Swedish 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. Swedish VAT rates: 25 (standard), 12 (food/lodging), 6 (books/newspapers/passenger transport), 0 (zero-rated/exempt/reverse charge). Amounts in SEK. 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 Swedish VAT number, format SExxxxxxxxxx01 (SE + 10-digit organisationsnummer + 01). Provide this and/or seller_org_number.
seller_org_number	string	optional	Optional seller Swedish organisationsnummer (organization number), 10 digits (NNNNNN-NNNN).
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 SE.
customer_name	string	required	Buyer legal/company name.
customer_vat	string	optional	Buyer Swedish VAT number SExxxxxxxxxx01. Provide this and/or customer_org_number (used to route on Peppol if no explicit recipient id is given).
customer_org_number	string	optional	Optional buyer Swedish organisationsnummer, 10 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 SE.
recipient_peppol_scheme	string	optional	Optional explicit Peppol routing scheme (EAS/ISO6523). Sweden: 0007 (organisationsnummer) or 9955 (VAT). Default 0007 when routing by organisationsnummer.
recipient_peppol_id	string	optional	Optional explicit Peppol participant identifier to route to (overrides deriving from the customer VAT/organisationsnummer).
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 SEK.
note	string	optional	Optional free-text note on the invoice.
lines	array	required	Invoice line items. Each: description, unit_price (net, VAT-exclusive, SEK), vat_rate (25\|12\|6\|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 Swedish VAT number, format SExxxxxxxxxx01 (SE + 10-digit organisationsnummer + 01). Provide this and/or seller_org_number."
    },
    "seller_org_number": {
      "type": "string",
      "description": "Optional seller Swedish organisationsnummer (organization number), 10 digits (NNNNNN-NNNN)."
    },
    "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 SE."
    },
    "customer_name": {
      "type": "string",
      "description": "Buyer legal/company name."
    },
    "customer_vat": {
      "type": "string",
      "description": "Buyer Swedish VAT number SExxxxxxxxxx01. Provide this and/or customer_org_number (used to route on Peppol if no explicit recipient id is given)."
    },
    "customer_org_number": {
      "type": "string",
      "description": "Optional buyer Swedish organisationsnummer, 10 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 SE."
    },
    "recipient_peppol_scheme": {
      "type": "string",
      "description": "Optional explicit Peppol routing scheme (EAS/ISO6523). Sweden: 0007 (organisationsnummer) or 9955 (VAT). Default 0007 when routing by organisationsnummer."
    },
    "recipient_peppol_id": {
      "type": "string",
      "description": "Optional explicit Peppol participant identifier to route to (overrides deriving from the customer VAT/organisationsnummer)."
    },
    "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 SEK."
    },
    "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, SEK), vat_rate (25|12|6|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 SEK, VAT-exclusive."
          },
          "vat_rate": {
            "type": "number",
            "description": "Swedish VAT rate percent: 25 (standard), 12, 6 (reduced), 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 Swedish B2B/B2G: pass the recipient identifier and scheme and learn if they are a registered Peppol participant. For Sweden use scheme 0007 with the 10-digit organisationsnummer, or 9955 with the VAT number SExxxxxxxxxx01. 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. Sweden: the 10-digit organisationsnummer (scheme 0007) or the VAT number SExxxxxxxxxx01 (scheme 9955).
scheme	string	optional	Peppol/ISO6523 scheme. Default 0007 (Swedish organisationsnummer). Use 9955 for a Swedish VAT 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. Sweden: the 10-digit organisationsnummer (scheme 0007) or the VAT number SExxxxxxxxxx01 (scheme 9955)."
    },
    "scheme": {
      "type": "string",
      "description": "Peppol/ISO6523 scheme. Default 0007 (Swedish organisationsnummer). Use 9955 for a Swedish VAT 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.md6 KBView on GitHub

Sweden Invoice MCP 🇸🇪 — How can my AI agent send a Peppol e-invoice (e-faktura) in Sweden?

Use it in 60 seconds

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

json

{
  "mcpServers": {
    "sweden-invoice": {
      "type": "http",
      "url": "https://inv-se.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/sweden-invoice-mcp && cd sweden-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 Sweden B2B/B2G electronic invoices (e-faktura) over the Peppol network in Peppol BIS 3.0 / EN 16931 format via Storecove, a certified Peppol Access Point. It builds the structured invoice, computes the Swedish 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-se.wishpool.app/mcp · Registry: app.wishpool/sweden-invoice-mcp

Why now — the Swedish mandate

Sweden mandates structured Peppol BIS e-invoicing (e-faktura) for public-sector suppliers (B2G) since 2019-04-01 — paper and PDF are not accepted for B2G. B2B is voluntary today and expected to follow the EU ViDA (VAT in the Digital Age) timeline. Peppol is already the de-facto Swedish rail, so sending B2B over Peppol now is future-proof.

Quick start

json

{
  "mcpServers": {
    "sweden-invoice": {
      "type": "http",
      "url": "https://inv-se.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 (organisationsnummer scheme `0007`, or VAT scheme `9955`). Returns `can_receive`. The safe pre-flight.
`create_invoice`	Build a Peppol BIS 3.0 invoice from seller + buyer (Swedish VAT `SExxxxxxxxxx01` / organisationsnummer, address) and line items (description, net unit price, VAT rate 25/12/6/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 SEK. Swedish VAT (moms) rates: 25 (standard), 12 (food/lodging), 6 (books/newspapers/passenger transport), 0 (zero-rated/exempt/reverse charge). Parties identified by Swedish VAT (SExxxxxxxxxx01) and/or organisationsnummer (10 digits).

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 @6% → taxable 300.00 / vat 56.00 (50 + 6) / total 356.00
2×50 @25% + 3×10 @12% + 1×25 @0% → taxable 155.00 / vat 28.60 (25 + 3.60 + 0) / total 183.60
rounding: 10.10 @25% → vat 2.53 (from 2.525) / total 12.63

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 (2026-07-10): 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 :3237
node test/e2e.js     # VAT math + Peppol 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: Belgium Peppol (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 Finland, Norway, Denmark, 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-se.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

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