Elorus | Composio Docs

Overview

SLUG: ELORUS

Description

Elorus is an online invoicing and time-tracking software designed for freelancers and small businesses to manage their finances and projects efficiently.

Authentication Details

API Key

generic_api_key

stringRequired

generic_id

stringRequired

Connecting to Elorus

Create an auth config

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

Select App

Navigate to Elorus.

Configure Auth Config Settings

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

Create and Get auth config ID

Click “Create Elorus Auth Config”. 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

1 from composio import Composio
2 
3 # Replace these with your actual values
4 elorus_auth_config_id = "ac_YOUR_ELORUS_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def 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": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Elorus for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, elorus_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

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

For code examples, see the Tool calling guide and Provider examples.

Tool List

ELORUS_CREATE_INVOICE

Tool Name: Create Invoice

Description

Tool to create a new invoice. Use after gathering all invoice details.

Action Parameters

client_id

stringRequired

contact_address_id

currency_id

stringRequired

discount

document_number

issue_date

stringRequired

items

arrayRequired

kind

stringRequired

notes

payable_date

series_id

stringRequired

ELORUS_CREATE_PRODUCT

Tool Name: CREATE_PRODUCT

Description

Tool to create a new product or service in Elorus. Use when you need to add or configure items/services in your product catalog.

Action Parameters

code

description

is_active

name

stringRequired

price

sku

tax_category_id

type

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_EMAIL_INVOICE

Tool Name: Email Invoice

Description

Tool to email an existing invoice to specified contacts. Use after generating an invoice and obtaining contact IDs.

Action Parameters

bcc

contacts

arrayRequired

email_body

stringRequired

email_subject

stringRequired

invoice_id

integerRequired

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_GET_BILLS

Tool Name: Get Bills

Description

Tool to retrieve a list of bills. Use when you need to list bills with optional filters after creation.

Action Parameters

due_date__gte

due_date__lte

issued_at__gte

issued_at__lte

page

page_size

status

supplier

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_GET_CONTACTS

Tool Name: Get Contacts

Description

Tool to retrieve a list of contacts. Use after authentication to fetch contacts in batches. Example: 'List page 2 of active company contacts sorted by name.'

Action Parameters

contact_ids

custom_fields

is_company

items_per_page

order_by

page

show_archived

sort_order

statuses

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_GET_CREDIT_NOTES

Tool Name: Get Credit Notes

Description

Tool to retrieve a list of credit notes. Use when you need to fetch credit notes filtered by page, contact, date range, or currency.

Action Parameters

contact

currency

issued_on__gte

issued_on__lte

page

page_size

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_GET_EMAIL_TEMPLATES

Tool Name: Get Email Templates

Description

Tool to retrieve a list of email templates. Use when you need to fetch and page through existing templates in the organization.

Action Parameters

page

page_size

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_GET_ESTIMATES

Tool Name: Get Estimates

Description

Tool to retrieve a list of estimates. Use when you need to list estimates with pagination after creation.

Action Parameters

page

page_size

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_GET_INVOICES

Tool Name: Get Invoices

Description

Tool to retrieve a list of invoices. Use when you need to list invoices with filtering and pagination options.

Action Parameters

contact

currency

due_date__gte

due_date__lte

issue_date__gte

issue_date__lte

number

ordering

page

page_size

status

ELORUS_GET_PRODUCTS

Tool Name: Get Products

Description

Tool to retrieve a list of products/services with optional filtering, sorting, and pagination. Use when you need to fetch products for reports, UI lists, or inventory management.

Action Parameters

fields

filter

limit

page

sort

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_GET_TAXES

Tool Name: Get Taxes

Description

Tool to retrieve a list of taxes. Use after authentication to list taxes with optional filters.

Action Parameters

page

per_page

Action Response

data

objectRequired

error

successful

booleanRequired

ELORUS_GET_TEMPLATES

Tool Name: Get Templates

Description

Tool to retrieve a list of document templates. Use when you need to list and paginate available templates.

Action Parameters

page

per_page

Action Response

current_page

integerRequired

data

arrayRequired

error

from_index

integerRequired

last_page

integerRequired

next_page_url

per_page

integerRequired

prev_page_url

successful

booleanRequired

integerRequired

total

integerRequired

ELORUS_UPDATE_CONTACT

Tool Name: Update Contact

Description

Tool to update an existing contact by ID. Use when you need to modify contact details after retrieving current information.

Action Parameters

address

city

code

contact_persons

country_id

currency_id

integerRequired

name

notes

phone

postal_code

tax_number

tax_office

vat_status

Action Response

data

objectRequired

error

successful

booleanRequired