Μετάβαση στο περιεχόμενο
ΕΛ
Άνοιγμα εφαρμογής

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/el/integrations/erp/soft1.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

Soft1 ERP

10 λεπτά ανάγνωσης
Αντιγραφή ως Markdown
Προβολή ως MarkdownΆνοιγμα του αρχείου .md.md

Με τη σύνδεση του Soft1, ο Ψηφιακός Βοηθός AI αναγνωρίζει τον πελάτη από τον αριθμό από τον οποίο καλεί, αναζητά είδη στον κατάλογό σας, ενημερώνει για το υπόλοιπο, την ενηλικίωση και τις πρόσφατες κινήσεις του πελάτη και μπορεί να καταχωρήσει στο Soft1 δελτίο παραγγελίας, τιμολόγιο, δελτίο αποστολής ή απόδειξη. Επιπλέον, μπορεί να καταγράψει την κλήση, να προγραμματίσει συνάντηση ή να δημιουργήσει εργασία παρακολούθησης στο CRM του Soft1.

Ανοίξτε Ενσωματώσεις - Κατάλογος - Soft1 ERP - Σύνδεση. Η σύνδεση γίνεται μία φορά και ισχύει για όλη την εταιρεία· σε κάθε βοηθό ορίζετε στη συνέχεια ποιες λειτουργίες του Soft1 επιτρέπεται να χρησιμοποιεί.

  • Έναν Web Account του Soft1 (όνομα χρήστη και κωδικό), τον οποίο δημιουργεί ο συνεργάτης ή ο διαχειριστής του Soft1. Η άδεια χρήσης πρέπει να περιλαμβάνει το module Web Service Connector και να διαθέτει ελεύθερη άδεια web service για τον λογαριασμό αυτό.
  • Το App id του Web Account. Σε πολλές εγκαταστάσεις είναι 2001· ο συνεργάτης σας μπορεί να το επιβεβαιώσει.
  • Τον τρόπο πρόσβασης της Voice Logica στο Soft1:
    • URL στο σύννεφο, εάν το Soft1 είναι προσβάσιμο από το διαδίκτυο. Πρόκειται για τη διεύθυνση των Web Services, για παράδειγμα https://yourcompany.oncloud.gr/s1services.
    • Σήραγγα, εάν το Soft1 λειτουργεί σε διακομιστή μέσα στο δίκτυο της επιχείρησης. Η σήραγγα είναι μια αντίστροφη σύνδεση από ένα μικρό πρόγραμμα εγκατάστασης στο δίκτυό σας προς τη Voice Logica, χωρίς να απαιτείται άνοιγμα θυρών στο firewall. Οι σήραγγες δημιουργούνται στο Ρύθμιση AI - Τούνελ, που εμφανίζεται μόνο σε διαχειριστές. Εάν δεν το βλέπετε, ζητήστε από την υποστήριξη της Voice Logica να δημιουργήσει τη σήραγγα και να σας στείλει το πρόγραμμα εγκατάστασης.

Η σύνδεση γίνεται σε τρία βήματα: διαπιστευτήρια, επιλογή εταιρείας και, τέλος, επισκόπηση με προαιρετικά SQL Scripts.

Βήμα 1 - διαπιστευτήρια

URL στο σύννεφο / ΣήραγγαREQUIRED
Επιλέξτε ένα από τα δύο. Για σύννεφο, πληκτρολογήστε το URL των Web Services του Soft1. Για σήραγγα, επιλέξτε μια ενεργή σήραγγα από τη λίστα.
Όνομα χρήστηREQUIRED
Το όνομα χρήστη του Web Account.
ΚωδικόςREQUIRED
Ο κωδικός του Web Account. Αποθηκεύεται κρυπτογραφημένος.
Αναγνωριστικό εφαρμογήςREQUIRED
Το App id του Web Account.
Να επιτρέπονται self-signed TLS πιστοποιητικά
Ενεργοποιήστε το μόνο για τοπικό διακομιστή με πιστοποιητικό που δεν έχει εκδοθεί από δημόσια αρχή.

