Registrácia Prihlásenie

API medziskladových presunov

Správa medziskladových presunov — načítanie, vytvorenie, úprava, uzavretie a stiahnutie dokumentu

Koncové body

Autentifikácia

Ku každej API požiadavke je potrebné odoslať hlavičku X-API-KEY.

X-API-KEY: {vas_api_kluc}

Máte ešte otázky?

Napíšte nám tiket, alebo si pozrite naše centrum pomoci.

Ak sa vám páčilo, podeľte sa s ostatnými

Základná URL

https://{tenant}.logzi.com/api/transmission/

Každá požiadavka vracia JSON odpoveď. Pri úspešnej odpovedi je result.code == 1, pri chybe result.code == 0.

GET /api/transmission/get

Načítanie jedného medziskladového presunu podľa identifikátora, s úplnými podrobnosťami (položky, zdrojový/cieľový sklad, sériové čísla, projekt).

Query parametre

Parameter Typ Povinné Popis
id int Jedinečný identifikátor medziskladového presunu

Príklad požiadavky

GET /api/transmission/get?id=11
X-API-KEY: {vas_api_kluc}

Príklad odpovede

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 11,
    "identify": "TR-2024-0011",
    "date_create": "2024-05-06 08:30:00",
    "date_perform": "2024-05-06",
    "status_id": 1,
    "item": [
      {
        "product_id": 3,
        "quantity": 10,
        "src_store_id": 1,
        "src_store_locality_id": 4,
        "dst_store_id": 2,
        "dst_store_locality_id": 7
      }
    ]
  }
}
GET /api/transmission/list

Stránkovateľné načítanie zoznamu medziskladových presunov s možnosťami filtrovania.

Query parametre

Parameter Typ Povinné Popis
list_offset int Posun stránkovania (predvolene: 0)
list_condition[identify] string Filtrovanie podľa identifikátora (LIKE)
list_condition[status_id] int Filtrovanie podľa stavu (1=otvorený, 2=uzavretý)
list_condition[status_ids] array Filtrovanie podľa viacerých stavov naraz
list_condition[company_user_id] int Filtrovanie podľa ID zodpovedného pracovníka
list_condition[date_create_from] date Dátum vytvorenia — od (YYYY-MM-DD)
list_condition[date_create_to] date Dátum vytvorenia — do (YYYY-MM-DD)
list_condition[date_perform_from] date Dátum realizácie — od (YYYY-MM-DD)
list_condition[date_perform_to] date Dátum realizácie — do (YYYY-MM-DD)
list_condition[partnumber] string Filtrovanie podľa katalógového čísla alebo čiarového kódu (LIKE)
list_condition[comment_bottom] string Filtrovanie podľa internej poznámky (LIKE)

Príklad požiadavky

GET /api/transmission/list?list_offset=0&list_condition[status_id]=1
X-API-KEY: {vas_api_kluc}

Príklad odpovede

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 11,
      "identify": "TR-2024-0011",
      "date_create": "2024-05-06",
      "status_name": "Nyitott",
      "company_user_name": "Kovács Péter"
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 8
  }
}
POST /api/transmission/save

Vytvorenie alebo úprava medziskladového presunu. Pre každú položku je potrebné samostatne zadať zdrojový a cieľový sklad. Pre nový presun zadajte data[id] = 0, pre úpravu zadajte existujúce ID.

POST polia — objekt data

Pole Typ Povinné Popis
id int 0 = nový presun, >0 = úprava
company_id int Identifikátor firmy
company_user_id int ID zodpovedného pracovníka
date_perform datetime Dátum realizácie (YYYY-MM-DD HH:MM:SS)
comment_bottom string Interná poznámka
jobnumber_id int Identifikátor pracovného čísla
departmentnumber_id int Identifikátor čísla oddelenia
project_id int Identifikátor projektu
source_receipt_id int Identifikátor zdrojového dokladu
source_receipt_type_id int Identifikátor typu zdrojového dokladu
item array Pole položiek — aspoň jedna položka je povinná (pozri nižšie)

Polia položky — data[item][]

Pole Typ Povinné Popis
product_id int Identifikátor produktu
quantity decimal Množstvo na presun
src_store_id int Identifikátor zdrojového skladu
src_store_locality_id int Identifikátor zdrojového skladového miesta
src_pallet_id int Identifikátor zdrojovej palety
dst_store_id int Identifikátor cieľového skladu
dst_store_locality_id int Identifikátor cieľového skladového miesta
dst_pallet_id int Identifikátor cieľovej palety

POST polia — objekt params (voliteľné)

Pole Typ Povinné Popis
close int 1 = automatické uzavretie po uložení
download int 1 = generovanie PDF po uložení

Príklad požiadavky

