# SAP ERP

Με τη σύνδεση SAP, ο Ψηφιακός Βοηθός AI χαιρετά τον γνωστό πελάτη με το όνομά του, εντοπίζει την καρτέλα του με βάση το τηλέφωνο, το ΑΦΜ, τον κωδικό πελάτη ή την επωνυμία, αναζητά υλικά, διαβάζει τις πρόσφατες παραγγελίες πώλησης και την κατάσταση μιας συγκεκριμένης παραγγελίας, και μπορεί να καταχωρήσει νέα παραγγελία ενώ ο πελάτης βρίσκεται στη γραμμή. Η ίδια σύνδεση καλύπτει το **SAP S/4HANA** (OData API, Cloud ή on-prem) και το **SAP Business One** (Service Layer).

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

  <ShotPlaceholder
    src="/assets/integrations/sap.png"
    name="sap-connect"
    alt="Παράθυρο σύνδεσης SAP ERP με επιλογή προϊόντος SAP, επιλογή URL στο σύννεφο / Σήραγγα και διαπιστευτήρια"
    capture="Connect SAP ERP dialog."
  />

## Τι χρειάζεστε πριν ξεκινήσετε

Ζητήστε από τον διαχειριστή SAP ή τον συνεργάτη SAP της εταιρείας σας τα παρακάτω, ανάλογα με το προϊόν.

**S/4HANA Cloud**

- Ένα communication arrangement που εκθέτει τα OData API επιχειρηματικών συνεργατών, προϊόντων και παραγγελιών πώλησης (API_BUSINESS_PARTNER, API_PRODUCT_SRV, API_SALES_ORDER_SRV).
- Είτε τον χρήστη επικοινωνίας και τον κωδικό του από το arrangement, είτε στοιχεία OAuth 2.0 client credentials: Client ID, Client secret και Token URL.
- Τη διεύθυνση API του tenant σας.

**S/4HANA on-prem (ή ECC με Gateway)**

- Τις ίδιες τρεις υπηρεσίες OData ενεργοποιημένες στο Gateway.
- Χρήστη υπηρεσίας με εξουσιοδοτήσεις OData και τον αριθμό SAP client (π.χ. 100).

**Business One**

- Τη διεύθυνση του Service Layer (συνήθως στη Θύρα 50000).
- Το όνομα της βάσης δεδομένων εταιρείας (CompanyDB).
- Χρήστη B1 με δικαιώματα σε Business Partners, Items και Sales Orders στη συγκεκριμένη εταιρεία.

**Δίκτυο.** Αν το SAP απαντά σε δημόσια διεύθυνση HTTPS, επιλέξτε **URL στο σύννεφο**. Αν λειτουργεί μόνο στο εσωτερικό δίκτυο της εταιρείας, η πρόσβαση γίνεται μέσω tunnel της Voice Logica: μια μικρή υπηρεσία αναμετάδοσης που εγκαθίσταται σε υπολογιστή του δικτύου σας (εγκαταστάτης για Windows ή Linux) και προωθεί τα αιτήματα στον server και τη Θύρα του SAP. Η ρύθμιση του tunnel γίνεται σε συνεργασία με την υποστήριξη της Voice Logica· μόλις ενεργοποιηθεί, εμφανίζεται στη λίστα **Σήραγγα** του παραθύρου σύνδεσης.

## Τι συμπληρώνετε

- **Προϊόν SAP** (required) — **S/4HANA (OData)** ή **Business One (Service Layer)**. Τα υπόλοιπα πεδία προσαρμόζονται στην επιλογή.
- **URL στο σύννεφο / Σήραγγα** (required) — Ο τρόπος με τον οποίο η Voice Logica φτάνει στο SAP.
- **Βασική διεύθυνση URL** (required) — Μόνο για σύνδεση cloud. Η διεύθυνση API του S/4HANA ή του on-prem Gateway, ή η ρίζα του Service Layer για Business One. Χωρίς κάθετο στο τέλος.
- **Σήραγγα** (required) — Μόνο για σύνδεση μέσω tunnel. Το ενεργό tunnel που οδηγεί στον server του SAP.
- **Βάση δεδομένων εταιρείας (CompanyDB)** (required) — Μόνο για Business One. Το όνομα του σχήματος εταιρείας όπως εμφανίζεται στο B1.
- **Πιστοποίηση** — Μόνο για S/4HANA. **Basic (χρήστης επικοινωνίας)** ή **OAuth2 (client credentials)**. Το Business One χρησιμοποιεί πάντα όνομα χρήστη και κωδικό.
- **Όνομα χρήστη / Κωδικός** (required) — Για πιστοποίηση Basic και για Business One. Ο χρήστης επικοινωνίας, υπηρεσίας ή B1 που περιγράφεται παραπάνω.
- **Αναγνωριστικό πελάτη / Μυστικό πελάτη / Token URL** (required) — Μόνο για S/4HANA με OAuth2. Και τα τρία προέρχονται από το communication arrangement.
- **SAP client (προαιρετικό)** — Μόνο για S/4HANA on-prem. Στο S/4HANA Cloud μένει κενό.

