softone-erp15.7 KB
View saved version →
---
name: softone-erp
description: >-
Ρώτα στοιχεία πελατών, ειδών, αποθέματος και παραστατικών/πωλήσεων από το Softone ERP της εταιρείας σου,
μέσω του SyncERP connector (read-only MCP). Χρησιμοποίησέ το όταν ο χρήστης ρωτάει για πελάτη (επωνυμία,
ΑΦΜ, στοιχεία, ιστορικό αγορών, τελευταία αγορά, custom πεδία), για είδη/απόθεμα, ή για πωλήσεις/παραστατικά
(τζίρος ημέρας, ανά κατάστημα, eshop, παραγγελίες, αποστολές), για υπόλοιπο/καρτέλα
πελάτη ή για εξαγωγή Excel, ή για CRM ενέργειες (τηλεφωνήματα, συναντήσεις, εργασίες).
Triggers: "τελευταία αγορά", "πόσες πωλήσεις", "τζίρος", "παραστατικά", "eshop",
"ανά κατάστημα", "βρες πελάτη", "βρες προμηθευτή", "ΑΦΜ", "απόθεμα", "υπόλοιπο", "υπόλοιπο προμηθευτή", "καρτέλα", "excel",
"ενέργειες", "τηλεφωνήματα", "συναντήσεις", "εργασίες".
---
# Softone ERP — SyncERP connector
Read-only πρόσβαση στο **Softone ERP** της εταιρείας σου μέσω του SyncERP connector. Πηγή αλήθειας για
πελάτες, είδη, απόθεμα και παραστατικά. Κάθε εταιρεία (tenant) συνδέεται με τα δικά της στοιχεία Softone —
οι συμβάσεις (σειρές, custom πεδία, κανάλια eshop) **διαφέρουν ανά εγκατάσταση**.
> Αυτό το skill είναι generic. Οι τοπικές συμβάσεις της δικής σου επιχείρησης (π.χ. ποια σειρά =
> ποιο κατάστημα, ποια custom πεδία) τα ορίζει ο admin στο panel (mcp.syncerp.gr):
> μνήμη σειρών, σημειώσεις και Ρυθμίσεις ERP. Από εδώ μπορείς μόνο να τα διαβάσεις.
## Έτοιμα prompts (starter templates)
Ο connector προσφέρει έτοιμα prompts στο picker του client — καλό σημείο εκκίνησης:
- **Τζίρος ημέρας ανά κατάστημα** · **Καρτέλα πελάτη & τελευταία αγορά** · **Απόθεμα είδους** · **Τι μπορώ να ρωτήσω;**
## Εργαλεία
**Πελάτες**
- `search_customers(term, limit=20, field="auto")` — αναζήτηση κατά επωνυμία/κωδικό/ΑΦΜ/τηλέφωνο.
Επιστρέφει `key` (π.χ. `CUSTOMER;119460`) για το `get_customer`.
Κωδικός με τελείες (π.χ. `50.01.00.0002`) ψάχνεται ως CODE.
- `search_suppliers(term, limit=20, field="auto")` — προμηθευτής (browser `SUPPLIER`,
SODTYPE=12). Όνομα object: `SOFTONE_SUPPLIER_OBJECT`. Δεν αλλάζει τους πελάτες.
- `supplier_balance(supplier)` — επίσημο «Υπόλοιπο» (`TRDFINDATA.LBAL`), χωρίς αντιστροφή.
Πολλοί ταιριασμοί επιστρέφονται ως λίστα, χωρίς σιωπηλή επιλογή. Σκέτος αριθμός
μόνο αν ο συναλλασσόμενος είναι προμηθευτής (SODTYPE 12). Δεν υπάρχει καρτέλα κινήσεων.
- `get_customer(key, extra_fields=[...], include_raw=False)` — πλήρη ισιωμένα στοιχεία + custom πεδία
+ `financials.Υπόλοιπο` από τα οικονομικά στοιχεία.
- `customer_balance(customer)` — το «Υπόλοιπο» της καρτέλας (Οικονομικά στοιχεία).
- `customer_ledger(customer, date_from="", date_to="", limit=500, as_excel=False)` — καρτέλα κινήσεων
(χρέωση/πίστωση/τρέχον υπόλοιπο) με το ίδιο πρόσημο με τον τζίρο (`FPRMS.RESTMODE`).
`as_excel=True` δίνει σύνδεσμο λήψης, όχι το αρχείο μέσα στην απάντηση.
- `export_customers_excel(fields, customers="", period="year", date_from="", date_to="")` —
μαζικό Excel με επιλογή πεδίων (στοιχεία, επικοινωνία, οικονομικά, υπόλοιπα, τζίρος ανά περίοδο).
Ο τζίρος περνάει από την ίδια λογική προσήμου με το `customer_document_totals`. Η απάντηση έχει
σύνδεσμο λήψης που λήγει σύντομα, είναι μίας χρήσης και ανοίγει μόνο από τη συνεδρία ή το
token της ίδιας εταιρείας. ΑΦΜ και email μένουν μασκαρισμένα όπως σε όλα τα εργαλεία,
εκτός αν ο admin έχει δώσει δικαίωμα προβολής.
- `list_customer_fields(key=None)` — όλα τα ονόματα πεδίων ανά πίνακα. **Για ανακάλυψη custom πεδίων.**
**CRM ενέργειες (read-only)**
- `list_crm_actions(date_from=None, date_to=None, user=None, customer=None, action_type="all", series=None, date_field="trndate", limit=50, offset=0)` —
τηλεφωνήματα, συναντήσεις/επισκέψεις, εργασίες, email, σημειώσεις. Με πελάτη και χωρίς
ημερομηνίες: πλήρες ιστορικό (`history=full`), σελιδοποιημένο. Χωρίς πελάτη χρειάζεται
`date_from`. `action_date` (TRNDATE) και `insert_date` (INSDATE) είναι χωριστά· το δεύτερο
μένει κενό αν δεν έρθει η στήλη. Χειριστής (`handler`), εντολέας (`assigner`) και πωλητή
Preview of the first 4,000 characters. Read full instructions →