Comax
Look up item catalog, stock balances, prices, and customers from the Comax ERP/POS
The Comax (קומקס) integration connects your agents to the Comax ERP/POS through its Comax_WebServices API, letting them look up the item catalog, current stock balances, item prices, and customer records.
Read-only
This integration currently exposes read-only lookups. It does not create or modify records in Comax.
Prerequisites
You need:
- Login ID — The Comax API user (
LoginID) provisioned for web-service access. - Login Password — The password (
LoginPassword) paired with that Login ID.
Both are issued by your Comax administrator for web-service (API) access — they are sent on every request as query-string credentials. If lookups return empty results, confirm the credentials have web-service permissions enabled in Comax.
Setup
- Open Integrations from the sidebar
- Select Comax from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "Comax - Production")
- Enter the configuration parameters:
- Login ID — Your Comax API user
- For authentication, enter your Login Password
- Save the config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Comax tools from the tools panel
- Tools are referenced as
comax.search_items,comax.search_item_balances, etc.
Searching
The search_* tools accept optional filters that combine with AND — leave a filter empty to ignore it. IDs (item, department, group, supplier, store, price list) are Comax numeric IDs passed as strings, and date filters use the dd/MM/yyyy format. Comax returns results as XML, which the agent reads directly.
Available Tools
Items
| Tool | Description | Action Type |
|---|---|---|
search_items | Search the item catalog and return item details (name, barcode, department, group, supplier) | ReadOnly |
search_item_balances | Search current stock balances (on-hand quantity), optionally scoped to a store/branch | ReadOnly |
search_item_prices | Search item prices across price lists | ReadOnly |
Customers
| Tool | Description | Action Type |
|---|---|---|
search_customers | Search customers by name, ID card, contact details, or customer group | ReadOnly |
get_customer | Get full details for a single customer by customer ID | ReadOnly |