Skip to main content
Elorus logo
  • Category: proposal & invoice management
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 21
  • Triggers: 0
  • Slug: ELORUS
  • Version: 20261030_00

Tools

Slug: ELORUS_CREATE_EXPENSECreate an Elorus expense from categorized line items.

Input Parameters

string
Expense date in YYYY-MM-DD format.
array
required
Expense lines; normal lines generally include an expense category and amount.
array
Taxes applied to the expense document.
string
ID of the associated branch.
string
ID of the associated supplier.
string
External identifier, up to 256 characters.
string
Supplier reference or receipt number, up to 150 characters.
string
Three-letter ISO 4217 currency code.
string
Exchange rate as a decimal string with up to six decimal places.
string ("initial" | "total")
Use initial for tax-exclusive or total for tax-inclusive amounts.
array
Tracking categories used to classify the expense.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_CREATE_INVOICECreates a new invoice or receipt in Elorus. Invoices are automatically saved as drafts by default and use the ‘initial’ calculation mode (amounts specified before taxes). Required: issue_date, currency_id (currency code like ‘INR’, ‘EUR’, ‘USD’), client_id (from contacts), kind (‘invoice’ or ‘receipt’), series_id (document type ID), and at least one line item. Use ELORUS_GET_CONTACTS to obtain valid client_id values, and check existing invoices for valid currency codes and series_id (documenttype) values in your organization.

Input Parameters

string ("invoice" | "receipt")
required
Document type: ‘invoice’ for standard invoices or ‘receipt’ for receipts
array
Optional list of tag labels for categorizing the invoice
array
required
Line items for the invoice
string
Optional notes visible to the client on the invoice
number
Optional invoice-level discount amount (must be non-negative)
string
required
Client/customer ID obtained from the contacts list
string
required
Document type ID (also known as ‘documenttype’) that defines the numbering series
string
required
Invoice issue date in ISO-8601 format (YYYY-MM-DD), e.g., ‘2026-01-29’
string
required
Currency code (e.g., ‘INR’, ‘EUR’, ‘USD’) for the invoice
string
Optional payment due date in ISO-8601 format (YYYY-MM-DD), e.g., ‘2026-02-28’
string
Optional custom document number to override auto-generated numbering
string
Optional alternate billing/shipping address ID for the client

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_CREATE_PRODUCTCreate a new product or service in Elorus. Use this to add items to your product catalog with pricing, tax settings, and inventory management options.

Input Parameters

string
Product code (internal reference).
boolean
Whether the product is available for sales. Defaults to True.
string
Initial stock level (required if manage=True).
string
required
Product title/name.
boolean
Whether the product is active. Defaults to True.
boolean
Whether to manage inventory for this product. Defaults to False.
string
Custom product ID.
boolean
Whether the product is available for purchases. Defaults to False.
array
List of tax IDs to apply to sales.
string
Sale price as decimal string.
string
TARIC code for customs declarations (must be at least 10 characters).
string
Product description.
string
Unit of measurement symbol. Must be a valid unit configured in your Elorus account (required if manage=True).
array
List of tax IDs to apply to purchases.
string
Purchase price as decimal string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_DELETE_INVOICEPermanently delete a draft invoice. Issued invoices cannot be deleted.

Input Parameters

string
required
Unique identifier of the draft invoice to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_EMAIL_INVOICETool to email an existing invoice to specified contacts. Use after generating an invoice and obtaining contact IDs.

Input Parameters

array
Optional list of email addresses to CC on the invoice email
array
Optional list of email addresses to BCC on the invoice email
array
required
List of contact IDs to send the invoice email to
string
required
Body text for the invoice email
integer
required
ID of the invoice to send via email
string
required
Subject line for the invoice email

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_BILLSRetrieve a paginated list of bills (expenses/purchases) from Elorus. Supports filtering by supplier, date range, status, and text search. Use this to view and manage bills created in your organization.

Input Parameters

integer
Page number to retrieve, must be >= 1
string
Predefined time period: ‘today’, ‘current_week’, ‘current_month’, ‘current_year’, ‘last_week’, ‘last_month’, ‘last_year’, or ‘last_N_days/weeks/months/years’ (e.g., ‘last_7_days’)
General search term to filter bills
string ("draft" | "pending" | "issued" | "partial" | "unpaid" | "overdue" | "paid" | "void")
Filter by bill status
string
Sort results by field: ‘date’, ‘supplier__display_name’, ‘total’, ‘due_date’, ‘created’, ‘modified’. Prepend ’-’ for descending order (e.g., ‘-date’).
string
Filter by supplier ID
integer
Number of items per page, must be between 1 and 250 (default: 100)
string
Filter bills up to this date (YYYY-MM-DD format). Must be used together with period_from.
string
Filter bills from this date onwards (YYYY-MM-DD format). Must be used together with period_to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_CONTACTRetrieve all current details for one Elorus contact by ID.

