Roger

Integrace s platformou Roger umožňuje automatický export přijatých faktur z Alice do systému Roger prostřednictvím REST API. Integrace je jednosměrná -- data putují pouze z Alice do Rogeru, žádný zpětný import ani synchronizace číselníků neprobíhá.

Jak to funguje?

Po označení dokumentu k exportu (stav K exportu) Alice odešle přijatou fakturu přes REST API do platformy Roger. Před odesláním se ověří, že se jedná o přijatou českou fakturu, a získá se přístupový token z autentikačního serveru Rogeru. Nejprve se odešle hlavička faktury, poté případné položky a nakonec se nahrají soubory (hlavní dokument a přílohy). Po úspěšném exportu se v Alici doklad přesune do stavu Exportovaný a uloží se identifikátor faktury přidělený Rogerem. Při chybě skončí ve stavu Chyba -- viz Diagnostika. Přehled všech stavů viz Stavy dokumentů.

Schéma datového toku

graph LR
    A[Alice] -->|faktura| B[Roger]
    B -.->|identifikátor faktury| A

Jednosměrný přenos

Roger neposílá zpět do Alice žádná stavová data. Po exportu Alice obdrží pouze identifikátor faktury, pod kterým ji následně dohledáte přímo v Rogeru.

Podporované verze a předpoklady

Oblast	Požadavek
Platforma	Roger
Legislativa	Pouze česká
Autentizace	OAuth 2.0 Client Credentials -- Client Id + Client Secret přidělené Rogerem
Síť	Autentikační i účetní API Rogeru musí být dosažitelné z cloudu Alice
Můstek	Není potřeba -- integrace probíhá přímo přes API

Podporované typy dokumentů

Typ dokumentu	Podpora	Popis
Přijaté faktury (CZ)	Podporováno	České faktury přijaté od dodavatelů
Vydané faktury	Nepodporováno	--
Slovenské faktury	Nepodporováno	--
Účtenky	Nepodporováno	--
Dobropisy	Nepodporováno	--
Objednávky	Nepodporováno	--

Pouze přijaté české faktury

Pokusíte-li se exportovat jiný typ dokumentu (vydanou fakturu, účtenku, slovenskou fakturu apod.), export selže.

Vytvoření integrace

V nastavení na kartě Integrace přidejte Roger.

Podrobný postup, jak vytvořit integraci pro účetní systémy, naleznete v části integrace.

Konfigurace

Po výběru typu exportu Roger vyplňte následující pole. Hodnoty pro autentizaci (Client Id a Client Secret) i adresy API získáte od poskytovatele platformy Roger.

Pole	Popis	Povinné
Url autentikačního API	Základní URL adresa autentikačního serveru Rogeru. Používá se pro získání přístupového tokenu před každým exportem.	Ano
Url účetního API	Základní URL adresa REST API Rogeru, na které se posílají faktury, položky a přílohy.	Ano
Client Id	Identifikátor klientské aplikace přidělený Rogerem. Slouží k autentizaci.	Ano
Client Secret	Tajný klíč klientské aplikace přidělený Rogerem. Spolu s Client Id slouží k získání přístupového tokenu.	Ano
Emailová adresa pro notifikace při chybě exportu	E-mailová adresa, na kterou systém zašle upozornění při neúspěšném exportu.	Ne

Autentizace

Připojení využívá OAuth 2.0 (Client Credentials). Před každým exportem si Alice automaticky vyžádá z autentikačního serveru Rogeru přístupový token pomocí Client Id a Client Secret. Autentikační a účetní API mají oddělené URL adresy -- vyplňte obě.

Nastavení uložte.

Průběh exportu

Při exportu přijaté faktury do Rogeru probíhají následující kroky:

Spustíte export přijaté faktury z Alice.
Alice ověří, že se jedná o přijatou českou fakturu. Jiné typy dokumentů nejsou podporovány a export selže.
Alice si vyžádá přístupový token z autentikačního serveru Rogeru.
Odešle se hlavička faktury. Roger v odpovědi vrátí unikátní identifikátor faktury.
Pokud faktura obsahuje položky, odešlou se samostatně.
Nahraje se hlavní dokument (sken faktury) a všechny přílohy.
Export se označí jako úspěšný a uloží se identifikátor faktury z Rogeru.

Nahrání příloh je nepovinné pro úspěch exportu

