Ta emot fakturor

Bli tillsagd med en webhook

Lägg till en webhook under företagets inställningar eller med POST /v1/webhooks. Den får händelsen document.received när en faktura kommer, med dokumentets id, nummer, belopp och avsändare. Svara med 2xx inom tio sekunder; annars försöker portalen igen efter 1, 5 och 15 minuter.

Kontrollera att det är portalen

Varje leverans är signerad i huvudet X-Portal-Signature. Kontrollera den mot webhookens hemlighet innan du litar på innehållet, och använd kroppen precis som den kom.

import { verifyWebhook } from "peppol-portal";

const event = await verifyWebhook({
  secret: process.env.WEBHOOK_SECRET!,
  signature: request.headers.get("X-Portal-Signature"),
  body: await request.text(),
});
if (event.type === "document.received") { /* hämta och bokför */ }

Hämta fakturan

GET /v1/documents/{id} ger fakturan som JSON i samma form som du skickar, med summorna som avsändaren angav dem. Originalet finns som UBL (/ubl), som PDF på tio språk (/pdf?lang=sv) och i andra format (/export/cii, /export/factur-x). Bilagor hämtas med /attachments/{n}. Utan webhook går det att lista det som kommit: GET /v1/documents?direction=inbound.

Portalen säger till om sådant som är värt en extra titt innan du betalar, i warnings: ny leverantör, nytt bankkonto, ett nummer som redan kommit, avsändare som inte stämmer, förfallodag som passerat.

Svara avsändaren

POST /v1/documents/{id}/response skickar en Invoice Response tillbaka över Peppol: AB mottagen, IP behandlas, UQ frågor, CA godkänd med villkor, RE avvisad, AP godkänd, PD betald. Frågor, villkor och avvisning ska ha en orsakskod.

Utan att skriva kod

Under inställningar kan mottagna fakturor vidarebefordras per e-post till ekonomin, med PDF, XML och bilagor. En enskild faktura kan också skickas vidare i efterhand från dess sida.