> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Altoviz

The Altoviz connector lets your AI agent act in each user's Altoviz account. Each user connects their own Altoviz API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** API Key
**Categories:** Accounting & Finance
**Tools:** 60: 33 read, 20 write, 7 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ALTOVIZ)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Altoviz connection

   In **AgentKit > Connections**, create an Altoviz connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'altoviz'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Altoviz:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'altoviz_current_user_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "altoviz"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Altoviz:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="altoviz_current_user_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Altoviz credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'altoviz_cash_flow_get',
  toolInput: {},
  connector: 'altoviz',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="altoviz_cash_flow_get",
    tool_input={},
    connection_name="altoviz",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `altoviz_cash_flow_get`

Get Cash Flow · Read-only

Get settled, outstanding and projected cash flow, bucketed by period.
Returns income and expenses per period.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cumulative` (`boolean`, optional): Return running totals instead of per-bucket values. Example: true.
- `from` (`string`, optional): First day of the period. Combined with to, takes precedence over year. Example: example.
- `periodicity` (`string`, optional): Bucket size: Daily, Weekly, Monthly (default), Quarterly or Annually. Example: Daily. One of: `Daily`, `Weekly`, `Monthly`, `Quarterly`, `Annually`.
- `to` (`string`, optional): Last day of the period, included. Example: example.
- `year` (`integer`, optional): Shorthand for a whole calendar year (defaults to the current one). Ignored when a range is given. Example: 1.

Example input: `{}`

### `altoviz_connection_test`

Test Connection · Read-only

Check that the API key works.
Returns a greeting with the account name.
Run it first to confirm the connection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `api_version` (`string`, optional): API Version. Example: example.

Example input: `{}`

### `altoviz_contact_get`

Get Contact · Read-only

Get one contact person by ID.
Returns the contact's name, company, email, phones and function.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Altoviz ID of the contact. Example: 123456.

Example input: `{"contact_id":123456}`

### `altoviz_contacts_list`

List Contacts · Read-only

List contact people, with paging, sorting and a text search.
Returns each contact's ID, name, company, email, phone and function.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `query` (`string`, optional): Text to search for. Example: Martin.

Example input: `{}`

### `altoviz_current_user_get`

Get Current User · Read-only

Get the Altoviz user and company the API key belongs to.
Returns the user's name, email and company.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `altoviz_customer_contacts_list`

List Customer Contacts · Read-only

List the contact people of a customer.
Returns each contact's name, email, phone and function.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Altoviz ID of the customer. Example: 123456.

Example input: `{"customer_id":123456}`

### `altoviz_customer_find`

Find Customer · Read-only

Find a customer by email, number or your internal ID.
Returns the matching customer.
Use altoviz_customers_list to browse or search by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, optional): Customer email address. Example: anna.martin@acme.fr.
- `internal_id` (`string`, optional): Your own ID stored in the customer's internal_id. Example: crm-1001.
- `number` (`string`, optional): Customer number in Altoviz. Example: C00012.

Example input: `{}`

### `altoviz_customer_get`

Get Customer · Read-only

Get one customer by Altoviz ID.
Returns the customer's details, addresses, billing options and company information.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Altoviz ID of the customer. Example: 123456.

Example input: `{"customer_id":123456}`

### `altoviz_customer_get_by_internal_id`

Get Customer by Internal ID · Read-only

Get a customer by the ID your own system stored in internal_id.
Returns the customer, or 404 if none matches.
Use it to sync with a CRM without a mapping table.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `internal_id` (`string`, required): Your own ID stored in the record's internal_id field. Example: crm-1001.

Example input: `{"internal_id":"<internal_id>"}`

### `altoviz_customers_list`

List Customers · Read-only

List customers, with paging, sorting and a text search.
Returns each customer's ID, number, name, email, phone, type and addresses.
Use altoviz_customer_find to look one up by email, number or internal ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `query` (`string`, optional): Text to search for. Example: Acme.

Example input: `{}`

### `altoviz_product_families_list`

List Product Families · Read-only

List product families.
Returns each family's ID, number and label.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `query` (`string`, optional): query (full text search). Example: example.

Example input: `{}`

### `altoviz_product_find`

Find Product · Read-only

Find a product by number or your internal ID.
Returns the matching product.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `internal_id` (`string`, optional): Your own ID stored in the product's internal_id. Example: sku-cons.
- `number` (`string`, optional): Product number. Example: P-CONS.

Example input: `{}`

### `altoviz_product_get`

Get Product · Read-only

Get one product by Altoviz ID.
Returns the product's name, prices, VAT, unit and family.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`integer`, required): Altoviz ID of the product. Example: 123456.

Example input: `{"product_id":123456}`

### `altoviz_products_list`

List Products · Read-only

List products and services in the catalogue, with paging, sorting and a text search.
Returns each product's ID, number, name, prices, VAT and unit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `family_id` (`string`, optional): Family ID. Example: 1234567890.
- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `query` (`string`, optional): Text to search for. Example: Consulting.

Example input: `{}`

### `altoviz_receipts_list`

List Receipts · Read-only

List customer payments received (receipts), with paging.
Returns each receipt's ID, customer, amount, date, method and linked invoices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `query` (`string`, optional): query (full text search). Example: example.

Example input: `{}`

### `altoviz_sales_credit_get`

Get Credit Note · Read-only

Get one sales credit note by ID.
Returns the credit note's customer, lines, totals and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sales_credit_id` (`integer`, required): Altoviz ID of the sales credit. Example: 123456.

