{"id":85785,"plugin_id":"plugin_asdk_app_6a33e5b7ed208191b24263c41e5dd7ee","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-07T12:27:30.032Z","digest":"d0739c3502395565acf5ac4b3c5b942679b4024e40667c1ce53e27c9776c3e17","against":null,"payload":{"description":"Ρώτα στοιχεία πελατών, ειδών, αποθέματος και παραστατικών/πωλήσεων από το Softone ERP της εταιρείας σου, μέσω του SyncERP connector (read-only MCP). Χρησιμοποίησέ το όταν ο χρήστης ρωτάει για πελάτη (επωνυμία, ΑΦΜ, στοιχεία, ιστορικό αγορών, τελευταία αγορά, custom πεδία), για είδη/απόθεμα, ή για πωλήσεις/παραστατικά (τζίρος ημέρας, ανά κατάστημα, eshop, παραγγελίες, αποστολές), για υπόλοιπο/καρτέλα πελάτη ή για εξαγωγή Excel, ή για CRM ενέργειες (τηλεφωνήματα, συναντήσεις, εργασίες). Triggers: \"τελευταία αγορά\", \"πόσες πωλήσεις\", \"τζίρος\", \"παραστατικά\", \"eshop\", \"ανά κατάστημα\", \"βρες πελάτη\", \"βρες προμηθευτή\", \"ΑΦΜ\", \"απόθεμα\", \"υπόλοιπο\", \"υπόλοιπο προμηθευτή\", \"καρτέλα\", \"excel\", \"ενέργειες\", \"τηλεφωνήματα\", \"συναντήσεις\", \"εργασίες\".","included_files":[],"name":"softone-erp","skill_md_contents":"---\nname: softone-erp\ndescription: >-\n  Ρώτα στοιχεία πελατών, ειδών, αποθέματος και παραστατικών/πωλήσεων από το Softone ERP της εταιρείας σου,\n  μέσω του SyncERP connector (read-only MCP). Χρησιμοποίησέ το όταν ο χρήστης ρωτάει για πελάτη (επωνυμία,\n  ΑΦΜ, στοιχεία, ιστορικό αγορών, τελευταία αγορά, custom πεδία), για είδη/απόθεμα, ή για πωλήσεις/παραστατικά\n  (τζίρος ημέρας, ανά κατάστημα, eshop, παραγγελίες, αποστολές), για υπόλοιπο/καρτέλα\n  πελάτη ή για εξαγωγή Excel, ή για CRM ενέργειες (τηλεφωνήματα, συναντήσεις, εργασίες).\n  Triggers: \"τελευταία αγορά\", \"πόσες πωλήσεις\", \"τζίρος\", \"παραστατικά\", \"eshop\",\n  \"ανά κατάστημα\", \"βρες πελάτη\", \"βρες προμηθευτή\", \"ΑΦΜ\", \"απόθεμα\", \"υπόλοιπο\", \"υπόλοιπο προμηθευτή\", \"καρτέλα\", \"excel\",\n  \"ενέργειες\", \"τηλεφωνήματα\", \"συναντήσεις\", \"εργασίες\".\n---\n\n# Softone ERP — SyncERP connector\n\nRead-only πρόσβαση στο **Softone ERP** της εταιρείας σου μέσω του SyncERP connector. Πηγή αλήθειας για\nπελάτες, είδη, απόθεμα και παραστατικά. Κάθε εταιρεία (tenant) συνδέεται με τα δικά της στοιχεία Softone —\nοι συμβάσεις (σειρές, custom πεδία, κανάλια eshop) **διαφέρουν ανά εγκατάσταση**.\n\n> Αυτό το skill είναι generic. Οι τοπικές συμβάσεις της δικής σου επιχείρησης (π.χ. ποια σειρά =\n> ποιο κατάστημα, ποια custom πεδία) τα ορίζει ο admin στο panel (mcp.syncerp.gr):\n> μνήμη σειρών, σημειώσεις και Ρυθμίσεις ERP. Από εδώ μπορείς μόνο να τα διαβάσεις.\n\n## Έτοιμα prompts (starter templates)\n\nΟ connector προσφέρει έτοιμα prompts στο picker του client — καλό σημείο εκκίνησης:\n- **Τζίρος ημέρας ανά κατάστημα** · **Καρτέλα πελάτη & τελευταία αγορά** · **Απόθεμα είδους** · **Τι μπορώ να ρωτήσω;**\n\n## Εργαλεία\n\n**Πελάτες**\n- `search_customers(term, limit=20, field=\"auto\")` — αναζήτηση κατά επωνυμία/κωδικό/ΑΦΜ/τηλέφωνο.\n  Επιστρέφει `key` (π.χ. `CUSTOMER;119460`) για το `get_customer`.\n  Κωδικός με τελείες (π.χ. `50.01.00.0002`) ψάχνεται ως CODE.\n- `search_suppliers(term, limit=20, field=\"auto\")` — προμηθευτής (browser `SUPPLIER`,\n  SODTYPE=12). Όνομα object: `SOFTONE_SUPPLIER_OBJECT`. Δεν αλλάζει τους πελάτες.\n- `supplier_balance(supplier)` — επίσημο «Υπόλοιπο» (`TRDFINDATA.LBAL`), χωρίς αντιστροφή.\n  Πολλοί ταιριασμοί επιστρέφονται ως λίστα, χωρίς σιωπηλή επιλογή. Σκέτος αριθμός\n  μόνο αν ο συναλλασσόμενος είναι προμηθευτής (SODTYPE 12). Δεν υπάρχει καρτέλα κινήσεων.\n- `get_customer(key, extra_fields=[...], include_raw=False)` — πλήρη ισιωμένα στοιχεία + custom πεδία\n  + `financials.Υπόλοιπο` από τα οικονομικά στοιχεία.\n- `customer_balance(customer)` — το «Υπόλοιπο» της καρτέλας (Οικονομικά στοιχεία).\n- `customer_ledger(customer, date_from=\"\", date_to=\"\", limit=500, as_excel=False)` — καρτέλα κινήσεων\n  (χρέωση/πίστωση/τρέχον υπόλοιπο) με το ίδιο πρόσημο με τον τζίρο (`FPRMS.RESTMODE`).\n  `as_excel=True` δίνει σύνδεσμο λήψης, όχι το αρχείο μέσα στην απάντηση.\n- `export_customers_excel(fields, customers=\"\", period=\"year\", date_from=\"\", date_to=\"\")` —\n  μαζικό Excel με επιλογή πεδίων (στοιχεία, επικοινωνία, οικονομικά, υπόλοιπα, τζίρος ανά περίοδο).\n  Ο τζίρος περνάει από την ίδια λογική προσήμου με το `customer_document_totals`. Η απάντηση έχει\n  σύνδεσμο λήψης που λήγει σύντομα, είναι μίας χρήσης και ανοίγει μόνο από τη συνεδρία ή το\n  token της ίδιας εταιρείας. ΑΦΜ και email μένουν μασκαρισμένα όπως σε όλα τα εργαλεία,\n  εκτός αν ο admin έχει δώσει δικαίωμα προβολής.\n- `list_customer_fields(key=None)` — όλα τα ονόματα πεδίων ανά πίνακα. **Για ανακάλυψη custom πεδίων.**\n\n**CRM ενέργειες (read-only)**\n- `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)` —\n  τηλεφωνήματα, συναντήσεις/επισκέψεις, εργασίες, email, σημειώσεις. Με πελάτη και χωρίς\n  ημερομηνίες: πλήρες ιστορικό (`history=full`), σελιδοποιημένο. Χωρίς πελάτη χρειάζεται\n  `date_from`. `action_date` (TRNDATE) και `insert_date` (INSDATE) είναι χωριστά· το δεύτερο\n  μένει κενό αν δεν έρθει η στήλη. Χειριστής (`handler`), εντολέας (`assigner`) και πωλητής\n  (`salesman`) γυρίζουν με id και όνομα. Ο χρήστης φιλτράρεται τοπικά. Αν `user_filter.applied`\n  δεν είναι `local`, μην αποδώσεις ενέργειες σε αυτόν. Κοίτα `truncated`, `field_notes` και `limitations`.\n  Σάρωση: το πολύ 1000 γραμμές ανά form. `group_by=\"customer\"` μετράει αυτές τις\n  γραμμές ανά πελάτη. `counts_complete=false` όταν κόπηκε η σάρωση, κάποιο form\n  δεν απάντησε, ή χρησιμοποιήθηκε το παράθυρο ~5 ημερών. Ο λόγος είναι στα\n  `limitations`.\n- `list_softone_users(query=None, limit=50, offset=0)` — χρήστες SoftOne (USERS) με σταθερό id.\n\n**Ιστορικό πελάτη (ΟΛΟ το ιστορικό σε μία κλήση, χωρίς όριο ημερομηνίας)**\n- `customer_documents(customer, limit=100, date_from=None, date_to=None)` — ΟΛΑ τα παραστατικά\n  ενός πελάτη (newest-first), προαιρετικά σε κλειστό διάστημα. Κάθε γραμμή έχει `in_turnover` /\n  `turnover_sign`. Μην τα αθροίζεις μόνος σου για τζίρο.\n- `customer_last_purchase(customer)` — η τελευταία **πώληση** (τιμολόγιο/απόδειξη), όχι προσφορά,\n  παραγγελία ή δελτίο. Νεότερη γραμμή του Soft1 χωρίς πρόσημο +1 δεν πετιέται\n  αν δεν είναι γνωστή μη-πώληση (`purchase_confidence=softone_row`).\n  «Τιμολόγιο - Δελτίο Αποστολής» και «Τιμολόγιο-Δελτίο Αποστολής» μένουν αγορά.\n  Με πρόσημο 0 μένουν εκτός προτιμολόγιο, παραγγελία, προσφορά, σκέτο δελτίο\n  αποστολής, απόδειξη είσπραξης, ακυρωτικό και πιστωτικό, ακόμη και με «λιανικής».\n- `customer_document_totals(customer, date_from=None, date_to=None)` — τζίρος (καθ./ΦΠΑ/μικτό).\n  Μόνο παραστατικά που ενημερώνουν πωλήσεις· το πιστωτικό αφαιρείται.\n\n**Είδη & απόθεμα**\n- `search_items(term, by=\"auto\", limit=20)` — είδη κατά περιγραφή/κωδικό/barcode.\n- `item_stock(term, warehouse=None, include_zero=True)` — υπόλοιπα **ανά νούμερο/χρώμα & αποθήκη**. Δες\n  `available_by_model` για γρήγορη σύνοψη· `include_zero=False` για μόνο όσα έχουν απόθεμα. ⚠️ Το feed μπορεί\n  να καλύπτει συγκεκριμένο κανάλι, όχι όλο το catalog: αν επιστραφεί `not_in_stock_feed=true`, το είδος\n  υπάρχει αλλά το απόθεμά του δεν εκτίθεται — **ΔΕΝ** σημαίνει υπόλοιπο 0.\n\n**Παραστατικά / Πωλήσεις**\n- `recent_documents(doc_type=\"retail\", limit=20)` — πρόσφατα (παράθυρο ~5 ημερών).\n- `documents_on_date(date_str, doc_type=\"retail\", customer=None, limit=2000, date_to=None)` — παραστατικά\n  μιας ημέρας ή κλειστού διαστήματος. Μόνο μέσα στο διάστημα (τοπική μέρα, όχι UTC prefix).\n  Επιστρέφει `total`, `returned`, `truncated`.\n- `erp_setup_check()` — **έλεγχος εγκατάστασης**: στήλες browsers, εύρος ημερομηνίας, τύποι παραστατικών με πρόσημο, προμηθευτές, γραμμές ειδών. Χωρίς πελάτες ή ποσά. Δείξε τα `questions` και το `ready`. Ό,τι δεν βρέθηκε ορίζεται στο panel, Ρυθμίσεις ERP.\n- `documents_summary(date_str, doc_type=\"retail\", series=None)` — **σύνολα ανά σειρά/κατάστημα με μία κλήση.**\n- `get_document(doc_id, doc_type=\"retail\")` — πλήρες παραστατικό (header + γραμμές + branch + doctype + ποσά).\n\n`doc_type`: `retail` (λιανική καταστημάτων + eshop), `sales` (χονδρική/τιμολόγια), `purchase` (αγορές).\n\n**Μνήμη εταιρείας (per-tenant — μένει μόνιμα)**\n- `list_series_labels()` — ο χάρτης σειρά → κατάστημα/κανάλι της εταιρείας. Εμφανίζεται αυτόματα στο `documents_summary`. Αν ο χρήστης λέει «αυτή η σειρά είναι το …», πες του να το ορίσει ο admin στο panel.\n- `list_facts()` — ελεύθερες επιχειρηματικές σημειώσεις/κανόνες που έχει ορίσει ο admin στο panel. **Συμβουλέψου `list_facts()` στην αρχή** όταν\n  η ερώτηση μπορεί να εξαρτάται από τοπικές συμβάσεις της επιχείρησης.\n\n## ⚠️ Κρίσιμοι κανόνες για σωστά νούμερα\n\n1. **ΠΟΤΕ μη μετράς σύνολα από μικρό `limit`.** Ο browser κόβει στο `limit` — μια μέρα έχει εύκολα εκατοντάδες\n   παραστατικά. **Πάντα** χρησιμοποίησε `documents_summary` (τραβάει όλα) ή `documents_on_date` με μεγάλο\n   limit, και **έλεγξε `total` vs `returned`**· αν `truncated=True`, ξανατράβα με μεγαλύτερο limit.\n\n2. **Τζίρος ανά κατάστημα → `documents_summary`, ΟΧΙ φίλτρο πελάτη.** Το κατάστημα κωδικοποιείται στη\n   **σειρά του παραστατικού** (το πρόθεμα του FINCODE), όχι στον κωδικό πελάτη. Φιλτράροντας με κωδικό πελάτη\n   χάνεις τα ονομαστικά παραστατικά του ίδιου καταστήματος.\n\n3. **Σειρά → κατάστημα διαφέρει ανά εγκατάσταση.** Δες `list_series_labels()` για ό,τι έχει ήδη αποθηκευτεί.\n   Αν μια σειρά είναι άγνωστη, **ρώτα τον χρήστη** τι αντιπροσωπεύει. Για να μείνει μόνιμα,\n   το ορίζει ο admin στο panel και μετά εμφανίζεται αυτόματα στις συνόψεις.\n\n4. **Διαχωρισμός καναλιών eshop.** Αν η επιχείρηση έχει πολλά κανάλια online (π.χ. δικό της eshop +\n   marketplace), συχνά μοιράζονται την ίδια λιανική (`retail`) με αριθμητικά παραστατικά αλλά ξεχωρίζουν στο\n   `get_document` με βάση το `branch` και το `doctype`. Αν χρειαστεί διαχωρισμός, άνοιξε ένα παραστατικό και\n   δες αυτά τα πεδία — ή ρώτησε τον χρήστη και πρότεινε να μπει ο κανόνας στο panel.\n\n5. **Τζίρος πελάτη → `customer_document_totals`.** Μην αθροίζεις το ιστορικό: περιέχει και προσφορές,\n   παραγγελίες και δελτία αποστολής. Το πιστωτικό αφαιρείται. Αν `turnover_reliable=false`, πες το.\n   Αν `partial=true`, πες ότι το νούμερο είναι ελλιπές και ανάφερε πόσα παραστατικά και πόσο\n   ποσό έμειναν εκτός (`unclassified`, `unclassified_net`).\n\n6. **Ημερομηνία = τοπική μέρα, κλειστό διάστημα.** Μην κόβεις το ISO στα 10 πρώτα γράμματα. Για\n   «από–έως» δώσε `date_from`/`date_to`· και οι δύο μέρες περιλαμβάνονται.\n\n7. **Ενέργειες CRM → `list_crm_actions`.** Όχι από παραστατικά ή καρτέλα πελάτη. Πλήρες\n   ιστορικό πελάτη: `customer` χωρίς ημερομηνίες. `action_date` και `insert_date` είναι χωριστά.\n   Αν το `user_filter` ή τα `limitations` λένε ότι ο χρήστης ή κάποιες μέρες δεν επιβεβαιώθηκαν, πες το.\n\n## Βασικές αρχές\n\n- **Search πρώτα** για πελάτες/είδη· αν τα αποτελέσματα είναι πολλά, δείξε λίστα και ζήτα διευκρίνιση.\n  Προσοχή σε τονισμένες παραλλαγές ελληνικών επωνύμων (π.χ. «Βουγιούκα» vs «Βουγιουκα») — το wildcard search\n  τα φέρνει και τα δύο· διάλεξε με το μικρό όνομα.\n- **Custom πεδία — ρώτα τον χρήστη.** Διαφέρουν ανά εγκατάσταση (συχνά `CUSEXTRA`: NUM01-05, BOOL01-04, KAD).\n  `list_customer_fields` → ρώτα ποιο όνομα αντιστοιχεί → πέρασέ το ως `extra_fields=[...]`.\n- **Κωδικοποιημένες τιμές** γυρνούν ως `id|label` (π.χ. `Νόμισμα: \"100|Euro\"`). Δείξε το label.\n- **PII**: αν τα στοιχεία επικοινωνίας έρχονται μασκαρισμένα, αυτό είναι σκόπιμο (ρύθμιση tenant) — μην το\n  παρακάμπτεις.\n\n## Σημειώσεις\n\n- Όλες οι κλήσεις προς Softone είναι **read-only**.\n- Αν δεις σφάλμα `clientID/login`, το token/συνεδρία της εταιρείας έληξε ή τα στοιχεία είναι λάθος —\n  ελέγχονται/ανανεώνονται από το panel της εταιρείας (SyncERP admin).\n</content>\n</invoke>\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}