Selhání nahrání příloh nezpůsobí selhání celého exportu -- faktura je v Rogeru vytvořena a chyba se pouze zaznamená jako varování. Chybějící přílohu lze v případě potřeby doplnit přímo v Rogeru.

Přenášená data

Hlavička faktury

Údaj	Poznámka
IČO a DIČ kupujícího a prodávajícího	Roger vyžaduje alespoň jedno z IČO nebo DIČ
Měna	--
Číslo faktury	--
Celková částka	--
Datum vystavení	--
Datum splatnosti	--
Datum zdanitelného plnění	--
Variabilní symbol	--
Bankovní spojení	Číslo účtu + kód banky, nebo IBAN + BIC

Položky faktury

Pokud faktura obsahuje položky, přenášejí se následující údaje:

Údaj položky	Poznámka
Název	--
Kód	--
Množství	--
Jednotka	--
Cena za jednotku bez DPH	--
Celková cena bez DPH	--
Cena po slevě	--
Výše DPH	--
Sazba DPH	v %

Přílohy

K faktuře se nahrávají všechny soubory -- hlavní dokument (sken faktury) i další přílohy.

Vlastnost	Hodnota
Limit velikosti	3 MB na jeden soubor
Podporované formáty	PDF, PNG, JPG, XLSX

Po úspěšném exportu

Po úspěšném exportu do Rogeru:

Dokument v Alici se přesune do stavu Exportovaný.
Uloží se identifikátor faktury přidělený Rogerem.
Fakturu následně dohledáte a spravujete přímo v platformě Roger.

Diagnostika

Při chybě se dokument v Alici přesune do stavu error Chyba s detailem v náhledu. Nejčastější příčiny chyb:

Nepodporovaný typ dokumentu

Příčina: Dokument není přijatá česká faktura (např. vydaná faktura, účtenka nebo slovenská faktura).

Řešení: Do Rogeru lze exportovat pouze přijaté české faktury. Ostatní typy dokumentů nejsou podporovány.

Chyba autentizace

Příčina: Neplatné Client Id nebo Client Secret, případně nesprávná Url autentikačního API.

Řešení: Zkontrolujte hodnoty Client Id, Client Secret a Url autentikačního API v nastavení integrace. V případě potřeby si vyžádejte nové přihlašovací údaje od poskytovatele Rogeru.

Chybí IČO i DIČ subjektu

Příčina: Roger vyžaduje pro identifikaci kupujícího a prodávajícího alespoň jedno z IČO nebo DIČ.

Řešení: Doplňte v detailu dokumentu IČO nebo DIČ příslušného subjektu a export opakujte.

Příloha se nenahrála

Příčina: Soubor překračuje limit 3 MB nebo má nepodporovaný formát.

Řešení: Faktura samotná je v Rogeru vytvořena -- selhání přílohy je pouze varování a nebrání úspěchu exportu. Přílohu lze doplnit ručně v Rogeru. Ověřte, že soubor nepřekračuje 3 MB a má podporovaný formát (PDF, PNG, JPG, XLSX).

Časté dotazy | FAQ

Jaké dokumenty můžu do Rogeru exportovat?

Pouze přijaté české faktury. Vydané faktury, účtenky, slovenské faktury, dobropisy ani jiné typy dokumentů exportovat nelze.

Posílá Roger nějaká data zpět do Alice?

Ne. Integrace je jednosměrná. Po exportu Alice obdrží pouze identifikátor faktury, žádná stavová data se zpět nepřenášejí. Synchronizace číselníků není podporována.

Co se stane, když se nepodaří nahrát příloha?

Selhání nahrání přílohy nezpůsobí selhání celého exportu. Faktura je v Rogeru vytvořena a chyba se zaznamená pouze jako varování. Chybějící přílohu lze doplnit přímo v Rogeru.

Jaký je limit velikosti příloh?

Maximálně 3 MB na jeden soubor. Podporované formáty jsou PDF, PNG, JPG a XLSX.

Proč se moje faktura nevyexportovala do Rogeru?

Zkontrolujte následující:

Dokument je přijatá česká faktura (jiné typy nejsou podporovány)
Máte správně vyplněné Client Id, Client Secret, Url autentikačního API a Url účetního API
Kupující i prodávající mají vyplněné alespoň jedno z IČO nebo DIČ

Musím vyplnit dvě různé URL adresy?

Ano. Roger má oddělené URL pro autentizaci (Url autentikačního API) a pro odesílání faktur (Url účetního API). Vyplňte obě.