Example input: `{"sales_credit_id":123456}`

### `altoviz_sales_credits_list`

List Credit Notes · Read-only

List sales credit notes, with filters and paging.
Returns each credit note's ID, number, customer, date, amounts and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cancelled` (`string`, optional): Cancelled credits: Excluded (default, when omitted) hides them, Only returns just cancelled credits, All returns both. Example: Only. One of: `Only`, `Excluded`, `All`.
- `customer_id` (`integer`, optional): Only credit notes of this customer. Example: 123456.
- `from` (`string`, optional): Only credit notes dated on or after this date, YYYY-MM-DD. Example: 2026-01-01.
- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `processed` (`string`, optional): Processed credits — those whose terminal e-invoicing status was taken into account ("traitées"): Excluded (default, when omitted) hides them, Only returns just processed credits, All returns both. Example: Only. One of: `Only`, `Excluded`, `All`.
- `to` (`string`, optional): Only credit notes dated on or before this date, YYYY-MM-DD. Example: 2026-12-31.

Example input: `{}`

### `altoviz_sales_invoice_einvoicing_check`

Check E-Invoicing Compliance · Read-only

Check a draft sales invoice against the e-invoicing rules before finalizing.
Returns the problems found, if any.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `sales_invoice_id` (`integer`, required): Altoviz ID of the sales invoice. Example: 123456.

Example input: `{"sales_invoice_id":123456}`

### `altoviz_sales_invoice_find`

Find Sales Invoice · Read-only

Find sales invoices by number or your internal ID.
Returns the matching invoices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `internal_id` (`string`, optional): Your own ID stored in the invoice's internal_id. Example: crm-inv-1001.
- `number` (`string`, optional): Invoice number. Example: F2026-0042.

Example input: `{}`

### `altoviz_sales_invoice_get`

Get Sales Invoice · Read-only

Get one sales invoice by ID.
Returns the invoice's customer, lines, totals, VAT breakdown, balance, status and PDF link.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sales_invoice_id` (`integer`, required): Altoviz ID of the sales invoice. Example: 123456.

Example input: `{"sales_invoice_id":123456}`

### `altoviz_sales_invoices_list`

List Sales Invoices · Read-only

List sales invoices, with filters by date, customer and status, and paging.
Returns each invoice's ID, number, customer, date, amounts, balance and status.
Use altoviz_sales_invoice_get for the lines.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cancelled` (`string`, optional): Cancelled invoices: Excluded (default) hides them, Only returns just cancelled invoices, All returns both. Example: Excluded. One of: `Only`, `Excluded`, `All`.
- `customer_id` (`integer`, optional): Only invoices of this customer. Example: 123456.
- `from` (`string`, optional): Only invoices dated on or after this date, YYYY-MM-DD. Example: 2026-01-01.
- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `processed` (`string`, optional): Processed (e-invoicing terminal status) invoices: Excluded (default), Only or All. Example: Excluded. One of: `Only`, `Excluded`, `All`.
- `status` (`string`, optional): Status. Example: Draft. One of: `Draft`, `Incoming`, `Expired`, `Paid`, `ToSend`.
- `to` (`string`, optional): Only invoices dated on or before this date, YYYY-MM-DD. Example: 2026-12-31.

Example input: `{}`

### `altoviz_sales_quote_get`

Get Sales Quote · Read-only

Get one sales quote by ID.
Returns the quote's customer, lines, totals, validity date and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sales_quote_id` (`integer`, required): Altoviz ID of the sales quote. Example: 123456.

Example input: `{"sales_quote_id":123456}`

### `altoviz_sales_quotes_list`

List Sales Quotes · Read-only

List sales quotes, with filters and paging.
Returns each quote's ID, number, customer, date, amounts and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, optional): Only quotes of this customer. Example: 123456.
- `from` (`string`, optional): Only quotes dated on or after this date, YYYY-MM-DD. Example: 2026-01-01.
- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `status_customer_id` (`integer`, optional): Customer ID. Example: 1.
- `status_from` (`string`, optional): From. Example: example.
- `status_status_customer_id` (`integer`, optional): Customer ID. Example: 1.
- `status_status_from` (`string`, optional): From. Example: example.
- `status_status_status` (`object`, optional): Status. Example: {}.
- `status_status_to` (`string`, optional): To. Example: example.
- `status_to` (`string`, optional): To. Example: example.
- `to` (`string`, optional): Only quotes dated on or before this date, YYYY-MM-DD. Example: 2026-12-31.

Example input: `{}`

### `altoviz_settings_get`

Get Settings · Read-only

Get the company's Altoviz settings, such as numbering, currency, VAT and payment terms.
Returns the settings object.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `altoviz_supplier_find`

Find Supplier · Read-only

Find a supplier by email.
Returns the matching supplier.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, optional): Supplier email address. Example: billing@supplier.fr.
- `internal_id` (`string`, optional): Supplier internal ID. Example: crm-1001.

Example input: `{}`

### `altoviz_supplier_get`

Get Supplier · Read-only

Get one supplier by Altoviz ID.
Returns the supplier's details and addresses.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `supplier_id` (`integer`, required): Altoviz ID of the supplier. Example: 123456.

Example input: `{"supplier_id":123456}`

### `altoviz_suppliers_list`

List Suppliers · Read-only

