Integreret Peppol

Integreret Peppol-infrastruktur og API til platforme

Tilføj Peppol-e-fakturering, e-ordrer og meget mere til dit produkt via ét REST-API. Du har fuld kontrol over brugeroplevelsen. Qvalia står for driften af Access Point, SMP og meddelelsesinfrastrukturen.

Integrerede Peppol-partnertjenester NYT

Tid til sandkassen

Åbningstider

Test i forhold til dine egne systemer og Peppol-testnetværket.

Tid til opsendelse

Dage til uger

Udfør lanceringen i overensstemmelse med jeres integrations- og release -proces.

Ratebegrænsning

Aftalt pr. partner

Kapacitet tildelt pr. partner.

Rollen som tjenesteudbyder

Qvalia

Qvalia står for driften af adgangspunktet, SMP og netværksstyringen.

Teknisk support

Tredje linje

Qvalia yder teknisk support på tredje niveau.

Udviklet til

ERP-udbydere · Fakturerings- og regnskabssoftware · CRM-systemer · VAN -udbydere
B2B-markedspladser · Regnskabsbureauer · IT-konsulentfirmaer

Jeres produkt, vores infrastruktur

Partnerne udvikler og står for brugeroplevelsen. Qvalia driver Access Point, SMP og den underliggende meddelelsesinfrastruktur, som man får adgang til via ét API.

Du styrer kundeoplevelsen, kontrakten og prissætningen. Qvalia står for driften af Peppol-tjenesten bag din brugergrænseflade.

Integreret Peppol-arkitektur: Slutkunderne er separate lejere inden for partnerplatformen, som kalder Qvalia’s Partner API; Qvalia driver Access Point og SMP, som er forbundet til Peppol-netværket.

Det, vi driver, det, du ejer

Hvad Qvalia kører

  • Access Point og SMP i rollen som Peppol-tjenesteudbyder hos Qvalia
  • Validering af meddelelser, formatkonvertering og levering via netværket
  • Deltagerregistrering og -opslag
  • Overvågning, opdateringer og overholdelse af netværkskrav

Hvad du ejer

  • Den brugergrænseflade, som dine kunder bruger, inde i dit eget produkt
  • Kundeforholdet, kontrakten og prissætningen
  • Din egen onboarding- og supportproces

Arbejdsgang for Partner-API’en

Partner-API’en omfatter systemgodkendelse, kundeopsætning, indsendelse af dokumenter og håndtering af indgående meddelelser. Qvalia varetager Peppol-transport, -opdagelse, -validering og certifikatadministration.

1. Log ind

Partnersystemer autentificerer sig med en API-nøgle eller udveksler den mod et kortvarigt JWT. Én adgangsoplysning dækker API’erne for transaktioner, partnere, konti og udvidelse.

curl –location –globoff -X POST \ ‘https://api.qvalia.com/token’ \ –data ‘{ “client_id”: “{partnerRegNo}”, “client_secret”: “{apiKey}” }’ # Valid for one hour. Send it on every call: # Authorization: Bearer <token>
curl --location --globoff -X POST \
  'https://api.qvalia.com/token' \
  --data '{
    "client_id": "{partnerRegNo}",
    "client_secret": "{apiKey}"
  }'

# Valid for one hour. Send it on every call:
# Authorization: Bearer <token>

2. Opret kunden

Opret kontoen og registrer dens Peppol-deltager-id. Qvalia står for deltagerregistrering og opdateringer af deltagerlisten

curl –location –globoff -X POST \ ‘https://api.qvalia.com/partner/{partnerRegNo}/account’ \ –header ‘Authorization: Bearer <token>’ \ –data ‘{ “accountRegNo”: “5567321707”, “name”: “Nordkap Logistik AB”, “address”: “Wallingatan 33”, “postalCode”: “111 24”, “country”: “SE” }’ curl –location –globoff -X PUT \ ‘https://api.qvalia.com/partner/{partnerRegNo}/account/5567321707/peppol/0007:5567321707’ \ –header ‘Authorization: Bearer <token>’
curl --location --globoff -X POST \
  'https://api.qvalia.com/partner/{partnerRegNo}/account' \
  --header 'Authorization: Bearer <token>' \
  --data '{
    "accountRegNo": "5567321707",
    "name": "Nordkap Logistik AB",
    "address": "Wallingatan 33",
    "postalCode": "111 24",
    "country": "SE"
  }'

