Oxygen WooCommerce Plugin

Skroutz Invoice Uploader — Οδηγός Χρήσης

Αυτόματη ή χειροκίνητη αποστολή των PDF παραστατικών του Oxygen στο Skroutz

Με λίγα λόγια: το Skroutz Invoice Uploader αναλαμβάνει να ανεβάζει στο Skroutz το PDF του παραστατικού που έχει εκδοθεί από το Oxygen, ώστε ο πελάτης να μπορεί να το κατεβάσει από την πλατφόρμα του Skroutz.
Χρειάζεστε Skroutz API Token
Χρειάζεστε Oxygen Api key
Τρόπος λειτουργίας Αυτόματα ή χειροκίνητα
1

Τι κάνει το Skroutz Invoice Uploader

Μετά την έκδοση ενός παραστατικού στο Oxygen, το plugin μπορεί να πάρει το PDF και να το αποστείλει στο αντίστοιχο Skroutz order.

Η αποστολή μπορεί να γίνει:

  • Αυτόματα, μέσω της ουράς αποστολών (queue).
  • Χειροκίνητα, από τη σελίδα της συγκεκριμένης παραγγελίας στο WooCommerce.
2

Αρχική ρύθμιση

Η παρακάτω διαδικασία χρειάζεται να γίνει μόνο την πρώτη φορά.

1
Από το WordPress μεταβείτε:
WP Admin → Skroutz Invoice Uploader → Settings
2
Στο πεδίο Skroutz API Token εισάγετε το API Token που έχετε από το Skroutz merchant portal.
3
Στο πεδίο Oxygen Api key εισάγετε το αντίστοιχο token από τις ρυθμίσεις MyData του Oxygen.
4
Αν θέλετε οι αποστολές να γίνονται αυτόματα, ενεργοποιήστε την επιλογή Enable Automatic Upload.
5
Πατήστε Save Settings και στη συνέχεια Test API Connection, ώστε να ελέγξετε ότι η σύνδεση με το Skroutz λειτουργεί σωστά.
Έτοιμο. Εφόσον έχει ενεργοποιηθεί το Automatic Upload, οι νέες παραγγελίες Skroutz θα μπαίνουν αυτόματα στη διαδικασία αποστολής του παραστατικού.
3

Πώς λειτουργεί η αυτόματη αποστολή

Το Skroutz στέλνει το order webhook και δημιουργείται η αντίστοιχη παραγγελία στο WooCommerce.
Το Oxygen δημιουργεί το παραστατικό και η παραγγελία προστίθεται στην ουρά αποστολών με κατάσταση pending.
Ο αυτόματος μηχανισμός εκτελείται κάθε ώρα, κατεβάζει το PDF από το Oxygen και προσπαθεί να το ανεβάσει στο Skroutz.
Αν η αποστολή ολοκληρωθεί επιτυχώς, η κατάσταση γίνεται completed.
Δεν χρειάζεται να περιμένετε την επόμενη ώρα αν θέλετε άμεση επεξεργασία. Από το Dashboard μπορείτε να χρησιμοποιήσετε το Process Queue Now.
4

Χειροκίνητη αποστολή παραστατικού

Μπορείτε να στείλετε ένα παραστατικό άμεσα, χωρίς να περιμένετε την αυτόματη διαδικασία.

1
Ανοίξτε την παραγγελία στο WooCommerce.
2
Στη δεξιά πλευρά της σελίδας εντοπίστε το πλαίσιο Skroutz Invoice Uploader.
3
Πατήστε Upload Invoice to Skroutz.
4
Η αποστολή εκτελείται άμεσα. Αν ολοκληρωθεί επιτυχώς, προστίθεται σχετικό note στην παραγγελία και η κατάσταση γίνεται manually_uploaded.
Προσοχή: πριν πατήσετε το κουμπί, πρέπει να έχει ήδη δημιουργηθεί το παραστατικό Oxygen στη συγκεκριμένη παραγγελία.
Μια παραγγελία που έχει κατάσταση manually_uploaded δεν αποστέλλεται ξανά από την αυτόματη διαδικασία.
5

Τι σημαίνει κάθε κατάσταση