List suppliers, with paging, sorting and a text search.
Returns each supplier's ID, number, name, email and addresses.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_by` (`string`, optional): Field to sort by. Example: number.
- `page_index` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Items per page. Example: 50.
- `query` (`string`, optional): Text to search for. Example: Office.

Example input: `{}`

### `altoviz_top_overdue_customers_get`

Get Top Overdue Customers · Read-only

List customers with overdue payments, ranked by amount outstanding.
Returns each customer with overdue amount and days.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `take` (`integer`, optional): How many customers to return (1–20, defaults to 5). Example: 1.

Example input: `{}`

### `altoviz_turnover_evolution_get`

Get Turnover Evolution · Read-only

Get turnover over a period, bucketed by month or another periodicity, optionally compared with the previous period and filtered by customer, supplier, colleague or product.
Returns the turnover series and totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `colleague_id` (`integer`, optional): Filter by colleague ID. Example: 11.
- `compare` (`integer`, optional): Number of previous periods to return alongside, each one calendar year further back (0–2, defaults to 0). Example: 1.
- `cumulative` (`boolean`, optional): Return running totals instead of per-bucket values. Example: false.
- `customer_id` (`integer`, optional): Filter by customer ID. Example: 123456.
- `from` (`string`, optional): First day of the period. Combined with to, takes precedence over year. Example: 2026-01-01.
- `periodicity` (`string`, optional): Bucket size: Daily, Weekly, Monthly (default), Quarterly or Annually. Example: Daily. One of: `Daily`, `Weekly`, `Monthly`, `Quarterly`, `Annually`.
- `product_id` (`integer`, optional): Filter by product ID. Example: 345678.
- `supplier_id` (`integer`, optional): Filter by supplier ID. Example: 234567.
- `to` (`string`, optional): Last day of the period, included. Example: 2026-12-31.
- `type` (`string`, optional): Dimension to break down by. Example: Sales. One of: `Sales`, `Expenses`, `Customer`, `Supplier`, `Product`, `Colleague`, `Margin`, `Discount`.
- `year` (`integer`, optional): Shorthand for a whole calendar year (defaults to the current one). Ignored when a range is given. Example: 2026.

Example input: `{}`

### `altoviz_units_list`

List Units · Read-only

List the units of measure.
Returns each unit's ID and label to use in products.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `altoviz_unpaid_invoices_get`

Get Unpaid Invoices Aging · Read-only

Get the aged balance of money customers owe, bucketed by how overdue it is.
Returns totals per aging bucket.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `altoviz_vats_list`

List VAT Rates · Read-only

List the VAT rates available in the account.
Returns each rate and region to use in document lines and products.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `altoviz_webhooks_list`

List Webhooks · Read-only

List the registered webhooks.
Returns each webhook's ID, name, URL and event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `altoviz_contact_create`

Create Contact · Write

Create a contact person.
Returns the new contact with its ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `cell_phone` (`string`, optional): Cell Phone. Example: +33 6 12 34 56 78.
- `company_name` (`string`, optional): Company Name. Example: Acme SAS.
- `email` (`string`, optional): Email. Example: anna.martin@acme.fr.
- `first_name` (`string`, optional): First Name. Example: Anna.
- `function` (`string`, optional): Function. Example: CFO.
- `internal_id` (`string`, optional): ID used in your system. Example: crm-c-55.
- `last_name` (`string`, optional): Last Name. Example: Martin.
- `phone` (`string`, optional): Phone. Example: +33 1 23 45 67 89.
- `service` (`string`, optional): Service. Example: Finance.
- `title` (`string`, optional): Title. Example: Mme.

Example input: `{}`

### `altoviz_contact_update`

Update Contact · Write

Update a contact person's details.
Returns the updated contact.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Altoviz ID of the contact. Example: 123456.
- `cell_phone` (`string`, optional): Cell Phone. Example: +33 6 12 34 56 78.
- `company_name` (`string`, optional): Company Name. Example: Acme SAS.
- `email` (`string`, optional): Email. Example: anna.martin@acme.fr.
- `first_name` (`string`, optional): First Name. Example: Anna.
- `function` (`string`, optional): Function. Example: CFO.
- `internal_id` (`string`, optional): ID used in your system. Example: crm-c-55.
- `last_name` (`string`, optional): Last Name. Example: Martin.
- `phone` (`string`, optional): Phone. Example: +33 1 23 45 67 89.
- `service` (`string`, optional): Service. Example: Finance.
- `title` (`string`, optional): Title. Example: Mme.

Example input: `{"contact_id":123456}`

### `altoviz_customer_create`

Create Customer · Write

Create a customer.
Returns the new customer with its ID and number.
Set internal_id to your own ID so you can find it later.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `active` (`boolean`, optional): false to archive the record. Example: true.
- `billing_address` (`object`, optional): Billing address with street, zipcode, city and countryIso. Example: {"street": "1 rue de Rivoli", "zipcode": "75001", "city": "Paris", "countryIso": "FR"}.
- `cell_phone` (`string`, optional): Cell phone number. Example: +33 6 12 34 56 78.
- `company_name` (`string`, optional): Company name, for a business. Example: Acme SAS.
- `email` (`string`, optional): Email. Example: anna.martin@acme.fr.
- `first_name` (`string`, optional): First name. Example: Anna.
- `internal_id` (`string`, optional): Your own ID for this record, to find it later with GetByInternalId. Example: crm-1001.
- `internal_notes` (`string`, optional): Internal notes. Example: Key account.
- `last_name` (`string`, optional): Last name. Example: Martin.
- `metadata` (`object`, optional): Free key-value data for your integration. Example: {"crmId": "1001"}.
- `number` (`string`, optional): Number in Altoviz; leave empty to number it automatically. Example: C00012.
- `phone` (`string`, optional): Phone number. Example: +33 1 23 45 67 89.
- `shipping_address` (`object`, optional): Shipping address, same shape as billing_address. Example: {"street": "1 rue de Rivoli", "zipcode": "75001", "city": "Paris", "countryIso": "FR"}.
- `title` (`string`, optional): Title. Example: Mme.
- `type` (`string`, optional): Customer type: Business, Consumer or Government. Example: Business. One of: `Business`, `Consumer`, `Government`.

