Redque Peppol dokumentace
Napojte svůj účetní nebo fakturační software na síť Peppol přes Redque a posílejte a přijímejte elektronické faktury. API podporuje formáty ISDOC, UBL nebo JSON.
Redque s.r.o. je certifikovaný AP (Access Point) a SMP (Service Metadata Publisher) poskytovatel v síti Peppol.
Architektura
Redque provozuje vlastní certifikovaný přístupový bod (Access Point) i vlastní SMP v síti Peppol. Redque Peppol je určený pro partnery — typicky dodavatele softwaru. Vaši zákazníci jsou koncoví uživatelé (End Users): firmy, které faktury skutečně posílají a přijímají. Každý koncový uživatel má jednoho nebo více účastníků (participants), který má svou adresu v síti Peppol, například 9929:CZ12345678 (české DIČ).
K dispozici jsou dvě API, každé s vlastním druhem API klíče:
| Partner API | Document API | |
|---|---|---|
| Slouží k | Nastavení: koncoví uživatelé, účastníci, API klíče koncových uživatelů, webhooky | Výměně dokumentů: odeslání, stav, schránka, vyhledání příjemce |
| Jedná jako | Vy, partner, za všechny své koncové uživatele | Jeden koncový uživatel, jen za své vlastní účastníky |
| Klíč | Partnerský klíč rqp_…, vydává Redque | Klíč koncového uživatele rqe_…, vydáváte vy přes Partner API |
| Sandbox | https://partnerapi-sandbox.peppol.redque.comSwagger UI | https://api-sandbox.peppol.redque.comSwagger UI |
| Produkce | https://partnerapi.peppol.redque.comSwagger UI | https://api.peppol.redque.comSwagger UI |
Integraci vyvíjejte a testujte v sandboxu. Do produkce přejdete změnou adres a API klíčů — rozhraní je v obou prostředích stejné. Viz Sandbox a produkce.
Pro získání přístupu do sandbox prostředí nás kontaktujte na adrese info@redque.cz.
Které aspekty Redque Peppol řeší
- Formáty. Posílejte ISDOC 6.0.2, UBL podle Peppol BIS Billing 3.0 nebo JSON. Redque dokument převede na Peppol BIS Billing 3.0 UBL a přijaté dokumenty vám vrátí ve formátu, o který si řeknete.
- Validace. Každý dokument se ověří podle oficiálních pravidel OpenPeppol přímo v rámci požadavku. Nevalidní faktura je odmítnuta okamžitě i s úplným protokolem validace, ne až po několika minutách.
- Doručení. Vyhledání příjemce, podpis, šifrování a přenos AS4, včetně automatického opakování, když je přístupový bod příjemce dočasně nedostupný.
- Adresace. Registrace účastníků vašich koncových uživatelů v SMP a v Peppol SML, volitelně i zápis do Peppol Directory.
- Auditní stopa. Přijaté i odesílané dokumenty jsou uchovány v trvalém neměnitelném uložišti dle certifikace OpenPeppol.
- Specifická pravidla jednotlivých zemí. Požadavky národních Peppol autorit v zemích, které Redque obsluhuje, uplatněné podle země sídla koncového uživatele (například povinný reporting Finanční správě SR při fakturaci na Slovensku).
Konvence
- Obě API používají JSON přes HTTPS, verze je součástí cesty (
/v1/…). - Autentizace probíhá hlavičkou
X-Api-Key. - Chyby mají formát RFC 9457 problem details: důvod najdete v poli
detail. Texty chyb jsou anglicky. - Prostředky jiného partnera nebo koncového uživatele vrací vždy
404, nikdy403. - Každé API publikuje svůj OpenAPI dokument na
/openapi/v1.jsona interaktivní Swagger UI na/swagger.