Βήμα 2 - εταιρεία και υποκατάστημα. Η Voice Logica διαβάζει σε ποια εταιρεία, υποκατάστημα, module και χρήστη αναφοράς έχει πρόσβαση ο Web Account και τα εμφανίζει σε λίστα. Επιλέξτε ένα. Εάν ο λογαριασμός έχει πρόσβαση μόνο σε ένα, το βήμα παραλείπεται.

Βήμα 3 - επισκόπηση. Ελέγξτε τη διεύθυνση, την εταιρεία και το υποκατάστημα. Η επιλογή Εμφάνιση προηγμένων επιλογών ανοίγει τις προαιρετικές θέσεις SQL Scripts. Το Εντοπισμός SQL scripts εμφανίζει τα scripts της εγκατάστασής σας και προεπιλέγει το πιθανότερο για κάθε θέση· εάν ο Web Account δεν έχει πρόσβαση στη λίστα, πληκτρολογείτε τους κωδικούς χειροκίνητα.

Script delta πελατών
Ταχύτερος συγχρονισμός πελατών. Χωρίς αυτό, ο συγχρονισμός γίνεται μέσω του τυπικού API.
Script delta ειδών
Ταχύτερος συγχρονισμός ειδών.
Script υπολοίπων πελατών
Υπόλοιπο και ενηλικίωση ανά πελάτη.
Script ιστορικού πελάτη
Απαιτείται για τη λειτουργία ιστορικού κινήσεων.
Script συχνότερων ειδών πελάτη
Απαιτείται για την ερώτηση «τι αγοράζει συνήθως ο πελάτης».
Script συγκεντρωτικών πωλήσεων ειδών
Προσθέτει σύνολα πωλήσεων στα είδη, για απαντήσεις σχετικά με τα πιο δημοφιλή.
Script επαφών (B2B caller-ID)
Προσθέτει τα πρόσωπα επικοινωνίας κάθε πελάτη, ώστε να αναγνωρίζεται και ο υπάλληλος ενός εταιρικού πελάτη όταν καλεί.
Πρότυπο παραστατικού πώλησης
Προαιρετικό πρότυπο για τα παραστατικά που δημιουργεί ο βοηθός.
Πρότυπο ηλεκτρονικού τιμολογίου
Προαιρετικό πρότυπο για την έκδοση ηλεκτρονικού τιμολογίου.

Αφήστε κενή όποια θέση δεν έχει αντίστοιχο script. Στην κάρτα της σύνδεσης, η ενότητα Ρυθμίσεις υπό διαχείριση AI δείχνει ποια μέθοδος χρησιμοποιήθηκε για κάθε δυνατότητα μετά από κάθε συγχρονισμό.

  1. Ενσωματώσεις - Κατάλογος - Soft1 ERP - Σύνδεση. Επιλέξτε URL στο σύννεφο ή Σήραγγα, συμπληρώστε τα στοιχεία του Web Account και πατήστε Συνέχεια.

  2. Επιλέξτε εταιρεία και υποκατάστημα και πατήστε Συνέχεια.

  3. Στο βήμα επισκόπησης πατήστε Δοκιμή σύνδεσης. Εάν η δοκιμή επιτύχει, πατήστε Σύνδεση. Ο πρώτος συγχρονισμός πελατών και ειδών ξεκινά στο παρασκήνιο και στη συνέχεια επαναλαμβάνεται κάθε 15 λεπτά· τα υπόλοιπα ενημερώνονται κάθε βράδυ. Το Συγχρονισμός τώρα στην κάρτα της σύνδεσης ξεκινά άμεσα συγχρονισμό.

  4. Εάν ο βοηθός θα δημιουργεί παραστατικά, πατήστε Ρύθμιση στην κάρτα της σύνδεσης. Πατήστε Αυτόματη ρύθμιση και ελέγξτε τη σειρά του Soft1 που επιλέχθηκε για κάθε είδος (Παραγγελία, Τιμολόγιο, Δελτίο αποστολής, Απόδειξη, καθώς και Κλήση, Συνάντηση και Εργασία του CRM). Ορίστε ενεργή σειρά για κάθε είδος που θα δημιουργεί ο βοηθός.

  5. Ανοίξτε Οι agents μου - τον βοηθό - Ικανότητες - Εργαλεία & ροές εργασίας. Ενεργοποιήστε το Soft1 ERP, πατήστε Διαμόρφωση και στις Λειτουργίες επιλέξτε τι επιτρέπεται στον βοηθό. Από προεπιλογή είναι επιλεγμένη η αναγνώριση καλούντος από το τηλέφωνο, μαζί με τις τρεις λειτουργίες έργων. Εάν ο βοηθός θα δημιουργεί παραστατικά, ορίστε Max sales doc value και Max sales doc lines. Πατήστε Αποθήκευση στις ρυθμίσεις του εργαλείου και Αποθήκευση στον βοηθό.

  6. Καλέστε τον βοηθό από αριθμό που είναι καταχωρημένος σε πελάτη του Soft1 (PHONE01 ή PHONE02, ή σε πρόσωπο επικοινωνίας εάν έχετε ορίσει το script επαφών). Ο βοηθός πρέπει να χαιρετήσει τον πελάτη με το όνομά του. Ρωτήστε «Ποιο είναι το υπόλοιπό μου;» και ο βοηθός πρέπει να αναφέρει το ανοιχτό ποσό. Εάν ο χαιρετισμός παραμένει γενικός, ανοίξτε τις Κλήσεις και ελέγξτε τις κλήσεις εργαλείων της συγκεκριμένης κλήσης.