Input Parameters

string
required
Unique identifier of the contact to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_CONTACTSTool 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.‘

Input Parameters

integer
Results page number (minimum 1).
string
Full-text search across name, code, VAT, etc.
string
Field to sort by (e.g., ‘name’, ‘created’).
array
Filter by status values (e.g., [‘active’,‘archived’]).
boolean
Filter by contact type: true=company, false=individual.
string ("asc" | "desc")
Sort direction: ‘asc’ or ‘desc’.
array
List of contact IDs to filter (will be comma-separated).
object
Filter by custom fields; map each custom field ID to a value. E.g., {‘42’: ‘Gold member’} => custom_fields[42]=Gold member.
boolean
Include archived contacts when true.
integer
Number of results per page (maximum 200).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_CREDIT_NOTESTool to retrieve a list of credit notes. Use when you need to fetch credit notes filtered by page, contact, date range, or currency.

Input Parameters

integer
Page number to return, must be >= 1
integer
Filter results by contact ID
string
Filter results by ISO 4217 currency code
integer
Number of results per page, must be >= 1
string
Only include credit notes issued on or after this date (YYYY-MM-DD)
string
Only include credit notes issued on or before this date (YYYY-MM-DD)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_EMAIL_TEMPLATESTool to retrieve a list of email templates. Use when you need to fetch and page through existing templates in the organization.

Input Parameters

integer
Page number to retrieve; defaults to first page if omitted
integer
Number of templates per page; defaults to server-side default if omitted

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_ESTIMATESTool to retrieve a list of estimates. Use when you need to list estimates with pagination after creation.

Input Parameters

integer
Page number to retrieve, must be >= 1
integer
Number of items per page, must be between 1 and 100

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_EXPENSERetrieve all current details for one Elorus expense.

Input Parameters

string
required
Unique identifier of the expense.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_EXPENSE_ATTACHMENTSList one Elorus expense’s attachments, one page at a time.

Input Parameters

integer
Page number to retrieve, starting at 1.
integer
Number of attachments to return, from 1 to 250.
string
required
Unique identifier of the expense.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_EXPENSESSearch and filter expenses and return one paginated page of summaries.

Input Parameters

integer
Page number to retrieve, starting at 1
string
Date period: today, current_week, current_month, current_year, last_week, last_month, last_year, or last_<integer>_<days|weeks|months|years>
string
Search term
string
Comma-separated ordering fields: date, branch__branch_name, supplier__display_name, net, total, created, or modified. Prefix a field with - for descending order
string
Supplier ID filter
string
Branch ID filter
string
Exact custom ID filter
integer
Number of expenses to return, from 1 to 250
string
End date in YYYY-MM-DD; use with period_from
string
Start date in YYYY-MM-DD; use with period_to
string
Return records created on or after this date or ISO timestamp
string
ISO 4217 currency code filter
string
Comma-separated fields to search: supplier__display_name, reference, items__description, supplier__vat_number, related_notes__notes, custom_id
string
Return records created on or before this date or ISO timestamp
string
Creation period: today, current_week, current_month, current_year, last_week, last_month, last_year, or last_<integer>_<days|weeks|months|years>
string
Return records modified on or after this date or ISO timestamp
string
Return records modified on or before this date or ISO timestamp
string
Modification period: today, current_week, current_month, current_year, last_week, last_month, last_year, or last_<integer>_<days|weeks|months|years>
object
Tracking category filters as category ID to option mappings; each becomes a tc_<category_id> query parameter

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_INVOICERetrieve all current details for one Elorus invoice.

Input Parameters

string
required
Unique identifier of the invoice to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_INVOICESRetrieves a paginated list of invoices from Elorus with flexible filtering options. Use this tool to: - List all invoices or filter by client, status, date ranges, currency, or tags - Paginate through large invoice lists - Sort invoices by various fields - Search for specific invoice numbers The response includes invoice summaries with key details like client name, amounts, dates, and status, making it suitable for dashboard views, reports, and bulk operations.

Input Parameters

