Altoviz API

Name: Altoviz API API
Brand: Altoviz API
Availability: InStock

★ Only Publicly Available SpecFinanceAccountingapiKey34 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.

Quickstart

Get started with Altoviz API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create a sale invoice in Altoviz"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Altoviz API 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

Create sale invoices and read existing ones via /SaleInvoices

GET STARTED

Start building with Altoviz API API

Explore with Jentic

View OpenAPI Spec

Jentic publishes the only available OpenAPI specification for Altoviz API, keeping it validated and agent-ready.

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 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 though 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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Xero Accounting API

Established cloud accounting platform with deep ledger and bank reconciliation tooling

Choose Xero when the workflow needs full general-ledger accounting, bank feeds, and multi-currency rather than lightweight invoicing.

Alternative

Sage API

Sage business cloud accounting suite for small and mid-sized businesses

Choose Sage when the team already runs Sage payroll or HR products and wants a unified vendor for accounting.

Complementary

Stripe API

Card and bank payment acceptance to settle Altoviz-issued invoices

Use Stripe alongside Altoviz when invoices need to be paid by card or bank transfer and the team wants automatic payment-to-receipt reconciliation.

FAQs

Specific to using Altoviz API 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.