Než váš ERP systém nebo platforma odešle fakturu, objednávku či jiný dokument ve formátu Peppol, může se dotázat systému Qvalia, zda je adresa „ Peppol ID “ příjemce zaregistrována a jaké typy dokumentů může příjemce přijímat. Dokument odeslaný účastníkovi, který není pro daný typ dokumentu zaregistrován, je sítí odmítnut, takže díky této kontrole může váš systém odhalit chybějící nebo nesprávnou adresu „ Peppol ID “ ještě před odesláním.
# Account API
GET /account/{accountRegNo}/action/lookup/peppol/{peppolId}
# Partner API
GET /partner/{partnerRegNo}/peppol/lookup/{peppolId}| API účtu | Partnerské API | |
| Používá se v | Společnosti, které odesílají zásilky ze svého vlastního účtu Qvalia | Platformy a poskytovatelé služeb, kteří zasílají jménem svých zákazníků |
| Volitelný filtr | docTypeRoot, například Invoice nebo CreditNote | docTypeRoot, například Invoice, OrderResponse nebo MLR |
| Základní URL adresy | Pískoviště api-test.qvalia.com, výroba api.qvalia.com | Pískoviště api-test.qvalia.com, výroba api.qvalia.com |
Kdy zkontrolovat příjemce
- Když je ve vašem systému vytvořen nový zákazník nebo dojde ke změně jeho Peppol ID
- Když uživatel ručně zadá adresu Peppol ID
- Než odešlete dokument, který příjemce od vás dosud neobdržel, například odpověď na první objednávku nebo dobropis,
Podat žádost
- Zadejte adresu Peppol ID ve formátu, kde je schéma a identifikátor odděleny dvojtečkou, například
0007:1234567890pro švédské identifikační číslo organizace. - Odešlete požadavek GET na koncový bod vyhledávání s vaším klíčem API nebo JWT v poli
Authorizationzáhlaví. - Přidat
docTypeRootpokud chcete znát odpověď pro jeden typ dokumentu, označený podle jeho kořenového prvku UBL.
GET /account/{accountRegNo}/action/lookup/peppol/0007:1234567890
?docTypeRoot=Invoice
Host: api-test.qvalia.com
Authorization: <your API key>Přečtěte si odpověď
| Stav | Význam | Co dělat |
| 200 | Účastník registrovaný v systému Peppol s typy dokumentů, které může přijímat | Odešlete, pokud je v seznamu uveden typ dokumentu, který potřebujete |
| 422 | Peppol ID a není ve formuláři scheme:identifier | Opravte formát, například 0007:1234567890 |
| 429 | Příliš mnoho požadavků na váš účet | Počkejte tak dlouho, jak Retry-After jak uvádí záhlaví, pak to zkus znovu |
Odpověď rozhraní Partner API dále obsahuje exists, což ukazuje, zda je služba „ Peppol ID “ vůbec zaregistrována, rootDocTypeExists, který udává, zda dokáže přijmout daný typ dokumentu v docTypeRoot, a seznam docTypes.
Pokud příjemce není pro daný typ dokumentu zaregistrován, požádejte ho o správnou adresu Peppol ID nebo se dohodněte na jiném způsobu doručení dokumentu.
Ručně zkontrolujte jednoho příjemce
Chcete-li vyhledat jednu společnost bez integrace, použijte vyhledávání na stráncePeppol ID .
Související témata: Peppol SMP a SML · Co je to „ Peppol ID “ · Fakturační API · Referenční příručka k API