Naleznete zde seznam příkazů, s popisem volaných parametrů a jejich upřesněním. Názvy, popis a datové typy všech vrácených DB položek v Result, zde neuvedených, naleznete přímo ve webovém rozhraní dev.premier.cz. Nejedná se o ukázkové příklady, ale v jednotlivých příkazech jsou uvedeny vždy všechny dostupné parametry, včetně jejich popisu a podrobností k nim.

PremierApi se průběžně vyvíjí a manuál je pouze informativní základní průřez nejčastěji používanými možnostmi a nereflektuje všechna specifika. Strukturu databázových polí aktuálně použitých tabulek naleznete v dev.premier.cz (Help - Help), který automaticky vždy odráží aktuální stav. V ApiComPremForm.exe - menu Testovací HTTP klient je přehled všech aktuálních příkazů i se změněnými parametry. Zároveň se dá aktuální struktura příkazu zjistit příkazem INFO, viz. dále.

Volání jednotlivých příkazů úspěšně vrátí z databáze Premiera výsledek při splnění těchto podmínek:

databáze Premiera je v SQL a běží na MS SQL serveru (Premier Enterprise)
konfigurační soubor setup.xml musí být nastaven pro konkrétní firmu(y) a musí se nacházet v adresáři, kde běží ApiComPrem
na serveru s přístupem k SQL serveru musí běžet ApiComPrem (jako služba nebo spuštěná aplikace)
firewall/antivir musí být nakonfigurován tak, aby vlastní komunikaci nijak neomezoval

příkaz INFO

Základní příkaz pro zobrazení možnosti jednotlivých příkazů a struktury jednotlivých tabulek

{

  "command": {
    "inComm": "INFO",
    "inParam": {
      "parameters": {
        "table_name": null,                                   /* název tabulky pro zobrazení její struktury */
        "prikaz": null                                            /* příkaz: FULL – zobrazí strukturu všech dostupných příkazů */
      }
    }
  }
}

{

"command": {
"inComm": "INFO",
"inParam": {
"parameters": {
"table_name": null, /* název tabulky pro zobrazení její struktury */
"prikaz": null /* příkaz: FULL – zobrazí strukturu všech dostupných příkazů */
}
}
}
}

Příklad

Zobrazí strukturu tabulky PARTNERY

{

"command": {
"inComm": "INFO",
"inParam": {
"parameters": {
"table_name": "PARTNERY",
"prikaz": null
}
}
}
}

Zobrazí strukturu všech dostupných tabulek najednou

Současné doplnění parametrů table_name a příkaz není možné a zobrazí chybovou hlášku

Tímto příkazem si vyexportujete seznam všech dostupných příkazů:

