API prijatých faktúr

Správa dodávateľských a prijatých faktúr — získavanie, vytváranie, úprava a uzatváranie

Základná URL

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

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

GET/api/invoice_in/get

Získanie jednej prijatej faktúry podľa identifikátora, s úplnými podrobnosťami.

Query parametre

ParameterTypPovinnéPopis
idintJedinečný identifikátor prijatej faktúry
identifystringMožno získať aj podľa čísla faktúry

Príklad požiadavky

GET /api/invoice_in/get?id=77
X-API-KEY: {vas_api_kluc}
GET/api/invoice_in/list

Stránkovaný zoznam prijatých faktúr s možnosťami filtrovania.

Query parametre

ParameterTypPovinnéPopis
list_offsetintPosun stránkovania (predvolené: 0)
list_countintPočet záznamov zobrazených na stránku
list_condition[identify]stringFilter podľa čísla faktúry (LIKE)
list_condition[company_name]stringFilter podľa názvu dodávateľa (LIKE)
list_condition[status_id]intFilter podľa stavu
list_condition[date_create_from]dateDátum vytvorenia — od (YYYY-MM-DD)
list_condition[date_create_to]dateDátum vytvorenia — do (YYYY-MM-DD)

Príklad požiadavky

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

Vytvorenie alebo úprava prijatej faktúry. Pre novú faktúru data[id] = 0.

POST polia — objekt data

PoleTypPovinnéPopis
idint0 = nová faktúra, >0 = úprava
company_idintIdentifikátor firmy
company_user_idintID zodpovedného pracovníka
company_address_idintID prevádzky firmy
currency_idintIdentifikátor meny
partner_idintIdentifikátor dodávateľa (partnera)
date_performdateDátum plnenia (YYYY-MM-DD)
date_paydateTermín splatnosti (YYYY-MM-DD)
paymod_idintIdentifikátor spôsobu platby
comment_topstringPoznámka
comment_bottomstringInterná poznámka
itemarrayPole položiek (pozri nižšie)

Polia položky — data[item][]

PoleTypPovinnéPopis
product_idintIdentifikátor produktu
quantityfloatMnožstvo
pricefloatČistá jednotková cena
tax_idintIdentifikátor sadzby DPH
store_idintIdentifikátor cieľového skladu
removeint1 = odstránenie položky pri úprave

Príklad požiadavky

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

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "company_address_id": 1,
    "currency_id": 1,
    "partner_id": 8,
    "date_perform": "2024-06-30",
    "date_pay": "2024-07-30",
    "item": [
      { "product_id": 2, "quantity": 100, "price": 500, "tax_id": 2 }
    ]
  }
}
POST/api/invoice_in/delete

Odstránenie prijatej faktúry. Odstrániť možno iba otvorenú faktúru (status_id=1).

POST polia — objekt data

PoleTypPovinnéPopis
receipt_idintIdentifikátor faktúry, ktorá sa má odstrániť

Príklad požiadavky

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

{ "data": { "receipt_id": 77 } }
POST/api/invoice_in/close

Uzavretie prijatej faktúry. Pri uzatvorení sa vytvoria účtovné zápisy. Príjem na sklad prebieha prostredníctvom modulu skladového príjmu (booking). Uzavrieť možno iba otvorenú faktúru (status_id=1).

POST polia — objekt data

PoleTypPovinnéPopis
receipt_idintIdentifikátor faktúry, ktorá sa má uzavrieť

Príklad požiadavky

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

{ "data": { "receipt_id": 77 } }

Kontaktuj nás

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

Potrebuješ pomoc?

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

Zaregistruj sa teraz,
zaplať neskôr!

Vyskúšaj 3 dni zadarmo, bez rizika a záväzkov!