> For the complete documentation index, see [llms.txt](https://voyzu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://voyzu.gitbook.io/docs/readme.md).

# Introduction

{% hint style="info" %}
We are taking the probably quite unusual step of publishing the documentation before the application. If you are interested in this project, which will be released mid to late 2026, drop a line to <chris@voyzu.com>.

Note that emails that do not concern the project directly, such as marketing emails, will be deleted without reply.
{% endhint %}

Voyzu is a modern, open source, headless and embeddable Financial Ledger. The software is a financial engine, capable of managing complex financial operations.

Developers looking to add or enhance the financial / accountancy capabilities of their software may find Voyzu a valuable "sidekick".

Voyzu is not accounting software like SAP or Microsoft Dynamics. Rather it empowers developers and development teams looking to strengthen their products by adding deeper Operational Accounting features.

## Financial Capabilities

Voyzu provides the core financial capabilities needed to process, post, and report financial activity from external systems through a consistent accounting engine.

#### Accounts Receivable & Invoicing

Create, validate, post, and manage customer invoices, credit notes, receipts, and receivable balances with clear ledger and subledger treatment.

#### Accounts Payable & Supplier Billing

Process supplier bills, credits, payments, and payable balances using structured financial documents and consistent posting rules.

#### Inventory & Cost Accounting

Record inventory-related financial movements, including stock value and cost accounting, so operational activity can flow cleanly into the ledger.

#### Payments & Cash Application

Manage customer and supplier payments, including allocation, unapplied balances, and cash application against open financial documents.

#### Taxation & Tax Reporting

Support tax-aware financial processing, including tax calculation, tax movements, authority-level reporting, and period-based tax position reporting.

## Components

Voyzu Includes a number of components designed to help developers add financial capabilities to their applications, integrating as deeply as desired

### Voyzu API

A comprehensive API, allowing integrators to manage all aspects of Voyzu's Financial engine, including administrative functions

**Example:**

```
• curl -X POST "http://localhost:3000/api/finance/process-document/AR_INVOICE" \
    -H "Content-Type: application/json" \
    -d '{
      "document_type": "AR_INVOICE",
      "company_code": "NZ_COMPANY_001",
      "ar_counterparty_code": "CUST_001",
      "document_id": "INV-1001",
      "invoice_date": "2026-04-19",
      "lines": [
        {
          "line_id": 1,
          "description": "Consulting services",
          "quantity": 1,
          "net_unit_price": 1000,
          "tax_posting_code": "STANDARD"
        }
      ]
    }'
```

For more information see [API Reference](/docs/api-reference/api-reference.md)

### Typescript libraries

Developers using Typescript can directly import and call all Voyzu Financial capabilities via the Voyzu Typescript Libraries

**Example:**

```typescript
import Voyzu from "@voyzu/core";
import type { ARInvoice } from "@voyzu/types";

const voyzu = new Voyzu({
  databaseUrl: process.env.VOYZU_DATABASE_URL!,
});

const invoice = {
  document_type: "AR_INVOICE",
  company_code: "NZ_COMPANY_001",
  ar_counterparty_code: "CUST_001",
  document_id: "INV-1001",
  invoice_date: "2026-04-19",
  lines: [
    {
      line_id: 1,
      description: "Consulting services",
      quantity: 1,
      net_unit_price: 1000,
      tax_posting_code: "STANDARD",
    },
  ],
} satisfies ARInvoice;

await voyzu.financialDocument.arInvoice.post(invoice);
```

For more information see [Typescript Libraries](/docs/typescript-libraries/introduction.md)

### Voyzu Admin Console

A fully featured and carefully designed User Interface allowing:

* Management of Organization wide Financial Configuration such as General Ledger configuration, Tax setup and the like
* View access to individual company financial ledgers and subledgers

**Example:**

<figure><img src="/files/ElWnNDXkxFyGuPvDNwri" alt=""><figcaption></figcaption></figure>

For more information see [Voyzu Admin Console](/docs/voyzu-admin-console/organization-financial-settings.md)

### Embeddable React Components

A number of UI components are available to directly embed into your application

**Example:**

```tsx
"use client";

import { CompanyProfitAndLoss } from "@voyzu/components";

export default function CompanyReportsPage() {
  return (
    <section>
      <h1>Company Profit and Loss</h1>

      <CompanyProfitAndLoss
        companyCode="NZ_COMPANY_001"
        fromDate="2026-04-01"
        toDate="2026-04-30"
      />
    </section>
  );
}
```

For more information see [Component Server](/docs/component-server/organization-pageset.md)

### Documentation

Whether you are looking to use Voyzu to validate your financial calculations, or you want to build an accounting system on top of the Voyzu platform, you will find helpful guidance here


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://voyzu.gitbook.io/docs/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
