Bevor Ihr ERP-System oder Ihre Plattform eine Rechnung, einen Auftrag oder ein anderes Peppol-Dokument versendet, kann es bei Qvalia abfragen, ob die „ Peppol ID “ des Empfängers registriert ist und welche Dokumenttypen der Empfänger empfangen kann. Ein Dokument, das an einen Teilnehmer gesendet wird, der dafür nicht registriert ist, wird vom Netzwerk abgelehnt. Durch diese Überprüfung kann Ihr System daher eine fehlende oder falsche „ Peppol ID “ erkennen, bevor etwas versendet wird.
# Account API
GET /account/{accountRegNo}/action/lookup/peppol/{peppolId}
# Partner API
GET /partner/{partnerRegNo}/peppol/lookup/{peppolId}| Konto-API | Partner-API | |
| Verwendet von | Unternehmen, die über ihr eigenes Qvalia-Konto versenden | Plattformen und Dienstleister, die im Auftrag ihrer Kunden versenden |
| Optionaler Filter | docTypeRoot, zum Beispiel Invoice oder CreditNote | docTypeRoot, zum Beispiel Invoice, OrderResponse oder MLR |
| Basis-URLs | Sandkasten api-test.qvalia.com, Produktion api.qvalia.com | Sandkasten api-test.qvalia.com, Produktion api.qvalia.com |
Wann sollte man einen Empfänger überprüfen?
- Wenn ein Kunde in Ihrem System angelegt wird oder sich dessen „ Peppol ID “ ändert
- Wenn ein Benutzer eine „ Peppol ID “ von Hand eingibt
- Bevor Sie ein Dokument versenden, das der Empfänger noch nicht von Ihnen erhalten hat, beispielsweise eine Antwort auf eine Erstbestellung oder eine Gutschrift
Stellen Sie die Anfrage
- Geben Sie den „ Peppol ID “ als Schema und Bezeichner an, getrennt durch einen Doppelpunkt, zum Beispiel
0007:1234567890für eine schwedische Organisationsnummer. - Senden Sie eine GET-Anfrage an den Lookup-Endpunkt, wobei Sie Ihren API-Schlüssel oder ein JWT im
AuthorizationKopfzeile. - Hinzufügen
docTypeRootwenn Sie die Antwort für einen bestimmten Dokumenttyp suchen, der durch sein UBL-Stammelement benannt ist.
GET /account/{accountRegNo}/action/lookup/peppol/0007:1234567890
?docTypeRoot=Invoice
Host: api-test.qvalia.com
Authorization: <your API key>Antwort lesen
| Status | Bedeutung | Was ist zu tun? |
| 200 | Der bei Peppol registrierte Teilnehmer mit den Dokumenttypen, die er empfangen kann | Senden Sie die Nachricht, wenn der von Ihnen benötigte Dokumenttyp aufgeführt ist |
| 422 | Die „ Peppol ID “ hat nicht die richtige Form. scheme:identifier | Korrigiere das Format, zum Beispiel 0007:1234567890 |
| 429 | Zu viele Anfragen für Ihr Konto | Warte so lange, wie die Retry-After Wie in der Kopfzeile angegeben, dann erneut versuchen |
Die Antwort der Partner-API enthält außerdem exists, das angibt, ob der „ Peppol ID “ überhaupt registriert ist, rootDocTypeExists, das angibt, ob es den Dokumenttyp in docTypeRoot, und die Liste der docTypes.
Falls der Empfänger für diesen Dokumenttyp nicht registriert ist, fragen Sie ihn nach seiner korrekten E-Mail-Adresse ( Peppol ID) oder vereinbaren Sie eine andere Art der Zustellung des Dokuments.
Einen einzelnen Empfänger manuell überprüfen
Um ein Unternehmen ohne Integration zu überprüfen, nutzen Sie die Suche unterPeppol ID .
Siehe auch: Peppol SMP und SML · Was ist ein „ Peppol ID “? · Rechnungs-API · API-Referenz