curl --location --globoff -X PUT \
  'https://api.qvalia.com/partner/{partnerRegNo}/account/5567321707/peppol/0007:5567321707' \
  --header 'Authorization: Bearer <token>'

3. Send og modtag beskeder

Dokumenterne valideres i henhold til de gældende Peppol-specifikationer inden overførslen. Strukturerede valideringssvar sendes tilbage til dit system, og indgående meddelelser kan ses via den samme konto.

curl –location –globoff -X POST \ ‘https://api.qvalia.com/partner/{partnerRegNo}/transaction/5567321707/invoices/outgoing’ \ –header ‘Authorization: Bearer <token>’ \ –data ‘{ “Invoice”: { } }’ # 200 # { “status”: “success”, “data”: { “message”: “invoice 12335675 sent” } }
curl --location --globoff -X POST \
  'https://api.qvalia.com/partner/{partnerRegNo}/transaction/5567321707/invoices/outgoing' \
  --header 'Authorization: Bearer <token>' \
  --data '{ "Invoice": { } }'

# 200
# { "status": "success", "data": { "message": "invoice 12335675 sent" } }

4. Tilmeld dig arrangementer

Abonner på dokumenthændelser via webhooks. Qvalia sender en besked til dit endpoint, når et dokument modtages, når leveringsstatus ændres, og når leveringen mislykkes.

curl –location –globoff -X PUT \ ‘https://api.qvalia.com/partner/{partnerRegNo}/webhook/configure’ \ –header ‘Authorization: Bearer <token>’ \ –data ‘{ “url”: “https://your-platform.example/qvalia/events”, “events”: [“new_document”, “document_delivery”, “document_error”] }’ # Delivered as HTTPS POST with a JSON body. # Respond 2xx within 10 seconds.
curl --location --globoff -X PUT \
  'https://api.qvalia.com/partner/{partnerRegNo}/webhook/configure' \
  --header 'Authorization: Bearer <token>' \
  --data '{
    "url": "https://your-platform.example/qvalia/events",
    "events": ["new_document", "document_delivery", "document_error"]
  }'

# Delivered as HTTPS POST with a JSON body.
# Respond 2xx within 10 seconds.
SpecifikationDetaljer
TransportPeppol AS4-transport, ebMS-beskedudveksling og håndtering af PKI-certifikater varetages af Qvalia.
ResponstidAPI-svartiden afhænger af datamængden og forbindelsen. Levering via Peppol foregår asynkront og afhænger af det modtagende adgangspunkt.
Væsentlige ændringerÆndringer, der medfører kompatibilitetsbrud, udgives som en ny API-version med mindst en måneds varsel, normalt længere

Konto-modeller med flere brugere

Vælg enten en samlet opsætning eller en separat konto pr. kunde, afhængigt af kravene til registrering, dataseparering og brugeradministration.

KonsolideretKonto pr. lejer
Peppol-registreringFælles opsætning, som du selv administrererEgen konto og Peppol ID pr. slutkunde
Data og brugereAdministreres samlet på jeres platformSeparate data, brugere og indstillinger pr. lejer
OnboardingDen hurtigste måde at tilføje en kunde påDeltagerregistrering og opdatering af deltagerlisten varetages af Qvalia
PasformMange små kunder samlet under én af de tjenester, I tilbyderKunder, der har brug for deres egen Peppol-identitet og revisionsspor

Du styrer onboarding-oplevelsen i begge modeller. Kontomodellen bestemmer deltagerregistreringen og adskillelsen af data.

Understøttede forretningsdokumenter

Den samme integration understøtter de tilgængelige processer for fakturering, ordreafgivelse og tilhørende forretningsdokumenter.