Example input: `{}`

### `altoviz_customer_update`

Update Customer · Write

Update a customer's name, contact details, addresses or notes.
Returns the updated customer.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Altoviz ID of the customer. Example: 123456.
- `active` (`boolean`, optional): false to archive the record. Example: true.
- `billing_address` (`object`, optional): Billing address with street, zipcode, city and countryIso. Example: {"street": "1 rue de Rivoli", "zipcode": "75001", "city": "Paris", "countryIso": "FR"}.
- `cell_phone` (`string`, optional): Cell phone number. Example: +33 6 12 34 56 78.
- `company_name` (`string`, optional): Company name, for a business. Example: Acme SAS.
- `email` (`string`, optional): Email. Example: anna.martin@acme.fr.
- `first_name` (`string`, optional): First name. Example: Anna.
- `internal_id` (`string`, optional): Your own ID for this record, to find it later with GetByInternalId. Example: crm-1001.
- `internal_notes` (`string`, optional): Internal notes. Example: Key account.
- `last_name` (`string`, optional): Last name. Example: Martin.
- `metadata` (`object`, optional): Free key-value data for your integration. Example: {"crmId": "1001"}.
- `number` (`string`, optional): Number in Altoviz; leave empty to number it automatically. Example: C00012.
- `phone` (`string`, optional): Phone number. Example: +33 1 23 45 67 89.
- `shipping_address` (`object`, optional): Shipping address, same shape as billing_address. Example: {"street": "1 rue de Rivoli", "zipcode": "75001", "city": "Paris", "countryIso": "FR"}.
- `title` (`string`, optional): Title. Example: Mme.
- `type` (`string`, optional): Customer type: Business, Consumer or Government. Example: Business. One of: `Business`, `Consumer`, `Government`.

Example input: `{"customer_id":123456}`

### `altoviz_product_create`

Create Product · Write

Create a product or service in the catalogue.
Returns the new product with its ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `active` (`boolean`, optional): false to archive the product. Example: true.
- `default_quantity` (`number`, optional): Default quantity. Example: 1.
- `description` (`string`, optional): Description. Example: One day of consulting.
- `internal_id` (`string`, optional): Your own ID for this product. Example: sku-cons.
- `internal_notes` (`string`, optional): Internal notes. Example: Standard rate.
- `metadata` (`object`, optional): Metadata: free-form key/value pairs carried with the product, for an integration to keep its own identifiers and flags against it. Sent as a PATCH, not a replacement: keys you send are added or updated, keys you leave out keep whatever they held, and a key is removed only when you send it as `null`. Omitting the property entirely leaves the whole bag untouched, and `""` stores an empty value rather than removing the key. Example: {"sku": "CONS"}.
- `name` (`string`, optional): Name. Example: Consulting day.
- `number` (`string`, optional): Number. Example: P-CONS.
- `purchase_vat` (`object`, optional): Purchase VAT, same shape as sales_vat. Example: {"rate": 20, "region": "FR"}.
- `sales_vat` (`object`, optional): Sales VAT with rate and region. Example: {"rate": 20, "region": "FR"}.
- `tax_excluded_purchase_price` (`number`, optional): Purchase price excluding tax: the cost the margin is computed on. Example: 0.
- `tax_excluded_sales_price` (`number`, optional): Sale price excluding tax. On update, the price is left unchanged unless this, `taxIncludedSalesPrice` or one of the deprecated price fields is sent. Example: 600.
- `tax_included_sales_price` (`number`, optional): Sale price including tax. Example: 720.
- `type` (`string`, optional): Product or service type. Example: Service. One of: `Product`, `Service`, `Text`.
- `unit` (`object`, optional): Unit of measure as an object with an id from altoviz_units_list. Example: {"id": 1}.

Example input: `{}`

### `altoviz_product_update`

Update Product · Write

