---
title: "How Nuvio works | Nuvio Docs"
description: "Everything in Nuvio belongs to a company. Customers and suppliers, incomes and expenses, bank accounts and payments connect to each other, and the reports are built from them."
url: https://nuvio.io/docs/how-nuvio-works
---

# How Nuvio works

Nuvio keeps a small set of records and connects them. Once you know what each one is and how they link, every screen in the app makes sense.

In short: you sell to **customers** and buy from **suppliers**. What you sell becomes an **income**, what you buy an **expense**. Money moves through your **bank accounts** as **bank transactions**. A **payment** links a transaction to the income or expense it settles. The cash flow, the dashboard and Nuvio AI’s answers are all built from these records.

## The company

Everything in Nuvio belongs to a **company**: its customers, suppliers, documents, bank accounts and users. Each company has its own plan. If you belong to more than one company, you switch between them in the app.

A company has a **functional currency**: the currency you keep your accounts and reports in. You choose it when you create the company, and it can’t be changed afterwards. Totals across the app are shown in it.

## Customers and suppliers

A **customer** is someone you invoice. A **supplier** is someone you pay. In Nuvio they are the same kind of record, so one business can be both: a customer’s page has the option “This customer is also a supplier.”

Each customer and supplier has its own page with its incomes and expenses, its bank transactions and its details.

## Incomes and expenses

An **income** is money you have earned or expect to receive, usually an invoice to a customer. An **expense** is money you owe or have spent: a supplier’s bill, a receipt, a subscription.

Both are built the same way:

-   A customer or supplier, a date and a **due date**.
-   **Lines**: what was sold or bought, with quantity and price. A line can use a **product or service** you have saved, and can carry one or more **taxes**.
-   A currency. If it isn’t your functional currency, Nuvio stores the exchange rate and the amount in your functional currency too.
-   Optionally a **project** and **tags**, so reports can group them.

Nuvio calculates every total and tax amount from the lines. You never type a total.

### Invoice numbers and sending

Each income gets the company’s next **invoice number**: a prefix and a running number, such as `INV-000007`. Numbers are unique within a company.

You can send an invoice to your customer by email straight from Nuvio, with **Generate & Send** or, for an invoice already generated, **Send to Customer**. The customer needs an email address in Nuvio, and every line needs a product or service.

An income’s **invoice status** shows how far it has gone: **Not Generated**, **Generated**, then **Sent to Customer**. Once an invoice is generated or sent, its lines, amounts, customer and dates are locked, so check it first. Only its description, project, tags and due date can still change.

### Drafts

An expense can be a **draft**: something Nuvio prepared that you haven’t confirmed yet. Receipts read by the [invoice scanner](#where-expenses-come-from) arrive as drafts, so nothing enters your books until you have checked it.

## Payment status: is it paid?

You never mark an income or expense as paid by hand. Nuvio works out its **payment status** from the payments recorded against it:

Status

Meaning

**Pending**

Nothing has been paid yet, and the due date hasn’t passed.

**Partially Received**

Part of the amount has been paid, and the due date hasn’t passed.

**Paid**

The full amount has been paid.

**Past Due**

It isn’t fully paid, and the due date has passed, whether or not part of it has been paid.

When a payment is added or removed, the status updates straight away.

## Bank accounts and bank transactions

A **bank account** in Nuvio is any place money sits: a checking or savings account, a credit card, or the cash box. Each company starts with a **Cash Account** for cash payments.

There are two kinds:

-   **Connected accounts** are linked to your bank. Nuvio brings in their **bank transactions** and balance automatically, every night and when you open **Banking**. Bank connections are available for banks in the United States and Canada.
-   **Manual accounts** you add yourself, with an opening balance. You add transactions to them, or import them from a bank statement in Excel.

A bank transaction is a fact from your bank: money in or out, on a date. On its own, it doesn’t say _why_ the money moved. That is what payments and matching are for.

## Payments and matching

A **payment** connects a bank transaction to the income or expense it settles. It has an amount, a date and a method, such as bank transfer, card, cash or check.

-   One transaction can pay several documents. A customer paying three invoices in one transfer is one transaction with three payments.
-   One document can be paid by several transactions, for example in instalments.
-   A few kinds of payment need no bank transaction: an **offset** against another document, a **write-off**, or **other**.

Each bank transaction shows how much of it is explained:

Match status

Meaning

**Unmatched**

None of the money is linked to an income or expense yet.

**Partially matched**

Some of it is.

**Matched**

All of it is.

**Transfer**

It is a move between two of your own accounts, paired with the matching transaction on the other account.

### Suggestions do most of the matching

You rarely match by hand. Nuvio compares each new transaction with your open incomes and expenses: the amount, the date, the customer or supplier, and any invoice number in the bank’s description. It then suggests a match, a transfer between your accounts, or a new expense or income for money that has no document yet.

Suggestions wait on the **Reconciliation** screen, sorted into **Ready to accept** and **Needs a decision**. You accept them one by one or all at once, and you can undo an accepted match. When you accept, the payment is recorded and the document’s status changes.

### How it fits together: an example

1.  You create an income for a customer: 1,000, due on the 30th. Its status is **Pending**.
2.  The due date passes. The status becomes **Past Due**. Nuvio sends the customer a payment reminder, and your team is notified in the app and by email.
3.  The customer pays. The transfer arrives in your connected bank account as a transaction.
4.  Nuvio suggests that the transaction pays that income. You accept.
5.  A payment is recorded. The income becomes **Paid**, and the transaction becomes **Matched**.

## Where expenses come from

You can add an expense in several ways, and they all end up as the same kind of record:

-   Type it in.
-   **Scan it**: upload a file or take a photo of a bill or receipt. Nuvio AI reads the supplier, date, total and tax, and saves a draft.
-   **Email it** to your company’s **Invoice Scanner Inbox** address. Each attachment becomes a draft expense.
-   **Create it from a bank transaction** that has no document yet. The expense is created already paid by that transaction.
-   **Import** a batch from Excel.

## What the reports are built from

Nothing in the reports is typed in separately. They are calculated from the records above:

-   **Cash Flow Projection**: your bank balances, plus unpaid incomes and expenses on their due dates. Amounts that are already past due appear first. You can look two weeks, three months, six months or a year ahead, and compare the expected case with a best case (no money going out) and a worst case (no money coming in).
-   **Payments Calendar**: the same unpaid incomes and expenses, day by day.
-   **Overview**: profit and loss, income and expenses, what is owed to you and by you, and how quickly invoices are paid, grouped by customer, supplier, product, project or tag.
-   **Nuvio AI**: answers questions from the same records, including your cash runway at your recent rate of spending.

## Who can see and change what

Every person in a company has a **role**, such as Company Admin, Finance Staff or Viewer. The role decides which screens they see and whether they can change anything. AI agents connected to Nuvio work with the same rights as the person who connected them. See [Users and roles](https://nuvio.io/docs/users-and-roles).

## For developers

The same records are available through Nuvio’s public API: incomes, expenses, customers, suppliers, bank accounts, transactions and payments. See the [API reference](https://nuvio.io/docs/api).
