Popisy jednotlivých príkazov a ich volanie
Nájdete tu zoznam príkazov, s popisom volaných parametrov a ich spresnením. Názvy, popis a dátové typy všetkých vrátených DB položiek v Result, tu neuvedených, nájdete priamo vo webovom rozhraní dev.premier.cz, viď. popis vyššie. Nejedná sa o ukážkové príklady, ale v jednotlivých príkazoch sú uvedené vždy všetky dostupné parametre, vrátane ich popisu a podrobností k nim.
Volanie jednotlivých príkazov úspešne vráti z databázy Premiera výsledok pri splnení týchto podmienok:
- databáza Premiera je v SQL a beží na MS SQL servery (Premier Enterprise)
- konfiguračný súbor setup.xml musí byť nastavený pre konkrétnu firmu(y) a musí sa nachádzať v adresári, kde beží ApiComPrem
- na serveri s prístupom k SQL servera musí bežať ApiComPrem (ako služba alebo spustená aplikácia)
- firewall / antivír musí byť nakonfigurovaný tak, aby vlastnú komunikáciu nijako neobmedzoval
príkaz INFO
Základný príkaz pre zobrazenie možností jednotlivých príkazov a štruktúry jednotlivých tabuliek
{
"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ů */
}
}
}
}
Príklad
Zobrazí štruktúru tabulky PARTNERY
{
"command": {
"inComm": "INFO",
"inParam": {
"parameters": {
"table_name": "PARTNERY",
"prikaz": null
}
}
}
}
Zobrazí štruktúru všetkých dostupných tabuliek naraz
Súčasné doplnenie parametrov table_name a príkaz nie je možné a zobrazí chybové hlásenie
Týmto príkazom si vyexportujete zoznam všetkých dostupných príkazov:
{
"command": {
"inComm": "INFO",
"inParam": {
"parameters": {
"table_name": null,
"prikaz": "FULL"
}
}
}
Načítanie INFO pre zobrazenie možností príkazu FA_OUT
{ "command": {
"inComm": "INFO",
"inParam": {
"parameters": {
"prikaz": "FA_OUT"
} } } }
Výsledok (Result)
príkaz SELECT
Možnosť vloženia ľubovoľného vlastného SQL dotazu pre priame volanie zo všetkých dostupných tabuliek uložených v databáze. Príkaz je dostupný predovšetkým pre testovacie účely. Jednotlivé väzby medzi tabuľkami rieši ostatné príkazy, ktoré sú v nich už ošetrené, preto ho odporúčame používať len vo výnimočných prípadoch. Používa syntax MS SQL.
{
"select": "select top 10 * from ob_in" /* samotný SELECT na databázi */
}
príkaz ZMENY
- prehľad zmien záznamu
{
"command": {
"inComm": "ZMENY",
"inParam": {
"parameters": {
"id": null
}
}
}
}
príkaz SADZBY_DPH
- vráti prehľad aktuálnych kódov DPH z Premiera (záložka Správca - Predvoľby - Globálne - Kódy DPH)
{
"command": {
"inComm": "SAZBY_DPH"
}
}
Výsledok (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 */
}
]
}
príkaz FA_IN
- zoznam prijatých faktúr
{
"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 */
}
}
}
}
Grafické zobrazenie vybraných DB položiek v prostredí Premier, vrátených Result
Zoznam všetkých DB položiek, vrátane datových typov, veľkosti, povinnosti a popisu nájdete v Helpu webového rozhrania, viď. odkaz vyššie
Položka C_KOD – EAN (DMS) môže byť zobrazená v Premieri formou hyperlinku, pokiaľ si jej štruktúru nadefinujete v "Správca-Predvolby globálne-Dodávatelia"
Povinné je vyplnenie aspoň jedného z týchto parametrov:
[id_fa, cis_fa, cis_obj, dokl_r, id_part, ico_part, timestamp] alebo [queryConditions]
příkaz FA_IN_ADD
- zápis novej prijatej faktúry
Pred zápisom sa kontroluje obdobie a program nedovolí záznam zapísat, ak je obdobie už uzatvorené.
příkaz FA_ZIN
- zálohové listy (zoznam prijatých zálohových faktúr)
{
"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 vyplnenie aspoň jedného z týchto parametrov:
[id_fa, cis_fa, cis_obj, dokl_r, id_part, ico_part] nebo [queryConditions]
Ak zadanie vracia veľké množstvo výsledkov. napr. ak je vyplnený len partner (id_part), je povinná položka aj dátum Od-Do [dat_od, dat_do]
Výsledok
příkaz FA_ZIN_ADD
- zápis nového zálohového listu (prijaté zálohové faktúry)
Povinné je vyplnenie týchto parametrov:
[DOKLAD, VARIABL, ID_PAR, datum_vys, datum_usk, datum_spl, TEXT, KOD_DPH]
príkaz FA_IN_UHR
- úhrady prijatých faktúr
{
"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 OD */
"dat_do": null, /* datum DO */
"VFzalohove": null /* 0/1 = včetně zálohových listů */
}
}
}
}
Povinné je vyplnenie niekterého z týchto parametrov:
[id_fa, cis_fa, inter_fa, dokl_r, id_part]
príkaz FA_IN_AUDIT
- zapíše príznak "Auditované" do prijatej faktúry
{
"command": {
"inComm": "FA_IN_AUDIT",
"inParam": {
"parameters": {
"id_fa": null, /* ID faktury */
"audit": null /* příznak auditováno: 0 / 1 */
}
}
}
}
Povinné je vyplnenie všetkých parametrov:
[id_fa, audit]
príkaz FA_OUT
- tabuľka vydaných faktúr.
Príkaz umožňuje vložiť aj vlastnú podmienku (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 vyplnenie aspoň jedného z týchto parametrov:
[id_fa, cis_fa, cis_obj, dokl_r, id_part, ico_part, timestamp] nebo [queryConditions]
Result
príkaz FA_OUT_ADD
- vloženie novej vystavenej faktúry
Pred zápisom sa kontroluje obdobie a program nedovolí záznam zapísat, ak je obdobie už uzatvorené.
príkaz FA_OUT_UHR
- úhrady odoslaných faktúr
{
"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 OD */
"dat_do": null, /* datum DO */
"VFzalohove": null /* 0/1 = včetně zálohových listů */
}
}
}
}
Povinné je vyplnenie niektorého z týchto parametrov:
[id_fa, cis_fa, inter_fa, dokl_r, id_part]
príkaz FA_ZOUT
- prijaté 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 vyplnenie aspoň jedného z týchto parametrov:
[id_fa, cis_fa, cis_obj, dokl_r, id_part, ico_part, _timestamp alebo [queryConditions]
Result
příkaz FA_ZOUT_ADD
- vkladanie prijatých zálohových listov
Result
{
"Result":"OK",
"CommandIn":"FA_ZOUT_ADD",
"Data":
{
"cislo_fa": 15000005.0,
"inter_fa": 14,
"id_fa": "5874B225-1777-40B8-8589-DD3D87762E5A"
}
}
príkaz PARTNERI
- tabuľka partnerov
{
"command": {
"inComm": "PARTNERI",
"inParam": {
"parameters": {
"part_typ": null, /* OD – odběratelé / DO – dodavatelé / FULL – všichni partneři */
"part_ico": "12345678", /* IČ partnera */
"part_id": null, /* ID partnera */
"part_cis": null, /* Zkratka v IS Premier */
"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 vyplnenie aspoň jedného z týchto parametrov:
[part_typ,part_ico,part_id,part_cis] alebo [queryConditions]
Príkaz umožňuje vložiť aj vlastnú podmienku (queryConditions)
Príklad vlastnej podmienky
{
"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"
}
]
}
}
}}
Príklad vyhľadávania partnera podľa jeho názvu
napr. pre zistenie povinného parametra ID_PAR konkrétneho partnera pri ukladaní dokladov
{
"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é zobrazenie vybraných DB položiek v prostredí Premiera, vrátených v Result
(Zoznam všetkých DB položiek, vrátane dátových typov, veľkosti, povinnosti a popisu nájdete v Helpu webového rozhrania, pozri. odkaz vyššie)
príkaz PARTNERI_ADD
- vloženie nového alebo zmena záznamu v tab. partnerov
{
"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": "012345678",
"NAZEV": "Test ADD00", /* název partnera */
"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": null, /* 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 */
"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“)
}
}
príkaz PART_ADR_ADD
- vloženir alebo zmena 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 */
}
}
príkaz SLEVY
- zákaznické cenníky
{
"command": {
"inComm": "SLEVY",
"inParam": {
"parameters": {
"part_ico": “123“, /* IČO partnera */
"part_cis": "NULL", /* zkratka partnera */
"part_naz": "NULL" /* název partnera */
"skl_cislo": "NULL" /* skladové číslo */
}
}
}
príkaz SORTIMENT
- vracia skupiny skladových kariet. Príkaz nemá dodatočné parametre
{
"command": {
"inComm": "SORTIMENT"
}
}
Result
{
"Result":"OK",
"CommandIn":"SORTIMENT",
"Data":
[
{
"_key":"Betonová ", /* název */
"parent":"Krytina", /* přesný název rodičovského sortimentu (nadřazená kategorie) */
"popis":"Betonová krytina" /* popis */
},
{
"_key":"Krytina",
"parent":"",
"popis":"Krytina"
}
]
}
príkaz CENIK
- vracia zoznam skladových kariet, vrátane cien. Príkaz umožňuje vložiť aj vlastnú podmienku (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 vyplnenie aspoň jedného z týchto parametrov:
číslo skladu [sklad]
Grafické zobrazenie vybraných DB položiek v prostredí Premiera, vrátených v Result
(Zoznam všetkých DB položiek, vrátane dátových typov, veľkosti, povinnosti a popisu nájdete v Helpu webového rozhrania, pozri. odkaz vyššie)
Pole "kg/" je vypočítané zo zadanej hodoty MN_KG, tzn. vzorec je: zaokrúhliť(1/MN) na celé číslo. V Result sa vracajú len informatívne ako hodnota KG_KS.
príkaz DOKL_PU
- vrátí prehľad dokladových rád
{
"command": {
"inComm": "DOKL_PU",
"inParam": {
"parameters": {
"typ_dr": null, /* FULL = vše, SKLAD = sklad */
"tok": null /* konkrétní dokladová řada [1 - POKLADNA, 2 - BANKA, 3 - FA_IN, 4 - FA_OUT, 6 - ZAPOCTY, 22 - OB_IN, 23 - VYDEJKY, 25 - OB_OUT, 26 - PRIJEMKY] */
}
}
}
}
príkaz DOCUMENT
- vráti voľný 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ýsledok (result)
{
"result": "OK",
"commandin": "DOCUMENT",
"error": "",
"warning": "",
"data": {
"typ": "VF",
"id": "82A0A187-F8A1-42CA-85DE-C131CCD1860C",
"documents": [
{
"zdroj": "F", /* F – free (volný) dokument / E - exportovaný dokument */
"fileName": "DAN_EKO_EE_POKYNY_4.PDF", /* název souboru */
"filePath": "..\\dokument\\sc23\\DAN_EKO_EE_POKYNY_4.PDF", /* cesta souboru */
"filePathBase64": "Li5cZG9rdW1lbnRcc2MyM1xEQU5fRUtPX0VFX1BPS1lOWV80LlBERg==", /* cesta souboru v BASE64, slouží jako parametr pro volání HTTP GET. Příklad: https://dev.premier.cz:12375/getFile.html&Li5cZG9rdW1lbnRcZmExXFZGMjAxOTA4ODMxLlBERg== */
"mime": "PDF", /* typ dokumentu */
"create": "2019-06-24 18:40:04Z", /* vytvořeno */
"desc": "Odkaz na dokument k: DP 800001" /* popis */
},
{
"zdroj": "E",
"fileName": "DP800001.PDF",
"filePath": "..\\dokument\\fa23\\DP800001.PDF",
"filePathBase64": "Li5cZG9rdW1lbnRcZmEyM1xEUDgwMDAwMS5QREY=",
"mime": "PDF",
"create": "2019-06-24 16:20:40Z",
"desc": ""
}
]
}
}
Príkaz s parametrom pre zobrazenie konkrétneho súboru
{
"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ýsledok (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 vyplnenie niektorého z týchto parametrov:
[typ, id]
príkaz PART_COUNT
- vráti počty dokladov vystavených na partnera
{
"command": {
"inComm": "PART_COUNT",
"inParam": {
"parameters": {
"id_part": null /* id partnera */
}
}
}
}
príkaz SEZ_SKL
- vráti zoznam skladov
{
"command": {
"inComm": "SEZ_SKL"
}
}
Výsledok (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="
}
]
}
príkaz SKLAD_STAV
- vráti stav na sklade, objednané alebo rezervované množstvo zo skladu podľa časového razítka alebo 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 vyplnenie aspoň jedného z týchto parametrov:
číslo skladu [sklad]
Výsledok (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) */
}
]
}
príkaz SKLAD_ADD
- zápis alebo zmena skladovej 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": {
"TEXT": null, /* název */
"TEXT_2": null,
"TEXT_3": null,
"TEXT_4": null,
"KOD_KN": null, /* kód zboží dle celního sazebníku */
"PUVOD_STAT": null, /* stát původu */
"MN_KG": null,
"C_KOD": null, /* EAN */
"MN_BAL": null,
"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,
"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 */
}
}
Povinné je vyplnenie aspoň jedného z týchto parametrov:
názov [text]
Grafické zobrazenie vybraných DB položiek v prostredí Premiera - viď. príkaz Cenník
príkaz POL_SDT
- vráti stav na sklade výrobného čísla, objednané alebo rezervované množstvo zo skladu podľa časového razítka alebo skladového čísla.
{
"command": {
"inComm": "POL_SDT",
"inParam": {
"parameters": {
"skl_cislo": null, /* skladové číslo */
"sklad": null, /* číslo skladu */
"timestamp": null, /* časové razítko – vrátí stav od zadané hodnoty */
"sdt_sn": null /* výrobní číslo (SN) */
}
}
}
}
príkaz IMAGE
- Vráti obrázok(y) uložený(é) zo skladu vo formáte 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é parametre:
[filename,skl_cislo,id_cislo]
príkaz OB_IN
- načítanie prijatých objednávok
{
"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 vyplnenie aspoň jedného z týchto parametrov:
[cislo_obj,id_obj,ico_part,id_part,cis_part,sklad,dokl_r,timestamp] nebo [queryConditions]
Príkaz umožňuje vložiť aj vlastnú poznámku (queryConditions).
Grafické zobrazenie vybraných DB položiek v prostredí Premiera, vrátených v Result
(Zoznam všetkých DB položiek, vrátane dátových typov, veľkosti, povinnosti a popisu nájdete v Helpu webového rozhrania, pozri. odkaz vyššie)
príkaz OB_OUT
- načítanie vystavených objednávok
{
"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 vyplnenie aspoň jedného z týchto parametrov:
[cislo_obj,id_obj,ico_part,id_part,cis_part,sklad,dokl_r,timestamp] alebo [queryConditions]
príkaz OBJ_CALC
- vracia podľa parametrov objednané, rezervované a vydané množstvo z prijatej objednávky.
Bez parametrov = zhrnuté množstvo nesplnených objednávok podľa 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é) */
}
}
}
}
príkaz OB_IN_ADD
- zápis novej prijatej objednávky
{
"command": {
"inComm": "OB_IN_ADD",
"inParam": {
"parameters": {}
}
},
"Data": {
"DATUM_VYST": "2018-03-23 17:00:15", /* datum vystavení */
"DATUM_SPL": "2020-01-08", /* datum splatnosti */
"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 dodavatele */
"KON_PRIJEM": "kon_prijem", /* 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 */
"UHRADA": "uhrada",
"BARVA": 255,
"POL_OBIN": [ /* tab. POL_OBIN */
{
"SCISLO": "200229", /* katalogové číslo */
"TEXT": "", /* název */
"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, /* celková cena */
"RAB_SK": 0.0, /* rabatní skupina */
"SLEVA_PR": 0.0, /* sleva v procentech */
"MJ": "KS", /* měrná jednotka */
"SAZBA_DPH": 21.0 /* procentní výše nejčastější sazby dph při prodeji */
}
]
}
}
Povinné je vyplnenie týchto parametrov:
[DATUM_VYST, DATUM_SPL, DOKLAD, ID_ODB]
Pred zápisom sa kontroluje obdobie a program nedovolí zapísať záznam, pokiaľ je už uzatvorené.
príkaz OB_OUT_ADD
- zápis novej vystavenej 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": 21, /* výše 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 */
"SAZBA_DPH": 21, /* výše sazby DPH */
}
]
}
}
Povinné je vyplnenie aspoň jedného z týchto parametrov:
čí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 */
}
}
príkaz OBJOUT_CALC
- vracia objednané množstvo podľa skladového čísla z vystavenej objednávky.
Bez parametrov, ktoré nie sú povinné = vrátí všetky skladové karty, v ktorých je objednávka pre dodávateľa.
Bez parametrov = zhrnuté množstvo nesplnených objednávok podľa 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é */
}
}
}
}
príkaz PRIJEMKY
- zoznam príjemok
{
"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é zobrazenie vybraných DB položiek v prostredí Premiera, vrátených v Result
(Zoznam všetkých DB položiek, vrátane dátových typov, veľkosti, povinnosti a popisu nájdete v Helpu webového rozhrania, pozri. odkaz vyššie)
Príklad obmedzeného výberu len na požadované DB položky
{
"command": {
"inComm": "PRIJEMKY",
"inParam": {
"parameters": {
"sklad": 1,
}
}
},
"queryFields": [
{
"tableName": "PRIJEMKY",
"tableFields": "ID, CISLO "
}
]
}
príkaz PRIJEMKY_ADD
- zápis novej prí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í */
}
]
}
}
Povinné je vyplnenie týchto parametrov:
[DOKLAD, ID_PAR]
Pred zápisom sa kontroluje obdobie a program nedovolí zapísať záznam, pokiaľ je obdobie už uzatvorené.
príkaz VYDEJKY
- zoznam výdajok
{
"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 vyplnenie aspoň jedného z týchto parametrov:
čí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": "",
"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
}
]
}
]
}
Grafické zobrazenie vybraných DB položiek v prostredí Premiera, vrátených v Result
(Zoznam všetkých DB položiek, vrátane dátových typov, veľkosti, povinnosti a popisu nájdete v Helpu webového rozhrania, pozri. odkaz vyššie)
Príklad obmedzeného výberu ina na požadované DB položky
{
"command": {
"inComm": "VYDEJKY",
"inParam": {
"parameters": {
"sklad": 1
}
}
},
"queryFields": [
{
"tableName": "VYDEJKY",
"tableFields": "ID, CISLO, BARVA, C_KOD"
}
]
}
príkaz VYDEJKY_ADD
- zápis novej výdajky
{
"command": {
"inComm": "VYDEJKY_ADD"
"inParam": {
"parameters": {
"bez_cen": null /* nekontroluje ceny položek: 0/1 */
}
}
},
"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, /* částka Brutto */
"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 (partnery.id) , 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 výdejek */
"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ší 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) */
}
]
}
}
Povinné je vyplnenie týchto parametrov:
[DOKLAD, ID_PAR]
Pred zápisom sa kontroluje obdobie a program nedovolí zapísať záznam, pokiaľ je obdobie už uzatvorené.
V prípade, že neexistuje objednávka (nie vždy sa vytvára pred výdajkou), vráti API iba varovanie
{
"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"
}
}
Podmenky používania poľa poukaz (viď. tiež príkaz DPOUKAZ):
- iba vo výdajke
- dľžka poukazu je 8 cifier
- množstvo nadobúda hodnotu 1 alebo -1
- na skladovej karte Premier musí byť zaškrtnuté „dárkové poukazy“
- kontroluje sa číslo skladovej karty poukazu predaja so skladovým číslom uplatneného poukazu
- pri predaji musí súhlasiť cena s cenou na karte Premier
- pri predaji sa kontroluje existencia čísla dárčekového poukazu
- pri predaji sa kontroluje cena, pri uplatnení sa kontroluje cena, dph, platnosť a zostatok, aj keď je parameter "bez_cen" rovný 1
príkaz VYDEJKY_UPD
- zmena alebo zápis údajov už existujúcej výdajky
{
"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 */
}
}
Upozornenie
Hodnoty, ktoré nechcete zmeniť, nemôžu byť vôbec zadané v parametroch alebo ich hodnota musí byť NULL. Pokiaľ je zadaná nulová alebo prázdná hodnota, prepíše sa stávajúca.
Príkaz ZAKAZKA
- prehľad zákaziek
{
"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 vyplnenie týchto parametrov:
[id_zak, cis_zak, zkkod, dokl_r, akt_zak, id_part, stkod, timestamp] alebo [queryConditions]
Result
{
"result": "OK",
"commandin": "ZAKAZKA",
"error": "",
"warning": "",
"data": [
{
"zkkod": 1,
"zakazka": "1 ",
"cislo": 1,
"zaka_nazev": "Omítka na budově",
"hs_obj": "",
"stredisko": 0,
"pu_zak": " ",
"odberatel": "",
"nazev_od2": "",
"ulice_odb": "Oranžová 27 ",
"psc_odb": "",
"mesto_odb": "Kyjovice¨ ",
"stat_odb": "",
"ico_odb": "1234567 ",
"dic_odb": "CZ1234567 ",
"kon_prijem": "",
"objednano": "2015-06-04T00:00:00",
"vyridit": "2015-06-04T00:00:00",
"vyrizeno": "1900-01-01T00:00:00",
"poznamka": "",
"cena": 100000,
"ukonceno": false,
"vystavil": "Plavecká Marie",
"doklad": "ZAK",
"termin": "2015-06-10T00:00:00",
"id": "C85C49CA-5F01-4604-8250-A00428C3C176",
"prubeh": "realizace ",
"id_par": ""
}
]
}
Príkaz SABLONY
- zápis vystavených objednávok
{
"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 */
}
}
}
}
Príkaz podporuje QueryFields a QueryConditions, príklad:
{
"command": {
"inComm": "SABLONY",
"inParam": {
"parameters": {
"sada": "GGV-11BQBMG-3/1
}
},
"queryCondition": {
"tableName": "SABL_SOU",
"conditions": [
{
"fieldName": "SKLAD",
"relationalOperator": "=",
"value": "200"
}
]
}
}
}
Povinné je vyplnenie parametrov:
[ID_SAB alebo SADA - načíta konkrétnu šablonu / alebo DOKLAD]
Výsledok (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 */
}
]
}
]
}
príkaz DPOUKAZ
- prehľad darčekových poukazov (viď. tiež príkaz VYDEJKY_ADD)
{
"command": {
"inComm": "DPOUKAZ",
"inParam": {
"parameters": {
"poukaz": null, /* číslo dárkového poukazu (8 cifer) */
"skl_cislo": null, /* skladové číslo dárkového poukazu */
"sklad": null, /* číslo skladu */
"rozpis": null /* 0/1 = vrátí pohyby dárkového poukazu */
}
}
}
}
Výsledok (result)
{
"Result":"OK",
"CommandIn":"DPOUKAZ",
"Data":
[
{
"sklad_p":1,
"karta":"SLUŽBA 1",
"poukaz":"46918075",
"prodano":"2019-01-22T00:00:00",
"doklad_p":"SV1",
"cislo_p":10062,
"komu":"Příjmení Jméno",
"platnost":12,
"do":"2020-01-22T00:00:00",
"cena_bezdph":1000.000,
"cena_dph":1000.000,
"kod_dph":"31",
"sazba_dph":0.00,
"uplatneno":1000.000,
"zbyva":0.000,
"dne":"2019-01-22T00:00:00",
"doklad_u":"SV1",
"sklad_u":1,
"cislo_u":10063,
"kym":"Příjmení Jméno"
}
]
}
Výsledok (Result) s rozpisom
{
"Result":"OK",
"CommandIn":"DPOUKAZ",
"Data":
[
{
"sklad_p":1,
"karta":"SLUŽBA 1",
"poukaz":"46918075",
"prodano":"2019-01-22T00:00:00",
"doklad_p":"SV1",
"cislo_p":10062,
"komu":"Příjmení Jméno",
"platnost":12,
"do":"2020-01-22T00:00:00",
"cena_bezdph":1000.000,
"cena_dph":1000.000,
"kod_dph":"31",
"sazba_dph":0.00,
"uplatneno":1000.000,
"zbyva":0.000,
"dne":"2019-01-22T00:00:00",
"doklad_u":"SV1",
"sklad_u":1,
"cislo_u":10063,
"kym":"Příjmení Jméno",
"rozpis":
[
{
"psklad":1,
"scislo":"SLUŽBA 1",
"mnozstvi":1.000, /* množství může nabývat hodnot: 1/-1 */
"id_pol_skl":"CE3A3ADD-13AE-4CFD-8481-1606125868E8",
"faktura":351,
"datum_vys":"2019-01-22T00:00:00",
"cas":"",
"id_vydej":"860DD6D1-E989-43C3-8B2D-18420E9122F8",
"cislo":10062,
"doklad":"SV1",
"nazev_odb":"Příjmení Jméno",
"poukaz":"46918075",
"cena":1000.000,
"cena_dph":1000.000,
"kod_dph":"31",
"sazba_dph":0.00,
"plat_dk":12
},
{
"psklad":1,
"scislo":"SLUŽBA 1",
"mnozstvi":-1.000,
"id_pol_skl":"DEE23733-B01D-497D-ACD5-E2C02BCD115C",
"faktura":352,
"datum_vys":"2019-01-22T00:00:00",
"cas":"",
"id_vydej":"F6A22C52-F45C-4579-9533-C4105258DC58",
"cislo":10063,
"doklad":"SV1",
"nazev_odb":"Příjmení Jméno",
"poukaz":"46918075",
"cena":-1000.000,
"cena_dph":-1000.000,
"kod_dph":"31",
"sazba_dph":0.00,
"plat_dk":12
}
]
}
]
}
príkaz STITKY
- zobrazí zoznam dostupných štítkov
{
"command": {
"inComm": "STITKY"
}
}
Result
{
"Result":"OK",
"CommandIn":"STITKY",
"Data":
[
{
"kod":"KLI",
"popis":"Významný klient ",
"id":"3932334B-4C49-0000-0000-000000000000"
},
{
"kod":"NSO",
"popis":"Nesolventní klient",
"id":"3932334E-534F-0000-0000-000000000000"
},
{
"kod":"VIP",
"popis":"VIP klient",
"id":"39323356-4950-0000-0000-000000000000"
}
]
}
Pridá alebo zmaže u partnera štítok podľa číselníku dostupných štítkov. Pokiaľ nie je vyplnené ADD ani DEL, zobrazí sa aktuálny záznam.
{
"command": {
"inComm": "STITKY",
"inParam": {
"parameters": {
"tab": "PARTNERY", /* název tabulky */
"id": "01FCB191-6718-470C-A451-FA5F4ECB7DDC", /* ID záznamu (partnera) */
"add": "KLI;VIP", /* pokud je vyplněn kód štítků, přidá záznam – může být vyplněno více kódů současně, oddělených středníkem */
"del": "" /* pokud je vyplněn kód štítků, zápis vymaže – může být vyplněno více kódů současně, oddělených středníkem */
}
}
}
}
príkaz ZMENY
- prehľad zmien záznamu v tabuľkách ZMENY a DEL_DBF
{
"command": {
"inComm": "ZMENY",
"inParam": {
"parameters": {
"id": null /* ID záznamu */
}
}
}
}
príkaz PROMEN
- zoznam povolených globálnych premenných z Premiera
{
"command": {
"inComm": "PROMEN"
}
}
Výsledok (Result)
{
"result": "OK",
"commandin": "PROMEN",
"error": "",
"warning": "",
"data": [
{
"PROMEN": "a_menycnb", /* název proměnné */
"C_SET": "EUR;USD;SSK", /* textová hodnota proměnné (240 znaků) */
"C_SET2": "", /* textová hodnota proměnné, 2. část (240 znaků) */
"D_SET": "1900-01-01T00:00:00", /* datumová hodnota proměnná - vrácená hodnota "1900-01-01T00:00:00", odpovídá hodnotě NULL */
"N_SET": 0, /* numerická hodnota proměnné (max. 17 cifer, včetně max. 7 des. míst) – vrácená 0, odpovídá také hodnotě NULL */
"L_SET": false, /* logická hodnota – vrácené hodnota false, odpovídá také NULL */
"POPIS": "meny pre CNB", /* popis proměnné */
"#_promen_sez": [
{
"kat": "UCET" /* kategorie */
}
]
}
]
}
príkaz KURS_LIST
- zoznam povolených globálnych premenných z Premiera
{
"command": {
"inComm": "KURS_LIST",
"inParam": {
"parameters": {
"mena": ‘EUR‘, /* označení měny */
"datum": null /* požadovaný datum */
}
}
}
}
Výsledok (Result)
{
"result": "OK",
"commandin": "KURS_LIST",
"error": "",
"warning": "",
"data": [
{
"datum": "2006-06-20", /* datum */
"mena": "EUR", /* měna */
"mnoz": 1, /* množství - kolik cizí měny dostanete za daný kurz 1, 100, 1000 */
"kurs": 0, /* kurz měny */
"pred": true
},
]
}
príkaz STREDISK
- export aktuálneho číselníku stredísk
{
"command": {
"inComm": "STREDISK"
}
}
}
Výsledok (Result)
{
"result": "OK",
"commandin": "STREDISK",
"error": "",
"warning": "",
"data": [
{
"stkod": 1, /* ID střediska */
"stredisko": "1 ", /* číselné označení (max. 12 cifer) */
"nazev": "Základové desky " /* popis = název střediska */
},
{
"stkod": 2,
"stredisko": "2 ",
"nazev": "Přípojky"
},
{
"stkod": 3,
"stredisko": "3 ",
"nazev": "Hrubé stavby"
},
]
}
príkaz OSNOVA
- účtovná osnova
{
"command": {
"inComm": "OSNOVA",
"inParam": {
"parameters": {
"rok": null /* účetní rok */
}
}
}
}
Výsledok (Result)
{
"result": "OK",
"commandin": "OSNOVA",
"error": "",
"warning": "",
"data": [
{
"ucet": "013", /* syntetický účet */
"analyt": "100 ", /* analytický účet */
"text": "Software", /* popis */
"rok": 2018, /* účetní rok */
"text_1": "", /* cizí výraz 1 */
"text_2": "", /* cizí výraz 2 */
"text_3": "", /* cizí výraz 3 (azbuka) */
"zakazka": 0, /* zakázka (0 = default (Může být) / 1 = Nesmí být zadána / 2 = Může být / 3 = Musí být / 4 = Musí být, není-li zadáno středisko) */
"stredisko": 0 /* středisko (0 = default (Může být) / 1 = Nesmí být zadána / 2 = Může být / 3 = Musí být / 4 = Musí být, není-li zadána zakázka) */
},
{
"ucet": "021",
"analyt": "100 ",
"text": "Stavby",
"rok": 2018,
"text_1": "",
"text_2": "",
"text_3": "",
"zakazka": 0,
"stredisko": 0
}
]
}
Povinné je vyplnenie parametra:
[ROK]
príkaz VERZEAPI
- kontrolna funkcia - vracia aktuálnu verziu knižníćc zabezpečujúcich chod API v premieri
{
"command": {
"inComm": "VERZEAPI",
"inParam": {
"parameters": {
"table_name": null,
"prikaz": null
}
}
}
}
Výsledok (Result)
{
"result": "OK",
"commandin": "VERZEAPI",
"error": "",
"warning": "",
"data": {
"ApiComPrem.dll": {
"verze": "1.0.0.2",
"datum": "25.02.2019 21:31"
},
"ApiComSQL.dll": {
"verze": "1.0.0.7",
"datum": "25.02.2019 21:30"
}
}
}
Obsah stránky