Přeskočit na hlavní obsah

Integrace na Premier - API integrace

Postup pro API integraci Wflow a účetního systému Premier

Autor: Ondřej Krejčí

1. Přehled integrace

Konektor zajišťuje automatický přenos dokladů z Wflow do účetního systému Premier.

Konektor v tuto chvíli řeší přijaté, vydané faktury a účtenky.

2. Co je potřeba zajistit na straně Premieru

  • Aktivace API v Premieru

Premier API musí být aktivováno pro danou účetní jednotku. Klient to ověří u podpory Premier nebo v administraci.

Potvrzení od Premier podpory vypadá takto:

'PREMIER API je aktivován pro Vaši účetní jednotku. Další informace pro vývojáře včetně veškerých API příkazů naleznete v manuálu k PREMIER API.'

Odkaz na návod nastavení API:

  • Povolení IP adres Wflow na serveru Premier

Na straně Premier serveru musí být povoleny tyto IP adresy, ze kterých Wflow přistupuje k API:

  • 80.95.100.18

  • 54.78.26.19

  • 54.246.201.85

Pokud je Premier provozován na outsourcovaném serveru (klient nemá admin přístup – pouze uživatelský RDP), je nutné konfiguraci IP adres zařídit přes podporu Premier.

  • Přihlašovací údaje pro napojení konektoru

Wflow ke konfiguraci konektoru potřebuje od klienta tyto 4 údaje:

Parametr

Příklad / formát

Poznámka

URL serveru + port

Adresa Premier API včetně portu – klient získá od podpory Premier

ID účetní jednotky (ID_UJ)

552B6F46-7288-41C1-95F2-...

GUID formát, klient získá od podpory Premier

Uživatelské jméno

WFLOW

Uživatel v Premieru s oprávněním k API přístupu (ne RDP login)

Heslo

– předáno bezpečně –

Heslo k API uživateli – sdělit až na schůzce nebo přes SMS

Heslo a citlivé údaje předávejte vždy na schůzce nebo přes SMS – ne volným emailem.

3. Nastavení konektoru – co vyplnit

  • Přehled všech voleb

Nastavení

Doporučená hodnota

Poznámka

Vydané faktury – číslování

Podle klienta

Pouze pokud vydané faktury přes konektor budete využívat. Lze nastavit číslo z Premieru nebo přepsat číslem z Wflow.

Auditováno

Podle klienta

Pokud příkazy generujete ve Wflow (ne přímo v Premieru), audit nehraje roli. Manuální auditace pak probíhá v Premieru.

Volitelná pole

Podle klienta

Lze nastavit v budoucnu, pokud bude potřeba přenášet další informace.

4. Číselníky v Premieru

Premier je hlavní zdroj pravdy pro číselníky (střediska, zakázky, dokladové řady, účtová osnova).

Veškeré číselníky se synchronizují z Premieru do Wflow (ne naopak). Před spuštěním je nutné mít v Premieru připraveno:

  • Dokladové řady pro přijaté faktury

  • Účtová osnova (předkontace)

  • Střediska a zakázky (pokud jsou používány)

Synchronizace číselníků probíhá automaticky každou noc. Pro okamžitou ruční aktualizaci kontaktujte podporu Wflow přes modrou bublinu v aplikaci.

5. Povinné pole

  • Dokladová řada

Dokladová řada určuje, do které agendy v Premieru doklad poputuje. Je nutné ji nastavit pro každý typ dokumentu. Dostupné dokladové řady se načítají přímo z Premieru.

Dokladová řada musí odpovídat typu faktury. Příklad: zálohová faktura musí mít dokladovou řadu pro zálohy – pokud přiřadíte řadu pro běžné faktury, konektor odeslání zablokuje a vypíše chybu.

  • Datumová pole – wflow - Premier

  • Datum případu → Deník a náklady

  • UZP (uskutečnění zdanitelného plnění) → Kontrolní hlášení

  • Datum přijetí → DPH

  • Kódy DPH

Kódy DPH

Výchozí (automaticky)

Systém nastaví automaticky: 09 = 0 %, 14 = 14 %, 15 = 21 %. Lze ručně přepsat na řádku dokladu.

Zálohy – jak nastavit správně

Pokud přijímáte zálohové faktury a v Premieru používáte účet 314 (přijaté zálohy), postupujte takto:

  • Typ faktury ve Wflow nastavte jako Daňový doklad (nebo odpovídající typ pro zálohy)

  • Dokladová řada musí odpovídat – vyberte řadu určenou pro zálohy v Premieru

Pokud na zálohové faktuře vyberete řadu pro běžné faktury (nebo naopak), konektor odeslání zablokuje. Systém kontroluje shodu typu dokladu a dokladové řady.

Přenášení odkazu do wflow a příloh

  • Pouze u přijatých faktur přenášíme odkaz. Kvůli technickému omezení API Premier nepřenášíme přílohy u všech agend a odkazy u vydaných faktur a účtenek

6. Průběh odeslání dokladu do Premieru

  • Stavy dokladů

Stav

Význam

🟠 Oranžový ERP

Doklad byl odeslán do Premieru, čeká na zpracování.

✅ Zelený ERP

Doklad byl úspěšně zapsán. Z Premieru se vrátilo interní číslo dokladu, doklad je automaticky zamčen.

🔴 Červený ERP

Chyba při odeslání. V historii událostí dokladu je vidět chybová hláška z Premieru.

7. Kontrola duplicit

Konektor automaticky hlídá duplicity i na straně Premieru. Pokud by byl doklad se stejným číslem odeslán znovu, systém to zachytí a odeslání zablokuje.

8. Textové vzory

Textové vzory (přednastavené předkontace) lze ve Wflow vyplnit ručně. Jejich automatický přenos přes API z Premieru zatím není podporován – Premier tuto funkci v API nenabízí.

Pokud se předkontace opakuje, Wflow nabídne predikci na základě historie. Toto je dostupná alternativa k textovým vzorům.

Podpora a řešení problémů

  • Modrá bublina v aplikaci Wflow → chat s podporou

Dostali jste odpověď na svou otázku?