soft1-syncerp — Documentation

Query your Softone ERP (customers, CRM actions, products, stock, sales & invoices) directly from Claude. Read-only by default, multi-tenant, secured with OAuth.

Setup

  1. Sign up at the panel and create your company account. New companies start on a 14-day free trial (unlimited calls). Full access is €50/month or €500/year, with 5 users.
  2. Under Softone settings, enter your connection — either a static clientID token, or your Softone web-user username & password. Click Test connection to confirm. For stock per warehouse, download the free read-only service template, have your Softone partner install and check it, then enter its URL in the panel. If Softone rejects the login (for example invalid credentials), the panel shows that Softone message. Network, DNS and blocked-address failures stay a generic message, without internal details.
  3. Add up to 5 users (your team) under Users.
  4. In Claude → Settings → Connectors → Add custom connector, paste:
    https://mcp.syncerp.gr/mcp
    Log in with your panel email & password when prompted (OAuth).

Available tools

ToolWhat it does
search_customersFind customers by name / code / VAT / phone
get_customerFull customer card (incl. custom fields and balance)
customer_balanceBalance («Υπόλοιπο») from the customer card's financial data
supplier_balanceOfficial supplier balance (TRDFINDATA.LBAL, no sign flip). Multiple matches are returned for you to choose. A bare id is accepted only when the trader is a supplier (SODTYPE 12); a customer id is rejected. No supplier ledger yet.
customer_ledgerCustomer ledger card (debit / credit / running balance), optional Excel
export_customers_excelBulk Excel export with selectable fields, including turnover per period. The download link is single-use and bound to the company that created it
list_crm_actionsCRM actions. Full history for one customer, or a date range. Handler, assigner and salesman are separate. group_by=customer counts scanned rows (cap 1000 per form). counts_complete=false when the scan is cut, a form does not answer, or the date range falls back to the ~5-day window; the reason is in limitations.
list_softone_usersSoftOne login users (USERS) with a stable id
customer_documentsA customer's entire invoice history
customer_last_purchaseLast purchase with line items. A newer Soft1 row is kept when it is not a known non-sale. With turnover sign 0, προτιμολόγιο, παραγγελία, προσφορά, a bare δελτίο αποστολής, απόδειξη είσπραξης, ακυρωτικό and πιστωτικό are skipped even if the name also says λιανικής. Τιμολόγιο - Δελτίο Αποστολής and Τιμολόγιο-Δελτίο Αποστολής stay a purchase.
customer_document_totalsLifetime turnover (net/VAT/gross)
search_items / item_stockProducts & per-warehouse stock
documents_on_dateAll documents on any date
erp_setup_checkChecks how your Softone is set up (columns, date range, document types). No customers or amounts. What it cannot detect goes to ERP settings in the panel.
documents_summaryDaily totals grouped by store / series
get_documentOne full document (header + lines)
recent_documentsRecent documents (last ~5 days)
list_series_labels / remember_series_label / forget_series_labelTeach the connector which document series is which store or channel
list_facts / remember_fact / forget_factBusiness notes the connector should remember for your company

Every tool above is read-only against your ERP — the connector never writes to Softone. The remember_* / forget_* tools write only to your company's own settings inside the connector (series labels and notes), never to your ERP.

Two additional tools, create_order and update_customer, do write to Softone. They are disabled and hidden by default: they only appear in Claude after your company explicitly requests write permissions from the panel (Δικαιώματα εγγραφής → Αίτημα), and Claude is instructed to show you the exact change and ask for confirmation before calling them.

Examples

Example 1 — Last purchase of a customer

Ask: "What was the last purchase of customer Eleni Vougiouka and how much?"
Claude calls search_customers → customer_last_purchase and replies with the date, the line items, and the amount.

Example 2 — Today's takings per store

Ask: "Give me yesterday's sales per store."
Claude calls documents_summary for that date and returns a table of each store/series with transaction count, total turnover and average receipt.

Example 3 — A salesperson's CRM actions last week

Ask: "Which calls, meetings and tasks did salesperson Maria enter from 28/10/2026 to 03/11/2026?"
Claude calls list_crm_actions with that user and the inclusive dates. The action date and the insert date are separate. For every action of one customer, omit the dates. If the company's browser does not show who entered the action, Claude says so instead of listing everyone's actions.

Example 4 — A customer's full history & turnover

Ask: "Show me all invoices for customer code 106609 and the total."
Claude calls customer_documents + customer_document_totals and lists every document with the lifetime net/VAT/gross totals.

Notes

Support

ByteBee — vsalapataras@bytebee.gr · Privacy Policy

← Back to soft1-syncerp