Κάθε λειτουργία επιλέγεται χωριστά στις Λειτουργίες. Οι λειτουργίες εγγραφής μεταβάλλουν δεδομένα στο Soft1· ενεργοποιήστε μόνο όσες χρειάζεστε.

ΕργασίαΛειτουργίες
Εντοπισμός πελάτηΑναγνώριση καλούντος από το τηλέφωνο· αναζήτηση με ΑΦΜ, κωδικό πελάτη ή επωνυμία· σύνδεση του αριθμού του καλούντος με πελάτη για τις επόμενες κλήσεις
Καρτέλα πελάτηΔημιουργία νέου πελάτη· προσθήκη ή αφαίρεση ενός από τα δύο τηλέφωνα του πελάτη
ΕίδηΑναζήτηση με περιγραφή, κωδικό, barcode ή προμηθευτή· τα είδη που αγοράζει συχνότερα ο πελάτης· τα είδη με τις περισσότερες πωλήσεις
ΥπόλοιπαΑνοιχτό υπόλοιπο· ενηλικίωση σε διαστήματα 1-30 / 31-60 / 61-90 / 90+ ημερών· κινήσεις μεταξύ δύο ημερομηνιών
Παραγγελίες και παραστατικάΑνοιχτές παραγγελίες του πελάτη ή ανάκτηση παραστατικού με το κλειδί του· δημιουργία ή τροποποίηση παραγγελίας, τιμολογίου, δελτίου αποστολής, απόδειξης ή γενικού παραστατικού· προσθήκη ή αφαίρεση γραμμών, αλλαγή ποσοτήτων, στοιχεία αποστολής· διαβίβαση εκδοθέντος παραστατικού στο myDATA
Ενέργειες CRMΚαταγραφή κλήσης, προγραμματισμός συνάντησης, εργασία παρακολούθησης, πρόσφατες ενέργειες του πελάτη· λίστα, δημιουργία και ενέργειες έργων του Soft1

Οι λειτουργίες εγγραφής εκτελούνται μόνο εφόσον είναι επιλεγμένες και έχει οριστεί σειρά του Soft1 για το αντίστοιχο είδος παραστατικού στη Ρύθμιση. Στις ρυθμίσεις του εργαλείου θα βρείτε επίσης την προφόρτωση των πρόσφατων παραγγελιών του καλούντος στην έναρξη της κλήσης, τα στοιχεία αποστολής στα παραστατικά, την άδεια τροποποίησης παραστατικών παλαιότερων των 24 ωρών, πρότυπο σημειώσεων για την καταγραφή κλήσης και πρόσθετες στήλες SALDOC που πρέπει να συμπληρώνει ο βοηθός.

