# Import APIs

Importné API vám umožňujú odosielať dáta z vašich systémov do Fiteku. Či už ide o faktúry od vášho operátora elektronickej fakturácie, objednávky z vášho nákupného nástroja alebo kmeňové dáta z vášho ERP – toto sú koncové body, ktoré ich tam dostanú.

Všetky importné API zdieľajú rovnaký vzor autentifikácie: RequestId, IntegratorId a AuthorizationToken v tele požiadavky. Prístup nie je predvolene otvorený – váš produktový manažér Fitek povolí koncové body, ktoré potrebujete, a poskytne vám prihlasovacie údaje.

### **Importovanie faktúr**

Najbežnejší východiskový bod. Invoice Import v3 vám umožňuje odosielať nákupné faktúry do Fiteku, jednu na požiadavku. Payload obsahuje úplné údaje o faktúre vo formáte elektronickej faktúry Fitek a overuje sa voči schéme verzie 1.12.2 (s možnosťou návratu k 1.12.1). Ak vaše faktúry spĺňajú estónsky formát e-faktúr 1.2 alebo 1.11, prejdú validáciou tiež.

Pomocou bloku Extensions môžete voliteľne označiť pôvod každej faktúry ako „Digitalizovaná“ alebo „E-faktúra“ – čo je užitočné, ak chcete rozlíšiť, ako faktúry vstúpili do systému.

Po importe faktúra prechádza štandardným procesom Fitek: automaticky sa spustí FitekAI, automatické transakcie a smerovanie na schvaľovanie.

### **Importovanie objednávok**

Purchase Order Import v3 funguje podobne, ale používa formát XML (Content-Type: application/xml). Každá požiadavka importuje jednu objednávku, zabalenú v poli Payload.PurchaseOrder.E\_Invoice. Odpoveď sa predvolene vracia ako XML – ak uprednostňujete JSON, pridajte hlavičku Accept: application/json.

Objednávky (PO) môžete importovať vrátane nákladových objektov a dimenzií. Kódy dimenzií v rámci payloadu sa musia zhodovať s tými, ktoré sú nakonfigurované v časti Nastavenia → Účtovníctvo. K dispozícii je aj samostatný koncový bod PurchaseOrderUpdate na aktualizáciu existujúcich objednávok pri použití rovnakého formátu.

### **Priraďovanie schvaľovateteľov cez API**

Confirmation Flow Action v3 umožňuje vášmu externému systému riadiť, kto schvaľuje faktúru – bez toho, aby sa niekto dotkol rozhrania Fitek. Odošlite požiadavku s faktúrou a jedným alebo viacerými používateľmi a tí budú pridaní na koniec existujúceho schvaľovacieho reťazca.

Pár pravidiel, ktoré treba mať na pamäti: toto funguje len pre faktúry v stave „New“ (Nová) alebo „Assigned“ (Priradená). Existujúci schvaľovatelia zostávajú zachovaní – noví sa pridávajú na koniec. Ak niekto v požiadavke nemá správne oprávnenia, je neaktívny alebo nemôže byť posledným schvaľovateľom, daná osoba sa vynechá, zatiaľ čo zvyšok sa pridá.

Toto je obzvlášť užitočné, keď váš ERP systém alebo procesný nástroj (workflow engine) rozhoduje o tom, kto má schváliť faktúru na základe nákladového strediska, sumy alebo inej obchodnej logiky, ale stále chcete, aby samotné schválenie prebehlo priamo vo Fiteku.

### **Pripájanie súborov a odkazov k faktúram**

File Import v3 vám umožňuje pripájať dokumenty k faktúram – buď skutočné súbory (prostredníctvom kódovania Base64), alebo externé webové odkazy (URL). Možnosť URL je praktická na prepojenie faktúr s externým archívom alebo zmluvným systémom bez toho, aby ste museli duplikovať veľké súbory PDF.

Ak požiadavka obsahuje súbor aj URL adresu, prioritou je súbor. Importované URL adresy sa na faktúre zobrazia v časti „Súvisiace dokumenty“ a sú klikateľné.

### Aktualizácia transakčných riadkov

Importné API pre transakčné riadky vám umožňuje aktualizovať účtovné riadky na faktúrach z externého systému. Cieľovú faktúru môžete identifikovať pomocou `InvoiceGuid` alebo `InternalInvoiceId` – čo je užitočné, ak váš systém pracuje skôr s číselným ID než s GUID. Ak sú poskytnuté oba údaje a odkazujú na rôzne faktúry, prioritu má GUID.

### **Synchronizácia kmeňových dát**

Niekoľko importných API udržiava vaše prostredie Fitek zladené s vašimi ostatnými systémami:

**Suppliers Import v3**: hromadne importuje údaje o dodávateľoch: názvy, registračné čísla, IČ DPH, kódy ERP, bankové účty. Navrhnuté pre veľké súbory údajov so spracovaním v rade na pozadí, takže nespomaľuje systém. Použite ho na úvodné nastavenie alebo pravidelnú synchronizáciu s vaším hlavným číselníkom dodávateľov.

**Users Import v3**: dostupný v dvoch variantoch. Hromadná verzia (bulk) je najlepšia pre počiatočné nastavenie alebo nočné úplné synchronizácie (payload je pole objektov používateľov, spracovávané na pozadí). Verzia „jeden po druhom“ je určená na synchronizáciu v reálnom čase s vaším HR systémom alebo systémom správy identít (jeden používateľ na požiadavku, prioritizované pre rýchle odpovede).

**Product Items Import v3**: dostupný v hromadnej verzii aj vo verzii po jednom. Nahráva vaše interné kódy produktov, popisy a mapovania na kódy produktov predajcu. Po nastavení dokáže Fitek rozpoznať produkty na prichádzajúcich faktúrach a automaticky doplniť kódy produktov do transakčných riadkov.

**Invoice Header Extension list values import v3**: dostupný v hromadnej verzii aj vo verzii po jednom. Udržiava hodnoty v rozbaľovacích zoznamoch pre vaše vlastné polia faktúr (typu "list") synchronizované s kmeňovými dátami. Zadáte kód nadradeného vlastného poľa a poskytnete položky zoznamu s ich kódmi, popismi a voliteľnými dátumami začiatku a konca platnosti.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fitek-learning.fitek.com/fitek-learning-space/slovakia-slovencina/integrations/integracie/import-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.