FruxonDocs

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

  1. Open Integrations from the sidebar
  2. Select Comax from the catalog
  3. Click Add Integration Config
  4. Give the config a display name (e.g., "Comax - Production")
  5. Enter the configuration parameters:
    • Login ID — Your Comax API user
  6. For authentication, enter your Login Password
  7. Save the config

Using in Your Agent

  1. Open your agent in Agent Studio. Under Model & capabilities → Tools, click Add tool and add the Comax tools you need
  2. On a tool's card, choose your config under Set default credentials. It applies to every Comax tool in the agent; click Override on one tool's card to give it a different config
  3. 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

ToolDescriptionAction Type
search_itemsSearch the item catalog and return item details (name, barcode, department, group, supplier)ReadOnly
search_item_balancesSearch current stock balances (on-hand quantity), optionally scoped to a store/branchReadOnly
search_item_pricesSearch item prices across price listsReadOnly

Customers

ToolDescriptionAction Type
search_customersSearch customers by name, ID card, contact details, or customer groupReadOnly
get_customerGet full details for a single customer by customer IDReadOnly

On this page