Skip to content
Documentation
English
Open the app

Importer

Drop PDF, image, XML or ZIP files into a company file, follow their automatic analysis and understand the import statuses.

The importer turns a file into an accounting document ready to validate. You drop invoices, credit notes, receipts or archives; NovaFisko reads each document, identifies the third party, extracts the lines and suggests an account and a VAT code. Nothing is booked without your validation.

Dropping files

  1. Open the Documents tab of the company file.
  2. Drag your files into the "Drop your PDF, image and XML files" area, or click Import (⌘N) then Choose files. An empty To validate list directly offers "Drag PDF, image, XML or ZIP files here to import them." and the Choose files button.
  3. An "Importing … documents" panel opens and shows the progress of each file.
  4. At the end, the panel shows "Import finished: … documents" with three counters, processed, in progress and errors. You can close it: the documents stay in the To validate filter.

Formats and limits

Item Rule
Accepted formats PDF, JPG, PNG, HEIC, XML (UBL Peppol BIS 3 or CII), ZIP
Size per file 25 MB at most; beyond that, the file is set aside with the message "File too large (25 MB maximum)."
Files per upload No practical limit: the application itself splits the selection into batches of 20 files
ZIP archive Extracted on arrival; at most 50 files handled per archive
PDF 100 pages at most; a password-protected PDF is refused
Scanned PDF 20 MB at most for automatic reading

A file whose format is not supported is set aside as soon as it is dropped, with the message "… file(s) ignored: unsupported format."

How a document is analysed

The actual type of the file is recognised from its content, not only from its extension. The analysis then depends on what the file is.

File Method
XML UBL or CII Direct reading of the electronic invoice: no interpretation, the data is exact. The embedded PDF is used as the preview.
PDF with text Reading of the text layer, then extraction by artificial intelligence.
Scanned PDF, photo Visual reading by artificial intelligence.
ZIP Each supported file becomes a separate import; the archive takes the status "Archive extracted".

The steps are shown live: Uploading file, Queued, Reading text, AI analysis, Extracting lines, Matching third party, Analysis finished.

After the extraction, NovaFisko matches the document against the company file:

  1. Third party. Search among the third parties of the right type (supplier for a purchase, customer for a sale), in this order: VAT number, then enterprise number, then IBAN (that of the third party, or the payment IBAN read on a purchase), then name (similarity of at least 85%, legal forms ignored). For a document from Novadesko, the third party already known to the shop is taken over. If nothing matches, the creation of a third party is suggested with the details read, completed from the company directory when it is available. The validation record shows which criterion was used to find the third party: see Document validation.
  2. Account. Default account of the third party, otherwise a match on keywords in the line description, otherwise a generic account (services for a purchase, default sales account for a sale).
  3. VAT code. Default code of the third party if its rate matches, otherwise according to the direction, the rate and the country of the third party: intra-Community code for an EU third party at 0%, import or export code outside the EU.
  4. Nature. A till receipt, a restaurant VAT stub or a parking ticket is flagged as such, because its deductibility rules are specific.
Note

If the artificial intelligence analysis is not configured on your environment, the application shows "AI analysis is not configured: only XML files are analysed.", with an Open settings button. Electronic invoices can still be imported.

Import statuses

Status Meaning Next step
Uploading, Queued, Analysing Processing in progress. Wait; an import left in the queue is picked up again automatically every minute.
Ready Analysis complete and consistent. To validate.
Needs review One point requires your attention. Open the record with Review.
Duplicate The file or the document already exists, or closely resembles an existing one. Click Compare: merge, create anyway, choose "Not a duplicate" or delete the import.
Error The document could not be read. Read the message, correct, then Retry.
Validated The document is created in the company file ("Document created in the file", or "… synced and locked in Novadesko"). Remove from the list.
Merged The import was merged into an existing document, whose reference is shown ("→ …"). Remove from the list.

An import moves to Needs review when the third party, the date, the totals or the lines were not found, when the lines do not match the document total (gap above 2%), when the document number is missing or when the analysis confidence is below 60%. The first point to check is shown under the file name.

On each row of the panel, the actions follow the status: Review, Compare, Retry, Remove from the list or Delete this import. A padlock marks a document locked in Novadesko. The To validate list of the tab can be searched by file name, third party or number, and filtered by Sales, Purchases or Credit notes.

Duplicate detection

Two checks prevent double entry:

  • same file: a strictly identical file already imported into the company file is recognised immediately, without a new analysis;
  • same document: an existing document resembles the incoming one. NovaFisko compares the number, the direction, the third party or its VAT number, the amount, the date, the structured communication and the IBAN.

The result is graded: Exact duplicate, Probable duplicate or Possible duplicate, with a "Similarity" percentage and the reason ("same structured communication", "same IBAN and amount", "same amount and close date", "different period (recurring subscription, same reference)"…). An exact or probable duplicate blocks validation until it is resolved; a possible duplicate only shows a warning ("Possible duplicate: …") and lets you validate. The Compare button opens the comparison window: the two documents side by side, differences highlighted, with the choices Merge (attach the file to the existing document, complete the missing fields, replace the data or the main file, and choose the lines to keep), Create anyway, Not a duplicate and Delete the import.

Warning

Imports left in Error or Duplicate are deleted automatically after 30 days, together with their file. A validated import is never deleted this way: its document belongs to the company file.

Common error messages

Message What to do
This PDF is password-protected Remove the protection, then upload it again.
This PDF has … pages, which is too many for an automatic analysis Split the file.
This XML file is not a UBL invoice or credit note nor a CII invoice Upload the corresponding PDF.
HEIC photos cannot be converted on this server Upload a JPG or a PNG.
This ZIP archive contains no supported document Check the content of the archive.
The automatic analysis failed Try again in a moment with Retry.
Tip

Always prefer the XML file of an electronic invoice to its PDF: the amounts, the rates and the VAT number are taken over as they are, with no risk of a reading error.

With the keyboard

In the Documents tab: ⌘N imports files, ⌘⇧N drafts a sales invoice for a customer, ⌘F searches, ↑ ↓ highlight a row, ␣ opens the preview of its document, ↩ opens its validation record, ⌘E exports the selected documents as a ZIP. See Keyboard shortcuts.

See also