integer
Page number to retrieve, must be >= 1
string
Filter by comma-separated tag names (e.g., ‘urgent,consulting’). Returns invoices matching any of these tags.
string
Filter by exact invoice number (e.g., ‘1’, ‘2’, ‘INV-2023-001’)
string ("draft" | "issued" | "paid" | "cancelled")
Filter by invoice status: ‘draft’ (not sent), ‘issued’ (sent but unpaid), ‘paid’ (fully paid), ‘cancelled’ (voided)
string
Filter by client/contact ID. Use to get all invoices for a specific customer.
string
Filter by ISO 4217 currency code (e.g., ‘USD’, ‘EUR’, ‘INR’). Returns only invoices in specified currency.
string
Sort results by field name. Prefix with ’-’ for descending order (e.g., ‘-date’ for newest first, ‘number’ for ascending).
integer
Number of items per page, must be between 1 and 100
string
Filter invoices due on or after this date (ISO 8601 format: YYYY-MM-DD). Find invoices becoming due soon.
string
Filter invoices due on or before this date (ISO 8601 format: YYYY-MM-DD). Find overdue or soon-due invoices.
string
Filter invoices issued on or after this date (ISO 8601 format: YYYY-MM-DD). Useful for date range queries.
string
Filter invoices issued on or before this date (ISO 8601 format: YYYY-MM-DD). Combine with issue_date__gte for date ranges.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_PRODUCTSTool 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.

Input Parameters

integer
Page number to retrieve, must be >= 1
string
Field to sort by; prefix with ’-’ for descending, e.g. ‘-name’
integer
Number of items per page, must be >= 1
string
Comma-separated list of fields to include in the response, e.g. ‘id,name,price’
string
Filter by matching code or name (partial, case-insensitive)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_TAXESTool to retrieve a list of taxes. Use after authentication to list taxes with optional filters.

Input Parameters

string
Search query to filter taxes
integer
Page number to retrieve, must be >= 1
integer
Number of results per page, must be between 1 and 100

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_GET_TEMPLATESRetrieves document templates used for formatting invoices, estimates, credit notes, and other business documents in Elorus. Templates define the visual layout, language, company branding, and default terms/notes for generated documents. Use this to list available templates, identify the default template, or get template IDs for document creation.

Input Parameters

integer
Page number of results to fetch (must be >= 1)
integer
Number of results per page (1–200)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_UPDATE_CONTACTUpdate an existing contact in Elorus by ID. Allows modifying contact details such as name, company, addresses, and communication preferences. Use this tool when you need to: - Update contact information (name, company, VAT number) - Modify contact addresses, emails, or phone numbers - Change contact type (client/supplier status) - Update language or currency preferences Note: At least one of first_name, last_name, or company must be provided in the update.

Input Parameters

string
required
Unique identifier of the contact to update
array
List of email objects for this contact (each with email and primary fields)
array
List of phone objects for this contact (each with number and primary fields)
string
Company name for business contacts
array
List of addresses for this contact
string
Custom identifier for the contact
boolean
Whether this contact is a client (receives invoices/estimates)
string
Last name of the contact person
string
First name of the contact person
string
Profession or job title of the contact
string
VAT/tax identification number
boolean
Whether this contact is a supplier (sends bills)
string
Default language code for communications (e.g., ‘en’, ‘el’)
string
Default currency code for transactions (e.g., ‘USD’, ‘EUR’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ELORUS_UPDATE_EXPENSEReplace an Elorus expense’s editable details and complete line-item set.

Input Parameters

string
Document net amount as a decimal string with up to two decimal places.
string
Expense date in YYYY-MM-DD format.
array
required
Complete desired line-item list. Existing lines omitted from this list are deleted.
array
Taxes applied to the expense document.
string
Document total as a decimal string with up to two decimal places.
string
ID of the associated branch; set to null to clear it.
string
ID of the associated supplier; set to null to clear it.
string
External identifier, up to 256 characters.
string
Supplier reference or receipt number, up to 150 characters.
string
required
Unique identifier of the expense to update.
string ("AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BYR" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "UYI" | "UYU" | "UZS" | "VED" | "VEF" | "VES" | "VND" | "VUV" | "WST" | "XAF" | "XCD" | "XDR" | "XOF" | "XPF" | "YER" | "ZAR" | "ZMW" | "ZWL")
Three-letter ISO 4217 currency code.
string
Exchange rate as a decimal string with up to six decimal places.
string ("initial" | "total")
Use initial for tax-exclusive or total for tax-inclusive amounts.
array
Tracking categories used to classify the expense.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not