{
"command": {
"inComm": "INFO",
"inParam": {
"parameters": {
"table_name": null,
"prikaz": "FULL"
}
}
}

Načtení INFO pro zobrazení možností příkazu FA_OUT

{ "command": {
"inComm": "INFO",
"inParam": {
"parameters": {
"prikaz": "FA_OUT"
} } } }

Výsledek (Result)

{
"Result": "OK",
"CommandIn": "INFO",
"Data": {
"ID": 120,
"nazov": "FA_OUT",
"pouziva_param": true,                            /* v příkaze jsou povolené parametry */
"parametre": [                                           /* seznam parametrů */
{
"name": "id_obj",
"is_required": false,
"desc": "cislo objednavky",
"format": "N",
"order": 0
},
{
"name": "cis_part",
"is_required": false,
"desc": "cislo partnera",
"format": "N",
"order": 1
},
{
"name": "ico_part",
"is_required": false,
"desc": "ICO partnera",
"format": "S",
"order": 2
},
{
"name": "dat_od",
"is_required": false,
"desc": "datum od",
"format": "D",
"order": 4
},
{
"name": "dat_do",
"is_required": false,
"desc": "datum do",
"format": "D",
"order": 5
},
{
"name": "typ_fa",
"is_required": false,
"desc": "FA/DOBROPIS - default [FA]",
"format": "C",
"order": 6
}
],
"popis": "zoznam faktur",
"typ_prikazu": "OUT",
"queryTab": [                                              /* povolené tabulky pro „queryFields“ */
"FA_OUT",
"POLOZKY"
]
}
}

Na této stránce najdete:

příkaz SELECT

Možnost vložení libovolného vlastního SQL dotazu pro přímé volání ze všech dostupných tabulek uložených v databázi. Příkaz je dostupný především pro testovací účely. Jednotlivé vazby mezi tabulkami řeší ostatní příkazy, které jsou v nich již ošetřeny, proto jej doporučujeme používat jen ve výjimečných případech. Používá syntaxi MS SQL.

{
"select": "select top 10 * from ob_in" /* samotný SELECT na databázi */
}

Ve specifických případech, kdy se například podmínky příkazu kryjí se specifikací UTF8, je možné zasílat příkaz SELECT ve formátu BASE64.

Příklad:

{"select": "select CISLO, TEXT, TEXT_2 from SKLAD where (TEXT like '%22312%' OR TEXT like '22312%') and sklad = '5'"}

se odešle takto, s uvedením textu "BASE64:“ na začátku:

{"select": "BASE64:c2VsZWN0IENJU0xPLCBURVhULCBURVhUXzIgZnJvbSBTS0xBRCB3aGVyZSAoVEVYVCBsaWtlICclMjIzMTIlJyBPUiBURVhUIGxpa2UgJzIyMzEyJScpIGFuZCBza2xhZCA9ICc1Jw=="}

příkaz ZMENY

přehled změn záznamu

{
"command": {
"inComm": "ZMENY",
"inParam": {
"parameters": {
"id": null
}
}
}
}

příkaz SAZBY_DPH

vrátí přehled aktuálních kódů dph z Premiera (záložka Správce - Předvolby globální - Kódy DPH)

{
"command": {
"inComm": "SAZBY_DPH"
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "SAZBY_DPH",
"error": "",
"warning": "",
"data": [
{
"KOD_DPH": "01", /* číselné označení kódu DPH */
"TEXT": "Neuskutečněná plnění", /* popis */
"SAZBA": 3, /* sazba 0,1,2,3 (0=0%; 1=nižší dle daňové soustavy (15%); 2=vyšší dle daňové soustavy (21%); 3=Jiná) */
"SAZBA_DPH": 0, /* procentní výše kódu DPH (0 může odpovídat 0% nebo nevyplněné sazbě "Jiná" */
"FA_IN": true, /* true/false - DPH na vstupu (dodavatelé) */
"FA_OUT": true, /* true/false - DPH na výstupu (odběratelé) */
"UCET": " " /* vyplněný účet */
}
]
}

příkaz FA_IN

seznam přijatých faktur

{
"command": {
"inComm": "FA_IN",
"inParam": {
"parameters": {
"id_fa": "1C2A99DA-ADEA-47F4-99A3-943C60704A10", /* ID faktury */
"cis_fa": null,                                               /* číslo faktury */
"cis_obj": null,                                             /* číslo objednávky */
"dokl_r": null,                                              /* dokladová řada */
"id_part": null,                                            /* ID partnera */
"ico_part": null,                                          /* IČ partnera */
"dat_od": null, /* období od */
"dat_do": null, /* období do */
"typ_fa": null,                                              /* typ faktury */
"timestamp": null                                       /* časové razítko */
}
}
}
}

Výsledek (Result)

{
"Result":"OK",
"CommandIn":"FA_IN",
"Data":
[
{
"INTER":1274,
"DOKLAD":"PF",
"CISLO":1,
"ZKKOD":0,
"STKOD":114,
"K_SYMBOL":"0308",
"OBJEDNAVKA":"",
"DOD_LIST":"",
"FORMA":"Převodním příkazem",
"DATUM_USK":"2020-06-10T00:00:00",
"DATUM_VYS":"2020-06-10T00:00:00",
"DATUM_SPL":"2020-06-24T00:00:00",
"CELKEM":484.00,
"ZALOHA":0.00,
"CISLO_ODB":"Žůrek",
"NAZEV_ODB":"Kateřina Čížková",
"ICO_ODB":"087",
"ID":"37FE0C3E-AC1A-4407-B0D9-F763A949FF6D",
"ID_PAR":"67387A8E-30B7-4EB6-A3FF-F8243290E933",
"POLOZ_IN":
[
{
"FAKTURA":1274,
"TEXT":"Pronájem vozidla POLEP - ŠKODA OCTAVIA COM",
"MNOZSTVI":2.000,
"MJ":"",
"CENA_MJ":200.000,
"CENA_SLV":0.00,
"SLEVA_PR":0.00,
"CENA":400.00,
"CENA_DPH":84.00,
"SAZBA_DPH":21.00,
"KOD_DPH":"15",
"MATERIAL":0,
"ZDROJ":0,
"OPERACE":"",
"POL_KOD":"",
"SLEVA":0.00,
"ID":"2B60F042-4B63-4447-A8A8-65146337F068",
"PORDER":0
}
]
}
]
}

Grafické zobrazení vybraných DB položek v prostředí Premiera, vrácených v Result

Seznam všech DB položek, včetně datových typů, velikosti, povinnosti a popisu naleznete v Helpu webového rozhraní, viz. odkaz výše,

Tip

Položka C_KOD – EAN (DMS) může být zobrazena v Premieru formou hyperlinku, pokud si její strukturu nadefinujete ve "Správce – Předvolby globální – Dodavatelé"

Povinné je vyplnění alespoň jednoho z těchto parametrů:
[id_fa, cis_fa, cis_obj, dokl_r, id_part, ico_part, timestamp] nebo [queryConditions]

příkaz FA_IN_ADD

zápis nové přijaté faktury
{

"command": {
"inComm": "FA_IN_ADD"
"inParam": {
"parameters": {
"variabl_force": null /* null = výchozí, v případě duplicity VS vrací API chybovou hlášku / 1 = umožní zapsat do databáze duplicitní variabilní symbol (V programu Premier, v případě existujícího VS, vyskočí upozorňující hláška, zda si uživatel přeje založit FA s duplicitním VS. Tento parametr ji nahrazuje a umožní implementaci stejné hlášky do vašeho systému v případě existence shodného VS. Pokud si to uživatel přeje, můžete po chybě zavolat stejný příkaz znovu s parametrem variable_force = 1 a dojde k vynucenému zápisu. Týká se faktur placených se stále stejným VS - např. pojištění) */
}
},
"Data": {

"DOKLAD": null,                                              /* označení dokladu */
"CISLO": 0,                                                       /* číslo dokladu, pokud je null nebo nulové, přiřadí se číslo dle seznamu jako následující. Pokud je vyplněno, kontroluje se pouze jeho duplicita */
"K_SYMBOL": null,                                         /* KS */
"VARIABL": null,                                              /* VS, kontroluje se na duplicitu u partnera */
"DATUM_VYS": null, /* datum vystavení nebo obdržení */
"DATUM_SPL": null, /* datum splatnosti */
"DATUM_USK": null, /* datum uskutečnění - podle tohoto datumu se kontroluje uzavřené období v Premieru */
"DATUM_KVY": null, /* DUZP, liší-li se */
"DATUM_DPH": null, /* datum pro přiznání DPH */
"CELKEM": 0,                                                   /* částka celkem */
"ZALOHA": 0,                                                   /* poskytnutá záloha */
"ZAOK": 0,   /* výše zaokrouhlení (pokud se hodnota nebude rovnat 0, automaticky se načtou účty dle nastavení v globálních proměnných (kladná/záporná hodnota) */

"SAZ_DPH1": 0,                                               /* snížená sazba dph */
"SAZ_DPH2": 0,                                               /* základní sazba dph */
"PRIJAL": null,
"CISLO_PF": null,                                            /* č. PF dodavatele (liší-li se od VS) */
"SPEC": null,                                                    /* specifický symbol */
"UCET_ODB": null,                                         /* číslo účtu odběratele, musí být vyplněno současně s KOD_ODB – pokud nejsou vyplněny UCET_ODB, KOD_ODB, BIC, doplní se číselníku adres partnerů */
"KOD_ODB": null,                                           /* kód banky odběratele, musí být vyplněno současně s UCET_ODB – pokud nejsou vyplněny UCET_ODB, KOD_ODB, BIC, doplní se číselníku adres partnerů */
"IBAN": null,                                                    /* IBAN (pokud je vyplněn, doplní se do UCET_ODB) */
"BIC": null,                                                       /* BIC odběratele – pokud nejsou vyplněny UCET_ODB, KOD_ODB, BIC, doplní se číselníku adres partnerů */
"ZKKOD": 0,                                                     /* zakázka */
"STKOD": 0,                                                     /* středisko */
"ID_PAR": null,                                                /* ID tab. partnery, vedený jako dodavatel (každý partner může být veden jako dodavatel i odběratel) */
"ID_KON": null,                                               /* ID tab. part_kon */
"ID_ADR": null,                                               /* ID adresy (toto ID není přímo součástí tab. FA_IN, ale je vhodné jej uvést pro potřebu přebírání dat, jako je třeba UCET_ODB, KOD_ODB a BIC */
"MENA": null,                                                  /* kód měny (EUR) – v případě CZK se pole MENA neplní; Parametry MENA a OZN_MENY se kontrolují dle kurzovního lístku (viz. https://manual.premier.cz:8443/pages/viewpage.action?pageId=3735836).
Pokud se vyplněn parametr MENA, je povinné vyplnění i parametrů OZN_MENY, KURS, M_KURS nebo DATUM_KVY a v tom případě se doplní kurz dle stáhnutého kurzovního lístku podle měny a duzp */
"OZN_MENY": null, /* označení měny (€) – v případě Kč se pole OZN_MENA neplní */
"MENA_PRED": 0 /* pozice měny: 0 = za částkou / 1 = před částkou (nepovinný parametr) */
"KURS": 0,                                                        /* kurz (pokud není doplněn a jedná se o cizí měnu, tak u SK ÚJ se použije vždy (datum - 1 den). V případě CZ ÚJ se kontroluje existence kurzu v daný den, pokud se nenajde zopakuje se kontrola s (datum - 1 den). V obou případě se kontroluje víkend, svátek až sedm dní zpětně) */

"POZNAMKA": null,                                        /* poznámka */
"POPIS": null, /* popis */
"M_KURS": 0, /* množství cizí měny pro daný kurz (výchozí hodnota v případě vyplněného kurzu je 1) */
"FORMA": null, /* forma úhrady - povolené hodnoty ['Hotovosť','Prevodným príkazom','Dobierkou','Platobnou kartou','Zápočtom','Inkasom','Zálohou','Hotově','Převodním příkazem','Dobírkou','Platební kartou','Zápočtem','Inkasem', 'Zálohou'] */
"OBJEDNAVKA": null,                                     /* objednávka */
"DOD_LIST": null,                                           /* dodací list */
"C_KOD": null,                                                 /* EAN (DMS) */
"BARVA": 0,                                                     /* podbarvení faktury v přehledu faktur */
"FA_POL": [                                                      /* položka faktury */
{
"TEXT": null,                                                /* text */
"CENA": 0, /* cena bez dph */
"MNOZSTVI": 0,                                          /* množství */
"Cena_MJ": 0,                                             /* cena MJ */
"SAZBA_DPH": 0,                                        /* výše sazby dph */
"KOD_DPH": null,                                       /* kód dph – hodnota se kontroluje dle číselníků kódů dph (příkaz SAZBY_DPH) */
"CENA_DPH": 0,                                          /* dph */
"DAN1": 0,                                                   /* číselník doplňkové analýzy (N) - pro příspěvkové organizace obvykle Uz */
"DAN2": 0,                                                   /* číselník doplňkové analýzy (N) - pro příspěvkové organizace obvykle OdPa */
"DAN3": null,                                               /* číselník doplňkové analýzy (C) - pro příspěvkové organizace obvykle Pol */
"ZKKOD": 0,                                                 /* zakázka */
"STKOD": 0,                                                 /* středisko */
"OPERACE":"123", /* určeno pro daňovou evidenci */
"ANALYT":"456", /* určeno pro daňovou evidenci */
"UC_S": null,                                                /* syntetický účet MD */
"UC_SA": null,                                             /* analytický účet MD */
"UC_D": null,                                               /* syntetický účet DPH – pokud je UC_D a UC_DA prázdné, doplní se přednastavená hodnota čísla účtu z číselníku kódů DPH, jeli vyplněn */
"UC_DA": null                                             /* analytický účet DPH */
}
]
}
}

Před zápisem se kontroluje období a program nedovolá záznam zapsat, pokud je již uzavřené.

Při vkládání faktury přes API se neprovádí zaúčtování. Jde však dodatečně provést hromadně v programu.

příkaz FA_IN_UPD

pouze dílčí aktualizace těchto parametrů u přijaté faktury

{
"command": {
"inComm": "FA_IN_UPD",
"inParam": {
"parameters": {
"id": null /* ID faktury */
}
}
},
"Data": {
"C_KOD": null, /* EAN (DMS) */
"BARVA": null /* podbarvení faktury v přehledu faktur */
}
}

příkaz FA_ZIN

zálohové listy (seznam přijatých zálohových faktur)

{
"command": {
"inComm": "FA_ZIN",
"inParam": {
"parameters": {
"id_fa": null, /* ID faktury */
"cis_fa": null, /* číslo faktury */
"cis_obj": null, /* číslo objednávky */
"dokl_r": null, /* dokladová řada */
"id_part": null, /* ID partnera */
"ico_part": null, /* IČ partnera */
"dat_od": null, /* období od */
"dat_do": null, /* období do */
"timestamp": null /* časové razítko ve formátu "2019-05-01 11:12:15" nebo "2019-05-01T11:15:15" */
}
}
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
[id_fa, cis_fa, cis_obj, dokl_r, id_part, ico_part] nebo [queryConditions]

Pokud zadání vrací velké množství výsledků, např. pokud je vyplněn jen partner (id_part), je povinná položka i datum Od-Do [dat_od, dat_do]

Výsledek (Result)

{
"Result":"OK",
"CommandIn":"FA_ZIN",
"Data":
[
{
"INTER":216, /* interní (pořadové) číslo */
"DOKLAD":"PFP", /* označení dokladu */
"CISLO":1, /* číslo dokladu */
"ZKKOD":0,   /* zakázka */
"STKOD":0, /* středisko */
"K_SYMBOL":"", /* konstantní symbol */
"OBJEDNAVKA":"", /* objednávka */
"DOD_LIST":"", /* dodací list */
"FORMA":"", /* forma úhrady */
"DATUM_USK":"2015-06-01T00:00:00", /* datum uskutečnění */
"DATUM_VYS":"2015-06-01T00:00:00", /* datum pořízení */
"DATUM_SPL":"2015-06-11T00:00:00", /* požadovaný termín splnění */
"CELKEM":4590.00, /* celková částka */
"ZALOHA":0.00, /* poskytnutá záloha */
"CISLO_ODB":"", /* zkratka partnera */
"NAZEV_ODB":"firma", /* název odběratele */
"ICO_ODB":"", /* IČO odběratele */
"ID":"1DA09524-6F87-4E0F-95D9-29BB06F6A833", /* ID dokladu */
"ID_PAR":"", /* ID partnera */
"POL_ZIN": /* položky zálohového listu */
[
{
"FAKTURA":216,
"TEXT":"mzdy", /* název */
"MNOZSTVI":0.000, /* množství */
"MJ":"", /* měrná jednotka */
"CENA_MJ":0.000, /* cena MJ */
"CENA_SLV":0.00, /* výše slevy */
"SLEVA_PR":0.00,   /* sleva v procentech */
"CENA":4590.00,   /* cena bez dph */
"CENA_DPH":0.00, /* dph */
"SAZBA_DPH":0.00,   /* výše sazby dph */
"KOD_DPH":"10", /* kód dph – hodnota se kontroluje dle číselníků kódů dph (příkaz SAZBY_DPH) */
"MATERIAL":0,
"ZDROJ":0,
"OPERACE":" ",
"POL_KOD":" ",
"SLEVA":0.00, /* sleva za uskutečněné výkony */
"ID":"29AB804B-6B79-44DB-A29E-A080CEB2C452", /* ID položky */
"PORDER":1 /* řazení */
}
]
}
]

příkaz FA_ZIN_ADD

zápis nového zálohového listu (přijaté zálohové faktury)

{
"command": {
"inComm": "FA_ZIN_ADD"
"parameters": {
"variabl_force": null /* null = výchozí, v případě duplicity VS vrací API chybovou hlášku / 1 = umožní zapsat do databáze duplicitní variabilní symbol (V programu Premier, v případě existujícího VS, vyskočí upozorňující hláška, zda si uživatel přeje založit FA s duplicitním VS. Tento parametr ji nahrazuje a umožní implementaci stejné hlášky do vašeho systému v případě existence shodného VS. Pokud si to uživatel přeje, můžete po chybě zavolat stejný příkaz znovu s parametrem variable_force = 1 a dojde k vynucenému zápisu. Týká se faktur placených se stále stejným VS - např. pojištění) */
}
},
"Data": {
"DOKLAD": null, /* označení dokladu = dokladová řada */
"cislo": 0,   /* číslo dokladu, pokud je null nebo nulové, přiřadí se číslo dle seznamu jako následující. Pokud je vyplněno, kontroluje se pouze jeho duplicita */
"K_SYMBOL": null,   /* KS */
"VARIABL": null, /* VS, kontroluje se na duplicitu u partnera */
"DATUM_VYS": null, /* datum pořízení */
"DATUM_SPL": null, /* datum splatnosti */
"DATUM_USK": null, /* datum uskutečnění - podle tohoto datumu se kontroluje uzavřené období v Premieru */
"CELKEM": 0,   /* částka celkem */
"ZALOHA": 0,   /* poskytnutá záloha */
"ZAOK": 0,   /* zaokrouhlení */
"SAZ_DPH1": 0, /* snížená sazba dph */
"SAZ_DPH2": 0,   /* základní sazba dph */
"PRIJAL": null,
"CISLO_PF": null, /* č. ZPF dodavatele (liší-li se od VS) */
"UCET_ODB": null,   /* číslo účtu odběratele, musí být vyplněno současně s KOD_ODB – pokud nejsou vyplněny UCET_ODB, KOD_ODB, BIC, doplní se číselníku adres partnerů */
"KOD_ODB": null, /* kód banky odběratele, musí být vyplněno současně s UCET_ODB – pokud nejsou vyplněny UCET_ODB, KOD_ODB, BIC, doplní se číselníku adres partnerů */
"IBAN": null, /* IBAN (pokud je vyplněn, doplní se do UCET_ODB) */
"BIC": null,   /* BIC odběratele – pokud nejsou vyplněny UCET_ODB, KOD_ODB, BIC, doplní se číselníku adres partnerů */
"SPEC": null, /* specifický symbol */
"ZKKOD": null, /* zakázka */
"STKOD": null, /* středisko */
"ID_PAR": null,   /* ID tab. partnery, vedený jako dodavatel (každý partner může být veden jako dodavatel i odběratel) */
"ID_KON": null, /* ID tab. part_kon */
"MENA": null, /* kód měny (EUR) – v případě CZK se pole MENA neplní; Parametry MENA a OZN_MENY se kontrolují dle kurzovního lístku (viz. 2. 8 Kurzovní lístek).
Pokud se vyplněn parametr MENA, je povinné vyplnění i parametrů OZN_MENY, KURS, M_KURS nebo DATUM_KVY a v tom případě se doplní kurz dle stáhnutého kurzovního lístku podle měny a duzp */
"OZN_MENY": null,   /* označení měny (€) – v případě Kč se pole OZN_MENA neplní */
"MENA_PRED": null, /* pozice měny: 0 = za částkou / 1 = před částkou (nepovinný parametr) */
"KURS": null, /* kurz */
"M_KURS": null,   /* kurz - množství */
"POZNAMKA": null,   /* poznámka */
"POPIS": null, /* popis */
"FORMA": null, /* forma úhrady - povolené hodnoty ['Hotovosť','Prevodným príkazom','Dobierkou','Platobnou kartou','Zápočtom','Inkasom','Hotově','Převodním příkazem','Dobírkou','Platební kartou','Zápočtem','Inkasem'] */
"OBJEDNAVKA": null, /* objednávka */
"DOD_LIST": null, /* dodací list */
"C_KOD": null,   /* EAN (DMS) */
"BARVA": null,   /* podbarvení faktury v přehledu zálohových listů */
"FA_POL": [ /* položky zálohového listu */
{
"TEXT": null,   /* název */
"MNOZSTVI": 0,   /* množství */
"CENA": 0, /* cena bez dph */
"CENA_MJ": 0, /* cena MJ */
"SAZBA_DPH": null, /* výše sazby dph */
"KOD_DPH": null,   /* kód dph – hodnota se kontroluje dle číselníků kódů dph (příkaz SAZBY_DPH) */
"CENA_DPH": 0,   /* dph */
"DAN1": null,   /* číselník doplňkové analýzy (N) - pro příspěvkové organizace obvykle Uz */
"DAN2": null,   /* číselník doplňkové analýzy (N) - pro příspěvkové organizace obvykle OdPa */
"DAN3": null,   /* číselník doplňkové analýzy (C) - pro příspěvkové organizace obvykle Pol */
"UC_S": null, /* syntetický účet MD */
"UC_SA": null, /* analytický účet MD */
"UC_D": null, /* syntetický účet DPH – pokud je UC_D a UC_DA prázdné, doplní se přednastavená hodnota čísla účtu z číselníku kódů DPH, jeli vyplněn */
"UC_DA": null,   /* analytický účet DPH */
"ZKKOD": null,   /* zakázka */
"STKOD": null /* středisko */
}
]
}
}

Povinné je vyplnění těchto parametrů:
[DOKLAD, VARIABL, ID_PAR, datum_vys, datum_usk, datum_spl, TEXT, KOD_DPH]

příkaz FA_IN_UHR

úhrady přijatých faktur

{
"command": {
"inComm": "FA_IN_UHR",
"inParam": {
"parameters": {
"id_fa": null, /* ID faktury */
"cis_fa": null, /* číslo dokladu */
"inter_fa": null, /* interní (pořadové) číslo faktury */
"dokl_r": null, /* dokladová řada */
"id_part": null, /* ID partnera */
"dat_od": null, /* datum vystavení OD (datum_vys) */
"dat_do": null, /* datum vystavení DO*/
"VFzalohove": null /* 0/1 = včetně zálohových listů */
}
}
}
}

Povinné je vyplnění některého z těchto parametrů:
[id_fa, cis_fa, inter_fa, dokl_r, id_part]

Result

{
"Result":"OK",
"CommandIn":"FA_IN_UHR",
"Data":
[
{
"Uhrazeno_CM":0.00,
"zaloha":0.00,
"Zaok":0.00,
"Prepocet":66550.00,
"K_zisk":0.00,
"interFa":1259,
"typ":"PF",
"zkkod":0,
"datum_vys":"20.03.2020",
"datum_usk":"31.12.2019",
"datum_spl":"30.03.2020",
"doklad":"DF",
"cislo_fa":2015000114,
"Fakturovano":66550.00,
"inter_fa":1259,
"nazev_odb":"AAA s.r.o",
"ico_odb":"28823231",
"id_par":"",
"mena_fa":"CZK",
"Uhrazeno":0.00,
"mena_uhr":"",
"zbyva_uhr":66550.00,
"datum_uhr":"",
"prodleni":232
}
]
}

příkaz FA_IN_AUDIT

zapíše příznak "Auditováno" do přijaté faktury

{

"command": {
"inComm": "FA_IN_AUDIT",
"inParam": {
"parameters": {
"id_fa": null, /* ID faktury */
"audit": null, /* příznak auditováno: 0 / 1 */
"overil": null /* jméno */
}
}
}
}

Povinné je vyplnění všech parametrů:
[id_fa, audit]

příkaz FA_OUT

tabulka vydaných faktur.

Příkaz umožňuje vložit i vlastní podmínku (queryConditions).

{
"command": {
"inComm": "FA_OUT",
"inParam": {
"parameters": {
"id_fa": null,                                                /* ID faktury */
"cis_fa": null,                                               /* číslo faktury */
"cis_obj": 2015100776, /* číslo objednávky */
"dokl_r": null,                                              /* dokladová řada */
"id_part": null,                                            /* ID partnera */
"ico_part": null,                                          /* IČ partnera */
"dat_od": null, /* období od */
"dat_do": null, /* období do */
"typ_fa": "FA"                                             /* FA/DOBROPIS – výchozí hodnotou je FA */
"timestamp": null                                       /* časové razítko */
}
}
},

"queryFields": [
{
/* seznam vrácených položek tabulky FA_OUT */
"tableName": "FA_OUT",
"tableFields": "INTER,DOKLAD,ZKKOD,OBJEDNAVKA,DOD_LIST,DATUM_VYS,DATUM_SPL,CELKEM,ZAOK"
},
{
/* seznam vrácených položek tabulky POLOZKY faktury */
"tableName": "POLOZKY",
"tableFields": "FAKTURA,MNOZSTVI,MJ,CENA_MJ,CENA_SLV,SLEVA_PR,CENA,CENA_DPH"
}
]
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
[id_fa, cis_fa, cis_obj, dokl_r, id_part, ico_part, timestamp] nebo [queryConditions]

Result

{
"Result":"OK",
"CommandIn":"FA_OUT",
"Data":
[
{
"INTER":60350,
"DOKLAD":"VF1",
"ZKKOD":0,
"OBJEDNAVKA":"2015100776",
"DOD_LIST":"1201533505",
"DATUM_VYS":"2015-11-26T00:00:00",
"DATUM_SPL":"2015-12-26T00:00:00",
"CELKEM":11.51,
"ZAOK":0.00,
"polozky":
[
{
"FAKTURA":60350,
"MNOZSTVI":1.000,
"MJ":"ks",
"CENA_MJ":0.59000,
"CENA_SLV":0.00,
"SLEVA_PR":0.00,
"CENA":0.59,
"CENA_DPH":0.12
},
{
"FAKTURA":60350,
"MNOZSTVI":2.000,
"MJ":"ks",
"CENA_MJ":0.55000,
"CENA_SLV":0.00,
"SLEVA_PR":0.00,
"CENA":1.10,
"CENA_DPH":0.22
},
{
"FAKTURA":60350,
"MNOZSTVI":1.000,
"MJ":"ks",
"CENA_MJ":7.90000,
"CENA_SLV":0.00,
"SLEVA_PR":0.00,
"CENA":7.90,
"CENA_DPH":1.58
}
] } ] }

příkaz FA_OUT_ADD

vložení nové vystavené faktury

{

"command": {
"inComm": "FA_OUT_ADD"

"inParam": {
"parameters": {
"isRecAut": null /* parametr pro zápis recyklačního a autorského poplatku položky (platí i pro OB_IN_ADD)

isRecAut = 0/ null - poplatky se nepoužívají
isRecAut = 1 – poplatky se použijí z nastavení karty
isRecAut = 2 – poplatky se definují v položce dokladu (vkládá se přes API), viz. POL_R a POL_A
*/

"variabl_force": null /* null = výchozí, v případě duplicity VS vrací API chybovou hlášku / 1 = umožní zapsat do databáze duplicitní variabilní symbol (V programu Premier, v případě existujícího VS, vyskočí upozorňující hláška, zda si uživatel přeje založit FA s duplicitním VS. Tento parametr ji nahrazuje a umožní implementaci stejné hlášky do vašeho systému v případě existence shodného VS. Pokud si to uživatel přeje, můžete po chybě zavolat stejný příkaz znovu s parametrem variable_force = 1 a dojde k vynucenému zápisu. */

"zauct": 1 /* zaúčtuje zapsanou fakturu do deníku */

}
}

},
"Data": {
"DOKLAD": "VF", /* dokladová řada */
"cislo": 999,   /* číslo dokladu, pokud je null nebo nulové, přiřadí se číslo dle seznamu jako následující. Pokud je vyplněno, kontroluje se pouze jeho duplicita */
"K_SYMBOL": 308, /* KS */
"VS": null, /* VS, kontroluje se na duplicitu u partnera */
"BANKA_DOKL": "CS", /* zkratka z číselníku peněžních ústavů (3 znaky) ve Správce - Globální předvolby – Dokladová řada – bankovní účty */



"DATUM_VYS": "2019-01-26", /* datum vystavení */
"DATUM_SPL": "2019-02-26", /* datum splatnosti */
"DATUM_USK": "2019-01-26", /* datum uskutečnění - podle tohoto datumu se kontroluje uzavřené období v Premieru */
"DATUM_DPH": "2019-01-26", /* datum pro přiznání DPH */
"CELKEM": 1000.0, /* částka celkem */
"ZALOHA": 0.0,   /* poskytnutá záloha */
"ZAOK": 0.0,   /* výše zaokrouhlení (pokud se hodnota nebude rovnat 0, automaticky se načtou účty dle nastavení v globálních proměnných (kladná/záporná hodnota) */

"SAZ_DPH1": 0.0, /* snížená sazba dph */
"SAZ_DPH2": 0.0, /* základní sazba dph */
"CISLO_VF": null, /* číslo VF originálu (liší-li se) */
"HLAVICKA": null,
"PATICKA": null,
"TELO": null,
"ZKKOD": null,   /* zakázka */
"STKOD": null, /* středisko */
"ID_PAR": "67387A8E-30B7-4EB6-A3FF-F8243290E933", /* ID tab. partnery, vedený jako dodavatel (každý partner může být veden jako dodavatel i odběratel) */
"ID_KON": null, /* ID tab. part_kon */
"MENA": null, /* kód měny (EUR) – v případě CZK se pole MENA neplní; Parametr MENA se kontroluje dle kurzovního lístku (viz. 2. 8 Kurzovní lístek - musí být vždy součástí "Předvolených měn pro připojení"). Kurz se dle něj a duzp (DATUM_KVY) automaticky do faktury doplní, pokud v daný den kurz je v Premieru stažený; Pokud jsou vyplněny i ostatní atributy OZN_MENY, KURS, M_KURS kurz je nastaven dle těchto hodnot, bez ohledu na aktuální kurz */
"OZN_MENY": null,   /* označení měny (€) – v případě Kč se pole OZN_MENA neplní */
  "MENA_PRED": 0 /* pozice měny: 0 = za částkou / 1 = před částkou (nepovinný parametr) */
"KURS": null,   /* kurz */
"M_KURS": null, /* množství cizí měny pro daný kurz (výchozí hodnota v případě vyplněného kurzu je 1) */
"POZNAMKA": null, /* poznámka */
"POPIS": null, /* popis */
"UC_VF": null, /* syntetický účet VF - pokud je hodnota prázdná, použije se z nastavení dokladové řady */
"UC_VFA": null, /* analytický účet VF - pokud je hodnota prázdná, použije se z nastavení dokladové řady */
"FORMA": null, /* forma úhrady - povolené hodnoty ['Hotovosť','Prevodným príkazom','Dobierkou','Platobnou kartou','Zápočtom','Inkasom','Hotově','Převodním příkazem','Dobírkou','Platební kartou','Zápočtem','Inkasem'] */
"OBJEDNAVKA": null,   /* objednávka */
"DOD_LIST": null, /* dodací list */
"NETTO": null, /* netto */
"BRUTTO": null, /* brutto */
"VYSTAVIL": null, /* vystavil */
"BARVA": null,   /* podbarvení faktury v přehledu faktur */
"CPUV_DOKL": null, /* Původní doklad (k dobropisu) na základě kterého dojde ke kontrole a vytvoření vazby */
"STORNO_FA": false, /* příznak storno faktury (true/false) */
"DOPRAVA": null, /* způsob dopravy */
"FA_POL": [ /* položka faktury */
"TEXT": "test", /* název */

"TEXT_2": null, /* další popis u položky (část 1. - 255 znaků) */
"TEXT2": null, /* další popis u položky (část 2. - 255 znaků) */
"TEXT3": null, /* další popis u položky (část 3. - 255 znaků) */
"MNOZSTVI": 0.0, /* množství */
"MJ": null, /* MJ */
"CENA_MJ": 0.0, /* cena za MJ (CENA_MJ nebo ZCENA_MJ musí být vyplněny a nesmí nabývat zároveň hodnoty null, mohou být však nulové (0) */
"CENA": 0.0, /* cena bez dph */
"CENA_DPH": 0.0, /* cena s dph */
"SLEVA_PR": null, /* procentní výše slevy */
"CENA_SLV": null, /* sleva */
"MATERIAL": null, /* číslo skladové karty */
"SAZBA_DPH": null, /* výše sazby dph */
"KOD_DPH": 21, /* kód dph – hodnota se kontroluje dle číselníků kódů dph (příkaz SAZBY_DPH) */
"DAN1": null, /* číselník doplňkové analýzy (N) - pro příspěvkové organizace obvykle Uz */
"DAN2": null, /* číselník doplňkové analýzy (N) - pro příspěvkové organizace obvykle OdPa */
"DAN3": null, /* číselník doplňkové analýzy (C) - pro příspěvkové organizace obvykle Pol */
"ZKKOD": null, /* zakázka */
"STKOD": null, /* středisko */
"UC_S": null,   /* syntetický účet Dal */
"UC_SA": null,   /* analytický účet Dal */
"UC_D": null,   /* syntetický účet DPH – pokud je UC_D a UC_DA prázdné, doplní se přednastavená hodnota čísla účtu z číselníku kódů DPH, jeli vyplněn */
"UC_DA": null, /* analytický účet DPH */
"CISLO_DOBR" : "12345", /* číslo původního dokladu v případě dobropisu položky */
"POL_R": { /* recyklační poplatek */
"TEXT": "", /* popis poplatku - nekontroluje se text */
"CENA_MJ": 0, /* jednotková částka poplatku */
"REC_INCL": false /* 0/null = poplatek není zahrnutý v částce zboží; 1 = poplatek je zahrnutý v ceně zboží */
},
"POL_A": { /* autorský poplatek */
"TEXT": "", /* popis poplatku - nekontroluje se text */
"CENA_MJ": 0, /* jednotková částka poplatku */
"REC_INCL": false /* 0/null = poplatek není zahrnutý v částce zboží; 1 = poplatek je zahrnutý v ceně zboží */
}
]
}
}

Před zápisem se kontroluje období a program nedovolá záznam zapsat, pokud je již uzavřené.

příkaz FA_OUT_UHR

úhrady odeslaných faktur

{
"command": {
"inComm": "FA_OUT_UHR",
"inParam": {
"parameters": {
"id_fa": null, /* ID faktury */
"cis_fa": null, /* číslo dokladu */
"inter_fa": null, /* interní (pořadové) číslo faktury */
"dokl_r": null, /* dokladová řada */
"id_part": null, /* ID partnera */
"dat_od": null, /* datum vystaveni OD (datum_vys) */
"dat_do": null, /* datum vystavení DO */
"VFzalohove": null /* 0/1 = včetně zálohových listů */
}
}
}
}

Povinné je vyplnění některého z těchto parametrů:
[id_fa, cis_fa, inter_fa, dokl_r, id_part]

Result

{
"Result":"OK",
"CommandIn":"FA_OUT_UHR",
"Data":
[
{
"typ":"VF",
"zkkod":0,
"datum_vys":"05.02.2020",
"datum_usk":"05.02.2020",
"datum_spl":"19.02.2020",
"doklad":"VF",
"cislo_fa":412148320,
"inter_fa":1429,
"nazev_odb":"Martin",
"ico_odb":"87826992",
"id_par":"67387A8E-30B7-4EB6-A3FF-F8243290E933",
"fakturovano":21599.00,
"mena_fa":"CZK",
"uhrazeno":0.00,
"mena_uhr":"",
"zbyva_uhr_czk":21599.00,
"datum_uhr":"",
"prodleni":272,
"Zbyva_uhr_CM":0.000000
}
]
}

příkaz FA_ZOUT

přijaté zálohové listy

{
"command": {
"inComm": "FA_ZOUT",
"inParam": {
"parameters": {
"id_fa": null, /* ID faktury */
"cis_fa": null, /* číslo dokladu */
"cis_obj": null, /* číslo objednávky */
"dokl_r": "VYZ", /* dokladová řada */
"id_part": null, /* ID partnera */
"ico_part": null, /* IČ partnera */
"dat_od": "2015-01-01", /* datum OD */
"dat_do": "2015-12-31", /* datum DO */
"timestamp": null /* časové razítko */
}
}
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
[id_fa, cis_fa, cis_obj, dokl_r, id_part, ico_part, _timestamp nebo [queryConditions]

Result

{

"Result":"OK",
"CommandIn":"FA_ZOUT",
"Data":
[
{
"INTER":10,
"DOKLAD":"VYZ",
"CISLO":15000001,
"ZKKOD":0,
"STKOD":0,
"K_SYMBOL":"0308",
"OBJEDNAVKA":"",
"DOD_LIST":"",
"FORMA":"Převodním příkazem",
"DATUM_USK":"2015-06-08T00:00:00",
"DATUM_VYS":"2015-06-08T00:00:00",
"DATUM_SPL":"2015-06-18T00:00:00",
"CELKEM":14520.00,
"ZALOHA":0.00,
"CISLO_ODB":"Oděvy ",
"NAZEV_ODB":"Pracovní oděvy s.r.o. ",
"ICO_ODB":"456789",
"ID":"D090C492-807B-43B3-B27D-54EF0B48555B",
"ID_PAR":"90375AD7-1209-4422-9D4D-9B7CC015211F",
"POL_ZOUT":
[
{
"FAKTURA":10,
"TEXT":"Daňová záloha 20% ",
"MNOZSTVI":1.000,
"MJ":"",
"CENA_MJ":12000.00000,
"CENA_SLV":0.00,
"SLEVA_PR":0.00,
"CENA":12000.00,
"CENA_DPH":2520.00,
"SAZBA_DPH":21.00,
"KOD_DPH":"36",
"MATERIAL":"",
"ZDROJ":0,
"OPERACE":"31 ",
"POL_KOD":" ",
"SLEVA":0.00,
"ID":"B08954F3-C07F-4E38-B86A-D78B3FC54F19",
"PORDER":1
}
]
}
]
}

příkaz FA_ZOUT_ADD

vkládání vydaných zálohový listů

{
"command": {
"inComm": "FA_ZOUT_ADD"
},
"Data": {
"DOKLAD": "VYZ", /* dokladová řada */
"cislo": 0, /* číslo zálohového listu */
"K_SYMBOL": "123", /* konstantní symbol */
"DATUM_VYS": "2019-11-23", /* datum vystavení */
"DATUM_SPL": "2019-10-28",   /* datum splatnosti */
"DATUM_USK": "2019-10-21",    /* datum uskutečnění */
"CELKEM": 50, /* částka celkem */
"ZKKOD": null, /* zakázka */
"STKOD": "15", /* středisko */
"POPIS": "popis", /* popis */
"ID_PAR": "2F5A7E6C-8F76-40CE-8CB5-D2181166D037",   /* ID tab. partnery, vedený jako dodavatel (každý partner může být veden jako dodavatel i odběratel) */
"ID_KON": null, /* ID tab. part_kon */
"ID_ADR": null,   /* ID adresy (toto ID není přímo součástí tab. FA_IN, ale je vhodné jej uvést pro potřebu přebírání dat, jako je třeba UCET_ODB, KOD_ODB a BIC */
"POZNAMKA": "poznámka", /* poznámka */
"UC_VF": null,
"UC_VFA": null,
"M_KURS": 0, /* kurz - množství */
"FORMA": 'Hotovosť', /* forma úhrady - povolené hodnoty ['Hotovosť','Prevodným príkazom','Dobierkou','Platobnou kartou','Zápočtom','Inkasom','Hotově','Převodním příkazem','Dobírkou','Platební kartou','Zápočtem','Inkasem'] */
"OBJEDNAVKA": null, /* číslo objednávky */
"DOD_LIST": null, /* číslo dodacího listu */
"BARVA": 255, /* vizuální podbarvení řádku */
"FA_POL": [
{
"TEXT": "polozka1", /* text položky */
"CENA": 50, /* cena bez dph */
"MNOZSTVI": 1, /* množství */
"Cena_MJ": 50, /* cena za MJ */
"SAZBA_DPH": null, /* sazba DPH */
"KOD_DPH": '15', /* kód DPH */
"CENA_DPH": 0, /* DPH */
  "DAN1": null, /* číselník doplňkové analýzy (N) - pro příspěvkové organizace obvykle Uz */
"DAN2": null, /* číselník doplňkové analýzy (N) - pro příspěvkové organizace obvykle OdPa */
"DAN3": null, /* číselník doplňkové analýzy (C) - pro příspěvkové organizace obvykle Pol */
"ZKKOD": 0, /* zakázka */
"STKOD": 0, /* středisko */
  "UC_S": null, /* syntetický účet Dal */
"UC_SA": null, /* analytický účet Dal */
"UC_D": null, /* syntetický účet DPH – pokud je UC_D a UC_DA prázdné, doplní se přednastavená hodnota čísla účtu z číselníku kódů DPH, jeli vyplněn */
"UC_DA": null /* analytický účet DPH */
}
]
}
}

Result

{
"Result":"OK",
"CommandIn":"FA_ZOUT_ADD",
"Data":
{
"cislo_fa": 15000005.0,
"inter_fa": 14,
"id_fa": "5874B225-1777-40B8-8589-DD3D87762E5A"
}
}

příkaz PARTNERI

tabulka partnerů.

{
"command": {
"inComm": "PARTNERI",
"inParam": {
"parameters": {
"part_typ": null,                                          /* OD – odběratelé / DO – dodavatelé / FULL – všichni partneři */
"part_ico": "12345678", /* IČ partnera */
"part_dic": null, /* DIČ partnera */
"part_nazev": null, /* název partnera */
"part_id": null,                                            /* ID partnera */
"part_cis": null,                                           /* Zkratka v IS Premier */
"e_mail": null, /* e-mailový kontakt partnera */
"part_adr": 0,                                              /* 0/1 – svázat (doplnit) i s tab. adres partnerů (PART_ADR) */
"part_kon": 0,                                             /* 0/1 – svázat (doplnit) i s tab. kontaktů partnerů (PART_KON)
Kontakty jsou svázány s partnerem ale i na adresu partnera, proto když part_kon=1, vrátí se kontakty na partnera, ale když je part_kon=1 a současně part_adr=1, tak se vrátí ke každé adrese i příslušné kontakty */
"timestamp": null                                       /* časové razítko = vrací výsledky od zadaného data a času */
}
}
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
[part_typ,part_ico,part_id,part_cis] nebo [queryConditions]

Příkaz umožňuje vložit i vlastní podmínku (queryConditions).

Příklad vlastní podmínky

{
"command": {
"inComm": "PARTNERI",
"inParam": {
"parameters": {
"part_typ": null,
"part_ico": null,
"part_id": null,
"part_cis": null,
"part_adr": 0,
"part_kon": 0,
"timestamp": null
}
},
"queryCondition": {
"tableName": "PARTNERY",
"conditions": [
{
"logicalOperator": "AND",                      /* logický operátor AND/OR */
"fieldName": "INTER",                              /* název položky, na kterou se podmínka vztahuje */
"relationalOperator": ">",                      /* relační operátor >/</<=/>=/<>/=/IN/LIKE */
"value": "100"                                           /* hodnota */
},
{
"logicalOperator": "AND",
"fieldName": "INTER",
"relationalOperator": "<",
"value": "900"
}
]
}
}
}}

Příklad vyhledání partnera dle jeho názvu
např. pro zjištění povinného parametru ID_PAR konkrétního partnera při ukládání dokladů

{
"command": {
"inComm": "PARTNERI",
"inParam": {
"parameters": {
"part_typ": "OD",
"part_ico": null,
"part_id": null,
"part_cis": null,
"part_adr": 0,
"part_kon": 0,
"timestamp": null
}
},
"queryCondition": {
"tableName": "PARTNERY",
"conditions": [
{
"fieldName": "NAZEV",
"relationalOperator": "LIKE",
"value": "'%SIMON%'"
}
]
}
}

Grafické zobrazení vybraných DB položek v prostředí Premiera, vrácených v Result
(seznam všech DB položek, včetně datových typů, velikosti, povinnosti a popisu naleznete v Helpu webového rozhraní, viz. odkaz výše)

příkaz PARTNERI_ADD

vložení nového nebo změna záznamu v tab. partnerů.

{
"command": {
"inComm": "PARTNERI_ADD",
"inParam": {
"parameters": {
"typCmd": “UPD“, /* ADD – přidání nového partnera, UPD – změna stávajícího partnera podle ID partnera */
"id_part": "780AE598-0411-4109-9D50-EDA99E76937C" /* ID čísla partnera, je nutné uvést u příkazu UPD = ID vráceno v Result nebo příkazem PARTNERI */
}
}
},

"Data": {
"INTER": "0",
"CISLO": "TST", /* zkrácený název */
"NAZEV": "Test ADD00", /* název partnera - musí být jedinečný, pokud fyzická osoba má totožný název, můžete nakonec názvu přidat pořadové číslo s prefixem #, vše za tímto znakem se pak nedostává nikam do tisku */
"ALT_NAZEV": null,                                        /* alternativní název */
"ULICE": null, /* Ulice */
"PSC": null, /* PSČ */
"MESTO": null,                                                /* Město */
"KOD_ZEME": null,                                         /* dvoumístný kód země */
"STAT": null,                                                    /* název státu */
"ICO": "12345678", /* IČO nesmí být "null" - pokud je prázdné (u zahraničního dodavatele), doplňte prázdný řetězec ("ICO": ““). Kontroluje se na duplicitu NAZEV+ICO. Parametr ICO nesmí být delší než 8 znaků */
"ICO_PLUS": "910", /* rozšíření pole IČO o možnost vložení delšího, než 8 znaků. Výsledkem je sloučení a zápis ICO + ICO_PLUS, tj. 12345678910
"DIC": null, /* DIČ */
"KON_PRIJEM": null,                                      /* Vyřizuje */
"MOBIL": null, /* mobilní číslo */
"E_MAIL": null,                                               /* email */
"BANKA": null, /* číslo bankovního účtu */
"KOD_BANKY": null,                                       /* kód banky */
"BIC": null, /* BIC */
"SPEC": null, /* specifický symbol */
"IBAN": null, /* IBAN */
"ODBERATEL": true,                                       /* odběratel true/false */
"DODAVATEL": false                                      /* dodavatel true/false */
"DIC_SK": null, /* SK DIČ */
"USER_C02": null, /* uživatelská proměnná */
"STITKY": null /* ““ = vymazání existujících štítků; pro přidání stačí zapsat kód z číselníku štítků (např. "STITKY": “KLI“)
"SKUP_SES": null,
}
}

příkaz PART_ADR_ADD

vložení nebo změna adresy partnera (tab. part_adr)

{
"command": {
"inComm": "PART_ADR_ADD",
"inParam": {
"parameters": {
"typCmd": null,                                           /* ADD – přidání nové adresy, UPD – změna stávající adresy partnera (jedná se o povinný atribut) */
"id_part": null,                                            /* ID partnera */
"id_adr": null                                               /* ID adresy */
}
}
},
"Data": {
"INTER": 0,                                                       /* id číslo */
"INT_ADR": 0,
"CISLO": null,                                                   /* zkratka */
"OSLOVENI": null,                                           /* oslovení */
"NAZEV": null,                                                 /* název partnera */
"ALT_NAZEV": null,                                        /* druhý název */
"ULICE": null,                                                   /* ulice */
"PSC": null,                                                       /* PSČ */
"MESTO": null,                                                /* Město */
"STAT": null,                                                    /* název státu */
"ICO": null,                                                       /* IČO */
"DIC": null,                                                       /* DIČ */
"KON_PRIJEM": null,                                      /* kontaktní osoba - vyřizuje */
"DOPRAVA": null,                                           /* způsob dopravy */
"MOBIL": null,                                                 /* mobil */
"E_MAIL": null,                                               /* email */
"ODBERATEL": false,                                      /* odběratel ANO/NE */
"DODAVATEL": false                                      /* dodavatel ANO/NE */
}
}

příkaz SLEVY

zákaznické ceníky

{
"command": {
"inComm": "SLEVY",
"inParam": {
"parameters": {
"id_part": null, /* Slevy se dají získat i podle ID partnera. Pokud je parametry vyplněný, ostatní parametry (part_ico, part_cis, part_naz) sa ignorují */
"part_ico": null, /* Slevy podle IČ partnera */
"part_cis": null, /* Slevy podle zkratky partnera */
"part_naz": null, /* Slevy podle názvu partnera */
"skl_cislo": "NULL" /* skladové číslo */
}
}
}

Result

{
  "Result":"OK",
  "CommandIn":"SLEVY",
  "Data":
  [
  {
  "POZNAMKA":"MM21004", /* poznámka */
  "CENIK":"MAKRO CR", /* zákaznický ceník č. */
  "PLAT_OD":"2021-01-25T00:00:00", /* platnost od */
  "PLAT_DO":"2021-02-16T00:00:00", /* platnost do */
  "ONLY_SKLAD":0, /* pouze sklad č. */
  "CISLO_ODB":"0873", /* číslo odběratele */
  "NAZEV_ODB":"ABC, s.r.o.", /* název odběratele */
  "ICO_ODB":"26000691", /* ič odběratele */
  "SORTIMENT":"003", /* sortiment */
  "ODKARTY":"4008895",
  "DOKARTY":"4008895",
  "ONLY_ONE":true, /* Pokud při nákupu bude odběrateli náležet jakákoliv jiná vyšší sleva, tak tuhle ignorovat */
  "ONLY_KAT":false, /* Pokud při nákupu bude odběrateli náležet vyšší sleva ve stejné kategorii, tak tuhle ignorovat */
  "IS_ABSOLUT":false, /* Tato sleva / cena má absolutní prioritu */
  "SLEVA":5, /* Procentuální ze součtu všech položek */
  "PROC_IND":0.000, /* Procentuální na základě aktuální položky */
  "PEVNA_ISL":0.00, /* Pevná sleva k položce */
  "PEVNA_ICE":64.76600, /* Pevná cena položky včetně DPH */
  "PEVNA_RS":0, /* Cenu čerpat z rabatní skupiny č */
  "VZOREC":"", /* Vypočítat cenu položky dle vzorce */
  "PROC_CASH":0.000, /* CashBack (přidělení bodů nebo virtuálních peněz) (ze součtu všech položek včetně DPH) */
  "CASH_KARTA":"", /* Evidovat na kartě */
  "KOEF_CASH":0.000 /* CashBack - jiný koeficient při čerpání bodů (1 bod = KOEF_CASH Kč) */
  }
  ]
}

příkaz SORTIMENT

vrací skupiny skladových karet. Příkaz nemá dodatečné parametry

{
"command": {
"inComm": "SORTIMENT"
}
}

Result

{
"Result":"OK",
"CommandIn":"SORTIMENT",
"Data":
[
{
"_key":"Betonová ", /* název */
"parent":"Krytina", /* přesný název rodičovského sortimentu (nadřazená kategorie) */
"popis":"Betonová krytina" /* popis */
},
{
"_key":"Krytina",
"parent":"",
"popis":"Krytina"
}
]
}

příkaz CENIK

vrací seznam skladových karet, včetně cen. Příkaz umožňuje vložit i vlastní podmínku (queryConditions).

{
"command": {
"inComm": "CENIK",
"inParam": {
"parameters": {
"pub_name": "",                                         /* název publikace (www ceník) */
"sklad": "1",                                                 /* číslo skladu */
"is_notnull": 0,                                            /* vrací jen nenulové položky */
"skl_cislo": "100983",                                /* skladové číslo */
"ean": null,                                                   /* EAN karty nebo EAN balení */
"timestamp": null,                                      /* časové razítko = vrací výsledky od zadaného data a času */
"is_rozclen": null                                        /* doplnění aktuálního rozčlenění */
}
}
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
číslo skladu [sklad]

Grafické zobrazení vybraných DB položek v prostředí Premiera, vrácených v Result
(seznam všech DB položek, včetně datových typů, velikosti, povinnosti a popisu naleznete v Helpu webového rozhraní, viz. odkaz výše)

Pole "kg/" je vypočteno ze zadané hodnoty MN_KG, tzn. vzorec je: zaokroulit(1/MN) na celé číslo. V Result se vrací jen informativně jako hodnota KG_KS.

Výsledek (Result)

{
"Result":"OK",
"CommandIn":"CENIK",
"Data":
[
{
"INTER":0,
"ZDROJ":"",
"SKLAD":1,
"CISLO":"1",
"C_KOD":"",
"TEXT":"mama",
"TEXT_2":"",
"SORTIMENT":"",
"MJ":"",
"SAZBA_DPH":0.00,
"KOD_DPH":"36",
"PRIJEM":0.000,
"VYDEJ":0.000,
"MIN":0.000,
"MAX":0.000,
"IDEAL":0.000,
"OBAL_MJ":"",
"OBAL_MJ2":"",
"OBAL_MJ3":"",
"OBAL_BAL":"",
"OBAL_BAL2":"",
"OBAL_PAL":"",
"OBAL_PAL2":"",
"ZAOK":0,
"RAB_PR0":0.00,
"RAB_PR1":0.00,
"RAB_PR2":0.00,
"RAB_PR3":0.00,
"RAB_PR4":0.00,
"RAB_PR5":0.00,
"RAB_CN0":405.00000,
"RAB_CN0D":490.05000,
"RAB_CN1":0.00000,
"RAB_CN1D":0.00000,
"RAB_CN2":0.00000,
"RAB_CN2D":0.00000,
"RAB_CN3":0.00000,
"RAB_CN3D":0.00000,
"RAB_CN4":0.00000,
"RAB_CN4D":0.00000,
"RAB_CN5":0.00000,
"RAB_CN5D":0.00000,
"ZPUSOB":0,
"SKUPINA":0,
"UMISTENI":"",
"MN_KG":0.00000000000,
"MN_BAL":0.00000,
"BAL_PAL":0.000,
"IDEN1":"",
"IDEN2":"",
"IDEN3":"",
"IDEN4":"",
"IDEN5":"",
"RABINV":false,
"UCTY_IND":false,
"U112":"",
"U111":"",
"U500":"",
"U600":"",
"U119":"",
"UC_NAK":"",
"UC_NAKA":"",
"UC_PROD":"",
"UC_PRODA":"",
"DIM_1":0,
"DIM_2":0,
"DIM_3":0,
"DIM_MJ":"",
"DIM_ZAKL":0,
"ISNOT_SLV":false,
"PEVNA_CENA":0.00000,
"ZPEVNA":0.00000,
"RAB_CN0Z":0.00000,
"RAB_CN1Z":0.00000,
"RAB_CN2Z":0.00000,
"RAB_CN3Z":0.00000,
"RAB_CN4Z":0.00000,
"RAB_CN5Z":0.00000,
"POPIS1":"", /* popis #1 (240 znaků) */
"POPIS2":"", /* popis #2 (960 znaků) - první část #2, je potřeba spojit dohromady POPIS2B, POPIS2C, POPIS2D */
"POPIS2B":"", /* druhá část popisu #2 */
"POPIS2C":"", /* třetí část popisu #2 */
"POPIS2D":"", /* čtvrtá část popisu #2 */
"IS_OBAL":false,
"ROZ_SN":false,
"ROZ_OS1":false,
"TROZ_OS1":"",
"ROZ_LAR":false,
"ROZ_COL":false,
"ROZ_TRV":false,
"ROZ_PRI":false,
"ROZ_OS2":false,
"TROZ_OS2":"",
"ROZ_OS3":false,
"TROZ_OS3":"",
"ROZ_BAL":false,
"ROZ_PAL":false,
"ZARUK_IN":0,
"ZARUK_OUT":0,
"ZMES_IN":0,
"ZMES_OUT":0,
"RAB_0Z2":0.00000,
"RAB_1Z2":0.00000,
"RAB_2Z2":0.00000,
"RAB_3Z2":0.00000,
"RAB_4Z2":0.00000,
"RAB_5Z2":0.00000,
"RAB_0Z3":0.00000,
"RAB_1Z3":0.00000,
"RAB_2Z3":0.00000,
"RAB_3Z3":0.00000,
"RAB_4Z3":0.00000,
"RAB_5Z3":0.00000,
"RAB_0Z4":0.00000,
"RAB_1Z4":0.00000,
"RAB_2Z4":0.00000,
"RAB_3Z4":0.00000,
"RAB_4Z4":0.00000,
"RAB_5Z4":0.00000,
"RAB_0Z5":0.00000,
"RAB_1Z5":0.00000,
"RAB_2Z5":0.00000,
"RAB_3Z5":0.00000,
"RAB_4Z5":0.00000,
"RAB_5Z5":0.00000,
"RAB_PZ2":0.00000,
"RAB_PZ3":0.00000,
"RAB_PZ4":0.00000,
"RAB_PZ5":0.00000,
"VAR_BAL":false,
"VAR_PAL":false,
"K_PLATNOST":0, /* Platnost do roku */
"NAKL_CENA":0.00000,
"NAKL_CM1":0.00000,
"NAKL_CM2":0.00000,
"NAKL_CM3":0.00000,
"IS_VYROBEK":false,
"ROZ_OS1IN":false,
"ROZ_OS1OU":false,
"ROZ_OS1VY":false,
"ROZ_LARIN":false,
"ROZ_LAROU":false,
"ROZ_LARVY":false,
"ROZ_COLIN":false,
"ROZ_COLOU":false,
"ROZ_COLVY":false,
"ROZ_TRVIN":false,
"ROZ_TRVOU":false,
"ROZ_TRVVY":false,
"ROZ_OS2IN":false,
"ROZ_OS2OU":false,
"ROZ_OS2VY":false,
"ROZ_OS3IN":false,
"ROZ_OS3OU":false,
"ROZ_OS3VY":false,
"MJ_2":"",
"MJ_3":"",
"MJ_4":"",
"MN_MJ_2":0.0000000,
"MN_MJ_3":0.0000000,
"MN_MJ_4":0.0000000,
"IS_OS1AUT":false,
"TEXT_3":"",
"TEXT_4":"",
"BARVA":0,
"PS_TIME":"2020050519:39:52",
"ISNOT_DN":false,
"VAHA_OBL1":0.0000000,
"VAHA_OBL2":0.0000000,
"VAHA_OBL3":0.0000000,
"VAHA_OBL4":0.0000000,
"VAHA_OBL5":0.0000000,
"VAHA_OBL6":0.0000000,
"OBAL1":"",
"OBAL2":"",
"OBAL3":"",
"OBAL4":"",
"OBAL5":"",
"OBAL6":"",
"ZPUS_OBL1":0,
"ZPUS_OBL2":0,
"ZPUS_OBL3":0,
"ZPUS_OBL4":0,
"ZPUS_OBL5":0,
"ZPUS_OBL6":0,
"IS_AOBAL":false,
"NADRAZ":"",
"id":"C0B6CF80-D135-4475-85A8-F5C6B8C81CD0",
"IN_ZTRATA":0.000,
"RAZ_ROZ1":0,
"RAZ_ROZ2":0,
"EAN_BAL":"",
"HUSTOTA":0.00,
"ROZ_LAR3D":false,
"JAKA_EXPIR":0,
"ROZ_PALIN":false,
"ROZ_LARSEL":0,
"KOD_KN":"",
"PUVOD_KRAJ":"",
"PUVOD_STAT":"",
"SPOT_DAN":"",
"IS_SLUZBA":false,
"MNOZ_DECI":0,
"FREE_DOK":"",
"KASA_UPCN":false,
"USER_C01":"",
"USER_C02":"",
"USER_C03":"",
"USER_C04":"",
"USER_C05":"",
"USER_C06":"",
"USER_C07":"",
"USER_C08":"",
"BEZ_SPOTD":false,
"IS_NADRAZ":false,
"JINY_CASHB":0.00,
"MN_OBAL1":0.0000000,
"MN_OBAL2":0.0000000,
"MN_OBAL3":0.0000000,
"CENA_SADY":0,
"MAX_SLEVA":0.00,
"LSET":"",
"TS":"AAAAAAAAB/c=",
"STITKY":"",
"kg_ks":0.00000000000,
"akce":"",
"ts_kart":"",
"ts_pict":"",
"bez_cesty":"",
"sortimenty":"",
"alt_ean":"",
"crossref":"",
"cros_pozn":"",
"crossref2":"",
"cros_pozn2":"",
"crossref3":"",
"cros_pozn3":"",
"dalsi_obr":"",
"dalsi_poz":"",
"y_sn":"",
"y_ost1":"",
"y_lar":"",
"y_col":"",
"y_ost2":"",
"y_ost3":"",
"y_bal":"",
"y_pal":"",
"skl_cena":0.00,
"timePec":"2020-05-05T19:39:52",
"img":
[
{
}
]
}
]
}

příkaz DOKL_PU

vrátí přehled dokladových řad

{
"command": {
"inComm": "DOKL_PU",
"inParam": {
"parameters": {
"typ_dr": null, /* FULL = vše, SKLAD = sklad */
"tok": null /* konkrétní typ dokladové řady [1 - POKLADNA, 2 - BANKA, 3 - FA_IN, 4 - FA_OUT, 6 - ZAPOCTY, 22 - OB_IN, 23 - VYDEJKY, 25 - OB_OUT, 26 - PRIJEMKY] */
}
}
}
}

příkaz DOCUMENT

vrátí volný nebo exportovaný dokument v BASE64

{
"command": {
"inComm": "DOCUMENT",
"inParam": {
"parameters": {
"typ": "VF", /* typ dokladu: VF = vydaná faktura / PF = přijatá faktura */
"id": "54D5167E-77BE-4A1C-A008-B3E07050B685", /* ID číslo dokladu */
"soubor": null /* název souboru (pokud se zadá název souboru, tak vrátí dokument v BASE64, pokud parametr není vyplněný, vrátí se seznam dokumentů dle zadaných parametrů) */
}
}
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "DOCUMENT",
"error": "",
"warning": "",
"data": {
"typ": "VF",
"id": "82A0A187-F8A1-42CA-85DE-C131CCD1860C",
"documents": [
{
"zdroj": "F", /* F – free (volný) dokument / E - exportovaný dokument */
"fileName": "DAN_EKO_EE_POKYNY_4.PDF", /* název souboru */
"filePath": "..\\dokument\\sc23\\DAN_EKO_EE_POKYNY_4.PDF", /* cesta souboru */
"filePathBase64": "Li5cZG9rdW1lbnRcc2MyM1xEQU5fRUtPX0VFX1BPS1lOWV80LlBERg==", /* cesta souboru v BASE64, slouží jako parametr pro volání HTTP GET. Příklad: https://dev.premier.cz:12375/getFile.html&Li5cZG9rdW1lbnRcZmExXFZGMjAxOTA4ODMxLlBERg== */
"mime": "PDF", /* typ dokumentu */
"create": "2019-06-24 18:40:04Z", /* vytvořeno */
"desc": "Odkaz na dokument k: DP 800001" /* popis */
},
{
"zdroj": "E",
"fileName": "DP800001.PDF",
"filePath": "..\\dokument\\fa23\\DP800001.PDF",
"filePathBase64": "Li5cZG9rdW1lbnRcZmEyM1xEUDgwMDAwMS5QREY=",
"mime": "PDF",
"create": "2019-06-24 16:20:40Z",
"desc": ""
}
]
}
}

Příkaz z parametrem pro zobrazení konkrétního souboru

{
"command": {
"inComm": "DOCUMENT",
"inParam": {
"parameters": {
"typ": "VF", /* typ dokladu: VF = vydaná faktura / PF = přijatá faktura */
"id": "54D5167E-77BE-4A1C-A008-B3E07050B685", /* ID číslo dokladu */
"soubor": "DAN_EKO_EE_POKYNY_4.PDF" /* název souboru, kdy se vrátí dokument v BASE64 */
}
}
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "DOCUMENT",
"error": "",
"warning": "",
"data": {
"typ": "VF",
"id": "82A0A187-F8A1-42CA-85DE-C131CCD1860C",
"documents": [
{
"zdroj": "F",
"fileName": "DAN_EKO_EE_POKYNY_4.PDF",
"filePath": "..\\dokument\\sc23\\DAN_EKO_EE_POKYNY_4.PDF",
"filePathBase64": "Li5cZG9rdW1lbnRcc2MyM1xEQU5fRUtPX0VFX1BPS1lOWV80LlBERg==",
"mime": "PDF",
"create": "24. 6. 2019 18:40:04",
"desc": "Odkaz na dokument k: DP 800001",
"base64": " . . . BASE64 souboru . . . “
}
]
}
}

Povinné je vyplnění některého z těchto parametrů:
[typ, id]

příkaz PART_COUNT

vrátí počty dokladů vystavené na partnera

{
"command": {
"inComm": "PART_COUNT",
"inParam": {
"parameters": {
"id_part": null /* id partnera */
}
}
}
}

příkaz SEZ_SKL

vrátí seznam skladů

{
"command": {
"inComm": "SEZ_SKL"
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "SEZ_SKL",
"error": "",
"warning": "",
"data": [
{
"CISLO": 1,
"POPIS": "Hlavní sklad - Zboží",
"POZNAMKA": "",
"US_ADD": "",
"US_EDI": "",
"USD_ADD": "",
"USD_EDI": "",
"U112": "132100 ",
"U111": "131100 ",
"U500": "504100 ",
"U600": "604100 ",
"U119": "119000 ",
"UC_NAK": "32 ",
"UC_NAKA": " ",
"UC_PROD": "11 ",
"UC_PRODA": " ",
"RABLOKAL": false,
"RABZPUS": 3,
"RABZAOK": 3,
"RAB0": 0,
"RAB1": 0,
"RAB2": 0,
"RAB3": 0,
"RAB4": 0,
"RAB5": 0,
"INDI_SORT": false,
"PRED_SKP": " ",
"PRED_SKV": " ",
"ID": "09FF4C7B-961B-4765-90B3-D000F9E018BB",
"PLATNOST": 0,
"KON_PRIJEM": "",
"KON_TEL": "",
"KON_FAX": "",
"KON_MAIL": "",
"KON_NAZEV": "",
"KON_ULICE": "",
"KON_MESTO": "",
"KON_PSC": "",
"KON_STAT": "",
"KON_EAN": "",
"NEUCETNI": false,
"TS": "AAAAAAAA2FI="
}
]
}

příkaz SKLAD_STAV

vrátí stav na skladě - objednané nebo rezervované množství ze skladu podle časového razítka nebo skladového čísla

{
"command": {
"inComm": "SKLAD_STAV",
"inParam": {
"parameters": {
"skl_cislo": "203748", /* skladové číslo; pokud není vyplněno, vrátí všechny skladové karty */
"sklad": "1", /* číslo skladu */
"timestamp": null, /* časové razítko – vrací záznamy změněné ve skladu od zadaného data a času; Příkaz se volá s aktuálním datem a časem. Pokud je zapnutý přepočet, dojde v databázi k uložení v aktuálních stavů do tabulky HTTP_STAV_SKLAD s časovým razítkem zjištěné změny. Jen tyto změněné záznamy se pak příkazem vrací v Result; Stavy se ukládají do tabulky HTTP_STAV_SKLAD současně se jménem připojeného uživatele v autentizaci, tzn. pro každého uživatele se bude vracet odlišný rozsah změn od té poslední */
"obj_calc": 1, /* přepočítat objednávky */
"poh_calc": 1 /* stavy přepočítat z pohybů */
}
}
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
číslo skladu [sklad]

Výsledek (Result)

{
"result": "OK",
"commandin": "SKLAD_STAV",
"error": "",
"warning": "",
"data": [
{
"cislo": "01", /* číslo skladové karty */
"sklad": 1, /* číslo skladu */
"stav": 1006, /* stav na skladě */
"objed": 0, /* objednané množství */
"rezer": 0, /* rezervované množství */
"disp": 1006 /* disponibilní množství (stav - rezer = disp) */
}
]
}

Skladovou cenu produktu API příkaz přímo nezjišťuje, lze ji získat následným selectem:

{
"select": "select vp = fifo.cena_avg/(fifo.kon_mn-fifo.mnozstvi), * from FIFO where cislo = '8010011' and sklad = 1"
}

příkaz SKLAD_ADD

zápis nebo změna skladové karty

{
"command": {
"inComm": "SKLAD_ADD",
"inParam": {
"parameters": {
"typCmd": null,                                           /* [ADD] - přidaní karty, [UPD] - úprava existujícího karty */
"sklad": null,                                                /* číslo skladu */
"skl_cislo": null,                                          /* skladové číslo (Karta), max. 20 znaků*/
"id_cislo": null                                             /* ID číslo skladové karty */
}
}
},
"Data": {
"C_KOD": null, /* EAN */
  "TEXT": null, /* název #1 */
"TEXT_2": null,   /* název #2 */
"SORTIMENT": null, /* sortiment */
"MJ": null, /* měrná jednotka */
"SAZBA_DPH": null, /* sazba DPH */
"KOD_DPH": null, /* kód DPH */
"TEXT_3": null, /* název #3 */
"TEXT_4": null, /* název #4 */
"KOD_KN": null,                                              /* kód zboží dle celního sazebníku */
"PUVOD_STAT": null,                                     /* stát původu */
"MN_KG": null, /* množství na 1 kg */
"MN_BAL": null, /* množství v balení */
"BAL_PAL": null,                                             /* bal./paletu */
"EAN_BAL": null, /* EAN kód, který při zápisu kontroluje duplicitu EAN v jiných skladových záznamech. Pokud ji najde, vrátí chybu */
"UMISTENI": null, /* umístění ve skladu */
"MIN": null,
"IDEAL": null,
"MAX": null,
"USER_C01": null,
"USER_C02": null,
"USER_C03": null,
"USER_C04": null,
"USER_C05": null,
"USER_C06": null,
"USER_C07": null,
"USER_C08": null,
"POPIS1": null, /* Popis #1 (max. 240 znaků) */
"POPIS2": null, /* Popis #2 (1. část) - max. 240 znaků */
"POPIS2B": null, /* Popis #2 (2. část) - max. 240 znaků */
"POPIS2C": null, /* Popis #2 (3. část) - max. 240 znaků */
"POPIS2D": null, /* Popis #2 (4. část) - max. 240 znaků */
"NAKL_CENA": null /* nákladová cena */
"ZMES_OUT": null, /* rozčlenění - záruky měsíců - out */
"ROZ_SN": null, /* rozčlenění dle sériových čísel */
"ZARUK_OUT": null, /* rozčlenění - záruční doby - out */

"RAB_CN0": 405, /* rabatní skupina 0: pořizovací cena */
"RAB_CN0D": 490.05, /* rabatní skupina 0: pořizovací cena s DPH */
"RAB_CN1": null, /* rabatní skupina 1: pořizovací cena */
"RAB_CN1D": null /* rabatní skupina 1: pořizovací cena s DPH */
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
název [text]

Grafické zobrazení vybraných DB položek v prostředí Premiera - viz. příkaz Ceník

příkaz POL_SDT

vrátí stav na skladě podle výrobního čísla, šarže, umístění, trvanlivost, jiné #1 - objednané nebo rezervované množství ze skladu podle časového razítka nebo skladového čísla.

{
"command": {
"inComm": "POL_SDT",
"inParam": {
"parameters": {
"scislo": null, /* skladové číslo */
"sklad": null, /* číslo skladu */
"sn": null, /* sériové číslo */
"sarze": null, /* šarže */
"umisteni": null, /* umístění */
"trvanlivost": null, /* datum trvanlivosti */
"jine_1": null
}
}
}
}

Result

{
"Result":"OK",
"CommandIn":"POL_SDT",
"Data":
[
{
"scislo":"4040000160",
"sklad":3,
"jine#1":"",
"sarze":"2014033103",
"umistneni":"B041800 ",
"trvanlivost":"2020-08-14",
"sn":"",
"stav":288.000
}
]
}

příkaz IMAGE

Vrátí obrázek(y) uložený(é) ze skladu ve formátu BASE64

{
"command": {
"inComm": "IMAGE",
"inParam": {
"parameters": {
"filename": "204631.jpg", /* souborové jméno obrázku - povinné, příp. skl_cislo, id_cislo */
"skl_cislo": null, /* vrátí všechny obrázky podle skladového čísla - povinné, příp. filename, id_cislo */
"id_cislo": null /* vrátí všechny obrázky podle ID skladové karty - povinné, příp. filename, skl_cislo */
}
}
}
}

Povinné parametry:
[filename,skl_cislo,id_cislo]

Result

{
"Result":"OK",
"CommandIn":"IMAGE",
"Warning":
[
{
"desc":"soubor obrázku nenalezen [ICO_ADD.BMP]" /* v případě chybějícího souboru obrázku je zobrazeno Varování s názvem souboru */
}
],
"Data":
{
"listImage":
[
{
"filename":"ICO_ADD.BMP",
"file": null /* chybějící soubor obrázku vrací hodnotu null */
},
{
"filename":"VYR_ETIKETA_SMALL.JPG", /* název (+ cesta) */ "file":"/9j/4AAQSkZJRgABAQEAYABgAAD/4QAiRXhpZgAATU0AKgAAAAgAAQESAAMAAAABAAEAAAAAAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAAQABYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoK" /* BASE64 */
}
]
}
}

příkaz OB_IN

načtení přijatých objednávek

{
"command": {
"inComm": "OB_IN",
"inParam": {
"parameters": {
"cislo_obj": 2015100776,                         /* číslo objednávky */
"id_obj": null,                                              /* ID objednávky */
"ico_part": null,                                          /* IČO partnera */
"id_part": null,                                            /* ID partnera */
"cis_part": null,                                           /* zkratka partnera */
"dat_od": null,                                            /* období od */
"dat_do": null,                                            /* období do */
"sklad": null,                                                /* číslo skladu (povinné) */
"dokl_r": null,                                              /* číslo dokladové řady */
"timestamp": null,                                      /* časové razítko, vrátí jen změnu stavu od zadané hodnoty */
"det_adr": null,                                           /* 1 = příznak, zda připojit dodací adresu partnera (tab. part_dod), když je zadán v dokladu (v Result vyplněné pole ID_DOD). Vrátí JSON „det_adr“ a výběr polí z „part_adr“ lze skrz příkaz „queryFields“ */
"nesplneno": null                                       /* 1 = pouze neukončené objednávky */
}
}
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
[cislo_obj,id_obj,ico_part,id_part,cis_part,sklad,dokl_r,timestamp] nebo [queryConditions]

Příkaz umožňuje vložit i vlastní podmínku (queryConditions).

Grafické zobrazení vybraných DB položek v prostředí Premiera, vrácených v Result
(seznam všech DB položek, včetně datových typů, velikosti, povinnosti a popisu naleznete v Helpu webového rozhraní, viz. odkaz výše)

příkaz OB_OUT

načtení vystavených objednávek.

{
"command": {
"inComm": "OB_OUT",
"inParam": {
"parameters": {
"cislo_obj": null,                                         /* číslo objednávky */
"id_obj": null,                                              /* ID objednávky */
"ico_part": null,                                          /* IČO partnera */
"id_part": null                                             /* ID partnera */,
"cis_part": null,                                           /* zkratka partnera */
"dat_od": null,                                            /* období od */
"dat_do": null,                                            /* období do */
"sklad": null                                                 /* číslo skladu (povinné) */,
"dokl_r": null,                                              /* číslo dokladové řady */
"det_kon": null,                                          /* 1 = příznak, zda připojit kontakt partnera (tab. part_kont), když je zadán v dokladu (v Result vyplněné pole ID_KON). Vrátí JSON „det_kon“ a výběr polí z „part_kon“ lze skrz příkaz „queryFields“ */
"timestamp": null                                       /* časové razítko, vrátí jen změnu stavu od zadané hodnoty */
}
}
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
[cislo_obj,id_obj,ico_part,id_part,cis_part,sklad,dokl_r,timestamp] nebo [queryConditions]

příkaz OBJ_CALC

vrací podle parametrů objednané, rezervované a vydané množství z přijaté objednávky.

Bez parametrů = shrnuto množství nesplněných objednávek dle skladového čísla

{
"command": {
"inComm": "OBJ_CALC",
"inParam": {
"parameters": {
"skl_cislo": null, /* skladové číslo (pouze nedodané) */
"int_obj": null /* INTER = id číslo objednávky, zobrazí všechny položky (i vydané) */
}
}
}
}

příkaz OB_IN_ADD

zápis nové přijaté objednávky

{
"command": {
"inComm": "OB_IN_ADD",
"inParam": {
"parameters": {

"isRecAut": null /* parametr pro zápis recyklačního a autorského poplatku položky (platí i pro OB_IN_ADD)

isRecAut = 0/ null - poplatky se nepoužívají
isRecAut = 1 – poplatky se použijí z nastavení karty
isRecAut = 2 – poplatky se definují v položce dokladu (vkládá se přes API), viz. POL_R a POL_A
*/
}

}
},
"Data": {
"DATUM_VYST": "2018-03-23", /* datum přijetí objednávky */
"DATUM_SPL": "2020-01-08", /* požadovaný termín dodávky */
"CELKEM": 0, /* částka celkem */
"BRUTTO": 0, /* částka celkem s DPH */
"CISLO": null, /* číslo objednávky - při hodnotě null se hledá číslo + 1 podle dokladové řady a účetního období. Pokud je nějaké číslo vloženo, tak zkontroluje existenci a pokud je volné, tak jej zapíše */
"STKOD": 0, /* středisko */
"ZKKOD": 2, /* zakázka */
"OBJEDNAVKA": "objednávka", /* Objednávka odběratele/zakázkové číslo */
"SKLAD": 1, /* číslo skladu */
"CIS_ESHOP": 123456, /* číslo z e-shopu, při zápise se kontroluje jeho existence */
"DOKLAD": "OBP", /* dokladová řada */
"ID_ODB": null, /* ID čísla partnera, je nutné uvést */
"ID_DOD": "DF0CFEF3-5842-42FB-AF8F-A0EE0388D944", /* ID adresy dodání = ID v part_adr */
"KON_PRIJEM": "kon_prijem", /* adresa konečného příjemce */
"POPIS": "popis", /* popis */
"POZNAMKA": "poznamka", /* poznámka */
"MORE_1": "more1", /* další popis #1 */
"MORE_2": "more2", /* další popis #2 */
"MORE_3": "more3", /* další popis #3 */
"MORE_4": "more4", /* další popis #4 */
"VYSTAVIL": "vystavil", /* zaevidoval */
"DOPRAVA": "doprava", /* způsob dopravy */
"PLATBA": null,
"BARVA": 255, /* barevné označení řádku */
"MENA": null, /* kód měny (EUR) – v případě CZK se pole MENA neplní */
"OZN_MENY": null, /* označení měny (€) – v případě Kč se pole OZN_MENA neplní */
"MENA_PRED": null, /* pozice měny: 0 = za částkou / 1 = před částkou (nepovinný parametr) */
"KURS": null, /* kurz */
"M_KURS": null, /* množství cizí měny pro daný kurz (výchozí hodnota v případě vyplněného kurzu je 1) */
"ZALOHA": 0, /* výše zálohy */
"TRASA": null,
"PRUBEH": null,
"TELO": null,
"TELO2": null,
"TELO3": null,
"TELO4": null,
"REZERVACE": 0, /* rezervovat na skladě 0/1/null */
"ONLY_KOMP": 0, /* pouze kompletní dodávka 0/1/null */
"ZARUKA": null, /* záruka */
"KOD_PLT": "", /* forma úhrady: H = hotově / D = dobírkou / K = platební kartou / P = převodním příkazem / (prázdná hodnota) */

"POL_OBIN": [                                                 /* tab. POL_OBIN */
{
"SCISLO": "200229", /* katalogové číslo */
"TEXT": "",                                                    /* název */
"TEXT_2": "", /* jiný popis, pokud je nevyplněn, přebírá se z nastavení odpovídající skladové karty */
"MNOZSTVI": 1.5,                                       /* množství / počet kusů */
"CENA_MJ": 15.0 ,                                      /* cena za MJ */
"CENA_SLV": 0.0, /* výše slevy */
"CENA": 15.8,                                              /* celkem (bez DPH) */
"CENA_DPH": 0, /* celkem (s DPH) */
"PSKLAD": 0, /* sklad */
"RAB_SK": 0.0,                                            /* rabatní skupina */
"SLEVA_PR": 0.0, /* sleva v procentech */
"MJ": "KS",                                                   /* měrná jednotka */
"KOD_DPH": 0, /* kód DPH */
"SAZBA_DPH": 21.0 /* procentní výše nejčastější sazby dph při prodeji */
"SN": null, /* sériové číslo */
"POUKAZ": null /* poukaz číslo */
"DALSI_N1": null, /* hodnota #1 */
"DALSI_N2": null, /* hodnota #2 */
"DALSI_N3": null, /* hodnota #3 */
"DALSI_N4": null, /* hodnota #4 */
"DALSI_N5": null, /* hodnota #5 */
"DALSI_N6": null, /* hodnota #6 */
"DALSI_C1": null, /* popis #1 */
"DALSI_C2": null, /* popis #2 */
"ZCENA_MJ": null, /* částka v cizí měně za MJ */
"MENA": null, /* měna */
"KURS": null /* kurz */
"POL_KOD": "S" /* pokud je vyplněno 'S' = daná položka objednávky se bere jako celková sleva */
"POL_R": { /* recyklační poplatek */
"TEXT": "", /* popis poplatku - nekontroluje se text */
"CENA_MJ": 0, /* jednotková částka poplatku */
"REC_INCL": false /* 0/null = poplatek není zahrnutý v částce zboží; 1 = poplatek je zahrnutý v ceně zboží */
},
"POL_A": { /* autorský poplatek */
"TEXT": "", /* popis poplatku - nekontroluje se text */
"CENA_MJ": 0, /* jednotková částka poplatku */
"REC_INCL": false /* 0/null = poplatek není zahrnutý v částce zboží; 1 = poplatek je zahrnutý v ceně zboží */
}

}

]
}
}

Povinné je vyplnění těchto parametrů:
[DATUM_VYST, DATUM_SPL, DOKLAD, ID_ODB]

Před zápisem se kontroluje období a program nedovolá záznam zapsat, pokud je již uzavřené.

příkaz OB_OUT_ADD

zápis nové vystavěné objednávky

{
"command": {
"inComm": "OB_OUT_ADD"
},
"Data": {
"DATUM_VYST": "2019-12-12", /* datum vystavení objednávky */
"DATUM_SPL": "2019-12-18", /* požadovaný termín dodávky */
"STKOD": 3, /* středisko */
"ZKKOD": 2, /* zakázka */
"SKLAD": 1, /* číslo skladu */
"DOKLAD": "OBS", /* dokladová řada */
"ID_ODB": "67387A8E-30B7-4EB6-A3FF-F8243290E933", /* ID odběratele v partnerech */
"KON_PRIJEM": "Příjemce", /* vyřizuje */
"POPIS": "popis", /* popis */
"POZNAMKA": "poznamka", /* poznámka */
"MORE_1": "more1", /* další popis #1 */
"MORE_2": "more2", /* další popis #2 */
"MORE_3": "more3", /* další popis #3 */
"MORE_4": "more4", /* další popis #4 */
"MORE_5": "more5", /* další popis #5 */
"MORE_6": "more6", /* další popis #6 */
"MORE_7": "more7", /* další popis #7 */
"MORE_8": "more8", /* další popis #8 */
"ZADAVATEL": "zadavatel", /* zadavatel */
"VYSTAVIL": "vystavil", /* vystavil */
"DOPRAVA": "doprava", /* způsob dopravy */
"BARVA": 255, /* barva podbarvení řádku v seznamu */
"POL_OBOU": [ /* položky objednávky */
{
"SCISLO": "1135141", /* číslo - provádí se kontrola na existenci skladové karty */
"TEXT": "test4", /* popis */
"MNOZSTVI": 5.0, /* množství */
"CENA_MJ": 10, /* cena/MJ */
"CENA_SLV": 5 , /* výše slevy */
"CENA": 100, /* cena (bez DPH) */
"CENA_DPH": 121, /* celkem (s DPH) */
"PSKLAD": 1, /* číslo skladu */
"RAB_SK": 1, /* rabatní skupina */
"SLEVA_PR": 5, /* sleva v procentech */
"MJ": "KS", /* měrná jednotka */
"KOD_DPH": 17, /* kód DPH - v případě existence skladové karty se přebírá z ní */
"SAZBA_DPH": 21, /* výše sazby DPH */
}
]
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
číslo skladu [sklad, DATUM_VYST, DATUM_SPL, DOKLAD, ID_ODB]

Result

{
"Result":"OK", /* výsledek OK/Err */
"CommandIn":"OB_OUT_ADD",
"Data":
{
"cislo_ob": 45000008.0, /* číslo vloženého dokladu */
"inter_ob": 23, /* interní číslo */
"id_ob": "582E1EE1-ECE0-4B53-AE72-A30F35CEB0B2" /* ID číslo */
}
}

příkaz OBJOUT_CALC

vrací objednané množství dle skladového čísla z vystavené objednávky.

Bez parametrů, které nejsou povinné = vrátí všechny skladové karty, ve kterých je objednávka pro dodavatele.
Bez parametrů = shrnuto množství nesplněných objednávek dle skladového čísla

{
"command": {
"inComm": "OBJOUT_CALC",
"inParam": {
"parameters": {
"skl_cislo": "100025",                                /* skladové číslo (pouze nepřijaté) */
"rozpis": 1,                                                   /* 0/1 – vrátí rozpis objednávek podle skladového čísla (pouze nedodané) */
"int_obj": null                                            /* id číslo (inter) objednávky – zobrazí všechny položky i přijaté */
}
}
}
}

příkaz PRIJEMKY

seznam příjemek

{
"command": {
"inComm": "PRIJEMKY",
"inParam": {
"parameters": {
"cis_dokl": "1",                                            /* číslo příjemky */
"ico_part": "2",                                           /* IČO partnera */
"dat_od": "2018-06-28", /* datum vystavení od */
"dat_do": "2018-06-28", /* datum vystavení do */
"sklad": "1", /* číslo skladu (povinné) */
"dokl_r": null,                                              /* dokladová řada */
"id": null, /* ID dokladu */
"det_kon": null,                                          /* 1 = příznak, zda připojit kontakt partnera (tab. part_kont), když je zadán v dokladu (v Result vyplněné pole ID_KON). Vrátí JSON „det_kon“ a výběr polí z „part_kon“ lze skrz příkaz „queryFields“ */
"timestamp": "2018-06-28 09:04:00" /* časové razítko = vrací výsledky změněné od zadaného data a času */
"uv_text": 1                                                 /* 1 = parametr, zda zařadit do výstupu úvodní text – „UV_TEXT“ není ve struktuře tabulky, je to vypočítaná hodnota, tudíž ji nelze uvádět v queryFields */
}
}
}
}

Grafické zobrazení vybraných DB položek v prostředí Premiera, vrácených v Result
(seznam všech DB položek, včetně datových typů, velikosti, povinnosti a popisu naleznete v Helpu webového rozhraní, viz. odkaz výše)

Result

{
  "Result":"OK",
  "CommandIn":"PRIJEMKY",
  "Data":
  [
  {
  "INTER":14700,
  "CISLO":2020700473,
  "OBJEDNAVKA":"",
  "DOD_LIST":"",
  "DATUM_VYS":"2020-03-30T00:00:00",
  "CELKEM":48183.972,
  "BRUTTO":56430.72,
  "CISLO_ODB":"P ",
  "NAZEV_ODB":"Potraviny s.r.o.",
  "ULICE_ODB":"Hrabinská 498\/19",
  "PSC_ODB":"737 01",
  "MESTO_ODB":"Český Těšín ",
  "STAT_ODB":"Česká republika ",
  "ICO_ODB":"05001037",
  "DIC_ODB":"CZ05001037",
  "POZNAMKA":"Ze skladu č:1,SV 2020700471 ",
  "POPIS":"2014033005",
  "SKLAD":9,
  "SK_KOD":"PP ",
  "SKL_CENA":0.00,
  "DOKLAD":"SP7",
  "ID":"D2496E2E-79D8-422D-AB70-DB97C1909B43",
  "ID_PAR":"5E658E4F-9C6B-4BBF-9675-D54AAFE38B99",
  "ID_KON":"",
  "DOPRAVA":"",
  "pol_skl":
  [
  {
  "FAKTURA":14700,
  "SCISLO":"4030000148",
  "TEXT":"Folie horní- tofu v misce, tl. 64µm ",
  "MNOZSTVI":1000.000,
  "MJ":"BM",
  "CENA_MJ":1.18032,
  "CENA_SLV":0.000,
  "SLEVA_PR":0.00,
  "CENA":1180.320,
  "CENA_DPH":1428.190,
  "KOD_DPH":"36",
  "SAZBA_DPH":21.00,
  "UKAZATEL":32200.000,
  "PSKLAD":9,
  "ID":"8D7DED44-75AF-4B52-9D2C-7206D43AA3AE",
  "PORDER":1,
  "INT_OB":0,
  "POL_SDT": /* stav skladu */
  [
  {
  "JINE#1":"",
  "M_JINE#1":0.000,
  "SARZE":"PS\/437\/2020\/1 ",
  "M_SARZE":500.000,
  "UMIST":"",
  "M_UMIST":0.000,
  "TRVAN":"2022-01-31T00:00:00",
  "M_TRVAN":500.000,
  "SN":"",
  "M_SN":0.000,
  "UNIQ_SDT":"2020033010:00:111 1-11051555"
  }
}
  ]
  }
  ]
  }
  ]
}

Příklad omezeného výběru jen na požadované DB položky:

{
"command": {
"inComm": "PRIJEMKY",
"inParam": {
"parameters": {
"sklad": 1,
}
}
},
"queryFields": [
{
"tableName": "PRIJEMKY",
"tableFields": "ID, CISLO "
}
]
}

příkaz PRIJEMKY_ADD

zápis nové příjemky

{
"command": {
"inComm": "PRIJEMKY_ADD"
"inParam": {
"parameters": {
"bez_cen": null                                           /* nekontroluje ceny položek: 0/1 */
}
}
},
"Data": {
"UV_TEXT": null,                                             /* úvodní text k příjemce */
"CISLO": 0, /* číslo dokladu */
"OBJEDNAVKA": null,                                     /* číslo objednávky – textová položka */
"DOD_LIST": null,                                           /* číslo dodacího list - textová položka */
"DATUM_VYS": "0001-01-01T00:00:00", /* datum vystavení */
"CELKEM": 0,                                                   /* celkem */
"BRUTTO": 0, /* brutto */
"N_CELKEM": 0,                                              /* počet položek v objednávce */
"VYSTAVIL": null,                                            /* kdo doklad pořídil */
"POPIS": null,                                                   /* popis */
"SKLAD": 0,                                                      /* číslo skladu */
"SK_KOD": null,                                               /* druh příjmu */
"DOKLAD": null,                                              /* dokladová řada */
"ID_PAR": null,                                                /* ID čísla partnera, je nutné uvést */
"C_KOD": null,                                                 /* EAN kód */
"MORE_1": null,                                             /* popis #1 */
"MORE_2": null,                                             /* popis #2 */
"MORE_3": null,                                             /* popis #3 */
"MORE_4": null,                                             /* popis #4 */
"DOPRAVA": null,                                           /* způsob dopravy */
"MENA": null, /* kód měny (EUR) – v případě CZK se pole MENA neplní; Parametry MENA a OZN_MENY se kontrolují dle kurzovního lístku (viz. 2. 8 Kurzovní lístek). Pokud se vyplněn parametr MENA, je povinné vyplnění i parametrů OZN_MENY, KURS, M_KURS nebo DATUM_VYS a v tom případě se doplní kurz dle stáhnutého kurzovního lístku podle měny a duzp */
"OZN_MENY": null, /* označení měny (€) – v případě Kč se pole OZN_MENA neplní */
  "MENA_PRED": 0 /* pozice měny: 0 = za částkou / 1 = před částkou (nepovinný parametr) */
"KURS": null, /* kurz */
"M_KURS": null, /* kurz - množství */
"BARVA": null                                                  /* celočíselný kód barvy zvýrazněného řádku v přehledu příjemek */
"POL_SKL": [                                                    /* tab. POL_SKL */
{
"SCISLO": null,                                             /* katalogové číslo */
"MNOZSTVI": 0,                                          /* množství */
"CENA_MJ": 0,                                            /* cena za MJ */
"CENA": 0,                                                    /* cena */
"CENA_DPH": 0,                                          /* cena s DPH */
"KOD_DPH": 0,                                            /* nejčastější kód DPH při prodeji */
"SAZBA_DPH": 0,                                        /* nejčastější procentní sazba DPH při prodeji */
"PSKLAD": 0,
"DALSI_N1": 0, /* pomocné numerické pole */
"DALSI_N2": 0,
"DALSI_N3": 0,
"DALSI_N4": 0,
"DALSI_N5": 0,
"DALSI_N6": 0,
"DALSI_C1": null, /* pomocné textové pole */
"DALSI_C2": null,
"USER_T1": null, /* uživatelské textové pole */
"USER_T2": null,
"USER_T3": null,
"USER_T4": null,
"DOBA": "2019033112:00:00", /* 16-znakový textový řetězec v uvedeném formátu s datem a časem pořízení */
"OPERACE": "132", /* předpis - strana MD, syntetický účet */
"ANALYT": "100", /* předpis - strana MD, analytický účet */
"DAL_O": "131", /* předpis - strana Dal, syntetický účet */
"DAL_A": "101" /* předpis - strana Dal, analytický účet */
"POL_SDT": [ /* musí obsahovat alespoň jeden parametr rozčlenění */

Parametry rozčlenění POL_SDT: sn, trvanslivost, jine_1, jine_2, jine_3

Při vyplnění některé z těchto hodnot se kontroluje nastavení na kartě (nepovolené parametry se nesmí posílat nebo musí být prázdné):

chyba při POL_SDT : na kartě [xy] nejsou povoleny sériová čísla ...
chyba při POL_SDT : na kartě [xy] není povolen datum trvanlivosti ...
chyba při POL_SDT : na kartě [xy] není povolená hodnota JINÉ 1 ...
chyba při POL_SDT : na kartě [xy] není povolená hodnota JINÉ 2 ...
chyba při POL_SDT : na kartě [xy] není povolená hodnota JINÉ 3 ...

{
"MNOZSTVI": 1, /* povinný parametr, suma MNOZSTVI v POL_SDT nesmí být větší než MNOTSTVI v POL_SKL */
"SN": "123456789", /*
parametr rozčlenění - SN (48 znaků), při použití tohoto parametru je povoleno množství = 1
Kontroluje se existence SN: chyba při POL_SDT : skladem již existuje požadované sériové číslo

*/
"TRVANLIVOST": null, /* parametr rozčlenění - datum trvanlivosti (10 znaků ve formátu „yyyy-mm-dd“)
"JINE_1": null, /* uživatelský parametr rozčlenění (48 znaků) */
"JINE_2": null, /* uživatelský parametr rozčlenění (48 znaků) */
"JINE_3": null /* uživatelský parametr rozčlenění (48 znaků) */
}
}
]
}
}

Povinné je vyplnění těchto parametrů:
[DOKLAD, ID_PAR]

Před zápisem se kontroluje období a program nedovolá záznam zapsat, pokud je již uzavřené.

příkaz VYDEJKY

seznam výdejek

{
"command": {
"inComm": "VYDEJKY",
"inParam": {
"parameters": {
"cis_dokl": "2",                                            /* číslo výdejky */
"ico_part": "3",                                           /* IČO partnera */
"dat_od": "2018-06-28", /* datum vystavení od */
"dat_do": "2018-06-28", /* datum vystavení do */
"sklad": "1", /* číslo skladu (povinné) */
"dokl_r": null, /* dokladová řada */
"det_adr": null,                                           /* 1 = příznak, zda připojit dodací adresu partnera (tab. part_adr), když je zadán v dokladu (v Result vyplněné pole ID_DOD).Vrátí JSON „det_adr“ a výběr polí z „part_adr“ lze skrz příkaz „queryFields“ */
"det_kon": null,                                          /* 1 = příznak, zda připojit kontakt partnera (tab. part_kont), když je zadán v dokladu (v Result vyplněné pole ID_KON). Vrátí JSON „det_kon“ a výběr polí z „part_kon“ lze skrz příkaz „queryFields“ Tyto údaje se zobrazují jen, pokud je vyplněno ID, kvůli velikosti vrácených dat */
"id": null,                                                      /* ID dokladu */
"timestamp": "2018-06-28 09:07:49"   /* časové razítko = vrací výsledky změněné od zadaného data a času */
"uv_text": 1                                                 /* 1 = parametr, zda zařadit do výstupu úvodní text – „UV_TEXT“ není ve struktuře tabulky, je to vypočítaná hodnota, tudíž ji nelze uvádět v queryFields */
}
}
}
}

Povinné je vyplnění alespoň jednoho z těchto parametrů:
číslo skladu [sklad]

Result

{
"result": "OK",
"commandin": "VYDEJKY",
"error": "",
"warning": "",
"data": [
{
"INTER": 1,
"CISLO": 10001,
"OBJEDNAVKA": "",
"DOD_LIST": "",
"DATUM_VYS": "2006-07-02T00:00:00",
"CELKEM": 105600,
"BRUTTO": 125664,
"CISLO_ODB": "Beruška ",
"NAZEV_ODB": "Beruška a.s. 1",
"ULICE_ODB": "Plachého 55 ",
"PSC_ODB": "747 87",
"MESTO_ODB": "Svatoňovice ",
"STAT_ODB": "Česká republika ",
"ICO_ODB": "23346341",
"DIC_ODB": "CZ23346341",
"POZNAMKA": "",
"POPIS": "",
"SKLAD": 1,
"SK_KOD": "SV ",
"SKL_CENA": 110800,
"DOKLAD": "SV1",
"ID": "6F84487F-E281-45D6-AC70-4A1D8C331980",
"ID_PAR": "",
"ID_KON": "",
"DOPRAVA": "",
"KON_PRIJEM": null,
"POZNAMKA": null,
"pol_skl": [
{
"FAKTURA": 1,
"SCISLO": "1575186 ",
"TEXT": "dutá cihla PkCD2",
"MNOZSTVI": 400,
"MJ": "ks",
"CENA_MJ": 300,
"CENA_SLV": 0,
"SLEVA_PR": 0,
"CENA": 120000,
"CENA_DPH": 142800,
"KOD_DPH": "36",
"SAZBA_DPH": 19,
"UKAZATEL": 400,
"PSKLAD": 1,
"ID": "1DA7D196-6D7B-46AE-ABC9-D2F5FD56C44A",
"PORDER": 1,
"INT_OB": 0
  "POL_SDT":
  [
  {
  "JINE#1":"",
  "M_JINE#1":0.000,
  "SARZE":"P30\/20.0301124",
  "M_SARZE":5952.000,
  "UMIST":"",
  "M_UMIST":0.000,
  "TRVAN":"2022-03-11T00:00:00",
  "M_TRVAN":5952.000,
  "SN":"",
  "M_SN":0.000,
  "UNIQ_SDT":"2020033010:00:111 2-13831555"
  }
  ]
}
]
}
]
}

Grafické zobrazení vybraných DB položek v prostředí Premiera, vrácených v Result
(seznam všech DB položek, včetně datových typů, velikosti, povinnosti a popisu naleznete v Helpu webového rozhraní, viz. odkaz výše)

Příklad omezeného výběru jen na požadované DB položky:

{
"command": {
"inComm": "VYDEJKY",
"inParam": {
"parameters": {
"sklad": 1
}
}
},
"queryFields": [
{
"tableName": "VYDEJKY",
"tableFields": "ID, CISLO, BARVA, C_KOD"
}
]
}

příkaz VYDEJKY_ADD

zápis nové výdejky

{
"command": {
"inComm": "VYDEJKY_ADD"
"inParam": {
"parameters": {
"bez_cen": null, /* nekontroluje ceny položek: 0/1 */
"bez_part": null, /* nekontroluje se povinnost zadání partnera (platí i pro PRIJEMKY_ADD) */
"isSada": null, /* součástí položek výdejky bude sada */
"isRecAut": null /* parametr pro zápis recyklačního a autorského poplatku položky (platí i pro OB_IN_ADD)

isRecAut = 0/ null - poplatky se nepoužívají
isRecAut = 1 – poplatky se použijí z nastavení karty
isRecAut = 2 – poplatky se definují v položce dokladu (vkládá se přes API), viz. POL_R a POL_A
*/

}
}
},
"Data": {
"UV_TEXT": null,                                             /* úvodní text k výdejce */
"CISLO": 0, /* číslo dokladu */
"OBJEDNAVKA": null,                                     /* objednávka – textová položka */
"DOD_LIST": null,                                           /* dodací list – textová položka */
"DATUM_VYS": "0001-01-01T00:00:00", /* datum pořízení */
"CELKEM": 0,                                                   /* celková částka */
"BRUTTO": 0,                                                   /* celková částka s DPH */
"N_CELKEM": 0,                                              /* počet položek v objednávce */
"VYSTAVIL": null,                                            /* doklad pořídil */
"POPIS": null, /* popis */
"SKLAD": 0, /* číslo skladu */
"SK_KOD": null,                                               /* druh výdeje */
"DOKLAD": null,                                              /* dokladová řada */
"ID_PAR": null,                                                /* ID číslo partnera z tab. PARTNERY (partnery.id) , je nutné uvést */
"ID_DOD": null, /* ID dodací adresy z tab. PART_ADR */
"ID_KON": null, /* ID kontaktu z tab. PART_KON */
"C_KOD": null,                                                 /* EAN kód */
"MORE_1": null,                                             /* popis #1 */
"MORE_2": null,                                             /* popis #2 */
"MORE_3": null,                                             /* popis #3 */
"MORE_4": null,                                             /* popis #4 */
"DOPRAVA": null,                                           /* způsob dopravy */
"MENA": null, /* kód měny (EUR) – v případě CZK se pole MENA neplní; Parametry MENA a OZN_MENY se kontrolují dle kurzovního lístku (viz. 2. 8 Kurzovní lístek). Pokud se vyplněn parametr MENA, je povinné vyplnění i parametrů OZN_MENY, KURS, M_KURS nebo DATUM_VYS a v tom případě se doplní kurz dle stáhnutého kurzovního lístku podle měny a duzp */
"OZN_MENY": null, /* označení měny (€) – v případě Kč se pole OZN_MENA neplní */
  "MENA_PRED": 0 /* pozice měny: 0 = za částkou / 1 = před částkou (nepovinný parametr) */
"KURS": null, /* kurz */
"M_KURS": null, /* kurz - množství */
"BARVA": null                                                  /* celočíselný kód barvy zvýrazněného řádku v přehledu výdejek */
"KON_PRIJEM": null, /* konečný příjemce */
"POZNAMKA": null, /* poznámka */
"OBJ_VYS": null, /* datum vystavení objednávky */
"OBJ_SPL": null, /* datum splatnosti objednávky */
"TRASA": null, /* trasa pro rozvoz */
"ZKKOD": 0,                                                     /* zakázka */
"POL_SKL": [                                                    /* tab. POL_SKL */
{
"SCISLO": null,                                             /* katalogové číslo */
"MNOZSTVI": 0,                                          /* množství */
"MN_BAL": 0, /* množství v balení (pokud je hodnota null nebo 0, tak API doplní hodnotu automaticky */
"CENA_MJ": 0,                                            /* cena za MJ */
"CENA": 0, /* cena */
"CENA_DPH": 0,                                          /* cena s dph */
"CENA_SLV": 0, /* sleva v Kč */
"SLEVA_PR": 0, /* sleva v procentech */
"KOD_DPH": 0,                                            /* nejčastější kód DPH při prodeji */
"SAZBA_DPH": 0,                                        /* nejčastější kód procentní sazba DPH při prodeji */
"PSKLAD": 0,
"DALSI_N1": 0, /* pomocné numerické pole */
"DALSI_N2": 0,
"DALSI_N3": 0,
"DALSI_N4": 0,
"DALSI_N5": 0,
"DALSI_N6": 0,
"DALSI_C1": null, /* pomocné textové pole */
"DALSI_C2": null,
"USER_T1": null, /* uživatelské textové pole */
"USER_T2": null,
"USER_T3": null,
"USER_T4": null,
"DOBA": "2019033112:00:00" /* 16-znakový textový řetězec v uvedeném formátu s datem a časem pořízení */
"POUKAZ": null /* číslo dárkového poukazu (8 cifer) */
"DP_PLAT": 0, /* doba platnosti dárkové poukázky, pokud jsou použity */
"OPERACE": null, /* účtovaní na položku, buď je vyplněné nebo se zapíší podle nastavení ve skladu (dokladová řada, středisko, ...) - strana MD, syntetické účet */
"ANALYT": null, /* strana MD, analytický účet */
"DAL_O": null, /* strana Dal, syntetické účet */
"DAL_A": null, /* strana Dal, analytický účet */

A. Pokud jsou v příkaze vyplněny hodnoty [OPERACE, ANALYT, DAL_O, DAL_A], použijí se tyto

B. Pokud chybí některé hodnoty, pak se hodnoty přebírají:

z nastavení karty (musí být povoleno "Povolit individuální nastavení účetní předkontace")
z pohybů
z nastavení skladu

Názvy databázových polí v nastavení skladové karty:

"PORDER": 0, /* řazení položek výdejky podle požadavku - pokud je položka svázaná s nějakou kartou, výrobkem, recyklační a autorský poplatek, tak se může řazení i tak změnit */
"POL_SDT": [ /* musí obsahovat alespoň jeden parametr rozčlenění */
Parametry rozčlenění POL_SDT: SN, trvanlivost, jine_1, jine_2, jine_3

Při vyplnění některé z těchto hodnot se kontroluje nastavení na kartě (nepovolené parametry se nesmí posílat nebo musí být prázdné):

chyba při POL_SDT : na kartě [xy] nejsou povoleny sériová čísla ...
chyba při POL_SDT : na kartě [xy] není povolen datum trvanlivosti ...
chyba při POL_SDT : na kartě [xy] není povolená hodnota JINÉ 1 ...
chyba při POL_SDT : na kartě [xy] není povolená hodnota JINÉ 2 ...
chyba při POL_SDT : na kartě [xy] není povolená hodnota JINÉ 3 ...

{
"MNOZSTVI": 1, /*
povinný parametr, suma MNOZSTVI v POL_SDT nesmí být větší než MNOTSTVI v POL_SKL,
kontroluje se množství na skladě (chyba při POL_SDT : skladem není dostatečné množství pro výdej)
*/
"SN": "123456789", /*
parametr rozčlenění - SN (48 znaků), při použití tohoto parametru je povoleno množství = 1
Kontroluje se existence SN: chyba při POL_SDT : skladem již existuje požadované sériové číslo
*/
"TRVANLIVOST": null, /* parametr rozčlenění - datum trvanlivosti (10 znaků ve formátu „yyyy-mm-dd“)
"JINE_1": null, /* uživatelský parametr rozčlenění (48 znaků) */
"JINE_2": null, /* uživatelský parametr rozčlenění (48 znaků) */
"JINE_3": null, /* uživatelský parametr rozčlenění (48 znaků) */
"VELIKOST": null, /* rozčlenění jednotlivě/skupinově dle velikosti */

"BARVA": null /* rozčlenění jednotlivě/skupinově dle barev */
}
],
"POL_R": { /* recyklační poplatek */
"TEXT": "", /* popis poplatku - nekontroluje se text */
"CENA_MJ": 0, /* jednotková částka poplatku */
"REC_INCL": false /* 0/null = poplatek není zahrnutý v částce zboží; 1 = poplatek je zahrnutý v ceně zboží */
},
"POL_A": { /* autorský poplatek */
"TEXT": "", /* popis poplatku - nekontroluje se text */
"CENA_MJ": 0, /* jednotková částka poplatku */
"REC_INCL": false /* 0/null = poplatek není zahrnutý v částce zboží; 1 = poplatek je zahrnutý v ceně zboží */
}
}
]
}
}

Povinné je vyplnění těchto parametrů:
[DOKLAD, ID_PAR]

Před zápisem se kontroluje období a program nedovolá záznam zapsat, pokud je již uzavřené.

V případě neexistence objednávky, kdy ne vždy objednávka předchází výdejce, vrací API pouze varování:

{
"Result":"OK",
"CommandIn":"VYDEJKY_ADD",
"Warning":
[
{
"desc":" číslo objednávky [test] neexistuje.",
"help":""
}
],
"Data":
{
"cislo_dokl": 10073.0,
"inter_dokl": 362.0,
"id_dokl": "E8B3C163-DB16-4C75-95F8-7ADC15D235CA"
}
}

Podmínky používání pole poukaz (viz. také příkaz DPOUKAZ):

jen ve výdejce
délka poukazu je 8 cifer
množství nabývá hodnot 1 nebo -1
na skladové kartě Premier musí byť zaškrtnuté „dárkové poukazy“
kontroluje se číslo skladové karty poukazu prodeje se skladovým číslem uplatněného poukazu
při prodeji musí souhlasit cena s cenou na kartě Premier
při prodeji se kontroluje existence čísla dárkového poukazu
při prodeji se kontroluje cena, při uplatnění se kontroluje cena, dph, platnost a zůstatek, i když je parameter "bez_cen" roven 1

příkaz VYDEJKY_UPD

změna nebo zápis údajů již existující výdejky. Příkaz obecně nelze využít tak, aby zásah v databázi změnil kritické parametry, jako je třeba ID partnera nebo jednotlivé položky. Aktuálně povolený výčet parametrů naleznete v uvedeném příkladě:

{
"command": {
"inComm": "VYDEJKY_UPD",
"inParam": {
"parameters": {
"id": ‘6F84487F-E281-45D6-AC70-4A1D8C331980‘ /* ID číslo záznamu */
}
}
},
"Data": {
"C_KOD": null, /* EAN kód */
"BARVA": null /* celočíselný kód barvy zvýrazněného řádku v přehledu výdejek */
}
}

Upozornění

Hodnoty, které nechcete změnit, nesmí být vůbec v parametrech zadané nebo jejich hodnota musí být NULL. Pokud je zadaná nulová nebo prázdná hodnota, přepíše se stávající.

Příkaz ZAKAZKA

přehled zakázek

{
"command": {
"inComm": "ZAKAZKA",
"inParam": {
"parameters": {
"id_zak": null, /* ID zakázky - po vyplnění se ostatní parametry ignorují */
"cis_zak": null, /* číslo zakázky - po vyplnění se ostatní parametry ignorují */
"zkkod": null, /* inter zakázky - po vyplnění se ostatní parametry ignorují */
"dokl_r": null, /* dokladová řada */
"id_part": null, /* ID partnera */
"term_od": null, /* požadovaný termín splnění - od (musí být současně vyplněn i parametr term_do) */
"term_do": null, /* požadovaný termín splnění - do (musí být současně vyplněn i parametr term_od) */
"ukonceno": null, /* ukončená zakázka (null = všechny zakázky / 1 = ukončené zakázky / 0 = neukončené zakázky */
"stkod": null, /* středisko */
"timestamp": null /* viz. časové razítko = stav od zadané hodnoty */
}
}
}
}

Povinné je vyplnění těchto parametrů:
[id_zak, cis_zak, zkkod, dokl_r, akt_zak, id_part, stkod, timestamp] nebo [queryConditions]

Výsledek (Result)

{
"result": "OK",
"commandin": "ZAKAZKA",
"error": "",
"warning": "",
"data": [
{
"zkkod": 1,
"zakazka": "1 ",
"cislo": 1, /* číslo zakázky */
"zaka_nazev": "Omítka na budově", /* název zakázky */
"hs_obj": "", /* Objed. / Smlouva */
"stredisko": 0,
"pu_zak": " ",
"odberatel": "", /* objednatel #1 */
"nazev_od2": "", /* název objednatele #2 */
"ulice_odb": "Oranžová 27 ", /* ulice objednatele */
"psc_odb": "", /* psč objednatele */
"mesto_odb": "Kyjovice¨ ", /* město objednatele */
"stat_odb": "",   /* stát objednatele */
"ico_odb": "1234567 ",   /* IČ objednatele */
"dic_odb": "CZ1234567 ", /* DIČ objednatele */
"kon_prijem": "", /* příjemce/vyřizuje */
"objednano": "2015-06-04T00:00:00",
"vyridit": "2015-06-04T00:00:00", /* plán: datum zahájení */
"vyrizeno": "1900-01-01T00:00:00",
"poznamka": "", /* poznámka */
"cena": 100000, /* cena zakázky v Kč */
"ukonceno": false,
"vystavil": "Plavecká Marie", /* zaevidoval */
"doklad": "ZAK", /* dokladová řada */
"termin": "2015-06-10T00:00:00", /* plán: termín splnění */
"id": "C85C49CA-5F01-4604-8250-A00428C3C176",
"prubeh": "realizace ",
"id_par": "" /* ID partnera */
}
]
}

Příkaz ZAKAZKA_ADD

vložení zakázky

{
"command": {
"inComm": "ZAKAZKA_ADD"
},
"Data": {
"DOKLAD": "ZAB", /* dokladová řada, kontroluje se existence v dokladových řadách */
"ZAKA_NAZEV": "Test001", /* název zakázky, kontroluje se jedinečnost (bez mezer a rozlišení velikosti písmen) */
"ZKKOD": 0, /* pokud není vyplněno číslo zakázky (null / 0), doplní se následné pořadové číslo z číselné řady. V případě vyplnění se kontroluje jedinečnost */
"HS_OBJ": "cislo obj", /* číslo objednávky */
"STREDISKO": 999, /* středisko */
"ID_PAR": "D33C4D94-0AD9-44A9-AE1A-95CA796B43E2", /* ID partnera */
"POZNAMKA": "_poznamka", /* poznámka */
"VYSTAVIL": "_vystavil", /* vystavil */
"BARVA": 255, /* číslo barvy vizuálního podbarvení řádku */
"OBJEDNANO": "2020-01-01", /* datum objednání */
"TERMIN": "2020-01-02", /* termín splnění */
"USER_C01": "_USER_C01", /* uživatelské parametry - znakové */
"USER_C02": "_USER_C02",
"USER_C03": "_USER_C03",
"USER_C04": "_USER_C04",
"USER_C05": "_USER_C05",
"USER_C06": "_USER_C06",
"USER_C07": "_USER_C07",
"USER_C08": "_USER_C08",
"USER_N01": 101, /* uživatelské parametry - číselné */
"USER_N02": 102,
"USER_N03": 103,
"USER_N04": 104,
"USER_N05": 105,
"USER_N06": 106,
"USER_N07": 107,
"USER_N08": 108,
"USER_D01": "2020-10-01", /* uživatelské parametry - datumové */
"USER_D02": "2020-10-02",
"USER_D03": "2020-10-03",
"USER_D04": "2020-10-04",
"USER_D05": "2020-10-05",
"USER_D06": "2020-10-06",
"USER_D07": "2020-10-07",
"USER_D08": "2020-10-08".
"NAD_NOD“: "", /* číslo nadřazené zakázky. Kontroluje se existence zakázky a číslo nadřazené zakázky se nesmí rovnat aktuální zakázce */
"VYRIDIT“: "" /* termín */
}
}

Povinné je vyplnění těchto parametrů:
[zaka_nazev]

Výsledek (Result)

{
  "Result":"OK",
  "CommandIn":"ZAKAZKA_ADD",
  "Data":
  {
  "cislo_dokl": 2008040007.0,
  "id_dokl": "4180DD80-A2EE-4C8A-BF66-1B509603FB3D"
  }
}

Příkaz SABLONY

zápis vystavěných objednávek

{
"command": {
"inComm": "SABLONY",
"inParam": {
"parameters": {
"id_sab": "6FA2996B-9235-11DA-BA9F-0050FCE4C670", /* ID šablony - v případě vyplnění, jsou ostatní atributy ignorovány */
"sada": "V - 1005003", /* konkrétní sada */
"doklad": "SSO", /* dokladová řada - vypíše všechny odpovídající */
"timestamp": "2018-01-01" /* timestamp - v případě vyplnění atributu DOKLAD */
}
}
}
}

Příkaz podporuje QueryFields a QueryConditions, příklad:

{
"command": {
"inComm": "SABLONY",
"inParam": {
"parameters": {
"sada": "GGV-11BQBMG-3/1
}
},
"queryCondition": {
"tableName": "SABL_SOU",
"conditions": [
{
"fieldName": "SKLAD",
"relationalOperator": "=",
"value": "200"
}
]
}
}
}

Povinné je vyplnění parametrů:
[ID_SAB nebo SADA - načte konkrétní šablonu / nebo DOKLAD]

Výsledek (Result)

{
"Result":"OK",
"CommandIn":"SABLONY",
"Data":
[
{
"inter":1, /* interní pořadové číslo */
"sada":"V - 1005003 ", /* číslo výrobku */
"cislo":1, /* doklad - číslo */
"zkkod":0, /* zakázka */
"stkod":0, /* středisko */
"objednavka":"",
"n_celkem":4, /* počet položek */
"vystavil":"Synková Marie ", /* vytvořil */
"kon_prijem":"",
"doprava":"",
"poznamka":"", /* poznámka */
"popis":"", /* popis */
"sklad":3, /* použité sklady komponent */
"rab_sk":0,
"rezervace":true,
"ukonceno":false, /* ukončeno (zneplatnění šablony) */
"more_1":"", /* další popis #1 */
"more_2":"", /* další popis #2 */
"datum_usk":"1900-01-01T00:00:00",
"is_sklad":true,
"nazev":"výrobek -brašna na vozík", /* název výrobku */
"id":"6FA2996B-9235-11DA-BA9F-0050FCE4C670", /* ID číslo */
"doklad":"SSO", /* dokladová řada */
"rezie":0.00,
"barva":0, /* podbarvení řádku */
"rozmer_x":0.000, /* rozměr X */
"rozmer_y":0.000, /* rozměr Y */
"rozmer_z":0.000, /* rozměr Z */
"hmotnost":0.000,
"schvaleno":true, /* auditováno */
"overil":"",
"pol_sso": /* položky šablony */
[
{
"faktura":1, /* doklad - číslo */
"text":"Šroub 8x16 vn.šest.čočk.hl.7380 černý zinek ", /* popis */
"text_2":"", /* další popis */
"mnozstvi":2.0000000, /* množství */
"mn_bal":0.000, /* Mn. / bal. */
"bal_pal":0.000, /* bal. / paletu */
"mj":"ks", /* měrná jednotka */
"cena_mj":0.0000000, /* Prodejní cena / MJ */
"cena_slv":0.00, /* výše slevy */
"sleva_pr":0.00, /* sleva v procentech */
"cena":0.00, /* celkem (bez DPH) */
"cena_dph":0.00, /* celkem s DPH */
"material":1064,
"scislo":"11240020", /* číslo materiálu */
"kod_dph":"36", /* kód DPH */
"sazba_dph":19.00, /* sazba DPH */
"psklad":3, /* číslo skladu */
"tara":0.000,
"brutto":0.000,
"mn_kg":0.00000000000,
"vykon":"", /* výkon */
"id":"6FA2996C-9235-11DA-BA9F-0050FCE4C670" /* ID číslo */
}
]
}
]
}

příkaz DPOUKAZ

přehled dárkových poukazů (viz. také příkaz VYDEJKY_ADD)

{
"command": {
"inComm": "DPOUKAZ",
"inParam": {
"parameters": {
"poukaz": null, /* číslo dárkového poukazu (8 cifer) */
"skl_cislo": null, /* skladové číslo dárkového poukazu */
"sklad": null, /* číslo skladu */
"rozpis": null /* 0/1 = vrátí pohyby dárkového poukazu */
}
}
}
}

Výsledek (Result)

{
  "Result":"OK",
  "CommandIn":"DPOUKAZ",
  "Data":
  [
  {
  "sklad_p":1,
  "karta":"SLUŽBA 1",
  "poukaz":"46918075",
  "prodano":"2019-01-22T00:00:00",
  "doklad_p":"SV1",
  "cislo_p":10062,
  "komu":"Příjmení Jméno",
  "platnost":12,
  "do":"2020-01-22T00:00:00",
  "cena_bezdph":1000.000,
  "cena_dph":1000.000,
  "kod_dph":"31",
  "sazba_dph":0.00,
  "uplatneno":1000.000,
  "zbyva":0.000,
  "dne":"2019-01-22T00:00:00",
  "doklad_u":"SV1",
  "sklad_u":1,
  "cislo_u":10063,
  "kym":"Příjmení Jméno"
  }
  ]
}

Výsledek (Result) s rozpisem

{
  "Result":"OK",
  "CommandIn":"DPOUKAZ",
  "Data":
  [
  {
  "sklad_p":1,
  "karta":"SLUŽBA 1",
  "poukaz":"46918075",
  "prodano":"2019-01-22T00:00:00",
  "doklad_p":"SV1",
  "cislo_p":10062,
  "komu":"Příjmení Jméno",
  "platnost":12,
  "do":"2020-01-22T00:00:00",
  "cena_bezdph":1000.000,
  "cena_dph":1000.000,
  "kod_dph":"31",
  "sazba_dph":0.00,
  "uplatneno":1000.000,
  "zbyva":0.000,
  "dne":"2019-01-22T00:00:00",
  "doklad_u":"SV1",
  "sklad_u":1,
  "cislo_u":10063,
  "kym":"Příjmení Jméno",
  "rozpis":
  [
  {
  "psklad":1,
  "scislo":"SLUŽBA 1",
  "mnozstvi":1.000,   /* množství může nabývat hodnot: 1/-1 */
  "id_pol_skl":"CE3A3ADD-13AE-4CFD-8481-1606125868E8",
  "faktura":351,
  "datum_vys":"2019-01-22T00:00:00",
  "cas":"",
  "id_vydej":"860DD6D1-E989-43C3-8B2D-18420E9122F8",
  "cislo":10062,
  "doklad":"SV1",
  "nazev_odb":"Příjmení Jméno",
  "poukaz":"46918075",
  "cena":1000.000,
  "cena_dph":1000.000,
  "kod_dph":"31",
  "sazba_dph":0.00,
  "plat_dk":12
  },
  {
  "psklad":1,
  "scislo":"SLUŽBA 1",
  "mnozstvi":-1.000,
  "id_pol_skl":"DEE23733-B01D-497D-ACD5-E2C02BCD115C",
  "faktura":352,
  "datum_vys":"2019-01-22T00:00:00",
  "cas":"",
  "id_vydej":"F6A22C52-F45C-4579-9533-C4105258DC58",
  "cislo":10063,
  "doklad":"SV1",
  "nazev_odb":"Příjmení Jméno",
  "poukaz":"46918075",
  "cena":-1000.000,
  "cena_dph":-1000.000,
  "kod_dph":"31",
  "sazba_dph":0.00,
  "plat_dk":12
  }
  ]
  }
  ]
}

příkaz STITKY

zobrazí seznam dostupných štítků

{
"command": {
"inComm": "STITKY"
}
}

Result

{
"Result":"OK",
"CommandIn":"STITKY",
"Data":
[
{
"kod":"KLI",
"popis":"Významný klient ",
"id":"3932334B-4C49-0000-0000-000000000000"
},
{
"kod":"NSO",
"popis":"Nesolventní klient",
"id":"3932334E-534F-0000-0000-000000000000"
},
{
"kod":"VIP",
"popis":"VIP klient",
"id":"39323356-4950-0000-0000-000000000000"
}
]
}

Přidá nebo smaže u partnera štítek podle číselníku dostupných štítků. Pokud není vyplněno ADD ani DEL, zobrazí se aktuální záznam

{
"command": {
"inComm": "STITKY",
"inParam": {
"parameters": {
"tab": "PARTNERY", /* název tabulky */
"id": "01FCB191-6718-470C-A451-FA5F4ECB7DDC", /* ID záznamu (partnera) */
"add": "KLI;VIP", /* pokud je vyplněn kód štítků, přidá záznam – může být vyplněno více kódů současně, oddělených středníkem */
"del": "" /* pokud je vyplněn kód štítků, zápis vymaže – může být vyplněno více kódů současně, oddělených středníkem */
}
}
}
}

příkaz ZMENY

přehled změn záznamu v tabulkách ZMENY a DEL_DBF

{
"command": {
"inComm": "ZMENY",
"inParam": {
"parameters": {
"id": null /* ID záznamu */
}
}
}
}

příkaz PROMEN

seznam povolených globálních proměnných z Premieru

{
"command": {
"inComm": "PROMEN"
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "PROMEN",
"error": "",
"warning": "",
"data": [
{
"PROMEN": "a_menycnb",                   /* název proměnné */
"C_SET": "EUR;USD;SSK",                      /* textová hodnota proměnné (240 znaků) */
"C_SET2": "", /* textová hodnota proměnné, 2. část (240 znaků) */
"D_SET": "1900-01-01T00:00:00", /* datumová hodnota proměnná - vrácená hodnota "1900-01-01T00:00:00", odpovídá hodnotě NULL */
"N_SET": 0, /* numerická hodnota proměnné (max. 17 cifer, včetně max. 7 des. míst) – vrácená 0, odpovídá také hodnotě NULL */
"L_SET": false, /* logická hodnota – vrácené hodnota false, odpovídá také NULL */
"POPIS": "meny pre CNB",                    /* popis proměnné */
"#_promen_sez": [
{
"kat": "UCET"                                   /* kategorie */
}
]
}
]
}

příkaz KURS_LIST

seznam povolených globálních proměnných z Premieru

{
"command": {
"inComm": "KURS_LIST",
"inParam": {
"parameters": {
"mena": ‘EUR‘, /* označení měny */
"datum": null /* požadovaný datum */
}
}
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "KURS_LIST",
"error": "",
"warning": "",
"data": [
{
"datum": "2006-06-20", /* datum */
"mena": "EUR", /* měna */
"mnoz": 1, /* množství - kolik cizí měny dostanete za daný kurz 1, 100, 1000 */
"kurs": 0, /* kurz měny */
"pred": true
},
]
}

příkaz STREDISK

export aktuálního číselníku středisek

{
"command": {
"inComm": "STREDISK"
}
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "STREDISK",
"error": "",
"warning": "",
"data": [
{
"stkod": 1, /* ID střediska */
"stredisko": "1 ", /* číselné označení (max. 12 cifer) */
"nazev": "Základové desky " /* popis = název střediska */
},
{
"stkod": 2,
"stredisko": "2 ",
"nazev": "Přípojky"
},
{
"stkod": 3,
"stredisko": "3 ",
"nazev": "Hrubé stavby"
},
]
}

příkaz OSNOVA

účtová osnova

{
"command": {
"inComm": "OSNOVA",
"inParam": {
"parameters": {
"rok": null /* účetní rok */
}
}
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "OSNOVA",
"error": "",
"warning": "",
"data": [
{
"ucet": "013", /* syntetický účet */
"analyt": "100 ", /* analytický účet */
"text": "Software", /* popis */
"rok": 2018, /* účetní rok */
"text_1": "", /* cizí výraz 1 */
"text_2": "", /* cizí výraz 2 */
"text_3": "", /* cizí výraz 3 (azbuka) */
"zakazka": 0, /* zakázka (0 = default (Může být) / 1 = Nesmí být zadána / 2 = Může být / 3 = Musí být / 4 = Musí být, není-li zadáno středisko) */
"stredisko": 0 /* středisko (0 = default (Může být) / 1 = Nesmí být zadána / 2 = Může být / 3 = Musí být / 4 = Musí být, není-li zadána zakázka) */
},
{
"ucet": "021",
"analyt": "100 ",
"text": "Stavby",
"rok": 2018,
"text_1": "",
"text_2": "",
"text_3": "",
"zakazka": 0,
"stredisko": 0
}
]
}

Povinné je vyplnění parametru:
[ROK]

příkaz VERZEAPI

kontrolní funkce - vrací aktuální verzi knihoven zajišťující chod API v Premieru

{
"command": {
"inComm": "VERZEAPI",
"inParam": {
"parameters": {
"table_name": null,
"prikaz": null
}
}
}
}

Výsledek (Result)

{
"result": "OK",
"commandin": "VERZEAPI",
"error": "",
"warning": "",
"data": {
"ApiComPrem.dll": {
"verze": "1.0.0.2",
"datum": "25.02.2019 21:31"
},
"ApiComSQL.dll": {
"verze": "1.0.0.7",
"datum": "25.02.2019 21:30"
}
}
}

příkaz VAZBY

výpis vazeb mezi jednotlivými doklady

{

"command": {
"inComm": "VAZBY",
"inParam": {
"parameters": {
"typDokl": "SP", /* typ dokladu */
"id_dokl": "fC66FA15-3819-4E41-AE1B-0B655C2998C5" /* ID číslo dokladu */
}
}
}
}

Podporovány jsou tyto typy dokladů:

"FR"="Externí dokument - volný / Skenovat / Hyperlink"
"EX"="Externí dokument - vložený"
"SK"="Skladová karta"
"PD"="Peněžní deník"
"UD"="Účetní deník"
"PA"="Seznam partnerů"
"ZA"="Kniha zakázek"
"VF"="Vydané faktury"
"ZV"="Zálohové vydané faktury"
"UP"="Upomínky"
"CR"="CRM / Pošta"
"PF"="Přijaté faktury"
"ZP"="Zálohové přijaté faktury"
"PU"="Příkaz k úhradě"
"RM"="Platby do zahraničí"
"MA"="Evidence majetku"
"PO"="Přijaté objednávky"
"VO"="Vystavené objednávky"
"SP"="Skladové příjemky"
"SV"="Skladové výdejky"
"NA"="Nabídky odběratelům"
"PT"="Poptávky u dodavatelů"
"VY"="Výrobní soupisky"
"KA"="Kalkulace"
"VP"="Výkazy práce"
"ND"="Nákladní doprava"
"CP"="Cestovní příkazy"
"NL"="Nákladní list"
"FM"="Finanční majetek"
"OE"="Ostatní evidence"
"ZM"="Personalistika"
"RV"="Řízení výroby"
"SA"="Šablony vydaných faktur"
"SF"="Šablony přijatých faktur"
"SY"="Šablony výrobních soupisek"

Result

{
  "Result":"OK",
  "CommandIn":"VAZBY",
  "Data":
  [
  {
  "KOD_ZDR":"SP", /* typ vyhledávaného dokladu */
  "INT_ZDR":21,
  "ID_ZDR":"FC66FA15-3819-4E41-AE1B-0B655C2998C5", /* ID číslo vyhledávaného dokladu */
  "KOD_TER":"PF", /* typ svázaného dokladu */
  "INT_TER":443,
  "ID_TER":"4FE93E5A-AF8B-4AE9-A077-498B412D7433", /* ID číslo svázaného dokladu */
  "datum":"2006-08-01", /* svázaný doklad: datum dokladu */
  "zdroj":"Přijaté faktury", /* svázaný doklad: typ dokladu */
  "castka":174180.30, /* svázaný doklad: částka */
  "popis":"", /* svázaný doklad: popis */
  "doklad":"DF", /* svázaný doklad: dokladová řada */
  "cislo":2006100178 /* svázaný doklad: číslo dokladu */
  }
  ]
}

příkaz VAZBY_ADD

zápis vazby mezi doklady

{
"command": {
"inComm": "VAZBY_ADD",
"inParam": {
"parameters": {
"kod_zdr": "SV", /* zdrojový typ dokladu */
"id_zdr": "C470AE42-9523-4D63-9A4E-7DCE98014013", /* zdrojové ID číslo dokladu */
"kod_ter": "PO", /* typ svázaného dokladu */
"id_ter": "70630557-BA31-413E-8AB5-DA3EB2991D83" /* ID číslo svázaného dokladu */
}
}
}
}

Číselník kod_zdr / kod_ter = viz. příkaz VAZBY

Result

{
"Result":"OK",
"CommandIn":"VAZBY_ADD"
}

příkaz CISELNIKY

vrací seznam hodnot zvoleného číselníku

Hodnoty parametru "typ":

PATRA = Trasa pro rozvoz - číselník tras (v Objednávkách ve Skladě)

Post

{
"command": {
"inComm": "CISELNIKY",
"inParam": {
"parameters": {
"typ": "PATRA"
}
}
}
}

Result

{
"Result":"OK",
"CommandIn":"CISELNIKY",
"Data":
[
{
"popis":"trasa"
}
]
}

ZAOBI = Průběh objednávky odběratele (v Objednávkách odběratelů ve Skladě)

DOP = Způsob dopravy

OBPPO = Platební podmínky

PASES = - Individuální tiskové sestavy partnera

příkaz ZAKAZKA_UPD

aktualizace parametrů zvolené zakázky

{
"command": {
"inComm": "ZAKAZKA_UPD",
"inParam": {
"parameters": {
"id": null /* ID zakázky */
}
}
},
"Data": {
"ZAKA_NAZEV": null, /* název zakázky */
"POZNAMKA": null, /* poznámka */
"BARVA": 0.0, /* podbarvení řádku */
"USER_C01": null, /* uživatelský parametr (textový) */
"USER_C02": null,
"USER_C03": null,
"USER_C04": null,
"USER_C05": null,
"USER_C06": null,
"USER_C07": null,
"USER_C08": null,
"USER_N01": 0.0, /* uživatelský parametr (číselný) */
"USER_N02": 0.0,
"USER_N03": 0.0,
"USER_N04": 0.0,
"USER_N05": 0.0,
"USER_N06": 0.0,
"USER_N07": 0.0,
"USER_N08": 0.0,
"USER_D01": null,
"USER_D02": null,
"USER_D03": null,
"USER_D04": null,
"USER_D05": null,
"USER_D06": null,
"USER_D07": null,
"USER_D08": null
}
}

Popisy jednotlivých příkazů a jejich volání

příkaz INFO

příkaz SELECT

příkaz ZMENY

příkaz SAZBY_DPH

příkaz FA_IN

příkaz FA_IN_ADD

příkaz FA_IN_UPD

příkaz FA_ZIN

příkaz FA_ZIN_ADD

příkaz FA_IN_UHR

příkaz FA_IN_AUDIT

příkaz FA_OUT

příkaz FA_OUT_ADD

příkaz FA_OUT_UHR

příkaz FA_ZOUT

příkaz FA_ZOUT_ADD

příkaz PARTNERI

příkaz PARTNERI_ADD

příkaz PART_ADR_ADD

příkaz SLEVY

příkaz SORTIMENT

příkaz CENIK

příkaz DOKL_PU

příkaz DOCUMENT

příkaz PART_COUNT

příkaz SEZ_SKL

příkaz SKLAD_STAV

příkaz SKLAD_ADD

příkaz POL_SDT

příkaz IMAGE

příkaz OB_IN

příkaz OB_OUT

příkaz OBJ_CALC

příkaz OB_IN_ADD

příkaz OB_OUT_ADD

příkaz OBJOUT_CALC

příkaz PRIJEMKY

příkaz PRIJEMKY_ADD

příkaz VYDEJKY

příkaz VYDEJKY_ADD

příkaz VYDEJKY_UPD

Příkaz ZAKAZKA

Příkaz ZAKAZKA_ADD

Příkaz SABLONY

příkaz DPOUKAZ

příkaz STITKY

příkaz ZMENY

příkaz PROMEN

příkaz KURS_LIST

příkaz STREDISK

příkaz OSNOVA

příkaz VERZEAPI

příkaz VAZBY

příkaz VAZBY_ADD

příkaz CISELNIKY

příkaz ZAKAZKA_UPD