POST /api/transmission/save
X-API-KEY: {vas_api_kluc}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "date_perform": "2024-06-10 08:00:00",
    "item": [
      {
        "product_id": 3,
        "quantity": 10,
        "src_store_id": 1,
        "src_store_locality_id": 4,
        "dst_store_id": 2,
        "dst_store_locality_id": 7
      }
    ]
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Príklad odpovede

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 12,
    "identify": "TR-2024-0012"
  }
}
POST /api/transmission/save_group

Vytvorenie hromadného medziskladového presunu. Údaje o zdrojovom a cieľovom sklade/skladovom mieste/palete sa zadávajú na úrovni data — tie platia jednotne pre všetky položky.

POST polia — objekt data

Pole Typ Povinné Popis
company_id int Identifikátor firmy
company_user_id int ID zodpovedného pracovníka
src_store_id int Identifikátor zdrojového skladu (platí pre všetky položky)
src_store_locality_id int Identifikátor zdrojového skladového miesta (platí pre všetky položky)
src_pallet_id int Identifikátor zdrojovej palety (platí pre všetky položky)
dst_store_id int Identifikátor cieľového skladu (platí pre všetky položky)
dst_store_locality_id int Identifikátor cieľového skladového miesta (platí pre všetky položky)
dst_pallet_id int Identifikátor cieľovej palety (platí pre všetky položky)
date_perform datetime Dátum realizácie (YYYY-MM-DD HH:MM:SS)
comment_bottom string Interná poznámka
item array Pole položiek — pre každú položku stačí product_id a quantity

Príklad požiadavky

POST /api/transmission/save_group
X-API-KEY: {vas_api_kluc}
Content-Type: application/json

{
  "data": {
    "company_id": 1,
    "company_user_id": 3,
    "src_store_id": 1,
    "src_store_locality_id": 4,
    "dst_store_id": 2,
    "dst_store_locality_id": 7,
    "date_perform": "2024-06-10 08:00:00",
    "item": [
      { "product_id": 3, "quantity": 10 },
      { "product_id": 7, "quantity": 4 }
    ]
  }
}

Príklad odpovede

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 13,
    "identify": "TR-2024-0013"
  }
}
POST /api/transmission/delete

Odstránenie medziskladového presunu. Odstrániť je možné iba doklad so stavom status_id = 1 (otvorený) alebo status_id = 2 (uzavretý).

POST polia — objekt data

Pole Typ Povinné Popis
receipt_id int Identifikátor medziskladového presunu, ktorý sa má odstrániť

Príklad požiadavky

POST /api/transmission/delete
X-API-KEY: {vas_api_kluc}
Content-Type: application/json

{
  "data": {
    "receipt_id": 11
  }
}

Príklad odpovede

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
POST /api/transmission/close

Uzavretie otvoreného medziskladového presunu. Uzavrieť je možné iba doklad so stavom status_id = 1 (otvorený).

POST polia — objekt data

Pole Typ Povinné Popis
receipt_id int Identifikátor medziskladového presunu, ktorý sa má uzavrieť

Príklad požiadavky

POST /api/transmission/close
X-API-KEY: {vas_api_kluc}
Content-Type: application/json

{
  "data": {
    "receipt_id": 11
  }
}

Príklad odpovede

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
GET /api/transmission/download

Generovanie dokumentu medziskladového presunu v rôznych formátoch (PDF, base64 reťazec, stream).

Query parametre

Parameter Typ Povinné Popis
receipt_id int Identifikátor medziskladového presunu
file_type string Výstupný formát (pozri nižšie)
language string Názov jazykového priečinka šablóny (napr. hungarian)
language_id int Identifikátor jazyka (predvolene: 1)
template_id int ID vlastnej tlačovej šablóny

Možné hodnoty file_type

Hodnota Popis
pdf Vrátenie base64 kódovaného PDF s metaúdajmi
pdf-string Zhodné s pdf — base64 reťazec + metaúdaje
pdf-string-sample Generovanie náhľadového PDF
stream Priamy súborový stream (stiahnutie v prehliadači)

Príklad požiadavky

GET /api/transmission/download?receipt_id=11&file_type=pdf
X-API-KEY: {vas_api_kluc}

Príklad odpovede (file_type=pdf)

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "name": "TR-2024-0011.pdf",
    "content": "JVBERi0xLjQK...",
    "receipt": { ... }
  }
}

Kontaktuj nás

Zaujíma ťa náš softvér? Pokojne nám napíš!

Odoslať dopyt

Potrebuješ pomoc?

Ak nevieš nájsť odpoveď a potrebuješ pomoc

Pozri sa do centra pomoci

Zaregistruj sa teraz,
zaplať neskôr!

Vyskúšaj 3 dni zadarmo, bez rizika a záväzkov!
Vytvorenie registrácie
Registrácia