Preskoči na glavno vsebino

Import záznamov cez API

Ako zistím, ktoré evidencie je možné importovať cez API?

Avtor: Petr Pech

Nie do každej evidencie sa dá cez API zapisovať. Či import podporuje, hovorí pole importStatus v zozname evidencií.


Zoznam evidencií

GET /c/{firma}/evidence-list.xml

Pri každej evidencii nájdete strojový názov (evidencePath), slovenský názov a tri užitočné príznaky:

Pole

Význam

importStatus

Či a ako je možné do evidencie importovať — hodnoty nižšie.

extIdSupported

Či evidencia podporuje externé identifikátory.

evidenceType, formCode

Typ evidencie a kód formulára pre tlačové zostavy.


Hodnoty importStatus

Hodnota

Význam

SUPPORTED

Import je podporovaný a zdokumentovaný — napríklad faktura-vydana.

NOT_DIRECT

Priamo importovať nemožno, len cez nadradený záznam. Týka sa položiek dokladov — pokus o priamy import skončí hláškou Import není povolen.

DISALLOWED

Import nie je povolený vôbec. Ide o dopočítavané pohľady ako stav-uctu, individualni-cenik alebo zurnal.

NOT_DOCUMENTED

Import nie je zdokumentovaný. Môže fungovať, ale správanie sa môže zmeniť.

💡 Zoznam možno filtrovať ako ktorúkoľvek inú evidenciu, takže si rovno vytiahnete len tie, do ktorých sa dá zapisovať. To isté vidíte aj vo webovom rozhraní na adrese /c/{firma}/evidence-list v stĺpci Podpora importu.

ℹ️ Aké vlastnosti daná evidencia má, vypíše /c/{firma}/{evidence}/properties.xml; zoznam naviazaných evidencií zase /relations.xml.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?