Průběh objednávky
Objednávka k odeslání
Objednávky, odpovědi, změny a zrušení
Specifikace
Specifikace Peppol BIS
Pouze objednávka, Objednávka, Pokročilá objednávka, Smlouva o objednávce
Události
Podepsané webhooky
Přijato, doručeno, zpožděno a neúspěšné
Dostupnost
99,8 % za měsíc
Smluvní, s kreditními body za služby
Průběh objednávky v systému Peppol v rámci jedné API
Odběratel i dodavatel se připojují každý přes svůj vlastní přístupový bod. Váš systém odesílá a přijímá zprávy prostřednictvím API služby Qvalia, přičemž Qvalia zajišťuje ověření, vyhledání příjemce a doručení v síti Peppol.
Přijmout objednávku a vyřídit ji
Jako dodavatel se přihlaste k odběru webhooku pro nové dokumenty, načtěte nečtené objednávky a odešlete odpověď s potvrzením objednávky. Jako odběratel odesílejte objednávky na odchozí koncový bod a sledujte odpovědi na příchozím koncovém bodě.
- Testovací prostředí na adrese api-test.qvalia.com, produkční prostředí na adrese api.qvalia.com
- Ve výchozím nastavení JSON, případně UBL XML s hlavičkami Content-Type a Accept
- Idempotentní klíč u každého požadavku POST zajišťuje bezpečnost opakovaných pokusů
● ● ●
Sandbox: načíst nepřečtené objednávky a poté odpovědět
# 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.jsonSeřazování zpráv a koncových bodů
Každá cesta začíná /transaction/{accountRegNo}. Každý typ zprávy má odchozí a příchozí koncové body, koncový bod pro čtení nepřečtených zpráv a koncový bod pro stav.
| Zpráva | Odeslal | Koncový bod | Peppol BIS |
| Objednávka | Kupující | /orders | Pouze objednávky, Objednávání, Pokročilé objednávání |
| Odpověď na objednávku | Dodavatel | /orderresponses | Objednávání, pokročilé objednávání |
| Změna objednávky | Kupující | /order-changes | Pokročilé objednávání |
| Zrušení objednávky | Kupující | /order-cancellations | Pokročilé objednávání |
| Objednávková smlouva | Dodavatel | /orderagreements | Objednávková smlouva |
| Katalog | Dodavatel | /catalogues | Katalog |
| Odpověď na katalog | Kupující | /catalogueresponses | Katalog s odpovědí |
| Oznámení o odeslání | Dodavatel | /despatch-advices | Oznámení o odeslání |
To, jaké zprávy váš účet používá, závisí na službě a tarifu. Schémata požadavků a odpovědí pro jednotlivé zprávy najdete v referenční příručce k API pro objednávky. Faktury za doručené objednávky se zpracovávají prostřednictvím API pro fakturaci.
Vyberte si výchozí bod
Dodavatelé
Správa elektronických objednávek
Přijímejte a vyřizujte objednávky ve formátu Peppol ve webové aplikaci Qvalia a převádějte je na faktury ještě předtím, než vytvoříte integraci.
Nákupní platformy
Integrovaný Peppol
Odesílejte a přijímejte objednávky pro své vlastní zákazníky. Partner API vytváří jejich účty a identifikátory Peppol a Order API zajišťuje přenos zpráv.
Elektronický obchod
Punchout
Propojte svůj katalog s nákupním systémem odběratele, aby se obsah nákupního košíku převedl do strukturované objednávky.
Často kladené otázky k API pro objednávky
Co je to API pro objednávky?
API pro objednávky umožňuje vašemu systému odesílat a přijímat objednávky a související zprávy ve strukturovaném formátu. API pro objednávky od společnosti Qvalia přenáší zprávy Peppol typu „ BIS ordering “ ve formátu JSON nebo UBL XML a doručuje je prostřednictvím sítě Peppol.
Jaké typy objednávkových zpráv API podporuje?
Objednávky, odpovědi na objednávky, změny objednávek, zrušení objednávek, dohody o objednávkách, katalogy s odpověďmi na katalogy a avíza o odeslání. Každá z těchto položek má odchozí a příchozí koncové body.
Jaký je rozdíl mezi službami Peppol „ BIS Ordering “ a „Advanced Ordering“?
Pojem „objednávka“ zahrnuje samotnou objednávku i odpověď na ni. Pojem „pokročilé objednávání“ zahrnuje navíc změny a zrušení objednávek, takže kupující může objednávku po jejím odeslání upravit nebo zrušit. Přečtěte si články „Co je Peppol BIS Ordering? “ a „Co je Peppol BIS Advanced Ordering?“
Mohu přijímat objednávky přes Peppol i bez integrace?
Ano. Všechny tarify Connect zahrnují příjem objednávek přes Peppol ve webové aplikaci Qvalia. Přístup k API a testovacímu prostředí je zahrnut již v tarifu Connect „ Medium “.
Jak poznám, že byla objednávka doručena?
Přihlaste se k odběru webhooků pro události týkající se doručení a chyb, nebo si zkontrolujte stav objednávek pomocí koncového bodu pro stav. Jakoukoli událost týkající se doručení lze po dobu 30 dnů znovu načíst pomocí jejího ID události.
Může se objednávka proměnit ve fakturu?
Ano. Ve webové aplikaci Connect je automatizace procesu od objednávky po fakturu součástí tarifu „ Medium “. Ve vaší vlastní integraci použijte údaje z objednávky k vytvoření faktury a odešlete ji prostřednictvím rozhraní API pro fakturaci.
Je tam pískoviště?
Ano. Testovací prostředí na adrese api-test.qvalia.com používá vlastní klíč API, takže můžete testovat postupy při zadávání objednávek, aniž by to mělo vliv na skutečné objednávky.
