
How-to · MK-soft (Ekonomická agenda SQL)
MK-soft: invoice import and export
Verteco Peppol supports the MK-soft format in both directions: invoices that reach you through the Peppol network are downloaded as a file that MK-soft imports without retyping, and invoices issued in MK-soft are uploaded to the portal and sent to your customers through Peppol. Amounts, VAT rates and document numbers are always taken exactly from the invoice; nothing is recalculated.
Verteco's price is public and the same for everyone (price list); fees for a module, licence or update of MK-soft are its vendor's fees agreed with the vendor.
Direct connection of MK-soft to the portal
MK-soft has a built-in connection to Verteco (the vendor's eFaktúra guide, published on 22 September 2026): received and issued e-invoices travel between the program and the portal directly over the API, with no files. This is the recommended route for a company that does both its bookkeeping and its invoicing in MK-soft.
Credentials
The Client Id and Client Secret that MK-soft asks for are our API key, not the e-mail address and password you log in to the portal with. Verteco does not send them to you by e-mail, not even after your selection on the Financial Administration (Finančná správa) portal, although the MK-soft guide says „dostanete od poskytovateľa“ (you will get them from the provider): you create them yourself. In the portal click API tokens in the left menu, on the API keys tab enter a name for the token (e.g. MK-soft) and click Create token. The portal shows two values with a Copy button: client_id (an identifier in UUID form) goes into the Client Id field, client_secret (it starts with vpt_) into the Client Secret field. The client_secret is shown only once, right after creation; the client_id stays visible in the token list. If you did not manage to save the client_secret, click Rotate next to the token or create a new token and enter both values in MK-soft again (the client_id and client_secret must belong to the same token). Open API keys
- 1Receiving: Číselníky → Účtovníctvo → Služby pre digitálne doklady → Pridaj (Insert) → Služba: VERTECO → Client Id, Client Secret → Test pripojenia (connection test). You then load the invoices in the Saldokonto window: right mouse button → Nástroje → Import digitálnych dokladov (Alt+G), and in the Digitálne doklady window right-click again → Importuj doklady z úložiska (Alt+I).
- 2Sending: Nastavenia → Parametre → the Sklad 2 tab → Nastavenie eFaktúry → Doručovacia služba: VERTECO → Client Id, Client Secret → Test pripojenia. If you have not yet selected Verteco on the Financial Administration portal, the „Žiadosť o registráciu poskytovateľa doručovacej služby“ button takes you there; after the selection you receive an e-mail with your portal login.
- 3MK-soft stores the credentials in two places: separately for receiving (Služby pre digitálne doklady) and separately for sending (Parametre, the Sklad 2 tab). Enter a new or changed key in both places and run Test pripojenia in both; on the receiving side you can take them over with the Načítať prihl. údaje z parametrov button, but only after you have corrected them in Parametre. The error „401 Invalid client credentials“ in Test pripojenia means that the values entered do not match any token on your account (e-mail and password instead of the key, swapped fields, client_id and client_secret from different tokens, a revoked or rotated token, a space picked up while copying, a key from the test environment).
- 4If you start using e-invoices already in 2026, fill in the „Doručovanie aktívne od“ field in Odosielanie eFaktúr (the date from which invoices are sent and received); an empty field means the program only starts on 1 January 2027.
- 5The „Načítať dokumenty od“ option downloads again even the invoices already taken over, from the chosen date onwards (MK-soft offers it for Verteco). The „Načítavať binárne dáta dokumentov“ option stores in MK-soft the XML and, where there is one, the supplier's original PDF.
- 6If you do not store the binary data and rely on the archive with us (Data archive switched on), MK-soft stores „dokument uložený na cloude“ links with the invoice. Those links only work with the Download invoices without authentication option switched on, on the Data archive tab of that company in the portal.
- MK-soft sends issued invoices as XML and optionally attaches a PDF as well (Vkladať do XML aj tlačovú formu PDF); we accept both forms, and the PDF is delivered to the customer as an attachment of the invoice.
- An error on an invoice (a missing mandatory field) is evaluated the moment it is sent from the program; MK-soft shows it in the eFaktúra stav column as „Chyba pri odosielaní“ and, once corrected, sends the invoice again.
- The welcome invoice VITAJTE and the test invoice TEST are documents with an amount of 0.00 EUR and a note that they are not tax documents. If MK-soft rejects them on import, that is fine; they no longer appear in the accounting exports from the portal.
- According to its manual, MK-soft offers the „Načítavať aj vystavené faktúry“ option (loading invoices issued outside MK-soft into Saldokonto, meant for external accountants) only for MRP and EVERIFIN. Our API does provide issued invoices (GET /sapi/document/sent/{id}/xml since version 1.8.15), so wiring it up is on MK-soft's side; until then use the Original XML export and the Peppol BIS 3.0 import (MK-soft 7.127+).
Source: MK-soft, eFaktúra guide (wording checked on 28 September 2026) ↗
Price and contract
- Verteco's price is public and the same for everyone: €2 excl. VAT per month per company ID (IČO), with 1,000 invoices a month included (sent and received together), free of charge until 31 December 2026.
- Fees for the eFaktúra module, the licence or an update of MK-soft are MK-soft's fees agreed with MK-soft; Verteco neither charges nor influences them.
- The contract with Verteco arises by registration under the terms and conditions (VOP); nothing is signed. You print the contract confirmation in the company detail on the Access & contracts tab.
1. Move invoices from the portal into MK-soft
Download received and issued invoices in bulk for a chosen period, or one at a time from the invoice detail.
- 7In the portal open Exports (left menu, address /dashboard/exports). Choose the company; if you like, narrow the period From date / To date and the direction (Received and sent, Received only, Sent only).
- 8In the Accounting software formats section click Download on the MK-soft (.zip) tile. The file
peppol-mksoft.zipdownloads. - 9Unzip the file. It contains:
mksoft_faktury.xml– issued invoices, credit notes and debit notes in POH-XML format (Pohoda dataPack)mksoft_naklady.xml– received invoices, credit notes and debit notes in POH-XML format (Pohoda dataPack)_preskocene.txt– documents the format cannot carry, with the reason for each
- 10In MK-soft open Systémové služby → Export / import údajov → new task (Insert or the Pridaj icon) → Typ „I - import“. For the file mksoft_faktury.xml (issued invoices, receivables) choose Typ importu I-FAKTURY and Formát súboru POH-XML; for the file mksoft_naklady.xml (received invoices, payables) choose Typ importu I-SALDOKONTO and Formát súboru POH-XML. The tasks are created once and then simply run on each new file. MK-soft has maintained the import of invoices from Pohoda (POH-XML) for a long time: I-FAKTURY for issued invoices (e.g. versions 5.39, 7.33, 7.89), I-SALDOKONTO for incoming invoices into Saldokonto (versions 4.119, 4.124, 7.33); do not confuse it with the POH-XML2 format, which is for a different VAT calculation. Source: vendor documentation ↗
- 11If a document is missing, look into
_preskocene.txt: every omitted document has its reason there (see What the format cannot carry). Nothing is left out silently.
One invoice: in the invoice detail, section Accounting data, use Export this document to… and pick MK-soft. A selection: tick documents in the invoice list, choose MK-soft in the Accounting software field of the bar below the list and click Download.
What to know before the first import
- Our file is a Pohoda dataPack (POH-XML) with all invoice lines and the VAT breakdown by rate; MK-soft reads it through the import definition I-FAKTURY (issued) or I-SALDOKONTO (received). If you loaded a file with received invoices into the I-FAKTURY task, the import would end with errors.
- Since version 7.127 (1 July 2026) MK-soft also imports issued invoices directly in Peppol BIS 3.0 format; you download the original XML of every invoice from the portal in the Original XML export.
- If you use MK-soft for both bookkeeping and invoicing, prefer the direct connection above; the file import is meant mainly for external accountants.
2. Send invoices issued in MK-soft through Peppol
You keep issuing invoices in your program. You upload its export to the portal and the portal delivers them to your customers through the Peppol network, with a delivery receipt and the report to the Financial Administration.
- 12The exact menu path in MK-soft for exporting issued invoices to XML is in its manual or known to the program's vendor; menus change between versions, so we would rather not quote one from memory here. Send us a screenshot and we will add it to the how-to.
- 13In the portal open Send e-invoice and the Bulk send tab; the direct link /dashboard/invoices/new?tab=bulk opens the tab with the MK-soft tile already selected. Otherwise click the tile and choose Select.
- 14Choose the Company (sender) and upload the exported files; you can select several at once. The portal imports only invoices you issued (supplier = your company); received invoices in the same file are skipped.
- 15Check the preview: the portal reads the lines, recalculates the totals the same way as for a manually issued invoice and compares them with the totals in the file. If they differ by even a cent, the invoice gets an error and does not leave; fix it in the program and export again. The customer must be in the Peppol network, which you check on /overenie.
- 16Click Send. Invoices leave one by one; the status and the delivery receipt are shown under Invoices – sent.
3. What the format cannot carry
The export never guesses values that the MK-soft format has nowhere to store. Such a document is listed in _preskocene.txt with the reason and stays available in the portal as PDF and original XML.
- a document in a foreign currency (the program would need an exchange rate the invoice does not carry)
- a document with an advance payment offset against it
- a document with rounding of the amount payable
- a document number longer than 32 characters
- the portal's test documents VITAJTE and TEST (0.00 EUR, not tax documents)
Something off during the import?
Send us the message from MK-soft and the file you imported, through Support in the portal or to peppol@verteco.digital. We will fine-tune the format. You can try the whole procedure without risk in the test environment.
Other programs: PROLUC · POHODA · MRP-K/S · Money S3 · Money S4 / S5 · KROS OMEGA · KROS ALFA plus · HELIOS iNuvio / Nephrite