Skicka från ditt system

Kontrollera innan du skickar

POST /v1/validate/json (eller validate i SDK:erna) säger vad som är fel utan att spara något: fälten först, sedan Peppols regler, och svarar med summorna och UBL:en. Bra i ett test, eller innan fakturan bokförs i ditt system.

Har du redan en e-faktura?

Har ditt system redan UBL, skicka den som den är till POST /v1/documents/ubl. CII (XRechnung, ZUGFeRD, Factur-X), en Factur-X-PDF eller FatturaPA tas också emot: de läses in och skickas som Peppol BIS Billing 3.0.

Vet mottagaren om Peppol?

Slå upp kunden innan du skickar: GET /v1/participants/0007:5599990008 säger om den finns och tar emot fakturor och kreditnotor. Har du bara momsnumret, prova GET /v1/participants/by-vat/SE559999000801. Se Hitta mottagare.

Bilagor

Tidrapporter, specifikationer och liknande bifogas utkastet: PDF, PNG, JPEG, CSV, XLSX eller ODS, högst 10 MB per fil och 20 MB sammanlagt. En liten fil skickas direkt; en stor laddas upp med en signerad länk. SDK:ernas attach väljer själv.

await portal.documents.attach(draft.id, { filename: "tidrapport.pdf", data: bytes, description: "Vecka 40" });

Följ upp

send svarar direkt med dokumentet i kö. Låt en webhook säga hur det gick (document.sent, document.failed, document.unconfirmed), eller vänta med sendAndWait. Mottagaren kan svara med en Invoice Response: godkänd, avvisad, betald. Den kommer som document.response och står i dokumentets response.

Kreditnota

POST /v1/documents/{id}/credit-note gör ett utkast till kreditnota med fakturans parter och rader och en hänvisning till fakturan. Ändra det som ska krediteras, ge det ett nummer och skicka.

När något går fel

Fel kommer som application/problem+json: code för program, detail för människor, field för fältet det gäller. Ett dokument med fel svarar 422 med errors per fält; ett som Peppols regler avvisar får findings med regelns nummer. Får du 429, vänta Retry-After sekunder; SDK:erna gör det själva och upprepar aldrig ett anrop som skickar något.