Στις ροές εργασιών, η επιλογή κόμβων έχει δικούς της κόμβους Soft1 κάτω από το SOFT1 ERP: Get Customer, Search Items, Customer Balance, Customer Aging, Transaction History, Create Sales Doc, Transmit eInvoice και Create call. Όταν κανένας δεν καλύπτει αυτό που χρειάζεστε, για παράδειγμα ένα δικό σας SQL script ή ένα αντικείμενο CCC… που πρόσθεσε ο συνεργάτης σας στο Soft1, χρησιμοποιήστε το Soft1 — Custom service. Δουλεύει με την ίδια σύνδεση Soft1.

Διαλέξτε Action. Η φόρμα δείχνει μόνο τα πεδία αυτής της ενέργειας:

Run SQL script (SqlData)
Το όνομα του script (SqlName) και οι παράμετροί του ως λίστα JSON, που στέλνονται με τη σειρά ως param1, param2, …, π.χ. ["{{soft1Customer.trdr}}", "2026-01-01"]. Επιστρέφει τις γραμμές, 50 από προεπιλογή (έως 500).
Read a record (getData)
Το αντικείμενο (π.χ. CUSTOMER) και το κλειδί της εγγραφής. Το LOCATEINFO είναι προαιρετικό και περιορίζει τους πίνακες και τα πεδία που επιστρέφονται. Επιστρέφει την εγγραφή.
Read a browser list
Το αντικείμενο και, προαιρετικά, ένα ευρετήριο και φίλτρα, π.χ. CUSTOMER.AFM={{tin}}. Επιστρέφει τις γραμμές. Ορισμένα ευρετήρια, συχνά το προεπιλεγμένο, αγνοούν τα φίλτρα και επιστρέφουν όλες τις γραμμές: για μία εγγραφή, χρησιμοποιήστε το Read a record με το κλειδί της.
Write a record (setData)
Το αντικείμενο και τα δεδομένα σε JSON, π.χ. { "SOACTION": [ { "TRDR": "{{soft1Customer.trdr}}", "COMMENTS": "{{call.summary}}" } ] }. Αφήστε κενό το Record Key (update) για νέα εγγραφή. Συμπληρώστε το για να ενημερώσετε εκείνη την εγγραφή.
Call a JS service (your own web service)
Μια υπηρεσία web που έγραψε ο συνεργάτης σας Soft1 σε Advanced JavaScript, με διεύθυνση όπως https://yourname.oncloud.gr/s1services/JS/VoiceLogica/getOpenTickets. Συμπληρώστε το Script (VoiceLogica) και το Function (getOpenTickets) και, προαιρετικά, ένα Body σε JSON, π.χ. { "trdr": "{{soft1Customer.trdr}}" }. Δεν γράφετε URL: ο κόμβος χρησιμοποιεί τη διεύθυνση της σύνδεσης Soft1 και προσθέτει μόνος του τη συνεδρία. Επιστρέφει ό,τι απαντήσει η function.

Οι επόμενοι κόμβοι χρησιμοποιούν την απάντηση ως μεταβλητές: {{node_X.rows[0].FIELD}} μετά από script ή ευρετήριο, {{node_X.record.FIELD}} μετά από ανάγνωση εγγραφής, {{node_X.key}} για την εγγραφή που αποθηκεύτηκε, και {{node_X.result.FIELD}} μετά από υπηρεσία JS. Στη θέση του node_X βάλτε τον κόμβο, όπως τον δείχνει η επιλογή μεταβλητών.

Οι εγγραφές είναι κλειστές μέχρι να τις επιτρέψει διαχειριστής. Ανοίξτε την κάρτα της σύνδεσης Soft1, πατήστε Configure και στο Workflow writes γράψτε τα αντικείμενα που μπορούν να δημιουργούν οι ροές (π.χ. SOACTION, CCCTICKET). Για να επιτρέψετε και ενημέρωση υπαρχουσών εγγραφών, γράψτε το αντικείμενο και στο δεύτερο πεδίο. Την αποθήκευση την κάνουν μόνο οι διαχειριστές της σύνδεσης. Η ανάγνωση δεν χρειάζεται ρύθμιση. Μια ροή δεν μπορεί ποτέ να διαγράψει κάτι στο Soft1. Η εγγραφή απορρίπτεται επίσης όταν ένας πίνακας έχει πάνω από 30 γραμμές ή όταν μια {{μεταβλητή}} στα δεδομένα δεν έχει τιμή, ώστε να μη φτάσει ποτέ κείμενο-υποκατάστατο στο ERP σας.