Update a product's name, prices, VAT or unit.
Returns the updated product.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`integer`, required): Altoviz ID of the product. Example: 123456.
- `active` (`boolean`, optional): false to archive the product. Example: true.
- `default_quantity` (`number`, optional): Default quantity. Example: 1.
- `description` (`string`, optional): Description. Example: One day of consulting.
- `internal_id` (`string`, optional): Your own ID for this product. Example: sku-cons.
- `internal_notes` (`string`, optional): Internal notes. Example: Standard rate.
- `metadata` (`object`, optional): Metadata: free-form key/value pairs carried with the product, for an integration to keep its own identifiers and flags against it. Sent as a PATCH, not a replacement: keys you send are added or updated, keys you leave out keep whatever they held, and a key is removed only when you send it as `null`. Omitting the property entirely leaves the whole bag untouched, and `""` stores an empty value rather than removing the key. Example: {"sku": "CONS"}.
- `name` (`string`, optional): Name. Example: Consulting day.
- `number` (`string`, optional): Number. Example: P-CONS.
- `purchase_vat` (`object`, optional): Purchase VAT, same shape as sales_vat. Example: {"rate": 20, "region": "FR"}.
- `sales_vat` (`object`, optional): Sales VAT with rate and region. Example: {"rate": 20, "region": "FR"}.
- `tax_excluded_purchase_price` (`number`, optional): Purchase price excluding tax: the cost the margin is computed on. Example: 0.
- `tax_excluded_sales_price` (`number`, optional): Sale price excluding tax. On update, the price is left unchanged unless this, `taxIncludedSalesPrice` or one of the deprecated price fields is sent. Example: 600.
- `tax_included_sales_price` (`number`, optional): Sale price including tax. Example: 720.
- `type` (`string`, optional): Product or service type. Example: Service. One of: `Product`, `Service`, `Text`.
- `unit` (`object`, optional): Unit of measure as an object with an id from altoviz_units_list. Example: {"id": 1}.

Example input: `{"product_id":123456}`

### `altoviz_receipt_create`

Create Receipt · Write

Record a payment received from a customer, optionally linked to invoices.
Returns the new receipt.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`number`, optional): Amount received. Example: 3600.
- `customer_id` (`integer`, optional): ID of the customer who paid. Example: 123456.
- `customer_internal_id` (`string`, optional): Customer number. Example: crm-1001.
- `customer_number` (`string`, optional): Customer number. Example: C00012.
- `date` (`string`, optional): Payment date, YYYY-MM-DD. Example: 2026-06-15.
- `internal_id` (`string`, optional): Internal ID. Example: pay-1001.
- `links` (`array`, optional): Invoices this payment settles, as objects with the invoice id and amount. Example: [{"id": 98765, "amount": 3600}].
- `metadata` (`object`, optional): Free key-value data for your integration. Example: {"bank": "BNP"}.
- `notes` (`string`, optional): Notes. Example: Bank transfer.
- `payment_method` (`string`, optional): Payment method. Example: Transfer. One of: `Transfer`, `Order`, `Check`, `Cash`, `Card`, `Bill`, `Usec`, `OnlinePayment`, `Other`.
- `reference` (`string`, optional): Payment reference. Example: VIR-2026-0615.

Example input: `{}`

### `altoviz_sales_credit_create`

Create Draft Credit Note · Write

Create a draft credit note for a customer with its lines.
Returns the draft credit note with its ID.
Use altoviz_sales_credit_finalize to lock it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `lines` (`array`, required): Lines of the document. Each line has a type (Product, Service, Text, Subtotal.), either a productId (or productInternalId/productNumber) or a description, a quantity, a unit price (taxExcludedPrice or taxIncludedPrice) and a vat with rate and region (FR, EU, .). Example: [{"type": "Service", "description": "Consulting - May", "quantity": 5, "taxExcludedPrice": 600, "vat": {"rate": 20, "region": "FR"}}].
- `billing_address` (`object`, optional): Billing address with street, zipcode, city and countryIso. Example: {"street": "1 rue de Rivoli", "zipcode": "75001", "city": "Paris", "countryIso": "FR"}.
- `customer_id` (`integer`, optional): ID of the customer. Get it from altoviz_customers_list or altoviz_customer_find. Example: 123456.
- `customer_number` (`string`, optional): Customer number, as an alternative to customer_id. Example: C00012.
- `customer_order_reference` (`string`, optional): Customer's purchase order reference. Example: PO-7781.
- `date` (`string`, optional): Document date, YYYY-MM-DD. Example: 2026-05-31.
- `footer_notes` (`string`, optional): Text shown below the lines. Example: Payment within 30 days.
- `global_discount` (`object`, optional): Discount on the whole document: type Percent or Fixed and a value. Example: {"type": "Percent", "value": 10}.
- `header_notes` (`string`, optional): Text shown above the lines. Example: Thank you for your business.
- `internal_id` (`string`, optional): Your own ID for this document. Example: crm-inv-1001.
- `internal_notes` (`string`, optional): Private notes, not shown to the customer. Example: Approved by Anna.
- `metadata` (`object`, optional): Free key-value data for your integration. Example: {"crmDealId": "D-42"}.
- `number` (`string`, optional): Document number; leave empty to number it automatically. Example: AV2026-0003.
- `shipping_amount` (`number`, optional): Shipping cost. Example: 0.
- `subject` (`string`, optional): Subject line. Example: Consulting May 2026.
- `use_tax_included_prices` (`boolean`, optional): true if line prices include tax. Example: false.
- `vat_note` (`string`, optional): VAT mention printed on the document. Example: TVA non applicable, art. 293 B du CGI.

Example input: `{"lines":[{"type":"Service","description":"Consulting - May","quantity":5,"taxExcludedPrice":600,"vat":{"rate":20,"region":"FR"}}]}`

### `altoviz_sales_credit_finalize`

Finalize Credit Note · Write

Finalize a draft credit note: number and lock it.
Returns the finalized credit note.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `sales_credit_id` (`integer`, required): Altoviz ID of the sales credit. Example: 123456.
- `date_adjustment` (`string`, optional): How the credit date is recalculated when it prevents finalization, i.e. when it is earlier than the last finalized credit or too far in the future. None (default): keep the date, finalization fails. MinimumDate: use the date of the last finalized credit. Today: use today's date. When finalizationDate is also supplied, it is used first and this only applies if that date cannot be finalized on. Due dates are recalculated from the resulting date. Example: None. One of: `None`, `MinimumDate`, `Today`.
- `finalization_date` (`string`, optional): Date the credit is finalized on. Defaults to the credit's own date. Example: 2026-01-01T00:00:00Z.

