Priebeh objednávania
Objednávka na odoslanie
Objednávky, odpovede, zmeny a zrušenia
Špecifikácie
Špecifikácie Peppol BIS
Iba objednávka, Objednávanie, Pokročilé objednávanie, Dohoda o objednávke
Podujatia
Podpísané webhooky
Prijaté, doručené, oneskorené a neúspešné
Dostupnosť
99,8 % za mesiac
Zmluvné, s kreditmi za služby
Priebeh objednávania cez Peppol v rámci jedného rozhrania API
Kupujúci aj dodávateľ sa pripájajú prostredníctvom svojho vlastného prístupového bodu. Váš systém odosiela a prijíma správy prostredníctvom rozhrania API spoločnosti Qvalia, pričom spoločnosť Qvalia zabezpečuje overovanie, vyhľadávanie príjemcov a doručovanie v sieti Peppol.
Prijmite objednávku a vybavte ju
Ako dodávateľ sa prihláste k odberu webhooku pre nové dokumenty, načítajte neprečítané objednávky a odpovedzte odpoveďou na objednávku. Ako kupujúci odosielajte objednávky na odchádzajúci koncový bod a sledujte odpovede na prichádzajúcom koncovom bode.
- Testovacie prostredie na adrese api-test.qvalia.com, produkčné prostredie na adrese api.qvalia.com
- Štandardne JSON alebo UBL XML s hlavičkami Content-Type a Accept
- Kľúč idempotencie pri každom požiadavku typu POST zabezpečuje bezpečnosť opakovaných pokusov
● ● ●
Sandbox: načítať neprečítané objednávky a potom odpovedať
# 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.jsonPoradie správ a koncových bodov
Každá cesta začína /transaction/{accountRegNo}. Každý typ správy má koncové body pre odosielanie a prijímanie, koncový bod pre neprečítané správy a koncový bod pre stav.
| Správa | Odoslal | Koncový bod | Peppol BIS |
| Objednávka | Kupujúci | /orders | Iba objednávky, Objednávanie, Pokročilé objednávanie |
| Odpoveď na objednávku | Dodávateľ | /orderresponses | Objednávanie, Pokročilé objednávanie |
| Zmena objednávky | Kupujúci | /order-changes | Pokročilé objednávanie |
| Zrušenie objednávky | Kupujúci | /order-cancellations | Pokročilé objednávanie |
| Objednávková zmluva | Dodávateľ | /orderagreements | Objednávková zmluva |
| Katalóg | Dodávateľ | /catalogues | Katalóg |
| Odpoveď na katalóg | Kupujúci | /catalogueresponses | Katalóg s odpoveďou |
| Oznámenie o odoslaní | Dodávateľ | /despatch-advices | Oznámenie o odoslaní |
To, aké správy váš účet používa, závisí od služby a tarifného plánu. Schémy požiadaviek a odpovedí pre každú správu sa nachádzajú v Referenčná príručka k rozhraniu API pre objednávky. Faktúry za dodané objednávky prechádzajú procesom API pre fakturáciu. Ak chcete pred odoslaním skontrolovať, či je príjemca zaregistrovaný na daný typ správy, napríklad Order alebo OrderResponse, použite vyhľadávanie príjemcov.
Vyberte si východiskový bod
Dodávatelia
Správa elektronických objednávok
Prijímajte a odpovedajte na objednávky vo formáte Peppol vo webovej aplikácii Qvalia a premeňte ich na faktúry ešte predtým, ako vytvoríte integráciu.
Platformy pre verejné obstarávanie
Integrovaný Peppol
Odosielajte a prijímajte objednávky pre svojich vlastných zákazníkov. Partner API vytvára ich účty a identifikátory Peppol, zatiaľ čo Order API zabezpečuje prenos správ.
Elektronický obchod
Punchout
Prepojte svoj katalóg so systémom obstarávania kupujúceho, aby sa nákupný košík vrátil ako štruktúrovaná objednávka.
Často kladené otázky k rozhraniu API pre objednávky
Čo je to API pre objednávky?
API pre objednávky umožňuje vášmu systému odosielať a prijímať objednávky a súvisiace správy v štruktúrovanom formáte. API pre objednávky od spoločnosti Qvalia prenáša správy Peppol typu „ BIS ordering “ vo formáte JSON alebo UBL XML a doručuje ich prostredníctvom siete Peppol.
Aké typy objednávkových správ podporuje toto API?
Objednávky, odpovede na objednávky, zmeny objednávok, zrušenia objednávok, dohody o objednávkach, katalógy s odpoveďami na katalógy a oznámenia o odoslaní. Každá z týchto položiek má odchádzajúce a prichádzajúce koncové body.
Aký je rozdiel medzi Peppol BIS Ordering om a Advanced Orderingom?
Objednávanie zahŕňa samotnú objednávku a odpoveď na ňu. Rozšírené objednávanie zahŕňa aj zmeny a zrušenia objednávok, takže kupujúci môže objednávku po jej odoslaní upraviť alebo zrušiť. Prečítajte si články „Čo je Peppol BIS Ordering? “ a „Čo je Peppol BIS Advanced Ordering?“
Môžem prijímať objednávky cez Peppol aj bez integrácie?
Áno. Všetky tarify Connect zahŕňajú prijímanie objednávok cez Peppol vo webovej aplikácii Qvalia. Prístup k API a testovaciemu prostrediu je súčasťou tarify Connect „ Medium “.
Ako zistím, že bola objednávka doručená?
Prihláste sa na odber webhookov pre udalosti týkajúce sa doručenia a chýb alebo si prečítajte stav objednávok prostredníctvom koncového bodu. Akúkoľvek udalosť týkajúcu sa doručenia je možné na základe jej ID udalosti opätovne vyvolať počas 30 dní.
Môže sa objednávka premeniť na faktúru?
Áno. Vo webovej aplikácii Connect je automatizácia procesu od objednávky po faktúru súčasťou balíka „ Medium “. Pri vlastnej integrácii použite údaje z objednávky na vytvorenie faktúry a jej odoslanie prostredníctvom rozhrania API pre fakturáciu.
Je tam pieskovisko?
Áno. Testovacie prostredie na adrese api-test.qvalia.com používa vlastný kľúč API, takže môžete testovať postupy pri zadávaní objednávok bez toho, aby to malo vplyv na skutočné objednávky.
