=== Business Cloud ERP Integration for WooCommerce ===
Contributors: businesscloudgr
Tags: ERP myDATA e-invoice Woocommerce Sync Accounting
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 8.2
WC requires at least: 8.5
WC tested up to: 10.9
Stable tag: 1.0.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Συνδέει το WooCommerce με το Business Cloud ERP για τον συγχρονισμό αποθέματος και τιμών και την αυτόματη αποστολή παραγγελιών στο ERP για άμεση ηλεκτρονική τιμολόγηση.

== Περιγραφή ==

Η επίσημη και δωρεάν διασύνδεση **Business Cloud ERP** για το **WooCommerce** συνδέει απευθείας το ηλεκτρονικό σας κατάστημα με την πλατφόρμα [Business Cloud ERP](https://businesscloud.gr/). Εάν χρησιμοποιείτε το WooCommerce μαζί με το Business Cloud, το πρόσθετο διατηρεί αυτόματα συγχρονισμένα τα δύο συστήματα, καταργώντας την επαναλαμβανόμενη χειροκίνητη καταχώριση δεδομένων. Υποστηρίζει επίσης την έκδοση τιμολογίων και αποδείξεων μέσω ηλεκτρονικής τιμολόγησης.

= Τι κάνει, με απλά λόγια =

Μετά την εγκατάσταση και τη σύνδεση με το κλειδί API σας, το πρόσθετο λειτουργεί διακριτικά στο παρασκήνιο και διαχειρίζεται τρεις βασικές διαδικασίες:

**Διατηρεί ακριβή τα επίπεδα αποθέματος.** Οι ποσότητες αποθέματος εισάγονται από το ERP στο WooCommerce σε χρονικό διάστημα που επιλέγετε, από κάθε 5 λεπτά έως μία φορά την ημέρα. Αυτό συμβάλλει στην αποφυγή πωλήσεων προϊόντων που δεν είναι πλέον διαθέσιμα και περιορίζει τις περιπτώσεις όπου οι πελάτες παραγγέλνουν είδη που εμφανίζονται λανθασμένα ως διαθέσιμα.

**Διατηρεί συγχρονισμένες τις τιμές των προϊόντων.** Όταν αλλάζει μια τιμή στο ERP, είτε λόγω ενημέρωσης προμηθευτή, προσφοράς είτε εποχικής προσαρμογής, η νέα τιμή μεταφέρεται στο αντίστοιχο προϊόν του WooCommerce κατά τον επόμενο συγχρονισμό. Ο ΦΠΑ υπολογίζεται σωστά σύμφωνα με τις φορολογικές ρυθμίσεις του WooCommerce.

**Αποστέλλει τις παραγγελίες απευθείας στο ERP.** Μόλις μια παραγγελία φτάσει σε κατάσταση WooCommerce που έχετε επιλέξει, όπως Σε επεξεργασία ή Ολοκληρωμένη, το πρόσθετο αποστέλλει ολόκληρη την παραγγελία στο ERP. Περιλαμβάνονται τα στοιχεία του πελάτη, τα προϊόντα, οι τρόποι πληρωμής και αποστολής, καθώς και τα πεδία τιμολογίου B2B. Οι ομάδες λογιστηρίου και logistics λαμβάνουν αυτόματα τα δεδομένα. Εάν μια παραγγελία δεν μπορεί να αποσταλεί, εμφανίζεται σαφές μήνυμα σφάλματος στην οθόνη της παραγγελίας, μαζί με ένα κουμπί **Αποστολή στο ERP** για νέα προσπάθεια μετά την επίλυση του προβλήματος.

= Ξεκινώντας =

Η ρύθμιση πραγματοποιείται από την ενότητα **Business Cloud ERP** στη διαχείριση του WordPress και συνήθως απαιτεί περίπου 10 λεπτά για ένα τυπικό κατάστημα:

1. **Καρτέλα Σύνδεση** 

Επικολλήστε το διακριτικό API που δημιουργήσατε στον λογαριασμό σας στο Business Cloud (*Επιλογές → Ρυθμίσεις → Διασύνδεση API → Παραγγελίες → Token*) και κάντε κλικ στο **Έλεγχος νέας σύνδεσης**. 
Μετά την επιτυχή σύνδεση, γίνονται διαθέσιμες οι υπόλοιπες καρτέλες ρυθμίσεων.

2. **Καρτέλα Ρυθμίσεις συγχρονισμού**

Ενεργοποιήστε τον συγχρονισμό αποθέματος και τιμών και, στη συνέχεια, επιλέξτε πόσο συχνά θα εκτελείται κάθε διαδικασία, από κάθε 5 λεπτά έως μία φορά την ημέρα. Τα χρονοδιαγράμματα αποθέματος και τιμών μπορούν να ρυθμιστούν ανεξάρτητα. 
Για τις παραγγελίες, επιλέξτε τις καταστάσεις του WooCommerce που θα ενεργοποιούν αυτόματα την αποστολή στο ERP, συνήθως *Σε επεξεργασία* ή/και *Ολοκληρωμένη*. 
Εάν παλαιότερες παραγγελίες έχουν ήδη καταχωριστεί χειροκίνητα στο ERP, ορίστε στο **Παράλειψη παραγγελιών έως το ID** τον πιο πρόσφατο αριθμό παραγγελίας που καταχωρίστηκε χειροκίνητα, ώστε αυτές οι παραγγελίες να μην αποσταλούν ξανά.

3. **Καρτέλα Αντιστοίχιση** 

Καθορίστε τον τρόπο αντιστοίχισης των προϊόντων μεταξύ WooCommerce και ERP, επιλέγοντας τι αντιπροσωπεύει το *βοηθητικό* πεδίο του ERP: Product ID, SKU ή προσαρμοσμένο meta key. 
Το πρόσθετο εμφανίζει τα ID των πυλών πληρωμής και των μεθόδων αποστολής του WooCommerce. Καταχωρίστε τα ίδια ID στις ρυθμίσεις του Business Cloud ERP, ώστε οι δύο πλατφόρμες να χρησιμοποιούν κοινές αναφορές. Μπορείτε επίσης να ορίσετε ποιες πύλες πληρωμής θα χαρακτηρίζουν τις εισερχόμενες παραγγελίες ως PAID ή UNPAID.

4. **Καρτέλα Τιμολόγιο**

Εάν η ολοκλήρωση αγοράς συλλέγει στοιχεία τιμολογίου, όπως ΑΦΜ, ΔΟΥ ή επάγγελμα, επιλέξτε το πρόσθετο τιμολόγησης που είναι ήδη εγκατεστημένο στο κατάστημά σας: Webexpert Timologio, Timologia for WooCommerce ή Greek VAT Invoices. Η διασύνδεση θα ανακτήσει αυτόματα τα σωστά πεδία. 
Για καταστήματα B2B όπου κάθε παραγγελία απαιτεί τιμολόγιο, επιλέξτε τη λειτουργία **Πάντα (B2B)**. 
Μπορείτε επίσης να καταχωρίσετε προσαρμοσμένα meta keys όταν χρησιμοποιείτε διαφορετική λύση τιμολόγησης.

5. **Καρτέλα Για προχωρημένους**

Επιλέξτε τον τύπο υπολογισμού αποθέματος (*Απόθεμα − Δεσμευμένα + Αναμενόμενα*, που συνιστάται για καταστήματα τα οποία χρησιμοποιούν παραγγελίες αγοράς, ή *Απόθεμα − Δεσμευμένα* για πιο συντηρητικό υπολογισμό της διαθέσιμης ποσότητας). 
Ορίστε ένα προεπιλεγμένο ποσοστό ΦΠΑ μόνο όταν οι φόροι του WooCommerce είναι απενεργοποιημένοι. 
Διατηρήστε την καταγραφή στη ρύθμιση **Σφάλμα** κατά την κανονική λειτουργία και αλλάξτε προσωρινά σε **Αποσφαλμάτωση** μόνο για τη διερεύνηση προβλημάτων.

6. **Καρτέλα Χειροκίνητος συγχρονισμός**

Αφού ολοκληρωθεί η ρύθμιση, κάντε κλικ στα **Ενημέρωση όλου του αποθέματος** και **Ενημέρωση όλων των τιμών** για να πραγματοποιήσετε την πρώτη πλήρη εισαγωγή από το ERP. 
Μια γραμμή προόδου εμφανίζει την κατάσταση κάθε συγχρονισμού. 
Μπορείτε να επιστρέφετε σε αυτή την καρτέλα όποτε χρειάζεται να εκτελέσετε πλήρη ενημέρωση μετά από σημαντικές αλλαγές στο ERP.

Μετά την αρχική ρύθμιση, το πρόσθετο λειτουργεί αυτόματα. Η κατάσταση συγχρονισμού κάθε παραγγελίας εμφανίζεται σε μια νέα στήλη **Κατάσταση ERP** στη λίστα παραγγελιών και σε ένα ειδικό meta box στην οθόνη επεξεργασίας της παραγγελίας. Από εκεί μπορείτε επίσης να επαναλάβετε χειροκίνητα την αποστολή μιας παραγγελίας, εάν η πρώτη προσπάθεια δεν ήταν επιτυχής.

= Απαιτήσεις =

* WordPress 6.4 ή νεότερο
* WooCommerce 8.5 ή νεότερο
* PHP 8.2 ή νεότερο
* Λογαριασμός Business Cloud ERP με πρόσβαση API

== External services ==

Αυτό το πρόσθετο επικοινωνεί με το API του Business Cloud ERP στη διεύθυνση `https://app.businesscloud.gr`. Η υπηρεσία χρησιμοποιείται για την επαλήθευση της σύνδεσης API του εμπόρου, την ανάκτηση πληροφοριών αποθέματος και τιμών από το ERP για την ενημέρωση προϊόντων του WooCommerce, τη λήψη δεδομένων αναφοράς από το ERP και τη μεταφορά παραγγελιών του WooCommerce στο ERP.

Απαιτούνται λογαριασμός πελάτη Business Cloud ERP και διακριτικό API. Το πρόσθετο δεν συνδέεται με το Business Cloud ERP μέχρι ένας διαχειριστής του καταστήματος να καταχωρίσει και να ελέγξει ένα διακριτικό API ή να ενεργοποιήσει τις λειτουργίες συγχρονισμού ή μεταφοράς παραγγελιών.

Κατά τον έλεγχο της σύνδεσης, τον συγχρονισμό αποθέματος ή τιμών ή την ανάκτηση δεδομένων αναφοράς από το ERP, το πρόσθετο συμπεριλαμβάνει το αποθηκευμένο διακριτικό API στις κεφαλίδες του αιτήματος. Τα αιτήματα συγχρονισμού αποθέματος και τιμών ενδέχεται επίσης να περιλαμβάνουν χρονική σήμανση `last_check`, ώστε το ERP να επιστρέφει μόνο τις πρόσφατες αλλαγές.

Όταν μια παραγγελία μεταφέρεται στο ERP, το πρόσθετο αποστέλλει τις πληροφορίες που απαιτούνται για την επεξεργασία της από το ERP. Σε αυτές μπορεί να περιλαμβάνονται το ID, η ημερομηνία και η κατάσταση της παραγγελίας, το όνομα, το τηλέφωνο και η διεύθυνση email του πελάτη, οι διευθύνσεις χρέωσης και αποστολής, ο τρόπος και η κατάσταση πληρωμής, ο τρόπος και το κόστος αποστολής, η σημείωση πελάτη, τα αναγνωριστικά προϊόντων, οι ποσότητες, οι τιμές, οι αξίες ΦΠΑ, οι χρεώσεις και τα ρυθμισμένα στοιχεία τιμολογίου, όπως ΑΦΜ, ΔΟΥ, επάγγελμα και επωνυμία εταιρείας, όταν είναι ενεργοποιημένη η υποστήριξη τιμολογίων.

Η υπηρεσία παρέχεται από την Business Cloud:

* Ιστότοπος υπηρεσίας: https://www.businesscloud.gr/
* Κεντρικός υπολογιστής API/εφαρμογής: https://app.businesscloud.gr/
* Επικοινωνία: https://www.businesscloud.gr/contact.php

Η πρόσβαση στο API του Business Cloud ERP είναι διαθέσιμη αποκλειστικά στους πελάτες της Business Cloud. Οι όροι υπηρεσίας και οι πληροφορίες απορρήτου παρέχονται στους πελάτες μέσω της σύμβασης και της σχέσης λογαριασμού τους με την Business Cloud.

== Installation ==

1. Μεταφορτώστε τον φάκελο `business-cloud-erp-integration` στον κατάλογο `/wp-content/plugins/` ή εγκαταστήστε το πρόσθετο από την οθόνη Προσθέτων του WordPress.
2. Ενεργοποιήστε το πρόσθετο από την οθόνη «Πρόσθετα» του WordPress.
3. Ανοίξτε το **Business Cloud ERP** από το μενού διαχείρισης και καταχωρίστε το κλειδί API σας.
4. Κάντε κλικ στο **Έλεγχος νέας σύνδεσης** για να επιβεβαιώσετε την πρόσβαση.
5. Ρυθμίστε τον συγχρονισμό, την αντιστοίχιση προϊόντων, την αντιστοίχιση πληρωμών και παραδόσεων και τις επιλογές προγραμματισμού στις διαθέσιμες καρτέλες.

== Frequently Asked Questions ==

= Πού μπορώ να βρω ένα κλειδί API; =

Συνδεθείτε στον λογαριασμό σας στο Business Cloud ERP και μεταβείτε στις Επιλογές → Ρυθμίσεις → Διασύνδεση API → Παραγγελίες → Token. Το διακριτικό μπορεί να δημιουργηθεί μόνο μία φορά και δεν μπορεί να εμφανιστεί ξανά, επομένως αποθηκεύστε το με ασφάλεια.

= Πώς λειτουργεί η αντιστοίχιση προϊόντων; =

Το πρόσθετο συνδέει τα προϊόντα του ERP με τα προϊόντα του WooCommerce μέσω του πεδίου "auxiliary" που επιστρέφει το ERP. Στην καρτέλα Αντιστοίχιση, επιλέξτε εάν αυτή η τιμή αντιστοιχεί στο Product ID του WooCommerce, στο SKU ή σε ένα προσαρμοσμένο meta field.

= Πόσο συχνά εκτελείται ο συγχρονισμός αποθέματος/τιμών; =

Ο συγχρονισμός αποθέματος και τιμών χρησιμοποιεί ξεχωριστά χρονοδιαγράμματα, με διαστήματα από κάθε 5 λεπτά έως μία φορά την ημέρα. Μια ρυθμιζόμενη περίοδος αναδρομής συμβάλλει στη διασφάλιση ότι δεν θα χαθεί καμία ενημέρωση.

= Τι συμβαίνει εάν αποτύχει η αποστολή μιας παραγγελίας; =

Το σφάλμα εμφανίζεται στο meta box του Business Cloud ERP στην οθόνη επεξεργασίας της παραγγελίας. Αφού διορθώσετε το πρόβλημα, κάντε κλικ στο "Αποστολή στο ERP" για να επαναλάβετε χειροκίνητα τη μεταφορά.

= Υποστηρίζει το πρόσθετο τιμολόγια; =

Ναι. Το πρόσθετο υποστηρίζει ελληνικά πεδία τιμολογίου από τα Webexpert Timologio, Timologia for WooCommerce και Greek VAT Invoices for WooCommerce. Μπορούν επίσης να ρυθμιστούν προσαρμοσμένα meta fields. Για καταστήματα B2B, υπάρχει επιλογή ώστε κάθε παραγγελία να αντιμετωπίζεται ως τιμολόγιο.

= Μπορώ να παραλείψω παλαιότερες παραγγελίες που έχουν ήδη καταχωριστεί στο ERP; =

Ναι. Στην καρτέλα Ρυθμίσεις συγχρονισμού, καταχωρίστε το ID της τελευταίας παραγγελίας που καταγράφηκε χειροκίνητα στο πεδίο "Παράλειψη παραγγελιών έως το ID". Κάθε παραγγελία με αυτό ή μικρότερο ID θα εξαιρείται.

== Screenshots ==

1. Καρτέλα Σύνδεση — καταχώριση και επαλήθευση του κλειδιού API.
2. Καρτέλα Σύνδεση — κατάσταση επιτυχούς σύνδεσης.
3. Ρυθμίσεις συγχρονισμού — ρύθμιση συγχρονισμού παραγγελιών.
4. Ρυθμίσεις συγχρονισμού — ρύθμιση συγχρονισμού αποθέματος και τιμών.
5. Χειροκίνητος συγχρονισμός — εκτέλεση πλήρους ενημέρωσης αποθέματος ή τιμών με γραμμή προόδου.
6. Αντιστοίχιση — ρύθμιση αντιστοίχισης προϊόντων και αντιστοίχισης τρόπων πληρωμής και παράδοσης.
7. Τιμολόγιο — επιλογή και ρύθμιση των πηγών πεδίων τιμολογίου.
8. Για προχωρημένους — ρύθμιση χειροκίνητου cron, επιλογών τιμολόγησης και εναλλακτικού ΦΠΑ.
9. Για προχωρημένους — ρύθμιση καταγραφής και διαχείρισης δεδομένων κατά την απενεργοποίηση.

== Changelog ==

= 1.0.0 =
* Αρχική έκδοση.
* Προγραμματισμένος και χειροκίνητος πλήρης συγχρονισμός αποθέματος.
* Προγραμματισμένος και χειροκίνητος πλήρης συγχρονισμός τιμών.
* Αυτόματη και χειροκίνητη αποστολή παραγγελιών στο ERP.
* Διασύνδεση τρόπων πληρωμής και παράδοσης με το ERP.
* Υποστήριξη πεδίων τιμολογίου για Webexpert, Timologia, Greek VAT Invoices και προσαρμοσμένα πεδία.
* Στήλη κατάστασης ERP στη λίστα παραγγελιών.
* Meta box κατάστασης ERP με κουμπί χειροκίνητης αποστολής στην οθόνη επεξεργασίας παραγγελίας.
* Ρυθμιζόμενη καταγραφή αποσφαλμάτωσης, πληροφοριών και σφαλμάτων.
* Συμβατότητα με HPOS.

== Upgrade Notice ==

= 1.0.0 =
Αρχική έκδοση.
