Přeskočit obsah

Premier

Premier

Premier system

Integrace s Premier system umožňuje export přijatých faktur a pokladních dokladů z Alice prostřednictvím REST API (Premier API příkazy FA_IN_ADD, POKLADNA_ADD).

Založení účetní jednotky

Nejdříve je nutné vytvořit Účetní jednotku, ze které budou doklady exportovány. Pokud účetní jednotku již máte vytvořenou, nastavte jí ID (viz Externí ID účetní jednotky). Dále v nastavení na kartě číselníky synchronizujte číselník s účetní jednotkou.

Jak to funguje?

Po označení dokumentu k exportu (stav state-ready-to-export.png K exportu) Alice volá REST API Premier system. Vyhledá nebo vytvoří partnera v adresáři podle IČO/DIČ, namapuje reference na číselníky (řada, předkontace, středisko, …) a doklad zapíše. Po úspěšném zápisu se v Alici doklad přesune do stavu Exportovaný, při chybě do stavu Chyba -- viz Diagnostika. Přehled všech stavů viz Stavy dokumentů.

Schéma datového toku

graph LR
    A[Alice] -->|doklad| B[Premier system]
    B -.->|potvrzení| A

Podporované verze a předpoklady

Oblast Požadavek
Aplikace Premier system s REST API
Autentizace Uživatel s přístupem k API a oprávněním k agendě
Externí ID Identifikátor účetní jednotky v Premier (viz Externí ID)
Síť API server Premier dosažitelný z cloudu Alice

Podporované typy dokumentů

Typ dokumentu Podpora Premier API příkaz
Česká přijatá faktura ✅ Podporováno FA_IN_ADD
Účtenka (pokladní doklad) ✅ Podporováno POKLADNA_ADD (typ V -- výdaj)
Vydaná faktura ❌ Nepodporováno --
Slovenská faktura ❌ Nepodporováno --

Vytvoření integrace

V nastavení na kartě Integrace přidejte Premier system.

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

  • Vyplnění údajů

    premier-setup

  • Popis polí

    Název Popis
    Název Uživatelský název spojení pro Premier system
    Účetní jednotka Účetní jednotka, ze které budou dokumenty importovány
    Adresa serveru Adresa serveru s Premier system API včetně protokolu
    Port Číslo portu, na kterém je služba dostupná
    Uživatelské jméno Jméno API uživatele, který má patřičná oprávnění pro práci s agendou v Premier system
    Uživatelské heslo Heslo API uživatele Premier system

Nastavení uložte.

Synchronizace číselníků

Alice umožňuje jednosměrně (Premier -> Alice) synchronizovat hodnoty číselníků:

Číselník Premier API Použití
Dokladová řada -- přijaté faktury DOKL_PU (Agenda 3) Přijaté faktury
Dokladová řada -- pokladní doklady DOKL_PU (Agenda 1) Účtenky
Kód DPH (Členění DPH) SAZBY_DPH Hlavička i položky -- pouze záznamy s IsExpense=true
Předkontace OSNOVA (aktuální rok) Klíč ve tvaru Synthetic.Analytic (např. 321.100)
Středisko STREDISK Hlavička i položky
Zakázka ZAKAZKA (jen otevřené, max 1000 nejnovějších) Hlavička i položky

Mapování polí dokumentu

Povinná pole

Pole Popis
Dokladová řada Číselná řada -- POVINNÉ POLE
Členění DPH Buď na hlavičce, nebo na každé položce -- POVINNÉ

Identifikace dokumentu

Pole v Alice Pole v Premier Poznámka
Číslo faktury ReceivedInvoiceNumber
Variabilní symbol VariableSymbol
Konstantní symbol ConstantSymbol
Specifický symbol SpecificSymbol
Číslo objednávky OrderNumber
Číslo dodacího listu DeliveryNoteNumber
URL dokumentu v Alici CCode Automaticky doplněn odkaz na detail v Alici

Datumy