Example input: `{"sales_credit_id":123456}`

### `altoviz_sales_credit_send`

Send Credit Note · Write

Email a finalized credit note to one or more addresses.
Returns an empty response on success.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `emails` (`array`, required): Email addresses to send the credit note to. Example: ["anna.martin@acme.fr"].
- `sales_credit_id` (`integer`, required): Altoviz ID of the sales credit. Example: 123456.

Example input: `{"emails":["anna.martin@acme.fr"],"sales_credit_id":123456}`

### `altoviz_sales_invoice_create`

Create Draft Sales Invoice · Write

Create a draft sales invoice for a customer with its lines.
Returns the draft invoice with its ID and totals.
Use altoviz_sales_invoice_finalize to number and lock it, then altoviz_sales_invoice_send to email it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `lines` (`array`, required): Lines of the document. Each line has a type (Product, Service, Text, Subtotal.), either a productId (or productInternalId/productNumber) or a description, a quantity, a unit price (taxExcludedPrice or taxIncludedPrice) and a vat with rate and region (FR, EU, .). Example: [{"type": "Service", "description": "Consulting - May", "quantity": 5, "taxExcludedPrice": 600, "vat": {"rate": 20, "region": "FR"}}].
- `billing_address` (`object`, optional): Billing address with street, zipcode, city and countryIso. Example: {"street": "1 rue de Rivoli", "zipcode": "75001", "city": "Paris", "countryIso": "FR"}.
- `customer_id` (`integer`, optional): ID of the customer. Get it from altoviz_customers_list or altoviz_customer_find. Example: 123456.
- `customer_number` (`string`, optional): Customer number, as an alternative to customer_id. Example: C00012.
- `customer_order_reference` (`string`, optional): Customer's purchase order reference. Example: PO-7781.
- `date` (`string`, optional): Document date, YYYY-MM-DD. Example: 2026-05-31.
- `footer_notes` (`string`, optional): Text shown below the lines. Example: Payment within 30 days.
- `global_discount` (`object`, optional): Discount on the whole document: type Percent or Fixed and a value. Example: {"type": "Percent", "value": 10}.
- `header_notes` (`string`, optional): Text shown above the lines. Example: Thank you for your business.
- `internal_id` (`string`, optional): Your own ID for this document. Example: crm-inv-1001.
- `internal_notes` (`string`, optional): Private notes, not shown to the customer. Example: Approved by Anna.
- `metadata` (`object`, optional): Free key-value data for your integration. Example: {"crmDealId": "D-42"}.
- `number` (`string`, optional): Document number; leave empty to number it automatically. Example: F2026-0042.
- `shipping_amount` (`number`, optional): Shipping cost. Example: 0.
- `subject` (`string`, optional): Subject line. Example: Consulting May 2026.
- `use_tax_included_prices` (`boolean`, optional): true if line prices include tax. Example: false.
- `vat_note` (`string`, optional): VAT mention printed on the document. Example: TVA non applicable, art. 293 B du CGI.

Example input: `{"lines":[{"type":"Service","description":"Consulting - May","quantity":5,"taxExcludedPrice":600,"vat":{"rate":20,"region":"FR"}}]}`

### `altoviz_sales_invoice_finalize`

Finalize Sales Invoice · Write

Finalize a draft sales invoice: give it its definitive number and lock it.
Returns the finalized invoice.
Run altoviz_sales_invoice_einvoicing_check first for e-invoicing customers.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `sales_invoice_id` (`integer`, required): Altoviz ID of the sales invoice. Example: 123456.
- `date_adjustment` (`string`, optional): How the invoice date is recalculated when it prevents finalization, i.e. when it is earlier than the last finalized invoice or too far in the future. None (default): keep the date, finalization fails. MinimumDate: use the date of the last finalized invoice. Today: use today's date. When finalizationDate is also supplied, it is used first and this only applies if that date cannot be finalized on. Due dates are recalculated from the resulting date. Example: None. One of: `None`, `MinimumDate`, `Today`.
- `finalization_date` (`string`, optional): Date the invoice is finalized on. Defaults to the invoice's own date. Example: 2026-01-01T00:00:00Z.

Example input: `{"sales_invoice_id":123456}`

### `altoviz_sales_invoice_mark_paid`

Mark Sales Invoice Paid · Write

Record a payment on a sales invoice, optionally finalizing it first.
Returns the updated invoice.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): ID of the invoice. Get it from altoviz_sales_invoices_list. Example: 98765.
- `allow_update` (`boolean`, optional): true to allow updating an existing payment. Example: false.
- `amount` (`number`, optional): Amount paid; defaults to the remaining balance. Example: 3600.
- `date` (`string`, optional): Payment date, YYYY-MM-DD. Example: 2026-06-15.
- `finalization_date` (`string`, optional): Date to finalize with, YYYY-MM-DD. Example: 2026-06-15.
- `finalize_invoice` (`boolean`, optional): true to finalize a draft invoice before recording the payment. Example: false.
- `payment_method` (`string`, optional): Payment method. Example: Transfer. One of: `Transfer`, `Order`, `Check`, `Cash`, `Card`, `Bill`, `Usec`, `OnlinePayment`, `Other`.
- `payment_reference` (`string`, optional): Payment reference, such as a transfer ID. Example: VIR-2026-0615.

