Altoviz integration
Altoviz is a French online invoicing and accounting service. Manage customers, suppliers, contacts, colleagues, products and their families; create, finalize, check for e-invoicing, email, download and mark as paid sales invoices, credit notes and quotes; record customer receipts; upload supplier bills; manage bank accounts and set transactions aside; read cash-flow, turnover, payment-delay and unpaid-balance statistics; export documents and accounting registers as files; register webhooks. Left out: the deprecated SaleInvoices, SaleCredits and SaleQuotes routes (the Sales ones replace them), the quote status filter (its published schema refers to itself), the OrderBy sort parameter (its values are not documented), and reading a product image. Authentication is an API key created in Altoviz under Settings, API access, sent in the X-API-KEY header; the API allows 100 calls per minute.
Say what should happen.
The workflow builds itself.
What you can do with Altoviz
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Find, 9 operations
find_colleaguesFind colleaguesGETFinds colleagues by email, internal ID or colleague number; pass one of them. Returns a list of colleagues; personal data.find_contactsFind contactsGETFinds contacts by email or internal ID; pass one of them. Returns a list of contacts; personal data.find_credit_notesFind credit notesGETFinds credit notes by number or internal ID; pass one of them. Returns a list of credit notes.find_customer_familiesFind customer familiesGETFinds customer families by number or internal ID; pass one of them. Returns a list.find_customersFind customersGETFinds customers by email, internal ID or customer number; pass one of them. Returns a list of customers.find_invoicesFind invoicesGETFinds invoices by number or internal ID; pass one of them. Returns a list of invoices.find_productsFind productsGETFinds products by number or internal ID; pass one of them. Returns a list of products.find_quotesFind quotesGETFinds quotes by number or internal ID; pass one of them. Returns a list of quotes.find_suppliersFind suppliersGETFinds suppliers by email or internal ID; pass one of them. Returns a list of suppliers.
Get by internal id, 8 operations
get_colleague_by_internal_idGet colleague by internal idGETReturns the colleague whose internal ID (the identifier from your own system) matches; personal data.get_credit_note_by_internal_idGet credit note by internal idGETReturns the credit note whose internal ID (the identifier from your own system) matches.get_customer_by_internal_idGet customer by internal idGETReturns the customer whose internal ID (the identifier from your own system) matches.get_invoice_by_internal_idGet invoice by internal idGETReturns the invoice whose internal ID (the identifier from your own system) matches.get_product_by_internal_idGet product by internal idGETReturns the product whose internal ID (the identifier from your own system) matches.get_quote_by_internal_idGet quote by internal idGETReturns the quote whose internal ID (the identifier from your own system) matches.get_receipt_by_internal_idGet receipt by internal idGETReturns the receipt whose internal ID (the identifier from your own system) matches.get_supplier_by_internal_idGet supplier by internal idGETReturns the supplier whose internal ID (the identifier from your own system) matches.
Contact, 6 operations
create_contactCreate contactPOSTCreates a contact (a person) with name, company, function, department, email, phone numbers and your own internal ID.delete_contactDelete contactDELETEDeletes a contact, identified by its Altoviz ID.get_contactGet contactGETReturns one contact by Altoviz ID: name, company, function, department, email and phone numbers; personal data.list_contactsList contactsGETLists contacts (people) with name, company, function, department, email and phone numbers; personal data. Paginated with PageIndex and PageSize; query runs a full-text search.list_customer_contactsList customer contactsGETLists the contacts attached to a customer with name, function, email, phone numbers and which one is the main contact; personal data.list_supplier_contactsList supplier contactsGETLists the contacts attached to a supplier with name, function, email, phone numbers and which one is the main contact; personal data.
Customer, 5 operations
create_customerCreate customerPOSTCreates a customer (business, consumer or government) with names, contact details, addresses, company identifiers (SIRET, VAT number, e-invoicing address), family and billing options.delete_customerDelete customerDELETEDeletes a customer, identified by its Altoviz ID.export_customersExport customersGETExports the customer list, optionally narrowed by a search term to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.get_customerGet customerGETReturns one customer by Altoviz ID: type, names, contact details, addresses, company identifiers, family and billing options.list_customersList customersGETLists customers with type, names, contact details, billing and shipping addresses, company identifiers (SIRET, VAT number) and billing options. Paginated with PageIndex and PageSize; query runs a full-text search.
Product, 5 operations
create_productCreate productPOSTCreates a product, service or text item with name, number, description, unit, sale and purchase prices, sales and purchase VAT and family. Margin, markup and margin rate are derived by Altoviz.delete_productDelete productDELETEDeletes a product, identified by its Altoviz ID.export_productsExport productsGETExports the product catalogue, optionally narrowed by a search term to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.get_productGet productGETReturns one product by Altoviz ID: number, name, description, type, unit, sale and purchase prices, VAT, margin figures, family and image URL.list_productsList productsGETLists products and services with number, name, type, unit, sale and purchase prices (tax excluded and included), VAT, margin and family. Paginated; query runs a full-text search and familyId filters by family.
Sales credit, 5 operations
create_credit_noteCreate credit notePOSTCreates a draft sales credit note for a customer with lines, discount, shipping, notes and references. It stays editable until finalize_credit_note makes it official and numbered.delete_credit_noteDelete credit noteDELETEDeletes a draft credit note, identified by its Altoviz ID.export_credit_notesExport credit notesGETExports sales credit notes over a date range, optionally for one customer or a search term to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.get_credit_noteGet credit noteGETReturns one credit note by Altoviz ID with its customer, lines, amounts, balance, VAT breakdown, due dates, PDF URL and the invoice it cancels, if any.list_credit_notesList credit notesGETLists sales credit notes with customer, dates, amounts, balance, VAT breakdown, lines and draft, paid and cancelled flags. Filter by date range or customer; cancelled and processed ones are hidden unless asked. Paginated.
Sales invoice, 5 operations
create_invoiceCreate invoicePOSTCreates a draft sales invoice for a customer with lines, discount, shipping, notes and references. It stays editable until finalize_invoice makes it official and numbered.delete_invoiceDelete invoiceDELETEDeletes a draft invoice. One with payments allocated to it is refused with 409 unless detachPayments is true, which deletes it and keeps the payments, no longer allocated.export_invoicesExport invoicesGETExports sales invoices over a date range, optionally for one customer or a search term to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.get_invoiceGet invoiceGETReturns one invoice by Altoviz ID with its customer, lines, amounts, balance, VAT breakdown, due dates, e-invoicing status, PDF URL and any credit note that cancels it.list_invoicesList invoicesGETLists sales invoices with customer, dates, amounts, balance, VAT breakdown, lines and draft, paid and cancelled flags. Filter by date range, customer or status; cancelled and processed ones are hidden unless asked. Paginated.
Sales quote, 5 operations
create_quoteCreate quotePOSTCreates a sales quote for a customer with lines, discount, deposit, validity date, status, notes and references.delete_quoteDelete quoteDELETEDeletes a quote, identified by its Altoviz ID.export_quotesExport quotesGETExports sales quotes over a date range, optionally for one customer or a search term to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.get_quoteGet quoteGETReturns one quote by Altoviz ID with its customer, lines, amounts, VAT breakdown, status, validity, acceptance or refusal dates and PDF URL.list_quotesList quotesGETLists sales quotes with customer, dates, validity date, status, amounts, VAT breakdown and lines. Filter by date range or customer. Paginated with PageIndex and PageSize.
Supplier, 5 operations
create_supplierCreate supplierPOSTCreates a supplier with company name, number, contact person, email, phone numbers, address, company identifiers (SIRET, VAT number) and default payment method.delete_supplierDelete supplierDELETEDeletes a supplier, identified by its Altoviz ID.export_suppliersExport suppliersGETExports the supplier list, optionally narrowed by a search term to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.get_supplierGet supplierGETReturns one supplier by Altoviz ID: name, number, contact details, address, company identifiers and default payment method.list_suppliersList suppliersGETLists suppliers with name, number, contact details, address, company identifiers and default payment method. Paginated with PageIndex and PageSize; query runs a full-text search.
Bank account, 4 operations
create_bank_accountCreate bank accountPOSTCreates a bank account kept by hand (name, bank, IBAN, BIC, currency, initial balance). An account synchronized from a bank provider cannot be created here: that connection is made in the Altoviz app.delete_bank_accountDelete bank accountDELETEIrreversibly deletes a bank account, every transaction in it and, unless shared, its accounting journal and entries. Refused for an account with reconciled transactions (409), a provider-connected account or the main account (400).get_bank_accountGet bank accountGETReturns one bank account by Altoviz ID: name, bank, IBAN, BIC, currency, initial and current balance, main-account flag, provider details and the count and total of transactions not yet reconciled.list_bank_accountsList bank accountsGETLists the company's bank accounts with name, bank, IBAN, BIC, currency, current balance, the main-account flag, provider details for synchronized accounts, and the count and total of transactions not yet reconciled.
Colleague, 4 operations
create_colleagueCreate colleaguePOSTCreates a colleague (a team member or partner) with name, contact details, number, internal ID and, for a partner, an initial balance.delete_colleagueDelete colleagueDELETEDeletes a colleague, identified by its Altoviz ID.get_colleagueGet colleagueGETReturns one colleague by Altoviz ID: name, number, email, phone numbers, internal ID, partner flag and linked Altoviz user; personal data.list_colleaguesList colleaguesGETLists the company's colleagues (team members and partners) with name, number, email and phone numbers; personal data. Paginated with PageIndex and PageSize; query runs a full-text search.
Customer family, 4 operations
create_customer_familyCreate customer familyPOSTCreates a customer family (a group used to organize customers) with a label, number and internal ID.delete_customer_familyDelete customer familyDELETEDeletes a customer family, identified by its Altoviz ID.get_customer_familyGet customer familyGETReturns one customer family by Altoviz ID: label, number and internal ID.list_customer_familiesList customer familiesGETLists customer families (groups used to organize customers) with ID, label, number and internal ID. Paginated with PageIndex and PageSize; query runs a full-text search.
Download, 4 operations
download_credit_noteDownload credit noteGETDownloads a sales credit note as a PDF and returns it as a stored file.download_invoiceDownload invoiceGETDownloads a sales invoice as a PDF and returns it as a stored file.download_purchase_invoiceDownload purchase invoiceGETDownloads a purchase invoice (a supplier bill) as a PDF and returns it as a stored file.download_quoteDownload quoteGETDownloads a sales quote as a PDF and returns it as a stored file.
Product family, 4 operations
create_product_familyCreate product familyPOSTCreates a product family (a group used to organize products) with a label and number.delete_product_familyDelete product familyDELETEDeletes a product family, identified by its Altoviz ID.get_product_familyGet product familyGETReturns one product family by Altoviz ID: label and number.list_product_familiesList product familiesGETLists product families (groups used to organize products) with ID, label and number. Paginated with PageIndex and PageSize; query runs a full-text search.
Receipt, 4 operations
create_receiptCreate receiptPOSTRecords a receipt (a payment received from a customer) with amount, date, payment method, status and reference; links name the invoices or credit notes it marks as paid.delete_receiptDelete receiptDELETEDeletes a receipt, identified by its Altoviz ID.get_receiptGet receiptGETReturns one receipt by Altoviz ID: amount, date, customer, payment method, status, reference and the documents it settles.list_receiptsList receiptsGETLists receipts (payments received from customers) with amount, date, customer, payment method, status, reference and the documents each one settles. Paginated with PageIndex and PageSize; query runs a full-text search.
Send, 3 operations
send_credit_noteSend credit notePOSTEmails a credit note to the given addresses. This sends a real email from your Altoviz account.send_invoiceSend invoicePOSTEmails an invoice to the given addresses. This sends a real email from your Altoviz account.send_quoteSend quotePOSTEmails a quote to the given addresses. This sends a real email from your Altoviz account.
Webhook, 3 operations
create_webhookCreate webhookPOSTRegisters a webhook: Altoviz POSTs the chosen events (customer, contact, product, quote or invoice created, updated or deleted) to a public URL; localhost and private networks are not reachable.delete_webhookDelete webhookDELETEUnregisters a webhook, identified by its ID or by its URL; pass one of them.list_webhooksList webhooksGETLists the registered webhooks with name, target URL and subscribed event types. Their signing secrets are not returned.
Bank transaction, 2 operations
export_bank_transactionsExport bank transactionsGETExports the transactions of one bank account over a date range to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.get_bank_transactionGet bank transactionGETReturns one bank transaction by Altoviz ID: account, dates, labels, amount, nature, payment method, and whether it is set aside, imported from a file or already reconciled.
Check einvoicing, 2 operations
check_credit_note_einvoicingCheck credit note einvoicingPOSTChecks a draft credit note against the e-invoicing conformance rules (Factur-X / CII) and returns the findings; it is NOT finalized or transmitted. Read isValid for the verdict. A finalized one answers 409.check_invoice_einvoicingCheck invoice einvoicingPOSTChecks a draft invoice against the e-invoicing conformance rules (Factur-X / CII) and returns the findings; it is NOT finalized or transmitted. Read isValid for the verdict. A finalized invoice answers 409.
Finalize, 2 operations
finalize_credit_noteFinalize credit notePOSTFinalizes a draft credit note: it becomes official, numbered and no longer editable. finalizationDate and dateAdjustment decide the date when the draft's own date cannot be used.finalize_invoiceFinalize invoicePOSTFinalizes a draft invoice: it becomes official, numbered and no longer editable. finalizationDate and dateAdjustment decide the date when the draft's own date cannot be used.
Activity, 1 operation
list_homecare_activitiesList homecare activitiesGETLists the home-care (services a la personne, SAP) activities with their ID, name and the TSA group they belong to, for French home-care service providers.
Cash flow by periodicity, 1 operation
get_cash_flow_statisticsGet cash flow statisticsGETReturns settled, outstanding and projected cash flow (receipts, expenses, profits), tax excluded, bucketed by day, week, month, quarter or year over a date range or a calendar year.
Classification, 1 operation
list_classificationsList classificationsGETLists the accounting classifications (sale, expense or other categories) with label, account number, default VAT and product or service flags. Its ID goes in classificationId on a document line that has no product.
Commitment, 1 operation
export_commitmentsExport commitmentsGETExports commitments (due dates of customers, suppliers and colleagues) over a date range to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.
Einvoicing ready, 1 operation
get_einvoicing_readinessGet einvoicing readinessGETReturns how many customers and suppliers are configured for e-invoicing and how many of each have configuration issues.
Exclude, 1 operation
exclude_bank_transactionExclude bank transactionPOSTSets a bank transaction aside: it is no longer offered for reconciliation and stops counting towards its account's pending total. The transaction itself is untouched; include_bank_transaction reverses it.
Expense charge, 1 operation
export_expense_chargesExport expense chargesGETExports purchase invoices (expense charges) over a date range, optionally for one supplier or a search term to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.
Expense report, 1 operation
export_expense_reportsExport expense reportsGETExports expense reports over a date range, optionally for one colleague to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.
Expenses book, 1 operation
export_expenses_bookExport expenses bookGETExports the expenses accounting register over a date range to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.
File, 1 operation
create_purchase_invoice_from_fileCreate purchase invoice from filePOSTCreates a purchase invoice (a supplier bill) from an uploaded file, such as the PDF the supplier sent, and returns it with its date, reference, supplier, amount and status.
Global turnover, 1 operation
get_global_turnoverGet global turnoverGETReturns the company's all-time total turnover, tax excluded.
Include, 1 operation
include_bank_transactionInclude bank transactionPOSTPuts a set-aside bank transaction back, so it is offered for reconciliation again and counts towards its account's pending total. Reverses exclude_bank_transaction.
Mark as paid, 1 operation
mark_invoice_paidMark invoice paidPOSTRecords a payment on an invoice (amount, date, method, reference, status). finalizeInvoice also finalizes a draft first; allowUpdate lets you edit the payment status, reference or metadata of a paid invoice.
Mark as refunded, 1 operation
mark_credit_note_refundedMark credit note refundedPOSTMarks a credit note as refunded, recording the refund amount, date, payment method, status and reference. finalizeCredit also finalizes it first when it is still a draft.
Me, 1 operation
get_current_userGet current userGETReturns the profile of the Altoviz user the API key belongs to: name, email, phone, profile (Admin, Standard, Accountant, Support, Api) and status.
Payment delay, 1 operation
get_payment_delay_statisticsGet payment delay statisticsGETReturns how long payments take over a period: median days from document date and from due date, the share of the settled amount paid late, and bucketed series. Customers by default, or suppliers.
Product image, 1 operation
delete_product_imageDelete product imageDELETEDeletes a product's image; id is the product's Altoviz ID.
Provider, 1 operation
list_bank_providersList bank providersGETLists the bank and payment providers Altoviz can synchronize accounts from, with name, branch, logo, country codes and markets; query runs a full-text search. Connecting one is done in the Altoviz app.
Receipts book, 1 operation
export_receipts_bookExport receipts bookGETExports the receipts accounting register over a date range to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.
Set as main, 1 operation
set_main_bank_accountSet main bank accountPOSTMakes a bank account the company's main one; the account that held it loses it. Only an account kept by hand or synchronized through Linxo qualifies: payment balances (Stripe, PayPal and the like) are refused with 400.
Setting, 1 operation
get_settingsGet settingsGETReturns the account settings: company identity and addresses, accounting codes and accounts, e-invoicing options, email templates per document type, sales defaults, VAT regime and social links.
Settlement, 1 operation
export_settlementsExport settlementsGETExports settlements (customer receipts, supplier payments, colleague repayments) over a date range to a stored file. format: Excel, European or American CSV, TSV, JSON or Markdown; sheets: Summary, Detail, Analysis or All.
Top overdue customer, 1 operation
list_top_overdue_customersList top overdue customersGETLists customers with overdue amounts, ranked by amount still due, with the age of their oldest unpaid due date and when they were last reminded (null when never).
Transaction, 1 operation
list_bank_transactionsList bank transactionsGETLists the transactions of one bank account: date, label, amount (negative for money out), nature and reconciliation state. Filter by date range or search term, and hide set-aside or reconciled ones. Paginated.
Tsa group, 1 operation
list_homecare_tsa_groupsList homecare tsa groupsGETLists the TSA groups (regroupements) that home-care (services a la personne) activities belong to, with ID and name.
Turnover comparison, 1 operation
get_turnover_comparisonGet turnover comparisonGETReturns turnover over a period, tax excluded, next to the same period one year earlier and the period of equal length just before it. Sales by default, purchases with expenses=true.
Turnover evolution, 1 operation
get_turnover_evolutionGet turnover evolutionGETReturns turnover bucketed over a period, tax excluded, optionally compared with up to 2 earlier years and broken down by sales, expenses, customer, supplier, product, colleague, margin or discount.
Unit, 1 operation
list_unitsList unitsGETLists the units of measure (code, name, type such as time or weight, decimals and conversion) usable on products and document lines.
Unpaid expense, 1 operation
get_unpaid_expensesGet unpaid expensesGETReturns the aged balance of money owed to suppliers: count and total still due per bucket of distance from today (negative overdue, 0 due today, positive upcoming).
Unpaid invoice, 1 operation
get_unpaid_invoicesGet unpaid invoicesGETReturns the aged balance of money customers owe: count and total still due per bucket of distance from today (negative overdue, 0 due today, positive upcoming).
Vat, 1 operation
list_vat_ratesList vat ratesGETLists the VAT rates configured in the account with rate, label, region (FR, EU, IE, DOM, Corse, Monaco) and which one is the default for its region.
Showing the first 120 of 130 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Altoviz from Claude Code, Cursor or Codex
Connect Altoviz in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Altoviz operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Altoviz
- Create your workspace
Sign up free. Nothing to install.
- Connect Altoviz once
Add your Altoviz connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Altoviz integration FAQ
What can you do with the Altoviz integration?
LiveContext exposes 130 operations on Altoviz, covering find, get by internal id, contact and customer.
