Přeskočit na hlavní obsah

Import evidencí přes API

Jak zjistím, které evidence lze importovat přes API?

Autor: Petr Pech

Ne do každé evidence lze přes API zapisovat. Jestli import podporuje, říká pole importStatus v seznamu evidencí.


Seznam evidencí

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

U každé evidence najdete strojový název (evidencePath), český název a tři užitečné příznaky:

Pole

Význam

importStatus

Zda a jak lze do evidence importovat — hodnoty níže.

extIdSupported

Zda evidence podporuje externí identifikátory.

evidenceType, formCode

Typ evidence a kód formuláře pro tiskové sestavy.


Hodnoty importStatus

Hodnota

Význam

SUPPORTED

Import je podporovaný a dokumentovaný — například faktura-vydana.

NOT_DIRECT

Přímo importovat nelze, jen přes nadřazený záznam. Týká se položek dokladů — pokus o přímý import skončí hláškou Import není povolen.

DISALLOWED

Import není povolen vůbec. Jde o dopočítávané pohledy jako stav-uctu, individualni-cenik nebo zurnal.

NOT_DOCUMENTED

Import není dokumentovaný. Může fungovat, ale chování se může změnit.

💡 Seznam lze filtrovat jako jakoukoli jinou evidenci, takže si rovnou vytáhnete jen ty, do kterých zapisovat jde. Totéž vidíte i ve webovém rozhraní na adrese /c/{firma}/evidence-list ve sloupci Podpora importu.

ℹ️ Které vlastnosti daná evidence má, vydá /c/{firma}/{evidence}/properties.xml; seznam navázaných evidencí pak /relations.xml.


Související

Dostali jste odpověď na svou otázku?