Sandbox a produkce
Redque provozuje pro partnery dvě prostředí. Mají stejné API, stejnou validaci a chovají se stejně — liší se tím, zda dokumenty míří do skutečné sítě Peppol.
| Sandbox | Produkce | |
|---|---|---|
| Účel | Vývoj a testování integrace | Skutečné faktury mezi skutečnými firmami |
| Partner API | https://partnerapi-sandbox.peppol.redque.comSwagger UI | https://partnerapi.peppol.redque.comSwagger UI |
| Document API | https://api-sandbox.peppol.redque.comSwagger UI | https://api.peppol.redque.comSwagger UI |
| API klíče | rqp_sandbox_…, rqe_sandbox_… | rqp_prod_…, rqe_prod_… |
| Síť Peppol | Žádná: uzavřená síť účastníků sandboxu | Síť Peppol |
| Komu můžete posílat | Jen účastníkům sandboxu; vše ostatní skončí Failed | Každému účastníkovi Peppol, který daný typ dokumentu přijímá |
| Kdo může posílat vašim koncovým uživatelům | Ostatní účastníci sandboxu | Kdokoli v síti Peppol |
| Právní a daňové účinky | Žádné | Dokumenty jsou skutečné faktury |
| Vyhledání účastníka | Jen účastníci sandboxu; hledání podle názvu není k dispozici | Celá síť a hledání podle názvu v Peppol Directory |
| Zápis do Peppol Directory | Přijme se, ale nic se nezveřejní | Zveřejní se na directory.peppol.eu |
| Obsluhované země | Česko, Slovensko | Česko. Slovensko |
Sandbox
Sandbox je úplná platforma Redque s vlastním přístupovým bodem a SMP, která není napojena na nic dalšího. Účastníci, které v něm zaregistrujete, jsou zveřejněni jen v sandboxu: žádná firma mimo něj je nenajde ani jim nic nepošle, a nic z toho, co odešlete, sandbox neopustí.
Pro získání přístupu do sandbox prostředí nás kontaktujte na adrese info@redque.cz.
Co funguje stejně jako v produkci
- Všechny endpointy obou API, se stejným formátem požadavků a odpovědí, stavovými kódy i chybovými hláškami.
- Validace. Dokumenty se ověřují podle stejných pravidel OpenPeppol, takže faktura přijatá v sandboxu projde i v produkci.
- Převody formátů. ISDOC, UBL a JSON se převádějí přesně jako v produkci, oběma směry.
- Životní cyklus účastníků (
SmpRegistered → Live, pozastavení, obnovení, odregistrace) i přenosů (Queued → … → Delivered). - Webhooky se stejnými událostmi, podpisy a opakováním.
- API klíče včetně dvou slotů, platnosti a samoobslužné rotace e-mailovým kódem.
Co je jinak
- Posíláte sami sobě. Pro vyzkoušení celé výměny založte druhého koncového uživatele v roli odběratele a posílejte mezi nimi — jako v návodu Začínáme. Dokument adresovaný účastníkovi, který v sandboxu zaregistrován není, nelze doručit a skončí ve stavu
Failed. - Identifikátory účastníků jsou jedinečné jen v rámci sandboxu. Registrace v sandboxu identifikátor v síti Peppol nerezervuje a identifikátor registrovaný u jiného poskytovatele lze v sandboxu zaregistrovat také. Můžete použít skutečné identifikátory svých zákazníků i smyšlené, které odpovídají formátu schématu.
- Vyhledání účastníka najde jen účastníky sandboxu. Hledání podle názvu firmy nevrátí žádné výsledky a pole
notesuvede, že není k dispozici. - Peppol Directory: souhlas se zápisem se uloží a API se chová normálně, ale nic se nezveřejní.
- Slovenští koncoví uživatelé. Daňové datové dokumenty (Tax Data Documents) se vytvoří, zvalidují a odešlou jako v produkci. Místo daňového úřadu je přijme simulovaný úřad v sandboxu: hlášení potvrdí (
Accepted), nebo odmítne (Rejected), pokud číslo nahlášené faktury začíná naRE-. Tak si vyzkoušíte i opravy a zrušení hlášení.
Dokumenty v sandboxu nemají žádné právní ani daňové účinky. Nepoužívejte ho k výměně skutečných faktur.
Produkce
V produkci je Redque přístupovým bodem Peppol vašich koncových uživatelů: jejich účastníci jsou registrováni v Peppol SML, ostatní poskytovatelé jim doručují dokumenty a faktury, které odešlete, dostanou jejich příjemci a jsou právně závazné.
Přechod do produkce
Prostředí nesdílejí nic kromě API. Nic z toho, co vytvoříte v sandboxu, se do produkce nepřenáší: koncové uživatele, účastníky, klíče koncových uživatelů, odběry webhooků i dokumenty je třeba vytvořit znovu.
- Udělejte prostředí konfigurovatelným.API klíč funguje jen v prostředí, které ho vydalo — druhé odpoví
401s uvedením prostředí, kam klíč patří. - Vyžádejte si produkční partnerský klíč od Redque. Druhý klíč si do slotu 2 můžete vydat sami.
- Vytvořte odběry webhooků s produkčním endpointem a novým secretem.