Pole v Alice Pole v Premier Poznámka
Datum vystavení DateIssued
Datum splatnosti DateDue
Datum zdanitelného plnění DateTaxableSupply, DateTaxableSupply2 Mapuje se do dvou polí
Datum uplatnění odpočtu DPH DateTaxDeduction

Bankovní spojení

Premier neumožňuje současně BBAN i IBAN -- Alice volí podle měny:

  • CZK -- prioritu má Číslo účtu + Kód banky
  • Cizí měna -- prioritu má IBAN + BIC, číslo účtu jako záloha
Pole v Alice Pole v Premier
Číslo účtu / IBAN BankAccount / Iban
Kód banky / BIC BankCode / Bic

Vlastní pole

Pole v Alice Pole v Premier Poznámka
Předkontace UcS (Synthetic) + UcSa (Analytic) Klíč ve tvaru Synthetic.Analytic se rozdělí na dva sloupce; lze nastavit i na položkách
Středisko Centre Lze nastavit i na položkách
Zakázka Contract Lze nastavit i na položkách
Členění DPH VatCode Lze nastavit i na položkách (s fallbackem na hlavičku)

Položky

Pole v Alice Pole v Premier
Název položky Text (faktura) / Description (účtenka)
Množství Count
Měrná jednotka Unit (jen u účtenky)
Cena bez DPH Price
Cena za jednotku UnitPrice (jen u faktury)
Sazba DPH VatRate (v %)
Částka DPH Vat

Způsoby platby

Způsob platby v Alice Způsob platby v Premier
Převod Převodním příkazem
Karta Platební kartou
Hotově Hotově
Dobírka Dobírkou
Záloha Zálohou
Zápočet Zápočtem
Inkaso Inkasem
Kredit, Stravenka, PayPal, ostatní Převodním příkazem (výchozí)

Práce s partnery

Při exportu dokladu se partner (dodavatel) automaticky vyhledá v adresáři Premier:

  1. Vyhledání podle IČO (pokud je vyplněno)
  2. Případně podle DIČ (pokud IČO není)
  3. Pokud partner neexistuje, vytvoří se nový záznam přes PARTNERI_ADD

IČO nebo DIČ povinné

Bez IČO i DIČ nelze partnera v Premier identifikovat -- export selže.

Podporované DPH sazby

Sazba Popis
0 % Osvobozeno od DPH
12 % Snížená sazba
21 % Základní sazba

Diagnostika

Při chybě se dokument v Alici přesune do stavu error Chyba s detailem v náhledu.

External id of accounting unit is not defined

Příčina: Účetní jednotka v Alici nemá vyplněné Externí ID.

Řešení: V detailu účetní jednotky doplňte Externí ID odpovídající identifikátoru v Premier.

Numerical serie required

Příčina: Vlastní pole Dokladová řada není vyplněné.

Řešení: V detailu dokumentu vyberte dokladovou řadu (nutno mít synchronizované číselníky).

Item VAT breakdown required

Příčina: Členění DPH není vyplněno ani na hlavičce, ani na konkrétní položce.

Řešení: Doplňte na hlavičce dokumentu Členění DPH (platí pro všechny položky), nebo na každé položce zvlášť.

Supplier IDs missing

Příčina: Dokument nemá vyplněné IČO ani DIČ dodavatele.

Řešení: Doplňte IČO nebo DIČ dodavatele.

Časté dotazy | FAQ

Jaké typy dokumentů lze exportovat?

Aktuálně přijaté faktury (FA_IN_ADD) a pokladní doklady -- účtenky (POKLADNA_ADD).

Jak se ukládá Předkontace?

Hodnota číselníku Předkontace ve tvaru Synthetic.Analytic (např. 321.100) se rozdělí na dva samostatné sloupce v Premier (UcS a UcSa).

Co se stane, když dodavatel v Premier neexistuje?

Alice ho automaticky vytvoří přes PARTNERI_ADD na základě údajů z dokumentu.

Můžu nastavit Středisko/Zakázku/Předkontaci na úrovni položek?

Ano. Pokud je hodnota nastavena na položce, použije se ona. Pokud ne, použije se hodnota z hlavičky dokumentu.