DokumentPeppol-navnDetaljer
FakturaFakturaEt betalingskrav med specifikation af poster, skat og betalingsbetingelser
KreditnotaKreditnotaEn rettelse eller annullering af en allerede afsendt faktura
Faktura med selvfaktureringSelvfaktureringsfakturaEn faktura, som køberen udsteder på leverandørens vegne
Kreditnota med selvfaktureringSelvfaktureret kreditnotaDen tilhørende kreditnota til en selvfaktureret faktura
BestillingBestillingEn indkøbsordre fra køber til leverandør
Svar på bestillingOrderResponseGodkendelse, afvisning eller ændring af en ordre
BestillingsaftaleOrdreaftaleEn rammeaftale, som senere ordrer henviser til
Ændring af ordreÆndring af ordreEn ændring til en ordre, der allerede er afsendt
Annullering af ordreAnnullering af ordreAnnullering af en ordre, der allerede er afsendt
Råd om afsendelseForsendelsesmeddelelseHvad er der rent faktisk blevet afsendt, i forhold til hvilken ordre
KatalogKatalogProdukter, beskrivelser og aftalte priser
Svar på katalogetKatalogresponsGodkendelse eller afvisning af et katalog
Svar på meddelelsesniveauMeddelelsesniveau-svarTeknisk bekræftelse eller afvisning af en besked
Status på meddelelsesniveauMeddelelsesniveau-statusBehandlingsstatus for en besked på netværket

Punchout, PDF- og EDI-tjenester kan benytte den samme kontostruktur. Qvalia varetager validering, videresendelse, levering og fejlhåndtering på netværksniveau.

Strukturerede transaktionsdata

Dokumenterne er tilgængelige som strukturerede transaktionsdata til rapportering, analyse og automatisering af regnskabsføringen.

Fakturalinje, som modtaget

ART 4471-B Trykpapir A4 80 g 5 x 500 12 stk. 489,00 SEK
ART 4471-B
Printing paper A4 80G 5X500
12 pcs          489,00 SEK

Samme linje, klassificeret

UNSPSC14111507 Kopipapir
KategoriKontorartikler
Enhed12 × 2 500 ark
Enhedspris40.75 SEK
LeverandørTilpasset til masterdata

Poster kan struktureres og klassificeres i realtid ved hjælp af » masterdata «, der er integreret i transaktionsforløbet. Dette understøtter rapportering, udgiftsanalyse og automatisering af regnskabsføringen i dit produkt. OCR, automatiseret regnskabsføring og udvidet klassificering tilbydes som tilvalg.

Forpligtelser i forbindelse med overholdelse af Peppol-standarderne

Qvalia fungerer som Peppol-tjenesteudbyder for Embedded Peppol. Partneren forbliver ansvarlig for sine kundeforhold og sit kommercielle tilbud. Kun aktive juridiske enheder kan tildeles en Peppol ID.

AnsvarQvaliaDu
Rollen som certificeret Peppol-tjenesteudbyderQvalia
Adgangspunkt og SMP-driftQvalia
Peppol-certificering, revisioner og netværksstyringQvalia
ISO/IEC 27001:2022 og ISO 22301:2019 – ledelsessystemerQvalia
KundekendskabsprocedurerPartner
Det skal sikres, at kunderne ikke er afmeldt, er insolvente eller overtræder kravene til bekæmpelse af hvidvaskning af pengePartner
Aftale med slutkunden, prisfastsættelse og forretningsforholdPartner

Dette gælder både Embedded Peppol og white-label-platformen. Partnere, der har brug for at varetage rollen som Peppol-tjenesteudbyder i eget navn, bør i stedet se nærmere på Hosted Access Point.

Ofte stillede spørgsmål

Hvad betyder »Embedded Peppol« i praksis?

I tilbyder jeres egne kunder Peppol-tilkobling og standardkonform udveksling af forretningsmeddelelser, integreret i jeres produkt via et API. Qvalia står for driften af Peppol-infrastrukturen i baggrunden. I ejer kundeforholdet og tilbuddet.

Skal vi selv sørge for, at vi overholder Peppol-kravene?

Nej. Med Embedded Peppol varetager Qvalia rollen som Peppol-tjenesteudbyder og driver adgangspunktet og SMP’en. Qvalia står for styringen af Peppol-netværket og sikrer, at tjenesten overholder de tekniske krav. Du er fortsat ansvarlig for kontrakter med slutkunder, onboarding-oplysninger, prisfastsættelse og support. Partnere, der har behov for at varetage rollen som tjenesteudbyder i eget navn, bør overveje Hosted Access Point.

