# API pro import API pro import vám umožňují nahrávat data z vašich systémů do Fiteku. Ať už se jedná o faktury od vašeho operátora e-fakturace, nákupní objednávky z nákupního nástroje nebo kmenová data z vašeho ERP – tyto koncové body zajistí jejich přenos. Všechna API pro import sdílejí stejný vzor autentizace: `RequestId`, `IntegratorId` a `AuthorizationToken` v těle požadavku. Přístup není ve výchozím nastavení otevřený – váš produktový manažer Fitek povolí koncové body, které potřebujete, a poskytne vám přihlašovací údaje. #### Importování faktur Nejčastější výchozí bod. **Invoice Import v3** umožňuje posílat nákupní faktury do Fiteku, jednu na požadavek. Datová část obsahuje kompletní data faktury ve formátu e-faktury Fitek a validuje se vůči schématu verze 1.12.2 (s návratem k verzi 1.12.1). Pokud vaše faktury splňují estonský formát e-faktury 1.2 nebo 1.11, projdou validací také. V bloku `Extensions` můžete volitelně označit původ každé faktury jako „Digitized“ (Digitalizováno) nebo „E-invoice“ (E-faktura) – to je užitečné, pokud chcete rozlišovat, jak faktury do systému vstoupily. Jakmile je faktura importována, prochází běžným procesem Fitek: automaticky se spustí FitekAI, automatické transakce a směrování schvalování. #### Importování nákupních objednávek **Purchase Order Import v3** funguje podobně, ale používá formát XML (`Content-Type: application/xml`). Každý požadavek importuje jednu nákupní objednávku (PO) zabalenou v poli `Payload.PurchaseOrder.E_Invoice`. Odpověď se standardně vrací jako XML – pokud preferujete JSON, přidejte hlavičku `Accept: application/json`. Objednávky můžete importovat včetně nákladových objektů a dimenzí. Kódy dimenzí v datové části musí odpovídat tomu, co je nakonfigurováno v **Nastavení → Účetnictví.** K dispozici je také samostatný koncový bod `PurchaseOrderUpdate` pro aktualizaci stávajících objednávek pomocí stejného formátu. #### Přiřazování schvalovatelů přes API **Confirmation Flow Action v3** umožňuje vašemu externímu systému řídit, kdo fakturu schválí – aniž by se kdokoli dotkl rozhraní Fitek. Pošlete požadavek s fakturou a jedním nebo více uživateli a ti budou přidáni na konec stávajícího schvalovacího řetězce. Je třeba mít na paměti několik pravidel: toto funguje pouze pro faktury ve stavu „Nová“ (New) nebo „Přiřazená“ (Assigned). Stávající schvalovatelé zůstávají na svém místě – noví se připojují za ně. Pokud má někdo v požadavku nesprávná oprávnění, je neaktivní nebo nemůže být posledním schvalovatelem, daná osoba je přeskočena, zatímco ostatní jsou stále přidáni. To je užitečné zejména tehdy, když váš ERP nebo workflow systém rozhoduje o tom, kdo má schvalovat na základě nákladového střediska, částky nebo jiné obchodní logiky, ale přesto chcete, aby samotné schválení proběhlo uvnitř Fiteku. #### Připojování souborů a odkazů k fakturám **File Import v3** umožňuje připojovat k fakturám dokumenty – buď skutečné soubory (přes kódování Base64), nebo externí webové odkazy (URL). Možnost URL je praktická pro propojení faktur s externím archivem nebo smluvním systémem bez duplikování velkých PDF souborů. Pokud požadavek obsahuje soubor i URL, prioritu má soubor. Importované URL adresy se zobrazují u faktury v sekci „Související dokumenty“ a lze na ně kliknout. #### Aktualizace transakčních řádků **API pro import transakčních řádků** (Transaction rows Import API) umožňuje aktualizovat zaúčtování řádků na fakturách z externího systému. Cílovou fakturu můžete identifikovat buď pomocí `InvoiceGuid`, nebo `InternalInvoiceId` – což je užitečné, když váš systém pracuje s číselným ID spíše než s GUID. Pokud jsou poskytnuty oba údaje a ukazují na různé faktury, prioritu má GUID. #### Synchronizace kmenových dat Několik importních API udržuje vaše prostředí Fitek v souladu s vašimi ostatními systémy: * **Suppliers Import v3:** importuje data dodavatelů hromadně: názvy, registrační čísla, DIČ, ERP kódy, bankovní účty. Je navrženo pro velké datové sady se zpracováním ve frontě na pozadí, takže nezpomaluje provoz. Použijte jej pro počáteční nastavení nebo pravidelnou synchronizaci s vaším hlavním číselníkem dodavatelů. * **Users Import v3:** k dispozici ve dvou variantách. Hromadná verze (bulk) je nejlepší pro počáteční nastavení nebo noční plné synchronizace (datovou částí je pole objektů uživatelů, zpracovávané na pozadí). Verze po jednom (one-by-one) je určena pro synchronizaci v reálném čase s vaším HR nebo systémem správy identit (jeden uživatel na požadavek, s prioritou pro rychlou odpověď). * **Product Items Import v3:** k dispozici také jako hromadný import nebo po jednom. Nahrává vaše interní kódy produktů, popisy a mapování na kódy produktů prodejce. Po nastavení dokáže Fitek rozpoznat produkty na příchozích fakturách a automaticky vyplnit kódy produktů na transakčních řádcích. * **Invoice Header Extension list values import v3:** k dispozici hromadně i po jednom. Udržuje hodnoty rozbalovacích seznamů pro vaše vlastní pole faktury v souladu s kmenovými daty. Určíte kód nadřazeného vlastního pole a poskytnete položky seznamu s jejich kódy, popisy a volitelnými daty zahájení/ukončení 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/czech-cestina/integrations/integrace/api-pro-import.md?ask= ``` 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.