Και οι υπηρεσίες JS είναι κλειστές μέχρι να τις επιτρέψει διαχειριστής. Μια υπηρεσία JS εκτελεί κώδικα του συνεργάτη σας και μπορεί να αλλάξει ή να διαγράψει δεδομένα, γι’ αυτό επιτρέπεται καθεμία με το όνομά της. Στην ίδια ενότητα Workflow writes, γράψτε τες ως Script/function, π.χ. VoiceLogica/getOpenTickets. Η κλήση σε υπηρεσία που δεν είναι στη λίστα απορρίπτεται και ο κόμβος αναφέρει ποιες επιτρέπονται. Όταν η function απαντήσει success: false, ο κόμβος ακολουθεί τη διαδρομή Failed με το μήνυμα σφάλματος της function.

Τα custom web services που προσθέτει ένας εγκαταστάτης Soft1 σε JavaScript (/s1services/JS/…) δεν καλούνται από αυτόν τον κόμβο.

Γιατί η σύνδεση με το Soft1 αποτυγχάνει με σφάλμα όπως Invalid credentials ή Web-service licences exceeded;

Το μήνυμα αναφέρει την αιτία. «Invalid credentials» σημαίνει λανθασμένο όνομα χρήστη, κωδικό ή App id. «Web Service Connector» σημαίνει ότι η άδεια δεν περιλαμβάνει το συγκεκριμένο module. «Web-service licences exceeded» σημαίνει ότι όλες οι άδειες web χρησιμοποιούνται. «User account is not active» σημαίνει ότι ο Web Account είναι απενεργοποιημένος στο Soft1. Επιλύστε το με τον συνεργάτη του Soft1 και δοκιμάστε ξανά.

Γιατί η δοκιμή σύνδεσης με το Soft1 λήγει ή εμφανίζει σφάλμα πιστοποιητικού;

Για σύννεφο, ελέγξτε το URL σε πρόγραμμα περιήγησης και βεβαιωθείτε ότι περιλαμβάνει το /s1services. Για τοπικό διακομιστή με δικό του πιστοποιητικό, ενεργοποιήστε το Να επιτρέπονται self-signed TLS πιστοποιητικά. Για σήραγγα, η σήραγγα πρέπει να είναι ενεργή και το πρόγραμμα εγκατάστασης να εκτελείται σε υπολογιστή που έχει πρόσβαση στον διακομιστή του Soft1.

Γιατί ο βοηθός δεν αναγνωρίζει γνωστό πελάτη από το Soft1;

Περιμένετε να ολοκληρωθεί ο πρώτος συγχρονισμός ή πατήστε Συγχρονισμός τώρα. Ο αριθμός του καλούντος πρέπει να είναι καταχωρημένος στον πελάτη στο Soft1. Οι υπάλληλοι εταιρικών πελατών αναγνωρίζονται μόνο εφόσον έχει οριστεί το script επαφών. Ελέγξτε επίσης ότι η αναγνώριση καλούντος από το τηλέφωνο είναι επιλεγμένη στις Λειτουργίες του εργαλείου.

Γιατί ο βοηθός λέει ότι δεν μπόρεσε να δημιουργήσει την παραγγελία στο Soft1;

Το Soft1 απαιτεί σειρά για το παραστατικό. Πατήστε Ρύθμιση στην κάρτα της σύνδεσης Soft1 και ορίστε ενεργή σειρά για το αντίστοιχο είδος. Μια σειρά με την ένδειξη Ανενεργή πρέπει να αντικατασταθεί. Απορρίπτεται επίσης κάθε παραστατικό που υπερβαίνει τα Max sales doc value ή Max sales doc lines.