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

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

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 https://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ů */       }     }   } }

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"         ]     }

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.                                                                            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": 2025000016,                                                                           /* Původní doklad (k dobropisu) na základě kterého dojde ke kontrole a vytvoření vazby */       "STORNO_FA": false,                                                                          /* příznak, že se jedná o storno faktury (true/false) a v atributu CPUV_DOKL bude číslo, o jakou se jedná */     "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,                                                                             /* výše 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": "36",                                                                            /* 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"     "inParam": {       "parameters": {         "only_eshop": 1       }     }   } }

 

Zapnutí parametru only_eshop = 1 odpovídá zatržení volby v Premieru:"Nepřenášet tento sortiment na e-shop (včetně podřízených) - zaškrtne se, pokud se karty náležící do tohoto sortimentu nemají přenášet na e-shop."

 

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: níže */                 "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říklad Base64

 

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 - typ string*/         "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 */ "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 {              "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ží */         }        }     ]   } } }


                                                                             

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í:

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

  2. z pohybů

  3. z nastavení skladu

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

 

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 ...

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",                            /* objednáno */ "vyridit": "2015-06-04T00:00:00",                                   /* plán: datum zahájení */ "vyrizeno": "1900-01-01T00:00:00",                                /* skutečné datum ukončení */ "poznamka": "",                                                               /* poznámka */ "cena": 100000,                                                               /* cena zakázky v Kč */ "ukonceno": false,                                                           /* uzavření */ "vystavil": "Plavecká Marie",                                            /* zaevidoval */ "doklad": "ZAK",                                                              /* dokladová řada */ "termin": "2015-06-10T00:00:00",                                   /* plán: termín splnění */ "skud_od": "",                                                                  /* skutečné datum zahájení */ "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