Finance

Altoviz

Learn how to use Altoviz with Composio

Overview

SLUG: ALTOVIZ

Description

Altoviz is a cloud-based billing and invoicing platform for businesses, offering online payments, expense tracking, document management, and customizable invoices.

Authentication Details

generic_api_key
stringRequired

Connecting to Altoviz

Create an auth config

Use the dashboard to create an auth config for the Altoviz toolkit. This allows you to connect multiple Altoviz accounts to Composio for agents to use.

1

Select App

Navigate to the Altoviz toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4altoviz_auth_config_id = "ac_YOUR_ALTOVIZ_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": user_api_key}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Altoviz for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, altoviz_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Altoviz toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["ALTOVIZ"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Create Product

Description

Creates a new product in the altoviz system. this tool allows for the independent creation of a product with all necessary details.

Action Parameters

active
booleanRequired
default_quantity
numberRequired
description
stringRequired
family
object
internal_id
string
internal_notes
string
is_unit_price_tax_included
booleanRequired
name
stringRequired
number
stringRequired
product_type
stringRequired
purchase_price
numberRequired
unit
object
unit_price
numberRequired
vat
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Product

Description

This tool allows you to delete an existing product from altoviz. the action permanently removes the product from the system.

Action Parameters

product_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Contact by Email

Description

This tool allows searching for contacts in altoviz using an email address. the action is independently executable and returns contact details if found.

Action Parameters

email
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Customer by Email

Description

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

Action Parameters

email
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Product by Number

Description

This tool allows users to find products in altoviz using the product number. it retrieves detailed product information including id, name, number, description, price, and other relevant metadata. it is a critical operation for product management in altoviz.

Action Parameters

product_number
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Units List

Description

This tool retrieves a list of all available units in the altoviz system. units are used for product measurements and quantity specifications in various transactions.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get VAT Rates

Description

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

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Customer Information

Description

This tool updates an existing customer's information in altoviz. it enables modification of various customer details including contact information, company details, and personal information.

Action Parameters

cell_phone
string
company_name
string
customer_id
stringRequired
email
string
first_name
string
internal_id
string
last_name
string
phone
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Classifications List

Description

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

Action Parameters

type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired