Auftragsfluss
Versandauftrag
Bestellungen, Antworten, Änderungen und Stornierungen
Spezifikationen
Peppol-BIS-Spezifikationen
Nur Bestellung, Bestellung, Erweiterte Bestellung, Bestellvereinbarung
Veranstaltungen
Signierte Webhooks
Erhalten, zugestellt, verspätet und fehlgeschlagen
Verfügbarkeit
99,8 % pro Monat
Vertraglich, mit Leistungsgutschriften
Der Peppol-Bestellablauf in einer API
Käufer und Lieferant stellen jeweils über ihren eigenen Zugangspunkt eine Verbindung her. Ihr System sendet und empfängt die Nachrichten über die API von Qvalia, und Qvalia übernimmt die Validierung, die Empfängersuche und die Zustellung im Peppol-Netzwerk.
Eine Bestellung entgegennehmen und bearbeiten
Als Lieferant abonnieren Sie den Webhook für neue Dokumente, rufen Sie ungelesene Bestellungen ab und senden Sie eine Bestellantwort zurück. Als Käufer senden Sie Bestellungen an den Endpunkt für ausgehende Daten und verfolgen Sie die Antworten über den Endpunkt für eingehende Daten.
- Sandbox unter api-test.qvalia.com, Produktionsumgebung unter api.qvalia.com
- Standardmäßig JSON oder UBL-XML mit den Headern „Content-Type“ und „Accept“
- Ein Idempotenz-Schlüssel bei jedem POST-Aufruf macht Wiederholungsversuche sicher
● ● ●
Sandbox: Ungelesene Aufträge abrufen, dann antworten
# Fetch unread incoming orders (marks them as read)
curl "https://api-test.qvalia.com/transaction/$ACCOUNT_REG_NO/orders/incoming/readorders?limit=10" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Accept: application/json"
# Reply with an order response
curl -X POST \
"https://api-test.qvalia.com/transaction/$ACCOUNT_REG_NO/orderresponses/outgoing" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d @order-response.jsonReihenfolge von Nachrichten und Endpunkten
Jeder Weg beginnt mit /transaction/{accountRegNo}. Jeder Nachrichtentyp verfügt über Endpunkte für ausgehende und eingehende Nachrichten, einen Endpunkt zum Abrufen ungelesener Nachrichten sowie einen Status-Endpunkt.
| Nachricht | Gesendet von | Endpunkt | Peppol BIS |
| Bestellung | Käufer | /orders | Nur Bestellung, Bestellung, Erweiterte Bestellung |
| Bestellbestätigung | Lieferant | /orderresponses | Bestellung, Erweiterte Bestellung |
| Bestelländerung | Käufer | /order-changes | Erweiterte Bestellung |
| Stornierung der Bestellung | Käufer | /order-cancellations | Erweiterte Bestellung |
| Auftragsvereinbarung | Lieferant | /orderagreements | Auftragsvereinbarung |
| Katalog | Lieferant | /catalogues | Katalog |
| Antwort auf den Katalog | Käufer | /catalogueresponses | Katalog mit Rückmeldung |
| Versandhinweise | Lieferant | /despatch-advices | Versandbenachrichtigung |
Welche Nachrichten Ihr Konto verwendet, hängt vom Dienst und vom Tarif ab. Die Anfrage- und Antwortschemas für die einzelnen Nachrichten finden Sie in der Referenz zur Bestell-API. Rechnungen für ausgelieferte Bestellungen werden über die Rechnungs-API abgewickelt.
Wählen Sie Ihren Ausgangspunkt
Lieferanten
E-Auftragsverwaltung
Empfangen und beantworten Sie Peppol-Aufträge in der Webanwendung von Qvalia und wandeln Sie diese in Rechnungen um, bevor Sie eine Integration einrichten.
Beschaffungsplattformen
Integriertes Peppol
Senden und empfangen Sie Bestellungen für Ihre eigenen Kunden. Die Partner-API legt deren Konten und Peppol-IDs an, und die Order-API übermittelt die Nachrichten.
E-Commerce
Punchout
Verbinden Sie Ihren Katalog mit dem Beschaffungssystem des Einkäufers, damit der Warenkorb als strukturierte Bestellung zurückkommt.
Häufig gestellte Fragen zur Bestell-API
Was ist eine Bestell-API?
Über eine Bestell-API kann Ihr System Bestellungen und die damit verbundenen Nachrichten in einem strukturierten Format senden und empfangen. Die Bestell-API von Qvalia überträgt Peppol-Nachrichten vom Typ „ BIS ordering “ als JSON oder UBL-XML und leitet sie über das Peppol-Netzwerk weiter.
Welche Bestellmeldungen unterstützt die API?
Bestellungen, Bestellbestätigungen, Bestelländerungen, Bestellstornierungen, Bestellvereinbarungen, Kataloge mit Katalogantworten und Versandbenachrichtigungen. Jede davon verfügt über Endpunkte für den ausgehenden und den eingehenden Datenverkehr.
Was ist der Unterschied zwischen Peppol- BIS Ordering s und „Advanced Ordering“?
Der Begriff „Bestellung“ umfasst die Bestellung selbst und die Bestellbestätigung. Der Begriff „Erweiterte Bestellung“ umfasst zusätzlich Bestelländerungen und Stornierungen, sodass der Käufer eine Bestellung nach dem Absenden ändern oder stornieren kann. Lesen Sie dazu die Artikel „Was ist Peppol BIS Ordering?“ und „Was ist Peppol BIS Advanced Ordering?“.
Kann ich Peppol-Aufträge auch ohne Integration empfangen?
Ja. Alle Connect-Tarife umfassen den Empfang von Peppol-Aufträgen in der Webanwendung von Qvalia. Der Zugriff auf die API und die Sandbox ist ab dem Connect- Medium -Tarif enthalten.
Woran erkenne ich, dass eine Bestellung zugestellt wurde?
Abonnieren Sie Webhooks für Zustell- und Fehlerereignisse oder rufen Sie den Status-Endpunkt für Bestellungen ab. Jedes Zustellereignis kann 30 Tage lang anhand seiner Ereignis-ID erneut abgerufen werden.
Kann aus einer Bestellung eine Rechnung werden?
Ja. In der Connect-Webanwendung ist die Automatisierung vom Auftrag bis zur Rechnung ab dem „ Medium “-Tarif enthalten. Verwenden Sie bei Ihrer eigenen Integration die Auftragsdaten, um die Rechnung zu erstellen und über die Rechnungs-API zu versenden.
Gibt es eine Sandkiste?
Ja. Die Sandbox unter api-test.qvalia.com verwendet einen eigenen API-Schlüssel, sodass Sie Bestellabläufe testen können, ohne dass dies Auswirkungen auf Live-Bestellungen hat.
