SyncERP for Softone

ΟΛΟ το ιστορικό παραστατικών ενός πελάτη (μία κλήση, χωρίς όριο ημ/νίας). Χρησιμοποιεί το `selectorFields` service που παρακάμπτει το 5-ήμερο παράθυρο των browsers, οπότε επιστρέφει ολόκληρο το ιστορικό αξιόπιστα. Args: customer: Κωδικός/όνομα/τηλέφωνο/TRDR πελάτη. limit: Μέγιστα παραστατικά προς επιστροφή (newest-first). Επιστρέφει λίστα παραστατικών με id, κωδικό, ημερομηνία, καθαρό/ΦΠΑ/μικτό. Για τις γραμμές ενός παραστατικού χρησιμοποίησε get_document(doc_id).

customer_documents

Η τελευταία αγορά ενός πελάτη — με πλήρεις γραμμές του παραστατικού. Args: customer: Κωδικός/όνομα/τηλέφωνο/TRDR πελάτη. Βρίσκει το νεότερο παραστατικό μέσω selectorFields (όλο το ιστορικό σε μία κλήση) και κατεβάζει τις γραμμές του με get_document.

customer_last_purchase

Σύνολα τζίρου ενός πελάτη (με & χωρίς ΦΠΑ) σε όλο το ιστορικό. Args: customer: Κωδικός/όνομα/τηλέφωνο/TRDR πελάτη. Επιστρέφει πλήθος παραστατικών και αθροίσματα net/ΦΠΑ/μικτό, καθώς και την πρώτη/τελευταία ημερομηνία συναλλαγής.

customer_document_totals

Σύνοψη παραστατικών μιας ημέρας ομαδοποιημένη ανά ΣΕΙΡΑ (κατάστημα/κανάλι). Τραβάει ΟΛΑ τα παραστατικά της ημέρας και τα ομαδοποιεί ώστε να βγάζεις σωστά σύνολα ανά κατάστημα ΧΩΡΙΣ να ανοίγεις κάθε παραστατικό. ⚠️ Για τζίρο ανά κατάστημα χρησιμοποίησε ΑΥΤΟ — ΟΧΙ φίλτρο πελάτη: το κατάστημα κωδικοποιείται στη σειρά του παραστατικού, όχι στον κωδικό πελάτη· φιλτράροντας με πελάτη χάνεις τα ονομαστικά παραστατικά του ίδιου καταστήματος. Η σειρά είναι το πρόθεμα του κωδικού (π.χ. 3ΔΛΠ, 13ΔΛΠ, 10ΔΛΔΣe). Η αντιστοίχιση σειρά→όνομα-καταστήματος διαφέρει ανά εγκατάσταση — ρώτα τον χρήστη ή δες το skill (π.χ. 0ΔΛΠ=Χαλάνδρι, 3ΔΛΠ=Mall κ.λπ. για τη συγκεκριμένη εγκατάσταση). Args: date_str: Ημερομηνία 'YYYY-MM-DD' ή 'DD/MM/YYYY'. doc_type: 'retail', 'sales', ή 'purchase'. group_by: 'series' (default) — μόνο αυτό υποστηρίζεται προς το παρόν. series: Προαιρετικά φίλτρο σε μία σειρά (π.χ. '3ΔΛΠ') — επιστρέφει και τη λίστα των παραστατικών εκείνης της σειράς.

documents_summary

Παραστατικά μιας συγκεκριμένης ημερομηνίας (ΟΠΟΙΑΔΗΠΟΤΕ, και ιστορική). ΕΠΙΣΤΡΕΦΕΙ ΟΛΑ τα παραστατικά της ημέρας (default limit 2000 — αρκετά για μια μέρα). ΠΡΟΣΟΧΗ: μη βάζεις μικρό limit για να μετρήσεις σύνολα — θα κόψει σιωπηλά. Πάντα έλεγξε `total` vs `returned`· αν `truncated=True`, ανέβασε το limit. Για άθροισμα ανά κατάστημα/σειρά χρησιμοποίησε `documents_summary`. Args: date_str: Ημερομηνία 'YYYY-MM-DD' ή 'DD/MM/YYYY'. doc_type: 'retail', 'sales', ή 'purchase'. customer: Προαιρετικά κωδικός/όνομα/τηλέφωνο/TRDR για φιλτράρισμα. limit: Μέγιστα (default 2000 = ουσιαστικά όλα).

documents_on_date

Επιστρέφει πλήρη καρτέλα για ένα id από το `search` (ChatGPT contract). Args: id: Το id ενός αποτελέσματος του `search` (π.χ. 'CUSTOMER;6' ή 'ITEM;12'). Επιστρέφει {"id","title","text","url","metadata"}. Το PII παραμένει μασκαρισμένο εκτός αν ο tenant έχει δικαίωμα αποκάλυψης.

fetch

Πλήρη στοιχεία ενός πελάτη από το Softone (getData), ισιωμένα. Args: key: Το key από το search_customers ('CUSTOMER;6'), ή σκέτο TRDR ('6'). extra_fields: Προαιρετικά custom/extra πεδία να συμπεριληφθούν. Δώσε 'TABLE.FIELD' (π.χ. 'CUSEXTRA.NUM01') ή σκέτο όνομα πεδίου. Χρήσιμο για custom πεδία της δικής σου εγκατάστασης — δες list_customer_fields. include_raw: Αν True, επιστρέφει και όλα τα raw πεδία του CUSTOMER. Επιστρέφει κύρια στοιχεία, επαφές, υποκαταστήματα, τραπεζικούς λογ/σμούς, extra πεδία, τα ρυθμισμένα custom_fields, και ό,τι ζητήθηκε στο extra_fields.

get_customer

Πλήρες παραστατικό με το id του (header + γραμμές + ποσά). Χωρίς όριο ημ/νίας. Args: doc_id: Το FINDOC id (π.χ. '1435022') ή key 'RETAILDOC;1435022'. doc_type: 'retail', 'sales', ή 'purchase'.

get_document

Λίστα ΟΛΩΝ των διαθέσιμων πεδίων της καρτέλας πελάτη ανά πίνακα. Χρησιμοποίησέ το για να ανακαλύψεις τα custom πεδία της συγκεκριμένης εγκατάστασης Softone (συχνά στο CUSEXTRA: NUM01-05, BOOL01-04, KAD). Μόλις βρεις το όνομα, δώσ' το στο get_customer(extra_fields=[...]) ή πρόσθεσέ το στο custom_fields.json. Args: key: Προαιρετικά συγκεκριμένος πελάτης· αλλιώς χρησιμοποιεί δείγμα.

list_customer_fields

Δείχνει τις αποθηκευμένες επιχειρηματικές σημειώσεις/κανόνες της εταιρείας (ελεύθερη μνήμη). Συμβουλέψου τες όταν η απάντηση εξαρτάται από τοπικές συμβάσεις της επιχείρησης (π.χ. ποια σειρά=eShop, ιδιαιτερότητες καταστημάτων).

list_facts