Example input: `{"invoice_id":98765}`

### `altoviz_sales_invoice_send`

Send Sales Invoice · Write

Email a finalized sales invoice to one or more addresses.
Returns an empty response on success.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `emails` (`array`, required): Email addresses to send the sales invoice to. Example: ["anna.martin@acme.fr"].
- `sales_invoice_id` (`integer`, required): Altoviz ID of the sales invoice. Example: 123456.

Example input: `{"emails":["anna.martin@acme.fr"],"sales_invoice_id":123456}`

### `altoviz_sales_invoice_update`

Update Draft Sales Invoice · Write

Update a draft sales invoice's customer, date, lines or notes.
Returns the updated invoice.
Finalized invoices cannot change; issue a credit note instead.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sales_invoice_id` (`integer`, required): Altoviz ID of the sales invoice. Example: 123456.
- `billing_address` (`object`, optional): Billing address with street, zipcode, city and countryIso. Example: {"street": "1 rue de Rivoli", "zipcode": "75001", "city": "Paris", "countryIso": "FR"}.
- `customer_id` (`integer`, optional): ID of the customer. Get it from altoviz_customers_list or altoviz_customer_find. Example: 123456.
- `customer_number` (`string`, optional): Customer number, as an alternative to customer_id. Example: C00012.
- `customer_order_reference` (`string`, optional): Customer's purchase order reference. Example: PO-7781.
- `date` (`string`, optional): Document date, YYYY-MM-DD. Example: 2026-05-31.
- `footer_notes` (`string`, optional): Text shown below the lines. Example: Payment within 30 days.
- `global_discount` (`object`, optional): Discount on the whole document: type Percent or Fixed and a value. Example: {"type": "Percent", "value": 10}.
- `header_notes` (`string`, optional): Text shown above the lines. Example: Thank you for your business.
- `internal_id` (`string`, optional): Your own ID for this document. Example: crm-inv-1001.
- `internal_notes` (`string`, optional): Private notes, not shown to the customer. Example: Approved by Anna.
- `lines` (`array`, optional): Lines of the document. Each line has a type (Product, Service, Text, Subtotal.), either a productId (or productInternalId/productNumber) or a description, a quantity, a unit price (taxExcludedPrice or taxIncludedPrice) and a vat with rate and region (FR, EU, .). Example: [{"type": "Service", "description": "Consulting - May", "quantity": 5, "taxExcludedPrice": 600, "vat": {"rate": 20, "region": "FR"}}].
- `metadata` (`object`, optional): Free key-value data for your integration. Example: {"crmDealId": "D-42"}.
- `number` (`string`, optional): Document number; leave empty to number it automatically. Example: F2026-0042.
- `shipping_amount` (`number`, optional): Shipping cost. Example: 0.
- `subject` (`string`, optional): Subject line. Example: Consulting May 2026.
- `use_tax_included_prices` (`boolean`, optional): true if line prices include tax. Example: false.
- `vat_note` (`string`, optional): VAT mention printed on the document. Example: TVA non applicable, art. 293 B du CGI.

Example input: `{"sales_invoice_id":123456}`

### `altoviz_sales_quote_create`

Create Sales Quote · Write

Create a sales quote for a customer with its lines.
Returns the quote with its ID, number and totals.
Use altoviz_sales_quote_send to email it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `lines` (`array`, required): Lines of the document. Each line has a type (Product, Service, Text, Subtotal.), either a productId (or productInternalId/productNumber) or a description, a quantity, a unit price (taxExcludedPrice or taxIncludedPrice) and a vat with rate and region (FR, EU, .). Example: [{"type": "Service", "description": "Consulting - May", "quantity": 5, "taxExcludedPrice": 600, "vat": {"rate": 20, "region": "FR"}}].
- `billing_address` (`object`, optional): Billing address with street, zipcode, city and countryIso. Example: {"street": "1 rue de Rivoli", "zipcode": "75001", "city": "Paris", "countryIso": "FR"}.
- `customer_id` (`integer`, optional): ID of the customer. Get it from altoviz_customers_list or altoviz_customer_find. Example: 123456.
- `customer_number` (`string`, optional): Customer number, as an alternative to customer_id. Example: C00012.
- `customer_order_reference` (`string`, optional): Customer's purchase order reference. Example: PO-7781.
- `date` (`string`, optional): Document date, YYYY-MM-DD. Example: 2026-05-31.
- `footer_notes` (`string`, optional): Text shown below the lines. Example: Payment within 30 days.
- `global_discount` (`object`, optional): Discount on the whole document: type Percent or Fixed and a value. Example: {"type": "Percent", "value": 10}.
- `header_notes` (`string`, optional): Text shown above the lines. Example: Thank you for your business.
- `internal_id` (`string`, optional): Your own ID for this document. Example: crm-inv-1001.
- `internal_notes` (`string`, optional): Private notes, not shown to the customer. Example: Approved by Anna.
- `metadata` (`object`, optional): Free key-value data for your integration. Example: {"crmDealId": "D-42"}.
- `number` (`string`, optional): Document number; leave empty to number it automatically. Example: D2026-0012.
- `shipping_amount` (`number`, optional): Shipping cost. Example: 0.
- `subject` (`string`, optional): Subject line. Example: Consulting May 2026.
- `use_tax_included_prices` (`boolean`, optional): true if line prices include tax. Example: false.
- `validity_date` (`string`, optional): Date the quote expires, YYYY-MM-DD. Example: 2026-06-30.
- `vat_note` (`string`, optional): VAT mention printed on the document. Example: TVA non applicable, art. 293 B du CGI.

Example input: `{"lines":[{"type":"Service","description":"Consulting - May","quantity":5,"taxExcludedPrice":600,"vat":{"rate":20,"region":"FR"}}]}`

### `altoviz_sales_quote_send`

Send Sales Quote · Write

Email a sales quote to one or more addresses.
Returns an empty response on success.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `emails` (`array`, required): Email addresses to send the sales quote to. Example: ["anna.martin@acme.fr"].
- `sales_quote_id` (`integer`, required): Altoviz ID of the sales quote. Example: 123456.

Example input: `{"emails":["anna.martin@acme.fr"],"sales_quote_id":123456}`

### `altoviz_supplier_create`

Create Supplier · Write

Create a supplier.
Returns the new supplier with its ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `active` (`boolean`, optional): false to archive the record. Example: true.
- `cell_phone` (`string`, optional): Cell phone number. Example: +33 6 12 34 56 78.
- `email` (`string`, optional): Email. Example: billing@supplier.fr.
- `first_name` (`string`, optional): First name. Example: Anna.
- `internal_id` (`string`, optional): Your own ID for this record, to find it later with GetByInternalId. Example: erp-sup-7.
- `internal_notes` (`string`, optional): Internal notes. Example: Key account.
- `last_name` (`string`, optional): Last name. Example: Martin.
- `number` (`string`, optional): Number in Altoviz; leave empty to number it automatically. Example: S00007.
- `phone` (`string`, optional): Phone number. Example: +33 1 23 45 67 89.
- `title` (`string`, optional): Title. Example: Mme.

Example input: `{}`

### `altoviz_supplier_update`

Update Supplier · Write

Update a supplier's details or addresses.
Returns the updated supplier.
Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `supplier_id` (`integer`, required): Altoviz ID of the customer. Example: 123456.
- `active` (`boolean`, optional): false to archive the record. Example: true.
- `cell_phone` (`string`, optional): Cell phone number. Example: +33 6 12 34 56 78.
- `email` (`string`, optional): Email. Example: billing@supplier.fr.
- `first_name` (`string`, optional): First name. Example: Anna.
- `internal_id` (`string`, optional): Your own ID for this record, to find it later with GetByInternalId. Example: erp-sup-7.
- `internal_notes` (`string`, optional): Internal notes. Example: Key account.
- `last_name` (`string`, optional): Last name. Example: Martin.
- `number` (`string`, optional): Number in Altoviz; leave empty to number it automatically. Example: S00007.
- `phone` (`string`, optional): Phone number. Example: +33 1 23 45 67 89.
- `title` (`string`, optional): Title. Example: Mme.

Example input: `{"supplier_id":123456}`

### `altoviz_webhook_create`

Create Webhook · Write

Register a webhook URL for Altoviz events.
Returns the new webhook.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the webhook. Example: CRM sync.
- `types` (`array`, required): Event types to send. Example: ["InvoiceCreated", "CustomerCreated"].
- `url` (`string`, required): HTTPS URL Altoviz posts events to. Example: https://example.com/hooks/altoviz.
- `secret_key` (`string`, optional): Secret used to sign the requests. Example: whsec_123.

Example input: `{"name":"<name>","types":["InvoiceCreated","CustomerCreated"],"url":"<url>"}`

### `altoviz_contact_delete`

Delete Contact · Destructive

Delete a contact person.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Altoviz ID of the contact. Example: 123456.

Example input: `{"contact_id":123456}`

### `altoviz_customer_delete`

Delete Customer · Destructive

Delete a customer.
Returns an empty response on success.
Set active to false with altoviz_customer_update to archive instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Altoviz ID of the customer. Example: 123456.

Example input: `{"customer_id":123456}`

### `altoviz_product_delete`

Delete Product · Destructive

Delete a product.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`integer`, required): Altoviz ID of the product. Example: 123456.

Example input: `{"product_id":123456}`

### `altoviz_sales_invoice_delete`

Delete Draft Sales Invoice · Destructive

Delete a draft sales invoice.
Returns an empty response on success.
Finalized invoices cannot be deleted.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `sales_invoice_id` (`integer`, required): Altoviz ID of the sales invoice. Example: 123456.
- `detach_payments` (`boolean`, optional): Detach the payments allocated to the invoice, and keep them unallocated, instead of refusing the deletion. Example: true.

Example input: `{"sales_invoice_id":123456}`

### `altoviz_sales_quote_delete`

Delete Sales Quote · Destructive

Delete a sales quote.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `sales_quote_id` (`integer`, required): Altoviz ID of the sales quote. Example: 123456.

Example input: `{"sales_quote_id":123456}`

### `altoviz_supplier_delete`

Delete Supplier · Destructive

Delete a supplier.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `supplier_id` (`integer`, required): Altoviz ID of the supplier. Example: 123456.

Example input: `{"supplier_id":123456}`

### `altoviz_webhook_delete`

Delete Webhook · Destructive

Unregister a webhook by ID or URL.
Returns an empty response on success.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, optional): ID of the webhook. Get it from altoviz_webhooks_list. Example: 12.
- `url` (`string`, optional): URL of the webhook, instead of the ID. Example: https://example.com/hooks/altoviz.

Example input: `{}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
