Altoviz API

Name: Altoviz API
Brand: Altoviz API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentFinanceAccountingapiKey34 EndpointsREST

For Agents

Manage customers, suppliers, products, invoices, purchase invoices, and receipts in Altoviz through 34 x-api-key-authenticated endpoints. Useful for agents synchronising books with line-of-business systems.

Install Jentic One Beta

Connect the Altoviz API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Altoviz API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Altoviz API.

List, create, update, and delete customer records via /Customers

Look up a customer by Altoviz id or by your own internal id (/Customers/GetByInternalId/{internalId})

Manage supplier records and their purchase relationships through /Suppliers and related endpoints

GET STARTED

Start building with Altoviz API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Altoviz API, keeping it validated and agent-ready. Altoviz is a free invoicing and accounting platform that exposes 34 REST endpoints across customers, suppliers, products, sale invoices, purchase invoices, receipts, customer families, settings, and users. Teams use it to push invoices and receipts from line-of-business systems, sync customer and supplier records, and pull settings such as tax codes and numbering rules. Authentication is a single x-api-key header issued from the Altoviz dashboard.

Use Cases

Patterns agents use Altoviz API for, with concrete tasks.

★ Sync Customers and Invoices from a CRM

Service businesses keep Altoviz aligned with their CRM by mirroring customer creates and updates, then issuing sale invoices from the same workflow. The /Customers/GetByInternalId/{internalId} endpoint lets the integration use the CRM's own primary key as the join, avoiding a parallel mapping table. New invoices flow into Altoviz via POST /SaleInvoices.

On a new closed-won deal, call GET /Customers/GetByInternalId/{crmId}; if 404, POST /Customers; then POST /SaleInvoices with the deal's line items.

Two-Sided Bookkeeping for Small Businesses

Solo operators and small teams record both the income side (sale invoices, receipts) and the expense side (purchase invoices) in Altoviz from the same script. The API exposes balanced create endpoints for SaleInvoices, PurchaseInvoices, and Receipts so a bookkeeping bot can keep the ledgers tied without manual data entry.

POST /PurchaseInvoices for an incoming supplier invoice, then POST /Receipts when the supplier is paid, linking both to the supplier id.

Product Catalogue Management

E-commerce and field-service teams sync their canonical product catalogue into Altoviz so that line items on invoices match the rest of the business. The /Products endpoints support full CRUD, which lets the integration roll out price changes or new SKUs from a single source of truth.

Iterate over the e-commerce catalogue and call POST /Products for new SKUs and PUT /Products/{id} for price updates against existing ones.

AI Agent Bookkeeping Assistant via Jentic

An AI bookkeeping agent built on Jentic can take 'invoice ACME for last week's hours and email it to billing@acme.com' and resolve it to a Customers lookup, a SaleInvoice create, and a downstream email send. The Altoviz x-api-key stays in the MAXsystem vault throughout.

Search Jentic for 'create a sale invoice in Altoviz', load the POST /SaleInvoices schema, and execute it with the resolved customer id and line items.

Key Endpoints

34 endpoints — jentic publishes the only available openapi specification for altoviz api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/Customers

List customer records

POST

/Customers

Create a new customer

GET

/Customers/GetByInternalId/{internalId}

Look up a customer by your own internal id

GET

/SaleInvoices

List sale invoices

POST

/SaleInvoices

Issue a new sale invoice

GET

/SaleInvoices/{id}

Get a single sale invoice

GET

/settings

Read account-level settings such as tax codes

GET

/Users/me

Get the user record associated with the API key

GET

/Customers

List customer records

POST

/Customers

Create a new customer

GET

/Customers/GetByInternalId/{internalId}

Look up a customer by your own internal id

GET

/SaleInvoices

List sale invoices

POST

/SaleInvoices

Issue a new sale invoice

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Altoviz x-api-key values are stored encrypted in the Jentic vault (MAXsystem). Agents never hold the raw key; the header is injected at call time, which prevents leakage through agent transcripts.

Intent-based discovery

Agents search Jentic by intent (e.g., 'create a sale invoice in Altoviz') and Jentic returns the matching operation schema with required fields, so the agent can fill in customer id, line items, and dates without reading the spec.

Time to first call

Direct Altoviz integration: half a day to a day for auth, customer/supplier mapping, and invoice payload assembly. Through Jentic: under an hour to search, load, and execute the first invoice create.

FAQs

Specific to using Altoviz API through Jentic.

Why is there no official OpenAPI spec for Altoviz API?

Altoviz does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Altoviz API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Altoviz API use?

Altoviz uses an x-api-key header on every request. Through Jentic, the key is stored encrypted in the MAXsystem vault and the header is injected at call time, so the raw key never enters the agent's context.

Can I create a sale invoice with the Altoviz API?

Yes. POST to /SaleInvoices with the customer id, issue date, and line items referencing existing product ids. Then call GET /SaleInvoices/{id} to confirm the invoice number that Altoviz allocated from your numbering scheme.

What are the rate limits for the Altoviz API?

Specific per-account limits are not published in the spec. Build retry-with-backoff for 429 responses and contact Altoviz to confirm your tier's ceilings if you plan high-volume bulk imports of customers or invoices.

How do I create an invoice from a CRM record through Jentic?

Run pip install jentic and search with 'create a sale invoice in Altoviz'. Load the POST /SaleInvoices schema, resolve the customer id with GET /Customers/GetByInternalId/{internalId}, then execute the invoice create.

Is the Altoviz API free?

Altoviz markets its core invoicing as free RESTful APIs for invoicing and accounting. Confirm the current limits and any premium feature gates on the Altoviz pricing page before relying on it for high-volume production workloads.

Altoviz API

Connect the Altoviz API to your agent

Capabilities

Start building with Altoviz API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs