> ## Documentation Index
> Fetch the complete documentation index at: https://control-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Netvisor

> Create Netvisor API identifiers and allow Control's interface resources.

export const ControlAppLink = ({path, breadcrumb, children}) => {
  const link = <a href={`https://app.control.dev${path}`} target="_blank" rel="noopener noreferrer" aria-label={breadcrumb ? `Open ${breadcrumb} in Control` : undefined}>
      {children}
    </a>;
  return breadcrumb ? <Tooltip tip={breadcrumb}>{link}</Tooltip> : link;
};

Netvisor requires both personal API identifiers and permission for the integration to use interface resources.

<Warning>
  The Netvisor API is included only in the **Professional**, **Premium**, and **Palkat** packages. If the company is on Basic, Starter, or Core, upgrade the package in Netvisor Store before connecting. Activating the API does not upgrade the package automatically. See [Netvisor API pricing](https://support.netvisor.fi/en/articles/766838-api-pricing).
</Warning>

## Create API identifiers

1. In Netvisor, choose the company.
2. Go to **Company → API identifiers**.
3. Choose **Create new API identifier**.
4. Copy the **User ID** and **Key**.
5. Find the company's organization ID in **Company → Company information**.

Netvisor API identifiers are user-specific. Create a separate identifier for Control when possible so access can be audited and revoked independently.

## Allow Control's interface resources

1. Go to **Company → Rights of interface resources**.
2. Under finished or ready-made integrations, search for `control.dev`.
3. Select **control.dev / Finata oy**.
4. Allow the resources listed below. Only enable the conditional resources for features enabled on the Control data source.

If the ready-made integration is not available, open **Custom integrations** and search with access key `490FC171429C1DA23EE3BE2F954BF7C9`.

Editing resource rights requires the appropriate Netvisor administrator rights. Ask the company or accounting-office administrator if you cannot open the page.

### Interface resources required

| Netvisor resource                                                               | Data               | When required                              |
| ------------------------------------------------------------------------------- | ------------------ | ------------------------------------------ |
| `accountlist.nv`                                                                | Chart of accounts  | Always                                     |
| `dimensionlist.nv`                                                              | Dimensions         | Always                                     |
| `accountingperiodlist.nv`                                                       | Accounting periods | Always                                     |
| `accountingledger.nv`                                                           | General ledger     | Always                                     |
| `salesinvoicelist.nv`, `getsalesinvoice.nv`, `deletedsalesinvoices.nv`          | Sales invoices     | When **Load invoices** is enabled          |
| `purchaseinvoicelist.nv`, `getpurchaseinvoice.nv`, `deletedpurchaseinvoices.nv` | Purchase invoices  | When **Load purchase invoices** is enabled |
| `salespaymentlist.nv`                                                           | Sales payments     | When **Load sales payments** is enabled    |

Control only reads these resources. Do not allow unrelated write or payment resources. The ready-made **control.dev / Finata oy** entry is preferred because it identifies Control clearly in Netvisor's integration list; verify its resource selections against this table.

## Fill the fields in Control

| Control field            | Netvisor value                                      |
| ------------------------ | --------------------------------------------------- |
| Netvisor Organization ID | Organization ID / Y-tunnus from Company information |
| Netvisor User ID         | API identifier User ID                              |
| Netvisor API Key         | API identifier Key                                  |

Save and verify the credentials after all three values are present.

## Data imported

* Chart of accounts, dimensions, and accounting periods
* General-ledger vouchers
* Sales invoices when **Load invoices** is enabled for the integration
* Purchase invoices when **Load purchase invoices** is enabled
* Sales payments when **Load sales payments** is enabled

## Common problems

* **Cannot create API identifiers:** the company's Netvisor package does not include the API. Upgrade to Professional, Premium, or Palkat in Netvisor Store.
* **Missing User ID:** enter the API identifier's User ID, not your email address.
* **Missing Organization ID:** enter the company organization ID, not an integration identifier.
* **Requests are blocked:** confirm Control is allowed on the Rights of interface resources page.

## Optional: enable native write-back

Control can post AI-proposed vouchers back to Netvisor through `accounting.nv` after an Owner or Admin approves them.
The write path uses a separate API identifier from the read/sync credential above, so it can be revoked independently.

Allow the `accounting.nv` resource on the write API identifier under **Company → Rights of interface resources**. Do
not allow unrelated write resources. Netvisor accepts the voucher as unchecked; a person still checks and posts it in
Netvisor. Unknown dimensions on a journal line are rejected instead of being created automatically, so add the
required dimensions in Netvisor first.

Configure the write credential in <ControlAppLink path="/settings#agent-integrations" breadcrumb="Settings → AI and automation → Native accounting write-back"><strong>Native accounting write-back</strong></ControlAppLink>.
See [Write-back approvals](/product-docs/integrations/write-back-approvals) for the proposal, review, and
reconciliation flow.

## Provider documentation

* [Netvisor API identifiers](https://support.netvisor.fi/en/articles/766837-api-identifiers)
* [Netvisor rights of interface resources](https://support.netvisor.fi/en/articles/766836-rights-of-api-resources)
* [Netvisor API pricing and license requirements](https://support.netvisor.fi/en/articles/766838-api-pricing)