Hvordan understøtter I Peppol-opsætninger med flere lejere?

Qvalia understøtter både konsoliderede modeller og multi-tenant-modeller. Du kan administrere flere slutkunder i et delt system eller oprette separate konti og Peppol-id’er for hver enkelt kunde.

Hvilke Peppol-meddelelsestyper kan vi tilbyde vores brugere og slutkunder?

Fakturaer, kreditnotaer, ordrer, ordrebekræftelser, forsendelsesmeddelelser, kataloger og tilhørende forretningsmeddelelser samt punchout. Qvalia varetager validering, videresendelse, levering og fejlhåndtering på tværs af netværket. PDF- og EDI-filer behandles via den samme kontostruktur.

Hvordan bliver slutkunderne integreret og administreret?

Slutkunderne tildeles deres egne Peppol-id’er og routingregler under onboarding-processen. Qvalia varetager deltagerregistrering, opdateringer af adresselisten og netværkskonfiguration i kulissen, mens du styrer onboarding-oplevelsen.

Skal vi foretage en afstemning for indgående dokumenter?

Nej. Abonner på webhook-begivenheder og Qvalia-meddelelser til dit endpoint, når der modtages en Peppol-besked eller et Peppol-dokument, når leveringsstatus ændres, og når leveringen mislykkes. Polling-endpoints er tilgængelige som et alternativ.

Kan vi tilbyde mere end blot udveksling af beskeder?

Ja. Hver eneste transaktion er tilgængelig som strukturerede data med klassificering på linjeniveau, hvilket giver dig mulighed for at integrere rapportering, udgiftsanalyse og automatiseret bogføring i dit eget produkt i stedet for blot at overføre dokumenter. OCR, automatiseret bogføring og udvidelse af klassificeringen er tilgængelige som tillægsmoduler.

Er der hastighedsbegrænsninger?

Ja. Partnerkonti tildeles grænser, der ligger betydeligt over standardgrænserne for konti, og grænsen tilpasses i forhold til jeres forventede volumen. Hvis I planlægger en stor onboarding eller en travl månedsafslutning, bedes I kontakte os.

Hvor hurtigt kan vi komme i gang?

Adgang til sandkassen er normalt tilgængelig inden for få timer. Lanceringen i produktionsmiljøet afhænger af integration, test og jeres proces for godkendelse af ændringer ( release ).

Hvordan er integrationen opbygget?

Platformen integreres via REST-API’er. Systemgodkendelsen foregår ved hjælp af OAuth 2.0-klientoplysninger. Bruger-SSO konfigureres separat via de understøttede identitetsmuligheder. Hvis du ikke har brug for grænsefladen i dit produkt, stiller white-label-platformen Qvalia’s applikation til rådighed under dit eget brand.

Alternative løsninger

Vælg en white-label-platform, hvis du ønsker en komplet løsning, eller et hostet adgangspunkt, hvis din organisation skal varetage rollen som tjenesteudbyder.

Du vil have produktet, ikke selve fremstillingen

White-label-platformen er Qvalia’s komplette applikation, der kører under dit brand, dit domæne og dine priser. Den tilbyder en fuldstændig brugergrænseflade uden behov for et udviklingsprojekt.

Du skal være den, der leverer tjenesten, i dit eget navn

Med Hosted Access Point bliver du en certificeret Peppol-tjenesteudbyder med din egen Access Point-identitet og dit eget PKI-certifikat på den infrastruktur, som Qvalia driver.

Kom i kontakt

Integrer e-fakturering, e-bestilling og databerigelse i din platform med Qvalia.

Vores partner-API, avancerede administrationsværktøjer og white label-løsninger giver dig mulighed for at tilbyde problemfri transaktionsstyring til dine slutbrugere.

Samarbejd med os om at udvide din platforms muligheder og drive den digitale transformation. Kontakt os for at få mere at vide.

Udveksling af forretningsdokumenter via Peppol, EDI og meget mere

Muliggør AI-drevet databerigelse på varelinjeniveau

Udvid dit produktudbud og din brugervenlighed