Document View
The Document View is where you review, edit, and validate a processed document. It opens when you click on any document in the document list.
Layout
The Document View has a split-panel layout:
- Left panel — a preview of the original document (PDF or image). You can zoom in/out, navigate pages (for multi-page documents), and collapse the preview panel to give more space to the data panel.
- Right panel — the extracted and enriched data, organized into collapsible sections.
Above the panels, the header shows the file name, direction label (Incoming/Outgoing), and a metadata chain with the document's lifecycle. The current status is shown on the status button in the top-right (see "Changing the document's status").
Uploaded [date] by [name]
The full audit — every status change, who made it, and when (including when the document was validated and by whom, when it was sent, and what the accounting system replied) — is on the History tab (see "History" below), not in this line.
The top-right area has the Save button (shown while the document is editable), a status button showing the document's current status, and a three-dot menu (⋮) for Download, Reprocess, and Delete. The status button is also where you move the document forward — clicking it opens a menu of the actions available from the current status (see "Changing the document's status" below).
Document Information panel
The right panel is divided into the following sections. Each section can be expanded or collapsed by clicking its header.
Basic Information
Contains the core document metadata:
- Document Type — the AI-detected type (Invoice, Receipt, etc.). You can change it manually.
- Document Number — the invoice or receipt number.
- Issue Date — the date the document was issued.
- Due Date — the payment due date.
- Period Start / Period End — the service or billing period, if applicable.
Supplier
Shows the external party's details as extracted from the document:
- Partner — a dropdown to select or search for a matching partner from your partner database. If the AI found a match, it is pre-selected.
- Legal Name — the supplier's name as printed on the document.
- Reg. No. — registration number.
- VAT No. — VAT registration number.
- Address — the supplier's address.
- Bank Accounts — bank account numbers found on the document.
Each field has a match indicator icon next to it:
- Green checkmark — the extracted value matches the linked partner record exactly.
- Red cross — the extracted value does not match the partner record. Hover over it to see a "Values do not match" tooltip.
- Grey dash — no partner is linked, or the field is empty in either the document or the partner record.
Recipient
Shows your entity's details as extracted from the document. Same field structure as the Supplier section. The entity is auto-matched based on registration and VAT numbers.
Financial Summary
Summarizes the document's financial totals:
- Currency — the document currency (e.g., EUR, USD).
- Subtotal — sum before adjustments.
- Allowances — discounts or reductions.
- Charges — additional charges (freight, handling).
- Retention — withheld amounts (deposits, warranties).
- Total — the net total (Subtotal − Allowances − Retention + Charges).
- Tax — the total tax amount.
- Total Incl. Tax — the grand total including tax.
- Payable — the amount due for payment (Total Incl. Tax − Prepaid).
Financial fields show a red background when the displayed value differs from the calculated value (e.g., when the sum of line items does not match the header total). This helps you spot discrepancies.
Comment
A free-text field for adding notes or comments about the document.
Dimensions
If dimensions are configured for the entity and the document type's extraction schema includes header-level dimensions, they appear here as dropdowns.
Swapping Supplier and Recipient data
If the AI placed the data in the wrong sections (for example, your entity's details appear in the Supplier section), you can swap them:
- Click the ⇄ swap button next to the Supplier or Recipient section header.
- All field values between the two sections are exchanged instantly.
- The partner link is cleared (you will need to re-select the partner).
- Click Save to keep the change.
The swap button is hidden when the document is validated (locked).
Line Items
Below the Document Information panel, the Line Items section shows a table with all extracted line items. Each row represents one line from the document.
Line item columns
The visible columns depend on your Field Settings configuration. Common columns include:
- No — the line number.
- Title — a short description of the item.
- Description — a detailed description.
- Partner Code — the supplier's article number.
- Unit — the unit of measure.
- Quantity — the number of units.
- Price — the unit price excluding tax.
- Total — the line total excluding tax.
- Tax Rate (%) — the tax rate as a percentage.
- Tax Amount — the calculated tax amount.
- Total Inc. Tax — the line total including tax.
- Dimension columns — one column per configured dimension (e.g., VAT Rate, Cost Center, Employees, Product). Each shows a dropdown for selecting the dimension value.
Documents with many lines
Most documents have well under 100 lines and the whole table fits on one page. If a document has more than 100 line items, the table splits them into pages of 100 — use the page controls that appear at the bottom of the table to move between them.
Editing line items
When a document is in Processed status (not yet validated), all line item cells are editable. Click any cell to modify its value.
Adding a line item
Click the + Add button next to the "Line Items" heading to add a new blank row at the bottom of the table.
Deleting a line item
Click the red delete icon at the right end of a line item row to remove it. A confirmation prompt appears.
Selecting line items
Each line item has a checkbox at the start of its row. Select one or more rows to activate the selection toolbar, which appears to the right of the Add button:
[+ Add] N selected [Bulk Update] [Merge | Split]
- Bulk Update appears when any row is selected.
- Merge appears when 2 or more rows are selected.
- Split appears when exactly 1 row is selected.
Selection and bulk operations are only available when the document is not locked.
Bulk Update
Use Bulk Update to apply the same field changes to multiple line items at once.
- Select the rows you want to update.
- Click Bulk Update in the toolbar.
- In the dialog, fill in only the fields you want to change. Empty fields are ignored.
- Click Apply. The changes are applied to all selected rows. Financial fields (total, tax amount, etc.) are recalculated automatically.
The dialog columns match the line item table exactly — the same fields in the same order.
Merge
Merge consolidates multiple selected line items into a single row. Useful when the AI extracted several lines that actually represent one consolidated amount.
- Select 2 or more rows.
- Click Merge in the toolbar.
The rows are combined instantly, with no dialog:
- The total amount is summed across all selected rows.
- Text fields (title, description, tax rate, dimensions, etc.) are taken from the topmost selected row.
- Quantity is set to 1, and price becomes the consolidated total.
- The merged row is inserted at the position of the topmost selected row. Unselected rows keep their order.
Split
Splitting divides one line item into multiple rows — for example, to allocate different portions to different cost centers.
- Select exactly 1 row.
- Click Split in the toolbar.
- In the Split Line Item dialog, choose how many items to split into (e.g., 2).
- Choose the split mode: Units (split by quantity) or % (split by percentage).
- Enter the quantity or percentage for each resulting item. The total must equal the original quantity.
- Click Split.
The original line item is replaced by the new split rows. Each split row can then be assigned different dimension values.
Bulk operations on mobile
Bulk Update, Merge, and Split are available on desktop only. Mobile and tablet layouts show the line items table without the selection toolbar.
AI-assigned dimensions
When the AI has assigned a dimension value to a line item, you will see the value displayed in the dimension column with a colored indicator dot:
- Green dot — the AI is confident in its assignment.
- Yellow/orange dot — the AI assigned a value but with lower confidence.
Hover over any AI-assigned dimension value to see a tooltip with:
- The dimension value name and reference ID.
- The confidence level as a percentage (e.g., "Confidence: 100%").
- An explanation of why the AI chose this value (e.g., "The line item 'Telpu noma/ Rent object: Office 22' directly relates to office space, which is classified under the 'Office' cost center.").
You can override any AI assignment by selecting a different value from the dropdown.
Direction toggle
Next to the status badge in the document header, you will see Incoming and Outgoing labels. Click the inactive label to change the direction.
When you change direction:
- The partner link is cleared (you will need to re-select the partner after saving).
- The change is saved when you click Save or Validate.
The direction toggle is locked when the document is validated.
Saving changes
Click the Save button in the top-right corner to save all changes you have made to the document information, line items, and direction. The document keeps its current status.
Changing the document's status
The coloured status button in the top-right corner shows the document's current status. Click it to open a menu of the actions available from that status. Each menu item shows the action and the status it leads to — for example Validate → Validated, Send → Sent, or Reprocess → Processing.
The menu only lists moves that make sense from the current status, so what you see changes as the document progresses. While an action is running, the button shows a spinner and is disabled until it finishes, so the same action can't be started twice. If a status has no available actions, the button simply has no menu.
The sections below describe each action you can pick from this menu.
Validating a document
Open the status menu and choose Validate to confirm that all data is correct. Validation does two things:
- Saves all current changes.
- Sets the document status to Validated, which locks all fields from editing.
Validated documents show a green Validated status button and lock all fields. The exact time it was validated and who validated it are recorded on the History tab.
Unlocking a validated document
If you need to make changes to a validated document, open the status menu and choose Unlock. The document returns to Processed status and all fields become editable again. After making your changes, validate the document again.
Sending a document
If your entity or workspace has a connection to an external system (see Connections), a Send action is available in the status menu. You can only send a document that has been validated first.
First send
- Open the status menu and choose Send. This runs the Send to Accounting workflow, which posts the document data to the entity's connection, or to the workspace default connection if the entity has not picked one.
- The document passes through Sending briefly while the external system answers.
- When the system accepts the document, the status changes to Sent. If the system returned an accounting reference, it is stored in the document's Accounting Reference field. The send time and the system's reply are recorded on the History tab.
- When the system does not accept it, the status changes to Send Failed and the error is recorded in the history. Common reasons: the external system rejected the data, or it did not answer in time. The document stays editable so you can correct it and try again.
Re-sending
On a Sent or Send Failed document, the status menu offers Re-send. A confirmation dialog appears (showing the original send date for an already-sent document) — confirm to send again. Re-sending replaces any previous accounting reference with the new one returned by the system.
Document status flow
The statuses and steps below describe Finpilo's default document lifecycle — the standard path a document follows out of the box. The lifecycle is configurable, so a workspace can use a tailored set of statuses and steps; this article describes the default.
Documents progress through the following statuses:
Uploaded → Processing → Processed → Validated → Sending → Sent
↘ Failed ↘ Send Failed
↘ Unsupported
Every document starts at Uploaded. If your workspace reads documents with AI, it moves on by itself: it goes to Processing while the AI reads it, and then to Processed, Unsupported or Failed depending on what came back. A document usually passes through Uploaded in a moment, so you will rarely catch it there.
Sending works the same way. When you send a document it waits in Sending while your accounting system answers, and then moves to Sent or Send Failed.
| Status | Editable | Send | Reprocess |
|---|---|---|---|
| Uploaded | — | No | No |
| Processing | — | No | No |
| Processed | Yes | No | Yes |
| Validated | No (locked) | Send | No |
| Sent | No (locked) | Re-send | No |
| Sending | No (locked) | — | No |
| Send Failed | Yes | Re-send | No |
| Unsupported | — | No | Yes |
| Failed | — | No | Yes |
While a document is Validated or Sent it is locked: all fields are read-only and the Save and Reprocess controls are hidden. The Send / Re-send action stays available on locked documents.
Documents keep the lifecycle they started on
A document follows the lifecycle exactly as it was when the document was uploaded. If an administrator later changes the workspace's lifecycle — renames a status, changes its colour, adds or removes a step — documents that are already in progress are not affected. They keep their own statuses and their own steps, so work in progress is never disrupted mid-way. Only documents uploaded after the change use the new lifecycle.
This means the status shown on an older document is the one its own lifecycle uses, which can differ from what a newly uploaded document shows. That is expected.
Moving a document to the current lifecycle
If a document is on an older version of the lifecycle, the three-dot menu (⋮) offers Move to Current Lifecycle.
This starts the document again from the first status of the current lifecycle, and the progress it had made is lost. Finpilo asks you to confirm before doing it. Use it when you want an in-progress document to follow the new lifecycle instead of the one it began on.
History
The History tab shows a timeline of everything that happened to the document — every status change, and every action the system ran on it. Each entry shows who did it (or System for automatic steps) and when.
Actions appear here too, with what they came back with — "Read with AI — unsupported", "Send — failed (502 from the accounting system)". This is where you look when a document did not go where you expected: it tells you what the system tried and what answer it got.
Use it as the document's audit trail: it is where you see when a document was validated and by whom, when it was sent, and every other status change along the way.
Reprocessing a document
If the AI extraction produced poor results (for example, after uploading a document that was initially unreadable), you can reprocess it. Either open the status menu and choose Reprocess, or use the three-dot menu (⋮) and select Reprocess. Confirm in the dialog that appears — note that all existing extracted data will be overwritten.
The document moves to Processing; the page stays open and refreshes automatically when reprocessing finishes (ending at Processed or Failed).
Reprocess is available for Processed and Failed documents. It is not available for a document that is validated, being sent, sent, or send-failed — unlock it first if you need to reprocess.
Downloading the original file
- Click the three-dot menu (⋮) in the top-right corner.
- Select Download to save the original uploaded file to your computer.
Deleting a document
- Click the three-dot menu (⋮) in the top-right corner.
- Select Delete.
- Confirm the deletion in the dialog that appears.
Deletion is permanent and cannot be undone. Delete is available for any document that is not locked. A locked document (validated, being sent, or sent) must be unlocked before it can be deleted.
Navigating between documents
In the top-right area of the document header, you will see navigation arrows and a counter (e.g., "5/25"). Use the left and right arrows to move to the previous or next document in the list without returning to the Documents page. The list order and filters from the Documents page are preserved.