Peppol-portalen
Kom igång gratis
Dokumentation

Guider · 1/6

Kom igång

Från konto till första skickade faktura på några minuter, i portalen eller med API:t.

1. Logga in

Logga in med ditt Vanami-konto, samma som för Vanamis andra tjänster; är du ny skapas det första gången. Kontot är er arbetsyta: alla du bjuder in under Konto ser era företag, och rollen i portalen (administratör, medarbetare eller läsare) avgör vad var och en får göra.

2. Registrera företaget

Lägg till företaget i portalen med land och organisationsnummer. Portalen registrerar det i Peppol-nätverket under landets schema (i Sverige 0007 och organisationsnumret), så att andra kan skicka fakturor till det. Det tar en kort stund; företaget är klart när det står Aktivt.

Vill du prova först, kryssa i testläge. Ett företag i testläge är inte med i nätverket: det går att skicka och ta emot på låtsas, och inget lämnar portalen.

3. Skapa en API-nyckel

Under företagets inställningar skapar du en API-nyckel. Den börjar med ppk_ och visas en gång. Ett program skickar den som Authorization: Bearer ppk_…. En företagsnyckel når bara sitt eget företag; en kontonyckel (under Konto) når alla dina företag, se guiden Flera företag.

4. Skicka en faktura

En faktura är JSON enligt EN 16931, den europeiska standarden. Säljarens Peppol-ID kan lämnas tomt: ett företag skickar som sig självt. Portalen räknar summor och moms, skriver UBL-filen och kontrollerar fakturan mot samma regler som nätverket.

curl -X POST https://api.example.com/v1/documents \
  -H "Authorization: Bearer $PEPPOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "INVOICE", "number": "2026-0042", "issue_date": "2026-10-08", "due_date": "2026-11-07", "currency": "SEK", "buyer_reference": "Anna Ek", "seller": { "name": "Kinnefrukt AB", "tax_id": "SE556123456701", "peppol_id": "", "address": { "country": "SE" } }, "buyer": { "name": "Exempelkunden AB", "peppol_id": "0007:5599990008", "address": { "country": "SE" } }, "lines": [{ "name": "Äpplen", "quantity": 3, "unit_price": 12.5, "vat": { "category": "S", "rate": 25 } }] }'

# Svaret är utkastet, med id. Skicka det:
curl -X POST https://api.example.com/v1/documents/$ID/send \
  -H "Authorization: Bearer $PEPPOL_API_KEY"

Ett dokument går igenom tillstånden draft, queued, sending och slutar som delivered (framme hos mottagarens accesspunkt), unconfirmed (skickat, men kvittot kom aldrig), invalid (Peppols regler sa nej) eller failed. Ett utkast med fel skickas inte; felen står i validation.

Nästa steg

NästaSkicka från ditt system