Στις **Προχωρημένες ρυθμίσεις**, όλα προαιρετικά:

- **Γλώσσα (προαιρετικό)** — S/4HANA: η γλώσσα των περιγραφών προϊόντων και των σχολίων στις παραγγελίες που δημιουργεί ο βοηθός.
- **Κωδικός χώρας τηλεφώνου** — `30` — Χρησιμοποιείται για την αντιστοίχιση του αριθμού του καλούντος με τα τηλέφωνα που είναι καταχωρημένα στο SAP.
- **Αποδοχή self-signed πιστοποιητικού TLS (on-prem HTTPS)** — Ενεργοποιήστε το μόνο για on-prem server με δικό του πιστοποιητικό.
- **Τύπος παραγγελίας πώλησης / Οργανισμός πωλήσεων / Κανάλι διανομής / Τομέας** — Μόνο για S/4HANA. Τα οργανωτικά στοιχεία που καταχωρούνται στις παραγγελίες του βοηθού. Ο οργανισμός πωλήσεων, το κανάλι διανομής και ο τομέας απαιτούνται για να μπορεί ο βοηθός να δημιουργεί παραγγελίες.
- **Αριθμός τιμοκαταλόγου (προαιρετικό)** — Μόνο για Business One. Ο τιμοκατάλογος από τον οποίο ο βοηθός διαβάζει τιμές.

## Πρώτη ρύθμιση

1. **Ενσωματώσεις - Κατάλογος - SAP ERP - Σύνδεση**

   Επιλέξτε προϊόν SAP, στη συνέχεια **URL στο σύννεφο** ή **Σήραγγα**, και συμπληρώστε τα διαπιστευτήρια για τον συγκεκριμένο συνδυασμό. Αν ο βοηθός θα καταχωρεί παραγγελίες, συμπληρώστε και τις προεπιλογές παραγγελίας στις **Προχωρημένες ρυθμίσεις**.

2. **Δοκιμή σύνδεσης**

   Η Voice Logica συνδέεται στο SAP και διαβάζει έναν πελάτη. Διορθώστε τυχόν σφάλμα πριν προχωρήσετε.

3. **Σύνδεση**

   Η σύνδεση αποθηκεύεται και ξεκινά ο πρώτος συγχρονισμός πελατών και προϊόντων. Στη συνέχεια ο συγχρονισμός επαναλαμβάνεται κάθε ώρα.

4. **Οι agents μου - ο βοηθός σας - Ικανότητες - Εργαλεία & ροές εργασίας**

   Ενεργοποιήστε το **SAP ERP**. Στις **Λειτουργίες** διατηρήστε το **Identify caller by phone** και προσθέστε όσες χρειάζεστε. Αφήστε ενεργό το **Auto-identify caller on connect**, ώστε ο καλών να εντοπίζεται πριν μιλήσει ο βοηθός. Αν ενεργοποιήσετε το **Create sales order**, ορίστε και τα **Max sales order value** και **Max sales order lines**.

5. **Αποθήκευση** του βοηθού.

6. **Επαλήθευση**

   Καλέστε τον βοηθό από αριθμό τηλεφώνου καταχωρημένο σε πελάτη του SAP. Ο βοηθός πρέπει να σας χαιρετήσει με την επωνυμία του πελάτη. Ρωτήστε «Σε ποια κατάσταση είναι η τελευταία μου παραγγελία;» και θα ακούσετε την πιο πρόσφατη παραγγελία πώλησης με ημερομηνία και κατάσταση. Ζητήστε στη συνέχεια ένα προϊόν με το όνομά του και ελέγξτε ότι ο βοηθός το εντοπίζει.

## Τι μπορεί να κάνει ο βοηθός

