Netvisor

🔗 What the Integration Does

Netvisor is a Finnish accounting and financial management platform. The Thril–Netvisor integration lets you send invoices from Thril to Netvisor, where they are booked and managed.

Key things to know:

• Invoices are sent manually — one at a time from the invoice detail view, or in bulk from the Invoices list
• The integration is configured at the company level and applies across all your venues
• Invoice statuses are synced automatically from Netvisor twice daily
• Customer data is synced to Netvisor when an invoice is sent
• You can record payments and delete them directly from Thril
• You can create credit notes for sent invoices
• External customers are automatically synced to Netvisor when their first invoice is sent

---

⚙️ Configuring Netvisor

Before connecting Thril, several things must be set up in your Netvisor account. Use this section as a checklist.

API credentials

Netvisor navigation: Company menu → API identifiers

Obtain your Customer ID and Customer Key. These are organisation-specific credentials that grant Thril access to your Netvisor account via the API.

Required API endpoint permissions

Netvisor navigation: Company menu → API resource access rights

In API resource access rights, add the integration or approve an existing partner. Select Thril / Sportribe Oy from the list and grant access — this activates (or prompts you to confirm) the endpoints Thril needs.

The following endpoints are included in the integration:

Accounting dimension headers

Netvisor navigation: Financials → Management of cost objects

Thril uses two accounting dimension headers to categorize invoices. These headers must be created manually before connecting — the API can only add items to existing headers, not create the headers themselves. Each header also needs at least one placeholder item; without it, the header may not be returned in API responses.

• Laji — used for sport and service type dimensions (e.g. Tennis, Padel, Kahvila)
• Toimipaikka — used for venue name dimensions (e.g. Tenniskeskus Helsinki, Padelareena Turku)

When you create the integration in Thril, dimension items are populated automatically under these headers. You only need to ensure the two headers exist beforehand.

Payment methods

Netvisor navigation: Sales → Basic data and settings → Payment methods → New payment method

Thril uses alternative (non-bank) payment methods when recording sales payments in Netvisor. The following payment methods must be created before payments can be recorded from Thril:

If a payment method is missing in Netvisor, recording a payment with that method will fail.

Business ID

Your company's Finnish Business ID (Y-tunnus) in Thril must match the organisation registered in Netvisor. It is used to identify your organisation in every API call.

Tip: If you need help enabling API endpoints, creating dimension headers, or configuring payment methods, contact your Netvisor account manager or Netvisor support.

---

🚀 Setting Up in Thril

1. Navigate to Settings → Integrations → Netvisor
2. Enter your Customer ID and Customer Key
3. Set the Integration status to Active
4. Click Create integration

Thril will automatically initialize products and dimensions in Netvisor. Once complete, you're ready to start sending invoices.

Your company must have a valid Business ID configured in Thril — it's used as the Netvisor organisation identifier.

---

🧾 Sending Invoices to Netvisor

Sending a single invoice

1. Open an invoice from the Invoices page
2. Use the Send to Netvisor action
3. Once sent, the invoice receives a Netvisor reference number

Billing address required: Individual customers (Thril app users) must have a complete billing address on their profile before you can send their invoice to Netvisor. If the address is missing, the send will fail with an error. You can add or update the address in the customer's profile before retrying.

After an invoice has been sent, additional actions become available:

• Sync status — manually refresh the invoice status from Netvisor
• Create payment — record a payment against the invoice in Netvisor (select from ePassi, cash, or card using the dropdown)
• Edit invoice in Netvisor — edit the invoice details and push the changes to Netvisor
• Create credit note — create a full credit note for the invoice

Invoice statuses are synced automatically from Netvisor immediately after every action (send, create payment, delete payment) and also twice daily in the background, so you rarely need to sync manually.

Sending multiple invoices at once

To send a batch of invoices to Netvisor in one go:

1. Go to the Invoices page
2. Check the boxes next to the invoices you want to send
3. Open the selection menu at the top of the table and choose Send to Netvisor

Invoices already sent to Netvisor are automatically skipped. A summary shows how many succeeded and lists any failures with the reason.

Creating an invoice from a reservation

When creating an invoice directly from a reservation (for example via the Reservations page), you can choose whether the invoice should be a Thril internal invoice or sent to Netvisor. An Invoicing system selector appears in the create-invoice form when Netvisor is connected.

---

🏢 External Customers in Netvisor

When you send an invoice for an external customer to Netvisor, the customer is automatically created in Netvisor and tagged as a Netvisor customer in Thril. You cannot manually mark a customer as a Netvisor customer — the tag is set by the system on first send.

To ensure a smooth first send, fill in the customer's details before sending:

• VAT identifier — must be in a format Netvisor accepts (e.g. FI12345678)
• E-invoicing details (Finvoice) — operator code and address. For customers already tagged as Netvisor customers, the operator code field shows a dropdown of Netvisor-accepted codes; otherwise it is a free-text field.

These details are included automatically in invoices sent to Netvisor for that customer.

Any updates to an external customer's details in Thril are automatically synced to Netvisor for customers who already have an account there.

---

🔄 Syncing Products and Dimensions

If you add new venues or sport types after the initial setup, use the Sync products and dimensions button on the Netvisor integration settings page. This will:

• Create new products in Netvisor for any new sport types
• Add new dimension items for any new venues

Existing products and dimensions in Netvisor are not affected.

---

✏️ Updating or Disabling the Integration

You can update your Netvisor credentials at any time from Settings → Integrations → Netvisor. Leave a credential field blank to keep the existing value.

To disable the integration, switch the Integration status to Inactive. A confirmation dialog will appear, since you will no longer be able to send invoices to Netvisor while the integration is inactive.

You can re-enable it at any time by switching back to Active.

---

🛠️ Need Help?

For questions about the Thril integration setup, contact our support team at support@thril.fi.

For questions about Netvisor API credentials, portal configuration, or your Netvisor account, contact your Netvisor account manager or Netvisor support.