Altoviz is a cloud-based billing and invoicing platform for businesses, offering online payments, expense tracking, document management, and customizable invoices.
Altoviz is a cloud-based billing and invoicing platform for businesses, offering online payments, expense tracking, document management, and customizable invoices. On Nagent, Altoviz is exposed as a fully-configurable accounting integration that any agent can call — 67 actions, and API key authentication. No code is required to wire Altoviz into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Altoviz to automate the kinds of tasks accounting teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Altoviz into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Altoviz, with input parameters and output schema. Drop these into any step of an agent built in Helix.
ALTOVIZ_CREATE_CONTACTCreates a new contact in the Altoviz system. Use when you need to add a new contact with details like name, email, phone, and company information.
Input parameters
Email address of the contact
Phone number of the contact
Job title of the contact
Service or department information
Job function or department of the contact
Last name of the contact
Cell phone number of the contact
First name of the contact
Internal ID used for reference in your system
Company name of the contact
Display name for the contact
Inverted display name (last name, first name)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_CREATE_CUSTOMERCreates a new customer in Altoviz. Use type='Company' for business customers (requires companyName) or type='Individual' for personal customers (typically uses firstName/lastName).
Input parameters
Type of customer: 'Company' for businesses or 'Individual' for persons. This determines which fields are required.
Email address of the customer
Landline/office phone number
Customer title/salutation (e.g., Mr., Mrs., Dr.)
Whether the customer account is active (default: true)
Customer family/classification
Custom customer number/reference code
Last name - typically used when type is 'Individual'
Mobile/cell phone number
First name - typically used when type is 'Individual'
Your own unique identifier for this customer, useful for integration with external systems
Company name - required when type is 'Company'
Private internal notes about the customer
Address details
Billing options for the customer
Address details
Company-specific information
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_CREATE_CUSTOMER_FAMILYCreates a new customer family in Altoviz for categorizing and organizing customers into groups. Use when you need to create customer segments or categories for better organization.
Input parameters
The name/label of the customer family for categorization
A unique reference number or code for the customer family
Your internal reference ID for syncing with external systems
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_CREATE_PRODUCTCreates a new product in the Altoviz system. This tool allows for the independent creation of a product with all necessary details.
Input parameters
VAT rate object. Use ALTOVIZ_GET_VATS to retrieve available rates. Must include: id, rate, region, label. Example: {'id': 51616, 'rate': 20.0, 'region': 'FR', 'label': '20.0% - FR'}
Name of the product
Unit of measurement object. Use ALTOVIZ_GET_UNITS to retrieve available units. Must include: id, name, code, type, conversion, decimals. Example: {'id': 23112, 'name': 'Kilogrammes', 'code': 'KG', 'type': 'Weight', 'conversion': 1.0, 'decimals': 3.0}
Whether the product is active and available for use
Product family/classification object for categorization. Must include: id and label fields
Unique product number or SKU identifier
Selling price of the product (must be greater than 0)
Detailed description of the product
Your internal reference ID for syncing with external systems
Type of item: 'Product' for physical goods, 'Service' for services
Private notes about the product (not visible to customers)
Cost/purchase price of the product (must be greater than 0)
Default quantity when adding product to invoices/quotes
True if unit_price includes VAT, False if price is before tax
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_CREATE_PRODUCT_FAMILYTool to create a new product family in Altoviz. Use when you need to organize products into categories or families for better inventory management.
Input parameters
Label or name of the product family for categorization
Unique reference number or code for the product family
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_CREATE_RECEIPTCreates a new receipt in the Altoviz system to record customer payments. Use when you need to document received payments and optionally link them to invoices or other documents.
Input parameters
Receipt date in ISO 8601 format (YYYY-MM-DD)
List of links to mark documents (invoices/quotes) as paid. Each link must include document ID, amount, and type.
Additional notes or comments about the receipt
Receipt amount (must be greater than 0)
Receipt status. If not specified, defaults to Success.
Additional metadata as key-value pairs for custom data storage
External reference number (e.g., check number, transaction ID)
Unique customer ID in Altoviz. Use ALTOVIZ_FIND_CUSTOMER to look up customer IDs by email.
Your internal reference ID for this receipt
Customer name
Payment method used for the receipt
Customer number/reference code
Your internal customer identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_CREATE_SALE_CREDITCreates a new draft credit note (avoir) in Altoviz. Credit notes are used to cancel or refund invoices. The credit note is created in draft status and can be modified before being finalized.
Input parameters
Date of the credit note in YYYY-MM-DD format. If not provided, current date will be used.
Line items for the credit note. Each line must include: description (string), quantity (number), type ('Product' or 'Service'), and either taxExcludedPrice or taxIncludedPrice depending on useTaxIncludedPrices setting.
Tax region for this credit note. Must be one of: FR (France), EU (European Union), IE (Ireland), DOM (French overseas territories), Corse (Corsica), Monaco
Subject/title for the credit note
VAT mode: Auto (automatic), Debit (on invoice), or Collection (on payment)
VAT note to print on the credit note
Additional metadata as key-value pairs
Customer ID to associate with this credit note. Either customerId or customerNumber must be provided. Use ALTOVIZ_FIND_CUSTOMER to look up customer IDs.
Your own internal reference ID for this credit note
Notes to print in the footer section of the credit note
Notes to print in the header section of the credit note
Indicates whether the document is liable to VAT
Customer name to display on the credit note
Internal notes (not printed on the credit note)
Billing address for the customer
Billing contact information
Customer reference number. Either customerId or customerNumber must be provided.
Global discount applied to the entire credit note
Shipping amount to include in the credit note
Shipping address for the customer
Shipping contact information
Vendor reference to be printed
Set to true if VAT reverse charge applies
Customer's VAT registration number
ID of the invoice this credit note cancels/refunds
Set to true if prices include tax/VAT, false if prices are pre-tax amounts
Customer's order reference number
Number of the invoice this credit note cancels/refunds
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_CREATE_SALE_INVOICECreates a new draft sale invoice in Altoviz. The invoice is created in draft status and can be modified before being finalized. Use when you need to generate an invoice for a customer with line items.
Input parameters
Date of the invoice in YYYY-MM-DD format. If not provided, current date will be used.
Line items for the invoice. At least one line item is required.
Tax region for this invoice. Must be one of: FR (France), EU (European Union), IE (Ireland), DOM (French overseas territories), Corse (Corsica), Monaco. If not provided, will use customer's default region.
Subject/title for the invoice
VAT mode: Auto (automatic), Debit (on invoice), or Collection (on payment)
VAT note to print on the invoice
Additional metadata as key-value pairs
Customer ID to associate with this invoice. Use ALTOVIZ_FIND_CUSTOMER to look up customer IDs.
Your own internal reference ID for this invoice
Notes to print in the footer section of the invoice
Notes to print in the header section of the invoice
Indicates whether the invoice is liable to VAT
VAT rate for shipping. Use ALTOVIZ_GET_VATS to retrieve available VAT rates.
Customer name to display on the invoice (overrides customer's name)
Internal notes (not printed on the invoice)
Billing address for the customer (overrides customer's default)
Billing contact information
Customer reference number
Global discount applied to the entire invoice
Shipping amount to include in the invoice
Shipping address for the customer (overrides customer's default)
Shipping contact information
Vendor reference to be printed
Set to true if VAT reverse charge applies
Customer's VAT registration number
Set to true if prices include tax/VAT, false if prices are pre-tax amounts. If not provided, will use customer's default setting.
Customer's order reference number
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_COLLEAGUETool to delete a colleague from Altoviz. Use when you need to permanently remove a colleague from the system.
Input parameters
Colleague id to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_CUSTOMERTool to delete a customer from Altoviz. Use when you need to permanently remove a customer record from the system. Use ALTOVIZ_FIND_CUSTOMER first to look up customer IDs by email address if needed.
Input parameters
The unique identifier of the customer to delete. Use ALTOVIZ_FIND_CUSTOMER to look up customer IDs by email.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_CUSTOMER_FAMILYTool to delete a customer family from Altoviz. Use when you need to permanently remove a customer family from the system.
Input parameters
Customer family id to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_PRODUCTThis tool allows you to delete an existing product from Altoviz. The action permanently removes the product from the system.
Input parameters
The unique identifier of the product to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_PRODUCT_FAMILYTool to delete a product family from Altoviz. Use when you need to permanently remove a product family from the system.
Input parameters
Product family id to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_RECEIPTTool to delete a receipt from Altoviz. Use when you need to permanently remove a receipt from the system.
Input parameters
The unique identifier of the receipt to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_SALE_CREDITTool to delete a draft credit from Altoviz. Use when you need to permanently remove a draft credit. Only draft credits can be deleted; finalized credits cannot be removed.
Input parameters
Draft credit ID to delete. Only draft credits can be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_SALE_INVOICETool to delete a draft sale invoice from Altoviz. Use when you need to permanently remove a draft invoice from the system. Only draft invoices can be deleted; finalized invoices cannot be deleted.
Input parameters
The unique identifier of the draft invoice to delete. Only draft invoices can be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_SALE_QUOTETool to delete a sale quote from Altoviz. Use when you need to permanently remove a quote from the system.
Input parameters
The unique identifier of the sale quote to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DELETE_SUPPLIERTool to delete a supplier from Altoviz. Use when you need to permanently remove a supplier record from the system.
Input parameters
The unique identifier of the supplier to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DOWNLOAD_PURCHASE_INVOICETool to download a purchase invoice as a PDF file from Altoviz. Use when you need to retrieve the PDF document of a specific purchase invoice.
Input parameters
The unique identifier of the purchase invoice to download
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DOWNLOAD_SALE_CREDITTool to download a sale credit as a PDF file from Altoviz. Use when you need to retrieve the PDF version of a specific sale credit document.
Input parameters
The unique identifier of the sale credit to download
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_DOWNLOAD_SALE_INVOICETool to download a sale invoice as a PDF file from Altoviz. Use when you need to retrieve the PDF document of a specific sale invoice.
Input parameters
The unique identifier of the sale invoice to download
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_FIND_CONTACTThis tool allows searching for contacts in Altoviz using an email address. The action is independently executable and returns contact details if found.
Input parameters
The email address to search for in contacts
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_FIND_CUSTOMERThis tool allows you to find a customer in Altoviz by their email address. This is a standalone action that doesn't require any resource IDs or dependencies on other tools.
Input parameters
The email address of the customer to find
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_FIND_PRODUCTSearch for a product in Altoviz by its product number/SKU. Returns the first matching product with complete details including name, description, pricing, VAT, unit of measurement, and more. Returns null if no product matches. Use cases: - Look up a specific product by its SKU before creating an invoice - Verify a product exists before referencing it in orders - Retrieve product pricing and tax information
Input parameters
The product number/SKU to search for. Supports partial matching - the search will return the first product whose number contains this value.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_FIND_PRODUCT_BY_NUMBER_OR_IDTool to find a product in Altoviz by exact product number or internal ID. Use when you need to look up a product by either its product number/SKU or your internal system ID. At least one of the parameters must be provided.
Input parameters
Product number/SKU for exact matching. At least one of 'number' or 'internal_id' must be provided.
Internal ID used in your system. At least one of 'number' or 'internal_id' must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_FIND_RECEIPTTool to find receipts in Altoviz by customer internal ID. Returns a list of receipts associated with the specified internal ID. If no internal ID is provided, may return all receipts. Use when you need to search for receipts by customer identifier.
Input parameters
Number of receipts to return per page (1-100). Controls pagination of results.
Zero-based page index for pagination. Use with PageSize to navigate through results.
Customer internal ID to filter receipts. If not provided, returns all receipts.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_FIND_SALE_CREDITTool to find sale credits in Altoviz. Use when you need to search for or retrieve credit notes. Can filter by internal ID or return all credits if no filter is provided.
Input parameters
Number of credits to return per page (1-100). Controls pagination of results.
Zero-based page index for pagination. Use with PageSize to navigate through results.
Credit internal ID to filter by. If not provided, all credits will be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_FIND_SALE_INVOICETool to find sale invoices in Altoviz. Use when you need to search for or retrieve invoices. Can filter by internal ID or return all invoices if no filter is provided.
Input parameters
Number of invoices to return per page (1-100). Controls pagination of results.
Zero-based page index for pagination. Use with PageSize to navigate through results.
Invoice internal ID to filter by. If not provided, all invoices will be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_FIND_SALE_QUOTETool to find sale quotes in Altoviz. Use when you need to search for or retrieve quotations. Can filter by internal ID or return all quotes if no filter is provided.
Input parameters
Number of quotes to return per page (1-100). Controls pagination of results.
Zero-based page index for pagination. Use with PageSize to navigate through results.
Quote internal ID to filter by. If not provided, all quotes will be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_CLASSIFICATIONSThis tool retrieves a list of classifications from the Altoviz platform. Classifications are essential for producing accounting registers from user-created invoices. It can fetch all classifications or filter them by type.
Input parameters
Filter classifications by type. Allowed values are 'Sale', 'Expense', or 'Other'.
Field name to sort the results by. Specify the classification field to use for ordering (e.g., 'label', 'accountNumber', 'type').
The number of classifications to return per page. Controls how many results are returned in a single request.
The page index for pagination (1-based, starting from 1). Use this to navigate through multiple pages of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_COLLEAGUETool to retrieve a colleague's details from Altoviz by their ID. Use this when you need to fetch information about a specific colleague including their contact information, partner status, and metadata.
Input parameters
Colleague id to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_CONTACTTool to retrieve a contact by its unique ID from Altoviz. Use when you need to fetch detailed information about a specific contact.
Input parameters
The unique identifier of the contact to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_CURRENT_USERTool to retrieve the current authenticated user's information from Altoviz. Use when you need to get details about the currently authenticated user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_CUSTOMERTool to retrieve a customer by their ID from Altoviz. Use when you need detailed information about a specific customer.
Input parameters
Customer ID to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_CUSTOMER_BY_INTERNAL_IDTool to retrieve a single customer from Altoviz by their internal ID. Use when you need to fetch detailed information about a specific customer using their internal identifier.
Input parameters
The internal ID of the customer to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_CUSTOMER_CONTACTSTool to retrieve all contacts associated with a specific customer in Altoviz. Use when you need to get contact information for a customer using their customer ID.
Input parameters
Customer ID to retrieve contacts for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_CUSTOMER_FAMILYTool to retrieve a customer family by ID from Altoviz. Use when you need to fetch details of a specific customer family.
Input parameters
Customer family id to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_PRODUCTTool to retrieve a product by its unique ID in Altoviz. Use when you need complete details about a specific product including pricing, VAT, units, and inventory information.
Input parameters
Product ID to retrieve. This is the unique identifier of the product in Altoviz.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_PRODUCT_FAMILYTool to retrieve a specific product family by its ID from Altoviz. Use when you need to fetch details about a product category or family grouping.
Input parameters
Product family ID to retrieve. Must be a valid product family identifier from your Altoviz account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_RECEIPTTool to retrieve a receipt by its ID from Altoviz. Use when you need to fetch details of a specific receipt including amount, payment method, status, and customer information.
Input parameters
Receipt id to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_SALE_CREDITTool to retrieve a sale credit by its ID from Altoviz. Use when you need to get detailed information about a specific credit.
Input parameters
Credit ID to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_SALE_INVOICETool to retrieve a sale invoice by its ID from Altoviz. Use when you need to get detailed information about a specific invoice.
Input parameters
Invoice ID to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_SETTINGSTool to retrieve application settings from Altoviz. Use when you need to access configuration for accounting, company information, emailing, sales, social media, or VAT settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_SUPPLIERTool to retrieve a supplier by their ID from Altoviz. Use when you need detailed information about a specific supplier.
Input parameters
Supplier ID to retrieve. This is the unique identifier of the supplier in Altoviz.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_SUPPLIER_CONTACTSTool to retrieve all contacts associated with a specific supplier in Altoviz. Use when you need to get contact information for a supplier using their supplier ID.
Input parameters
Supplier ID to retrieve contacts for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_UNITSThis tool retrieves a list of all available units in the Altoviz system. Units are used for product measurements and quantity specifications in various transactions.
Input parameters
Field name to sort the results by. Specify the unit field to use for ordering (e.g., 'name', 'code', 'type').
The number of units to return per page. Controls how many results are returned in a single request.
The page index for pagination (1-based, starting from 1). Use this to navigate through multiple pages of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_GET_VATSThis tool retrieves a list of all available VAT rates from Altoviz. It's essential for creating and managing invoices and quotes where VAT calculations are required. It supports retrieving VAT rates, validating them for different regions, and ensuring correct tax calculations in financial documents.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_COLLEAGUESRetrieves a list of colleagues from Altoviz. Supports pagination, sorting, and full-text search. Use this to discover available colleagues, search for specific team members, or list all colleagues in the system.
Input parameters
Full text search query to filter colleagues. Searches across colleague name, email, phone, and other text fields. Use this to find colleagues matching specific keywords.
Field name to sort the results by. Common values include 'name', 'lastName', 'firstName', 'number'. Append ' desc' for descending order (e.g., 'name desc').
The number of colleagues to return per page. Use this with page_index to control pagination. Typical values are 10, 20, 50, or 100.
The page index for pagination. One-based index (1 = first page, 2 = second page, etc.). Use this with page_size to paginate through large result sets. Must be greater than 0.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_CONTACTSTool to retrieve a list of contacts from Altoviz with optional filtering and pagination. Use when you need to browse or search through available contacts.
Input parameters
Full text search query to filter contacts. Searches across contact fields like name, email, company, etc.
Field name to sort contacts by. Examples: 'displayName', 'email', 'lastName'.
The number of contacts to return per page. Use this to control the size of the result set.
The page index for pagination (0-based). Use this to navigate through multiple pages of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_CUSTOMER_FAMILIESTool to list customer families from Altoviz. Use when you need to retrieve or search through customer family groups. Supports pagination and full-text search to filter results.
Input parameters
Full text search query to filter customer families. Use this to search across all customer family fields.
Field name to order the results by. Use this to sort the customer families list.
The number of customer families to return per page. Use this to control the size of the result set.
The page index for pagination. Use this to navigate through multiple pages of results. Must be greater than 0 (starts at 1 for the first page).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_CUSTOMERSTool to retrieve a paginated list of customers from Altoviz. Use when you need to browse all customers, search for customers by name/email/company, or fetch multiple customers at once. Supports pagination, sorting, and full-text search across customer fields.
Input parameters
Full text search query to filter customers. Searches across customer fields like name, email, company name, etc.
Field name to sort the results by. Specify the customer field to use for ordering the list (e.g., 'name', 'email', 'number').
The number of customers to return per page. Controls how many results are returned in a single request.
The page index for pagination (1-based, starting from 1). Use this to navigate through multiple pages of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_PRODUCT_FAMILIESTool to retrieve a list of product families from Altoviz. Use when you need to browse available product families, search for specific families, or get family information for product categorization.
Input parameters
Full-text search query to filter product families. Searches across all text fields in product families.
Field name to sort the results by. Specify the field name from the product family object (e.g., 'label', 'number').
Number of product families to return per page. Use for pagination control.
One-based page index for pagination. Use this to navigate through multiple pages of results. Must be greater than 0.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_RECEIPTSTool to retrieve a list of receipts from Altoviz. Use this when you need to view, search, or filter receipts by pagination, ordering, or full-text search.
Input parameters
Full text search query to filter receipts. Use this to search across receipt fields like reference, customer name, or notes.
Field name to sort the results by. Specify the field to order the receipt list (e.g., 'date', 'amount').
The number of receipts to return per page. Controls how many items are returned in a single request.
The zero-based page index for pagination. Use this to navigate through multiple pages of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_SALE_CREDITSTool to retrieve a list of sale credits from Altoviz. Use when you need to view credit notes issued to customers, filter by date range, or find credits for a specific customer. Supports pagination and sorting for efficient data retrieval.
Input parameters
Filter credits up to this date (inclusive). Format: YYYY-MM-DD.
Filter credits from this date onwards (inclusive). Format: YYYY-MM-DD.
The field to order results by. Common values include 'date', 'number', 'customerName'.
The number of items to return per page. Recommended range is 1-100.
The page index for pagination (zero-based). Use this to navigate through multiple pages of results.
Filter credits by specific customer ID. Only credits for this customer will be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_SALE_INVOICESTool to retrieve a list of sale invoices from Altoviz. Use when you need to view invoices issued to customers, filter by date range, status, or find invoices for a specific customer. Supports pagination, sorting, and status filtering for efficient data retrieval.
Input parameters
Filter invoices up to this date (inclusive). Format: YYYY-MM-DD.
Filter invoices from this date onwards (inclusive). Format: YYYY-MM-DD.
Filter invoices by status. Choose from Draft, Incoming, Expired, Paid, or ToSend.
The field to order results by. Common values include 'date', 'number', 'customerName'.
The number of items to return per page. Recommended range is 1-100.
The page index for pagination (one-based). Must be greater than 0. Use this to navigate through multiple pages of results.
Filter invoices by specific customer ID. Only invoices for this customer will be returned.
Indicates whether cancelled invoices should be included in the results. Default is false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_SALE_QUOTESTool to retrieve a list of sale quotes from Altoviz. Use when you need to view quotes issued to customers, filter by date range, or find quotes for a specific customer. Supports pagination and sorting for efficient data retrieval.
Input parameters
Filter quotes up to this date (inclusive). Format: YYYY-MM-DD.
Filter quotes from this date onwards (inclusive). Format: YYYY-MM-DD.
The field to order results by. Common values include 'date', 'number', 'customerName'.
The number of items to return per page. Recommended range is 1-100.
The page index for pagination (zero-based). Use this to navigate through multiple pages of results.
Filter quotes by specific customer ID. Only quotes for this customer will be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_SUPPLIERSTool to retrieve a paginated list of suppliers from Altoviz. Use when you need to browse all suppliers, search for suppliers by name/email/company, or fetch multiple suppliers at once. Supports pagination, sorting, and full-text search across supplier fields.
Input parameters
Full text search query to filter suppliers. Searches across supplier fields like name, email, company information, etc.
Field name to sort the results by. Specify the supplier field to use for ordering the list (e.g., 'name', 'number', 'email').
The number of suppliers to return per page. Controls how many results are returned in a single request. Must be between 1 and 100.
The page index for pagination (1-based). Use this to navigate through multiple pages of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_LIST_WEBHOOKSTool to retrieve all configured webhooks from Altoviz. Use when you need to view all webhook configurations, including their URLs, event types, and authentication details.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_REGISTER_WEBHOOKTool to register a new webhook in Altoviz. Use when you need to receive real-time notifications for events like customer creation, invoice updates, or product changes.
Input parameters
Webhook URL where events will be sent (must be a valid HTTPS endpoint)
Name of the webhook for identification purposes
List of event types that will trigger this webhook. Select one or more events to monitor.
Optional secret key for webhook authentication and signature verification
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_TEST_API_KEYTool to test API key validity and retrieve basic account information. Use this action to verify that the API key is working correctly and to get basic information about the authenticated account.
Input parameters
Optional API version parameter to use for the request
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_UNREGISTER_WEBHOOKTool to unregister a webhook from Altoviz. Use when you need to remove a webhook configuration. Either webhook ID or URL must be provided to identify which webhook to unregister.
Input parameters
Webhook ID to unregister. Either id or url must be provided.
Webhook URL to unregister. Either id or url must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_UPDATE_COLLEAGUEUpdates an existing colleague's information in Altoviz. Only fields that are provided will be updated; omitted fields retain their current values. Use this action to modify colleague details such as contact information, partner status, and associated metadata.
Input parameters
The unique identifier of the colleague to update
Full name of the colleague
Email address of the colleague
Phone number of the colleague
Title or position of the colleague
Colleague number/reference code
User identifier associated with the colleague
Last name of the colleague
Metadata associated with the colleague as key-value pairs
Cell phone number of the colleague
First name of the colleague
Indicates if the colleague is a partner
Internal identifier for the colleague, useful for integration with external systems
Homecare service number associated with the colleague
Initial balance for the partner (if the colleague is a partner)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_UPDATE_CUSTOMERUpdates an existing customer's information in Altoviz. Only fields that are provided will be updated; omitted fields retain their current values. Important: For Individual customers, you must provide either last_name or company_name. Setting company_name will change the customer type to Company. Use ALTOVIZ_FIND_CUSTOMER first to look up customer IDs by email address.
Input parameters
Customer's email address
Customer's landline/office phone number
Customer's title/salutation
Customer's last name. Required for Individual-type customers when company_name is not set.
Customer's mobile/cell phone number
Customer's first name (for Individual-type customers)
The unique Altoviz customer ID. Use ALTOVIZ_FIND_CUSTOMER to look up customer IDs by email.
Your own unique identifier for this customer, useful for integration with external systems
Company name. Required for Company-type customers. Setting this changes customer type to Company.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_UPDATE_RECEIPTUpdates an existing receipt in Altoviz. Only fields that are provided will be updated; omitted fields retain their current values. Use this to modify receipt details such as amount, date, payment method, status, or notes.
Input parameters
Receipt ID to update
Receipt date in ISO 8601 format (YYYY-MM-DD)
Links to mark documents (invoices, quotes, etc.) as paid by this receipt
Notes or comments about the receipt
Receipt amount. Must be provided when updating receipt details.
Receipt status.
Custom metadata as key-value pairs for integration purposes
Payment reference or transaction ID
Customer ID associated with the receipt
Your internal reference ID for this receipt
Customer name (read-only, auto-populated from customer)
Payment method for a receipt.
Customer number/reference code
Your internal customer identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_UPDATE_SALE_CREDITTool to update a draft credit note in Altoviz. Use when you need to modify an existing draft credit. Only draft credits can be updated; finalized credits cannot be modified.
Input parameters
Credit ID to update. Use ALTOVIZ_FIND_SALE_CREDIT to look up credit IDs.
Date of the credit note in YYYY-MM-DD format
Line items for the credit note. Each line should include fields like productId, quantity, price, description, etc.
Tax region for this credit note. Must be one of: FR (France), EU (European Union), IE (Ireland), DOM (French overseas territories), Corse (Corsica), Monaco
Set to true to keep as draft, false to finalize. Only draft credits can be modified.
Subject/title for the credit note
VAT mode: Auto (automatic), Debit (on invoice), or Collection (on payment)
VAT note to print on the credit note
Additional metadata as key-value pairs
Customer ID to associate with this credit note
Your own internal reference ID for this credit note
Notes to print in the footer section of the credit note
Notes to print in the header section of the credit note
Indicates whether the document is liable to VAT
Shipping VAT details
Customer name to display on the credit note
Internal notes (not printed on the credit note)
Billing address for the customer
Billing contact information
Customer reference number
Global discount applied to the entire credit note
Shipping amount to include in the credit note
Shipping address for the customer
Shipping contact information
Vendor reference to be printed
Set to true if VAT reverse charge applies
Customer's VAT registration number
ID of the invoice this credit note cancels/refunds
Set to true if prices include tax/VAT, false if prices are pre-tax amounts
Customer's order reference number
Number of the invoice this credit note cancels/refunds
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_UPDATE_SUPPLIERUpdates an existing supplier's information in Altoviz. Only fields that are provided will be updated; omitted fields retain their current values. Use this when you need to modify supplier details such as contact information, address, payment terms, or internal notes.
Input parameters
The unique Altoviz supplier ID to update
Company name of the supplier
Supplier's email address
Supplier's phone number
Title/salutation for the supplier contact
Supplier reference number
Supplier's address information
Last name of the supplier contact person
Supplier's mobile/cell phone number
First name of the supplier contact person
Your own unique identifier for this supplier, useful for integration with external systems
Private notes about the supplier (not visible to supplier)
Company registration information (SIRET, VAT number)
Default payment method for this supplier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ALTOVIZ_UPLOAD_PURCHASE_INVOICETool to upload and create a new purchase invoice from a file (PDF or image format). Use when you need to create a purchase invoice by uploading a document.
Input parameters
The purchase invoice file to upload (PDF or image format).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 89 agents privately built on Nagent that already use Altoviz.
Build on Nagent
Connect Altoviz to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Altoviz, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Altoviz is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Altoviz is connected, you configure its 67 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Altoviz steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Altoviz event fires, the agent kicks off automatically.
Every Altoviz action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Altoviz ships with 67 pre-built accounting actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Altoviz together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Altoviz-based workflows tailored to your business.