PeppolDokumentace pro partnery Swagger UI: sandbox · produkce

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.

Peppol Access Point – Certified Provider

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 APIDocument API
Slouží kNastavení: koncoví uživatelé, účastníci, API klíče koncových uživatelů, webhookyVýměně dokumentů: odeslání, stav, schránka, vyhledání příjemce
Jedná jakoVy, partner, za všechny své koncové uživateleJeden koncový uživatel, jen za své vlastní účastníky
KlíčPartnerský klíč rqp_…, vydává RedqueKlíč koncového uživatele rqe_…, vydáváte vy přes Partner API
Sandboxhttps://partnerapi-sandbox.peppol.redque.com
Swagger UI
https://api-sandbox.peppol.redque.com
Swagger UI
Produkcehttps://partnerapi.peppol.redque.com
Swagger UI
https://api.peppol.redque.com
Swagger 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, nikdy 403.
  • Každé API publikuje svůj OpenAPI dokument na /openapi/v1.json a interaktivní Swagger UI na /swagger.