# Import APIs Import APIs let You push data from Your systems into Fitek. Whether it's invoices from Your e-invoicing operator, purchase orders from Your procurement tool, or master data from Your ERP - these are the endpoints that get it there. All import APIs share the same authentication pattern: RequestId, IntegratorId, and AuthorizationToken in the request body. Access is not open by default - Your Fitek product manager enables the endpoints You need and provides Your credentials. ### **Importing invoices** The most common starting point. Invoice Import v3 lets You send purchase invoices into Fitek, one per request. The payload contains the full invoice data in Fitek e-invoice format, and it validates against schema version 1.12.2 (with fallback to 1.12.1). If Your invoices follow the Estonian e-invoice 1.2 or 1.11 format, they'll pass validation too. You can optionally tag each invoice's origin as "Digitized" or "E-invoice" using the Extensions block - useful if You want to distinguish how invoices entered the system. Once imported, the invoice goes through the normal Fitek flow: FitekAI, autotransactions, and approval routing all kick in automatically. ### **Importing purchase orders** Purchase Order Import v3 works similarly, but uses XML format (`Content-Type: application/xml`). Each request imports one PO, wrapped in the `Payload.PurchaseOrder.E_Invoice` field. Response comes back as XML by default — add `Accept: application/json` if You prefer JSON. You can import POs with cost objectives and dimensions included. The dimension codes in the payload must match what's configured in Settings → Accounting. A separate PurchaseOrderUpdate endpoint is also available for updating existing POs using the same format. ### **Assigning approvers via API** Confirmation Flow Action v3 lets Your external system control who approves an invoice - without anyone touching the Fitek interface. Send a request with the invoice and one or more users, and they're added at the end of the existing approval chain. A few rules to keep in mind: this only works for invoices in status "New" or "Assigned." Existing approvers stay in place - new ones are appended. If someone in Your request has wrong permissions, is inactive, or can't be the last approver, that person is skipped while the rest are still added. This is particularly useful when Your ERP or workflow engine decides who should approve based on cost centre, amount, or other business logic, but You still want the actual approval to happen inside Fitek. ### **Attaching files and links to invoices** File Import v3 lets You attach documents to invoices — either actual files (via Base64 encoding) or external web links (URLs). The URL option is handy for linking invoices to an external archive or contract system without duplicating large PDFs. If a request contains both a file and a URL, the file takes priority. Imported URLs show up under "Related documents" on the invoice and are clickable. ### **Updating transaction rows** The Transaction rows Import API lets You update posting lines on invoices from an external system. You can identify the target invoice using either the InvoiceGuid or the InternalInvoiceId — useful when Your system works with the numeric ID rather than the GUID. If both are provided and point to different invoices, the GUID takes priority. ### **Syncing master data** Several import APIs keep Your Fitek environment aligned with Your other systems: **Suppliers Import v3:** imports vendor data in bulk: names, registration numbers, VAT numbers, ERP codes, bank accounts. Designed for large datasets with background queue processing, so it doesn't slow things down. Use it for initial onboarding or regular synchronisation with Your main supplier master. **Users Import v3:** available in two variants. The bulk version is best for initial onboarding or nightly full syncs (payload is an array of user objects, processed in background). The one-by-one version is for real-time sync with Your HR or identity management system (single user per request, prioritised for quick responses). **Product Items Import v3:** also available in bulk and one-by-one. Uploads Your internal product codes, descriptions, and mappings to seller product codes. Once set up, Fitek can recognise products on incoming invoices and auto-fill product codes on transaction rows. **Invoice Header Extension list values import v3:** available in bulk and one-by-one. Keeps the dropdown values for Your list-type invoice custom fields in sync with master data. You specify the parent custom field code and provide the list items with their codes, descriptions, and optional start/end dates. --- # 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/copy-of-english/integrations/integrations/import-apis.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.