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.
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.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
Use for: Create a new customer in Altoviz, Look up a customer by our internal CRM id, Issue a sale invoice for a customer, List every sale invoice issued this month
Not supported: Does not handle payroll, full general ledger journals, or bank-feed reconciliation — use only for invoicing, receipts, and customer/supplier records in Altoviz.
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.
Record and retrieve receipts and purchase invoices for two-sided bookkeeping
Maintain a product catalogue used as line items on invoices
Read account-level settings such as tax codes and numbering schemes from /settings
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.
34 endpoints — jentic publishes the only available openapi specification for altoviz api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/Customers
List customer records
/Customers
Create a new customer
/Customers/GetByInternalId/{internalId}
Look up a customer by your own internal id
/SaleInvoices
List sale invoices
/SaleInvoices
Issue a new sale invoice
/SaleInvoices/{id}
Get a single sale invoice
/settings
Read account-level settings such as tax codes
/Users/me
Get the user record associated with the API key
/Customers
List customer records
/Customers
Create a new customer
/Customers/GetByInternalId/{internalId}
Look up a customer by your own internal id
/SaleInvoices
List sale invoices
/SaleInvoices
Issue a new sale invoice
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.
Alternatives and complements available in the Jentic catalogue.
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.
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.
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.
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.
/SaleInvoices/{id}
Get a single sale invoice
/settings
Read account-level settings such as tax codes
/Users/me
Get the user record associated with the API key