Netvisor Export
Vuoro produces Netvisor-ready CSV files for payroll. Once a payroll period is approved, you download the pay data as CSV and import it into Netvisor.
:::note Manual upload Export works by downloading a file and importing it into Netvisor by hand, then marking the period exported in Vuoro. Vuoro does not send data to Netvisor automatically — plan for the manual import step. :::
The Exports card
All export files are on the payroll period's detail page, in the Exports card just below the Summary. The card shows which company the period belongs to; each file is generated for that company.
| Button | What you get | Use it for |
|---|---|---|
| Payroll Results CSV | The full calculated results: one row per employee, pay component, rate, and location. | Checking, archiving, and cost analysis in a spreadsheet. |
| Salary Voucher CSV | Salary lines per employee mapped to Netvisor salary types, split by the location where the pay was earned. | Importing salary lines (palkkatosite) into Netvisor. |
| Worktime CSV | Worked time broken out per day, using your company's work-time (Kirjauslaji) codes. | Importing into Netvisor's work-time preprocessing. |
Payroll Results CSV is available once the period has results and is approved. The Netvisor files (Salary Voucher CSV and Worktime CSV) appear only when the period is Approved.
:::info Salary Voucher API The Exports card also has a Salary Voucher API button, which tries to post the salary voucher straight to Netvisor's interface. This direct integration is not in production use — use the CSV files above and import them manually. :::
Prerequisites
| Requirement | Where to configure |
|---|---|
| Company has a Netvisor ID | Settings → Organization |
| Kirjauslaji codes (Worktime CSV only) | Settings → Organization — Netvisor Kirjauslajit (workday import) |
| Payroll period is Approved | Payroll |
| All employees have hourly rates | Employee pay rates and wage tables |
If the company has no Netvisor ID, the Netvisor buttons are disabled and show "no Netvisor ID" on hover. If the Kirjauslaji codes are missing or incomplete, Worktime CSV is disabled with a hint to set them in company settings.
Export Process
- Open the approved payroll period.
- In the Exports card, click the file you need. The download starts immediately.
- Import the file into Netvisor.
- Back in Vuoro, click Mark exported. This moves the period to Exported and locks it against further changes. See Revoking an Exported Period if you need to undo this.
You can download the files as many times as you like while the period is Approved — nothing is stored or sent until you mark the period exported.
Salary Voucher CSV
One row per employee, salary type, description, and location:
| Column | Content |
|---|---|
| Employee Number | The employee's numeric employee number. |
| Employee Name | Full name. |
| Netvisor Salary Type | The salary type code (see Salary type codes). |
| Description | The salary type's description, or the allowance's own name for custom allowances and project gigs. |
| Hours | The quantity (Netvisor Määrä). |
| Rate | The unit price (Netvisor A-hinta). |
| Amount | The line total, for reconciliation. |
| Location | Where the hours were worked. |
Map Hours → Määrä and Rate → A-hinta when importing; Netvisor computes the line total. On every row, Hours × Rate = Amount.
- Hourly lines (regular hours, overtime, premiums, sick pay) carry the hours as the quantity and the hourly rate as the unit price. If an employee's rate changed during the period, each rate gets its own line.
- Fixed-euro lines (custom allowances and project gigs) carry the number of times paid as the quantity and the per-instance amount as the unit price. For example, three €30 allowances export as
3 × 30,00, not1 × 90,00. Different allowances stay on separate lines. - Locations. An employee who worked at several locations gets one line per location. Regular hours and overtime are split in the order the hours were worked, so the overtime lands at the location where the latest hours were worked. Lines that aren't tied to a place — such as AP-leave compensation, union dues, equalization, and missing X-day compensation — show
—as the location. - Which employees are included. Everyone paid by the period's company: employees who worked at its locations, plus employees whose payroll company is this company (including their hours at other companies' locations). Location assignments don't affect who is included.
:::tip Older periods show "—"
Per-location attribution applies to periods calculated after it was introduced (September 2026). An older approved period shows — in the Location column until it is recalculated with Reject → Run Payroll → Approve. The totals don't change.
:::
Worktime CSV
The worktime file lists each employee's work per day in the shape Netvisor's work-time import expects, using the four Kirjauslaji codes configured for the company (Regular work, AP leave, Vacation, Sickness).
Worklogs with no end time (someone forgot to clock out) can't be exported as a day entry and are skipped. If any were skipped, a warning such as "2 open-ended worklogs skipped" appears after the download — close those worklogs in Timesheets and download again.
Salary type codes
Each pay component is mapped to a Netvisor salary type code. The default mapping is:
| Pay component | Code |
|---|---|
| Regular hours | 1001 |
| Additional work | 1002 |
| Training hours | 1003 |
| Overtime +50% | 2001 |
| Overtime +100% | 2002 |
| Sunday / public holiday premium | 3001 |
| V-day premium +100% | 3002 |
| X-day premium +50% | 3003 |
| AP-day premium +50% | 3004 |
| TS-day premium +50% | 3005 |
| Evening allowance | 4001 |
| Night allowance | 4002 |
| AP leave compensation | 4003 / 4004 |
| Sickness pay | 4005 |
| Shift cancellation compensation | 4006 |
| Missing X-day compensation | 4007 |
| Project gig (fixed fee) | 4098 |
| Custom allowance | 4099 |
The codes can be changed for your whole organization or for an individual company, so they match the salary types in your own Netvisor setup. There's no settings screen for this yet — contact Vuoro support to load your codes. Until then, the defaults above are used.
File format
All CSV files follow the Finnish Excel convention, so they open correctly in Excel without an import wizard:
- Delimiter: semicolon (
;) - Decimals: comma (
12,50) - Encoding: UTF-8 with a byte-order mark (BOM)
The Worktime CSV contains only whole numbers, so it has no decimal values to convert.
Troubleshooting
| Issue | Solution |
|---|---|
| Netvisor buttons not visible | The period must be Approved. |
| Netvisor buttons disabled | Check that the company has a Netvisor ID in Settings → Organization. For Worktime CSV, also enter all four Kirjauslaji codes. |
| Employees show warnings | Ensure all employees have hourly rates for the period. Warnings appear during payroll calculation, before the export stage. |
| Allowance lines import as zero | Make sure the import maps Hours to Määrä and Rate to A-hinta, not Amount. |
Location column shows — | The line isn't tied to a location, or the period was calculated before per-location attribution. Recalculate with Reject → Run Payroll → Approve. |
| An employee is missing from the file | Check which company pays them — if their payroll company is another company, their pay is in that company's export. |
| Numbers look wrong in Excel | Open the file directly (double-click) rather than pasting it; the file relies on semicolon delimiters and decimal commas. |
Revoking a Completed Export
If an exported period needs to be reopened — Netvisor rejected the file, a reconciliation surfaced an error, or the wrong period was exported — a Company Admin can revoke the export. See Revoking an Exported Period for the full procedure and constraints.