| Εργασία | Λειτουργίες |
|---|---|
| Αναγνώριση καλούντος | Αναγνώριση με βάση το τηλέφωνο· αναζήτηση πελάτη με ΑΦΜ, κωδικό πελάτη (CardCode) ή επωνυμία |
| Ερωτήσεις για προϊόντα | Αναζήτηση προϊόντων με όνομα, κωδικό ή barcode |
| Παραγγελίες | Λίστα πρόσφατων παραγγελιών πώλησης του πελάτη· ανάγνωση μίας παραγγελίας με γραμμές, ποσότητες και κατάσταση παράδοσης |
| Λογαριασμός | Ανοιχτό υπόλοιπο του πελάτη (Business One· το S/4HANA δεν επιστρέφει υπόλοιπο μέσω αυτής της σύνδεσης) |
| Λήψη παραγγελίας | Δημιουργία παραγγελίας πώλησης |

Η επιλογή **Pre-fetch recent orders on call start** φορτώνει τις τελευταίες παραγγελίες του αναγνωρισμένου πελάτη πριν μιλήσει ο βοηθός.

Το **Create sales order** καταχωρεί δεδομένα στο SAP και εκτελείται μόνο όταν το ενεργοποιήσετε στις **Λειτουργίες**. Στο S/4HANA απαιτεί επιπλέον να έχουν οριστεί στη σύνδεση ο οργανισμός πωλήσεων, το κανάλι διανομής και ο τομέας. Παραγγελίες που υπερβαίνουν το **Max sales order value** ή έχουν περισσότερες γραμμές από το **Max sales order lines** απορρίπτονται και ο βοηθός ενημερώνει τον πελάτη.

## Αντιμετώπιση προβλημάτων

**Η Δοκιμή σύνδεσης αποτυγχάνει**

Το μήνυμα σφάλματος περιλαμβάνει τον κωδικό HTTP που επέστρεψε το SAP.

- **401 ή 403**: λάθος χρήστης ή κωδικός, ή ο χρήστης δεν έχει εξουσιοδότηση στις υπηρεσίες OData (S/4HANA) ή στους Business Partners (Business One).
- **OAuth2 token request failed**: ελέγξτε Client ID, Client secret και Token URL σε σχέση με το communication arrangement.
- **Business One login failed**: ελέγξτε το όνομα CompanyDB και τον χρήστη B1.
- Λήξη χρόνου ή άρνηση σύνδεσης: το SAP δεν είναι προσβάσιμο από το διαδίκτυο. Χρησιμοποιήστε tunnel ή επιβεβαιώστε ότι το tunnel είναι ενεργό.

**Ο βοηθός δεν αναγνωρίζει πελάτη που υπάρχει στο SAP**

Η αναγνώριση βασίζεται στη συγχρονισμένη λίστα πελατών, που ανανεώνεται κάθε ώρα. Ελέγξτε ότι ο αριθμός του καλούντος είναι καταχωρημένος στον πελάτη στο SAP, ότι ο **Κωδικός χώρας τηλεφώνου** αντιστοιχεί στη χώρα σας και ότι στον βοηθό είναι επιλεγμένο το **Identify caller by phone**. Πελάτης που προστέθηκε πριν από λίγα λεπτά θα εμφανιστεί μετά τον επόμενο συγχρονισμό.

**Ο βοηθός δεν μπορεί να δημιουργήσει παραγγελία πώλησης**

Στο S/4HANA, συμπληρώστε **Οργανισμός πωλήσεων**, **Κανάλι διανομής** και **Τομέας** στη σύνδεση (για αλλαγή απαιτείται νέα σύνδεση). Ελέγξτε ότι στον βοηθό είναι επιλεγμένο το **Create sales order** και ότι η παραγγελία είναι εντός των ορίων αξίας και γραμμών που ορίσατε. Ο βοηθός εντοπίζει πρώτα τα προϊόντα μέσω αναζήτησης, οπότε το υλικό πρέπει να υπάρχει στη συγχρονισμένη λίστα προϊόντων.

## Επόμενα βήματα

[Ενεργοποίηση ενσωμάτωσης](https://docs.voicelogica.ai/el/integrations/) - σύνδεση εταιρείας και στη συνέχεια το εργαλείο του βοηθού.  
[Εργαλεία & ροές εργασίας](https://docs.voicelogica.ai/el/agent-configuration/built-in-tools/) - όπου ενεργοποιείται το εργαλείο SAP.  
[Soft1](https://docs.voicelogica.ai/el/integrations/erp/soft1/) · [Entersoft ONE](https://docs.voicelogica.ai/el/integrations/erp/entersoft-one/) · [Odoo](https://docs.voicelogica.ai/el/integrations/erp/odoo/) - άλλες συνδέσεις ERP.