Zeit für die Sandbox
Öffnungszeiten
Führen Sie eine Validierung anhand Ihrer eigenen Systeme und des Peppol-Testnetzwerks durch.
Zeit für den Start
Tage bis Wochen
Führen Sie die Einführung gemäß Ihrem Integrations- und „ release “-Prozess durch.
Ratenbegrenzung
Je nach Partner vereinbart
Pro Partner bereitgestellte Kapazität.
Rolle als Dienstleister
Qvalia
Qvalia betreibt den Access Point, das SMP und die Netzwerkverwaltung.
Technischer Support
Dritte Zeile
Qvalia bietet technischen Support der dritten Ebene an.
Entwickelt für
ERP-Anbieter · Rechnungsstellungs- und Buchhaltungssoftware · CRM-Systeme · VAN -Betreiber
B2B-Marktplätze · Buchhaltungsbüros · IT-Beratungsunternehmen
Ihr Produkt, unsere Infrastruktur
Die Partner gestalten und verantworten die Benutzererfahrung. Qvalia betreibt den Access Point, das SMP sowie die dahinterstehende Messaging-Infrastruktur, auf die über eine einzige API zugegriffen werden kann.
Sie haben die Kontrolle über das Kundenerlebnis, den Vertrag und die Preisgestaltung. Qvalia betreibt den Peppol-Dienst hinter Ihrer Benutzeroberfläche.
Was wir betreiben, was Ihnen gehört
Was Qvalia betreibt
- Access Point und SMP im Rahmen der Rolle als Peppol-Dienstleister von Qvalia
- Nachrichtenvalidierung, Formatkonvertierung und Übermittlung über das Netzwerk
- Anmeldung und Suche nach Teilnehmern
- Überwachung, Aktualisierungen und Einhaltung der Netzwerkvorschriften
Was dir gehört
- Die Benutzeroberfläche, die Ihre Kunden nutzen – direkt in Ihrem eigenen Produkt
- Kundenbeziehung, Vertrag und Preisgestaltung
- Ihr individueller Onboarding- und Support-Ablauf
Partner-API-Workflow
Die Partner-API umfasst die Systemauthentifizierung, die Kundenkonfiguration, die Einreichung von Dokumenten und die Bearbeitung eingehender Nachrichten. Qvalia übernimmt den Peppol-Transport, die Erkennung, die Validierung und die Zertifikatsverwaltung.
1. Anmelden
Partnersysteme authentifizieren sich mit einem API-Schlüssel oder tauschen diesen gegen ein kurzlebiges JWT aus. Ein einziger Zugangsnachweis gilt für die Transaction-, Partner-, Account- und Enrichment-APIs.
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. Den Kunden anlegen
Erstellen Sie das Konto und registrieren Sie dessen Peppol-Teilnehmerkennung. Qvalia verwaltet die Registrierung der Teilnehmer und die Aktualisierung des Verzeichnisses.
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. Nachrichten senden und empfangen
Die Dokumente werden vor der Übermittlung anhand der geltenden Peppol-Spezifikationen validiert. Strukturierte Validierungsantworten werden an Ihr System zurückgesendet, und eingehende Nachrichten sind über dasselbe Konto abrufbar.
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. Veranstaltungen abonnieren
Abonnieren Sie Dokumentereignisse über Webhooks. Qvalia sendet eine Benachrichtigung an Ihren Endpunkt, wenn ein Dokument eintrifft, sich der Zustellstatus ändert oder die Zustellung fehlschlägt.
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.| Spezifikation | Details |
| Verkehr | Der Peppol-AS4-Transport, der ebMS-Nachrichtenaustausch und die Verwaltung von PKI-Zertifikaten werden von Qvalia betrieben. |
| Reaktionszeit | Die Antwortzeit der API hängt von der Größe der Nutzdaten und der Verbindungsqualität ab. Die Peppol-Übermittlung erfolgt asynchron und hängt vom empfangenden Zugangspunkt ab. |
| Kompatibilitätsbrechende Änderungen | Kompatibilitätsbrechende Änderungen werden als neue API-Version veröffentlicht, wobei eine Vorankündigung von mindestens einem Monat erfolgt, in der Regel sogar länger. |
Mandantenfähige Kontomodelle
Wählen Sie je nach den Anforderungen hinsichtlich Registrierung, Datentrennung und Benutzerverwaltung entweder eine konsolidierte Konfiguration oder ein separates Konto pro Kunde.
| Konsolidiert | Konto pro Mieter | |
| Peppol Registrierung | Von Ihnen verwaltete gemeinsame Konfiguration | Eigenkonto und „ Peppol ID “ pro Endkunde |
| Daten und Nutzer | Gemeinsam auf Ihrer Plattform verwaltet | Getrennte Daten, Benutzer und Einstellungen pro Mandant |
| Onboarding | Der schnellste Weg, einen Kunden hinzuzufügen | Die Teilnehmeranmeldung und die Aktualisierung des Teilnehmerverzeichnisses werden von Qvalia übernommen |
| Passform | Viele kleine Kunden unter einem von Ihnen betriebenen Dienst | Kunden, die eine eigene Peppol-Identität und einen eigenen Prüfpfad benötigen |
Bei beiden Modellen haben Sie die Kontrolle über den Onboarding-Prozess. Das Kontomodell legt die Registrierung der Teilnehmer und die Datentrennung fest.
Unterstützte Geschäftsdokumente
Diese Integration unterstützt die verfügbaren Abrechnungs-, Bestell- und damit verbundenen Geschäftsdokumentenabläufe.
| Dokument | Peppol-Name | Details |
| Rechnung | Rechnung | Eine Zahlungsaufforderung mit Einzelposten, Steuern und Zahlungsbedingungen |
| Gutschrift | Gutschrift | Eine Korrektur oder Stornierung einer bereits versandten Rechnung |
| Rechnung auf eigene Rechnung | Selbstrechnungsstellung | Eine Rechnung, die der Käufer im Namen des Lieferanten ausstellt |
| Gutschrift aus Eigenfakturierung | Selbstrechnungs-Gutschrift | Die entsprechende Gutschrift für eine selbst ausgestellte Rechnung |
| Bestellung | Bestellung | Eine Bestellung des Käufers an den Lieferanten |
| Bestellbestätigung | Bestellbestätigung | Annahme, Ablehnung oder Änderung einer Bestellung |
| Auftragsvereinbarung | Bestellvereinbarung | Ein Rahmenvertrag, auf den sich spätere Aufträge beziehen |
| Bestelländerung | Auftragsänderung | Eine Änderung einer bereits versandten Bestellung |
| Stornierung der Bestellung | Stornierung einer Bestellung | Stornierung einer bereits versandten Bestellung |
| Versandhinweise | Versandhinweise | Was wurde tatsächlich versandt, und auf welche Bestellung hin? |
| Katalog | Katalog | Produkte, Beschreibungen und vereinbarte Preise |
| Antwort auf den Katalog | Katalogantwort | Annahme oder Ablehnung eines Katalogs |
| Antwort auf Nachrichtenebene | MessageLevelResponse | Technische Bestätigung oder Ablehnung einer Nachricht |
| Status auf Nachrichtenebene | Nachrichten-Ebene-Status | Verarbeitungsstatus einer Nachricht im Netzwerk |
Punchout, PDF- und EDI-Dienste können dieselbe Kontostruktur nutzen. Qvalia übernimmt die Validierung, die Weiterleitung, die Zustellung und die Fehlerbehandlung auf Netzwerkebene.
Strukturierte Transaktionsdaten
Die Dokumente stehen als strukturierte Transaktionsdaten für die Berichterstellung, Analyse und Automatisierung der Buchhaltung zur Verfügung.
Rechnungsposition, wie erhalten
ART 4471-B
Printing paper A4 80G 5X500
12 pcs 489,00 SEKGleiche Zeile, klassifiziert
| UNSPSC | 14111507 Kopierpapier |
| Kategorie | Bürobedarf |
| Einheit | 12 × 2.500 Blatt |
| Stückpreis | 40.75 SEK |
| Lieferant | Mit den Stammdaten abgeglichen |
Einzelposten können in Echtzeit strukturiert und klassifiziert werden, wobei die Stammdaten mit dem Transaktionsfluss verknüpft sind. Dies unterstützt das Berichtswesen, die Ausgabenanalyse und die Automatisierung der Buchhaltung in Ihrem Produkt. OCR, automatisierte Buchhaltung und die Anreicherung von Klassifizierungsdaten sind als Add-ons verfügbar.
Verantwortlichkeiten hinsichtlich der Peppol-Konformität
Qvalia fungiert als Peppol-Dienstleister für „Embedded Peppol“. Der Partner bleibt weiterhin für die Kundenbeziehung und das kommerzielle Angebot verantwortlich. Eine „ Peppol ID “ kann nur aktiven juristischen Personen zugewiesen werden.
| Verantwortung | Qvalia | Du |
| Rolle als zertifizierter Peppol-Dienstleister | Qvalia | |
| Access Point und SMP-Betrieb | Qvalia | |
| Peppol-Zertifizierung, Audits und Netzwerk-Governance | Qvalia | |
| Managementsysteme nach ISO/IEC 27001:2022 und ISO 22301:2019 | Qvalia | |
| Kundenüberprüfung | Partner | |
| Sicherstellen, dass Kunden nicht aus dem Register gelöscht wurden, nicht zahlungsunfähig sind und nicht gegen die Geldwäschevorschriften verstoßen | Partner | |
| Endkundenvertrag, Preisgestaltung und Geschäftsbeziehung | Partner |
Dies gilt sowohl für „Embedded Peppol“ als auch für die White-Label-Plattform. Partner, die die Rolle des Peppol-Dienstanbieters in eigenem Namen wahrnehmen müssen, sollten sich stattdessen mit „Hosted Access Point“ befassen.
Häufig gestellte Fragen
Was bedeutet „Embedded Peppol“ in der Praxis?
Sie bieten Ihren eigenen Kunden Peppol-Anbindung und den normkonformen Austausch von Geschäftsnachrichten an, die über eine API in Ihr Produkt integriert sind. Qvalia betreibt die Peppol-Infrastruktur im Hintergrund. Die Kundenbeziehung und das Angebot liegen in Ihrer Verantwortung.
Müssen wir die Einhaltung der Peppol-Vorgaben selbst sicherstellen?
Nein. Bei „Embedded Peppol“ übernimmt Qvalia die Rolle des Peppol-Dienstanbieters und betreibt den Access Point sowie den SMP. Qvalia ist für die Netzwerksteuerung und die technische Konformität des Dienstes im Peppol-Netzwerk verantwortlich. Sie bleiben weiterhin für Endkundenverträge, Onboarding-Informationen, Preisgestaltung und Support zuständig. Partner, die die Rolle des Dienstanbieters in eigenem Namen übernehmen möchten, sollten „Hosted Access Point“ in Betracht ziehen.
Wie unterstützen Sie Peppol-Setups mit mehreren Mandanten?
Qvalia unterstützt sowohl konsolidierte als auch mandantenfähige Modelle. Sie können mehrere Endkunden in einer gemeinsamen Umgebung verwalten oder für jeden Kunden separate Konten und Peppol-IDs bereitstellen.
Welche Peppol-Nachrichtentypen können wir unseren Nutzern und Endkunden anbieten?
Rechnungen, Gutschriften, Bestellungen, Bestellbestätigungen, Versandbenachrichtigungen, Kataloge und zugehörige Geschäftsnachrichten sowie „ punchout “. Qvalia übernimmt die Validierung, Weiterleitung, Zustellung und Fehlerbehandlung im gesamten Netzwerk. PDF- und EDI-Dateien werden über dieselbe Kontostruktur abgewickelt.
Wie werden Endkunden eingebunden und verwaltet?
Endkunden erhalten beim Onboarding ihre eigenen Peppol-IDs und Routing-Regeln. Qvalia kümmert sich im Hintergrund um die Registrierung der Teilnehmer, die Aktualisierung des Verzeichnisses und die Netzwerkkonfiguration, während Sie den Onboarding-Prozess steuern.
Müssen wir nach eingehenden Dokumenten abfragen?
Nein. Abonnieren Sie Webhook-Ereignisse und Qvalia-Beiträge an Ihren Endpunkt, wenn eine Peppol-Nachricht oder ein Dokument eintrifft, wenn sich deren Zustellstatus ändert und wenn die Zustellung fehlschlägt. Alternativ stehen Polling-Endpunkte zur Verfügung.
Können wir mehr bieten als nur den Austausch von Nachrichten?
Ja. Jede Transaktion steht als strukturierte Daten mit Einzelpostenklassifizierung zur Verfügung. Dadurch können Sie Berichtsfunktionen, Ausgabenanalysen und automatisierte Buchhaltung in Ihr eigenes Produkt integrieren, anstatt lediglich Dokumente zu übertragen. OCR, automatisierte Buchhaltung und die Anreicherung der Klassifizierung sind als Add-ons verfügbar.
Gibt es Ratenbeschränkungen?
Ja. Partnerkonten werden mit Limits eingerichtet, die deutlich über den Standardlimits für Konten liegen, und das Limit wird an Ihr erwartetes Volumen angepasst. Wenn Sie eine umfangreiche Neuanmeldung oder einen besonders arbeitsintensiven Monatsabschluss planen, wenden Sie sich bitte an uns.
Wie schnell können wir loslegen?
Der Zugriff auf die Sandbox ist in der Regel innerhalb weniger Stunden möglich. Der Start in der Produktion hängt von der Integration, den Tests und Ihrem Prozess „ release “ ab.
Wie ist die Integration aufgebaut?
Die Plattform wird über REST-APIs integriert. Die Systemauthentifizierung erfolgt über OAuth 2.0-Client-Anmeldedaten. Das Single-Sign-On (SSO) für Benutzer wird separat über unterstützte Identitätsoptionen konfiguriert. Wenn Sie die Schnittstelle nicht in Ihrem Produkt benötigen, stellt die White-Label-Plattform die Anwendung von Qvalia unter Ihrer Marke bereit.
Alternative Lösungen
Entscheiden Sie sich für die White-Label-Plattform, wenn Sie eine Komplettlösung benötigen, oder für den gehosteten Access Point, wenn Ihr Unternehmen die Rolle des Dienstanbieters übernehmen soll.
Du willst das Produkt, nicht die Version
Die White-Label-Plattform ist die vollständige Anwendung von Qvalia, die unter Ihrer Marke, Ihrer Domain und zu Ihren Preisen bereitgestellt wird. Sie bietet eine vollständige Benutzeroberfläche, ohne dass ein Entwicklungsprojekt erforderlich ist.
Sie müssen als Anbieter in Ihrem eigenen Namen auftreten.
Mit dem „Hosted Access Point“ werden Sie zum zertifizierten Peppol-Dienstleister mit eigener Access-Point-Identität und eigenem PKI-Zertifikat – auf einer von Qvalia betriebenen Infrastruktur.
Kontakt aufnehmen
Integrieren Sie mit Qvalia e-Invoicing, e-Ordering und Datenanreicherung in Ihre Plattform.
Mit unserer Partner-API, fortschrittlichen Verwaltungstools und White-Label-Lösungen können Sie Ihren Endbenutzern ein nahtloses Transaktionsmanagement anbieten.
Arbeiten Sie mit uns zusammen, um die Möglichkeiten Ihrer Plattform zu erweitern und die digitale Transformation voranzutreiben. Kontaktieren Sie uns, um mehr zu erfahren.
Austausch von Geschäftsdokumenten über Peppol, EDI und mehr
KI-gestützte Datenanreicherung auf Einzelpostenebene ermöglichen
Erweitern Sie Ihr Produktangebot und Ihre Benutzerfreundlichkeit