pending
Σε αναμονή.
Η παραγγελία περιμένει την επόμενη εκτέλεση της αυτόματης διαδικασίας.
completed
Ολοκληρώθηκε.
Το PDF ανέβηκε επιτυχώς στο Skroutz μέσω της αυτόματης διαδικασίας.
manually_uploaded
Χειροκίνητη αποστολή.
Το παραστατικό στάλθηκε από διαχειριστή και δεν θα επανεκτελεστεί αυτόματα.
retry
Θα γίνει νέα προσπάθεια.
Η προηγούμενη προσπάθεια απέτυχε, αλλά το σύστημα θα ξαναδοκιμάσει.
failed
Οριστική αποτυχία.
Έχουν εξαντληθεί οι διαθέσιμες προσπάθειες. Χρησιμοποιήστε το Reset Failed για νέα προσπάθεια.
6

Κουμπιά του Dashboard

Κουμπί Τι κάνει
Process Queue Now Εκτελεί άμεσα την ουρά αποστολών, χωρίς να περιμένετε την επόμενη ωριαία εκτέλεση.
Reschedule Cron Διαγράφει και δημιουργεί ξανά το ωριαίο cron schedule. Χρησιμοποιείται όταν η αυτόματη διαδικασία δεν εκτελείται σωστά.
Test API Connection Ελέγχει αν το Skroutz API Token είναι έγκυρο και αν η σύνδεση λειτουργεί.
Reset Failed (N) Επαναφέρει όλες τις παραγγελίες με κατάσταση failed σε pending, ώστε να γίνει νέα προσπάθεια αποστολής.
Clear Queue (N) Διαγράφει όλες τις εγγραφές της ουράς αποστολών.
Προσοχή στο Clear Queue: η διαγραφή της ουράς είναι μη αναστρέψιμη.
7

Συχνά προβλήματα και λύσεις

Πρόβλημα Τι να ελέγξετε
Οι παραγγελίες μένουν σε pending για πολλές ώρες Ελέγξτε αν λειτουργεί το WP-Cron. Δοκιμάστε πρώτα το Process Queue Now. Αν το cron δεν εκτελείται καθόλου, χρησιμοποιήστε το Reschedule Cron.
HTTP 404 — Order not found Ο κωδικός παραγγελίας Skroutz που υπάρχει στο WooCommerce δεν αντιστοιχεί σε υπαρκτή παραγγελία Skroutz. Ελέγξτε το order meta _skroutz_order_code.
No invoice data Δεν έχει δημιουργηθεί ακόμη το παραστατικό Oxygen για τη συγκεκριμένη παραγγελία.
PDF download failed Ελέγξτε το Oxygen Api key στις ρυθμίσεις. Μπορεί να είναι λάθος ή να έχει λήξει.
Οι παραγγελίες πηγαίνουν συνεχώς σε retry ή failed Κατεβάστε το log file από τα Settings και αναζητήστε γραμμές με την ένδειξη ERROR.
Έγινε χειροκίνητη αποστολή αλλά το cron προσπάθησε να στείλει ξανά Κανονικά αυτό δεν πρέπει να συμβαίνει. Η χειροκίνητη αποστολή ορίζει την κατάσταση manually_uploaded, την οποία το cron παραλείπει.
8

Πού θα βρείτε τα Logs

Τα logs είναι χρήσιμα όταν θέλετε να εντοπίσετε γιατί μια συγκεκριμένη παραγγελία δεν στάλθηκε.

Τρόπος 1 — Από τα Settings

Μεταβείτε στα Settings του Skroutz Invoice Uploader και πατήστε Download Log File. Θα κατέβει στον υπολογιστή σας το πιο πρόσφατο αρχείο skroutz-uploader-*.log.

Τρόπος 2 — Από το WooCommerce

Μεταβείτε:
WooCommerce → Status → Logs
και επιλέξτε skroutz-uploader από τη λίστα.

Στα logs εμφανίζονται και οι δύο κωδικοί της παραγγελίας, π.χ. WC#1433 / Skroutz#260818-9607017. Μπορείτε να αναζητήσετε οποιονδήποτε από τους δύο για να δείτε το ιστορικό της συγκεκριμένης παραγγελίας.