Ergani Submissions

Ελληνικά · English

Πώς φτάνουν τα χτυπήματα στο ΕΡΓΑΝΗ

Κάθε χτύπημα πρώτα αποθηκεύεται στη βάση της Karta και μετά στέλνεται στο ΕΡΓΑΝΗ από μια ουρά που τρέχει στο παρασκήνιο. Η οθόνη του καταστήματος δεν περιμένει ποτέ το ΕΡΓΑΝΗ: αν το ΕΡΓΑΝΗ αργεί ή δεν λειτουργεί, το χτύπημα είναι ασφαλές και στέλνεται μόλις γίνει δυνατό.

Καταστάσεις κινήσεων

Τις βλέπετε στο «Ρυθμίσεις» → «Κινήσεις» και στις αναφορές.

Κατάσταση	Τι σημαίνει
«Υποβλήθηκε»	Το ΕΡΓΑΝΗ το δέχτηκε· ο αριθμός πρωτοκόλλου έχει αποθηκευτεί.
«Σε αναμονή»	Περιμένει να σταλεί, ή να ξαναδοκιμαστεί μετά από σφάλμα.
«Απέτυχε»	Δεν έγινε δεκτό μετά από 30 προσπάθειες. Ελέγξτε το σφάλμα και ξαναστείλτε το χειροκίνητα.
«Προς έλεγχο στο ΕΡΓΑΝΗ»	Αβέβαιο: το αίτημα μπορεί να έφτασε στο ΕΡΓΑΝΗ, αλλά δεν ήρθε καθαρή απάντηση. Δείτε παρακάτω.
«Δοκιμή (δεν στάλθηκε)»	Έγινε σε dry_run· δεν στάλθηκε ποτέ.
«Μόνο στην κάρτα (δεν στάλθηκε)»	Καταχωρίστηκε από τον διαχειριστή μόνο στην Karta (ξεχασμένο χτύπημα / ξεχασμένη βάρδια). Δεν στέλνεται ποτέ.
«Προσαρμογή (δεν στάλθηκε)»	Έγινε στην περίοδο προσαρμογής. Δεν στέλνεται ποτέ.

Επαναλήψεις

Αν η αποστολή αποτύχει, η Karta ξαναδοκιμάζει με όλο και μεγαλύτερη παύση: 1 λεπτό, μετά 2, μετά 3, έως 15 λεπτά ανάμεσα στις προσπάθειες. Σταματά μετά από 30 προσπάθειες («Απέτυχε»). Τα σφάλματα βγάζουν ειδοποίηση:

• Απορρίφθηκε η σύνδεση: συνήθως λάθος ή ληγμένος κωδικός ΕΡΓΑΝΗ. Διορθώνεται στις «Ρυθμίσεις» → «Επιχείρηση και σύνδεση με το ΕΡΓΑΝΗ» (ή στο .env).
• Το ΕΡΓΑΝΗ απέρριψε το χτύπημα: η ειδοποίηση δείχνει το μήνυμα του ίδιου του ΕΡΓΑΝΗ. Οι απορρίψεις από το ΕΡΓΑΝΗ μένουν στη σελίδα διαχείρισης μέχρι να τις σημειώσετε ως ολοκληρωμένες.
• Το ΕΡΓΑΝΗ δεν λειτουργεί (HTTP 5xx) ή δεν υπάρχει σύνδεση: ξαναδοκιμάζεται αυτόματα.

Εκπρόθεσμες δηλώσεις

Αν ένα χτύπημα φτάσει στο ΕΡΓΑΝΗ περισσότερο από LATE_THRESHOLD_SECONDS (προεπιλογή 120) μετά τη στιγμή που έγινε, στέλνεται ως εκπρόθεσμη δήλωση με κωδικό αιτιολογίας:

Κωδικός	Αιτία	Πότε τον χρησιμοποιεί η Karta
001	Διακοπή ρεύματος	Μόνο όταν τον επιλέξετε εσείς με το «Τεχνικό πρόβλημα».
002	Μη διαθεσιμότητα συστημάτων του εργοδότη	Αυτόματα όταν απέτυχε η σύνδεση στο ΕΡΓΑΝΗ, ή όταν τον επιλέξετε με το «Τεχνικό πρόβλημα».
003	Μη διαθεσιμότητα συστημάτων του ΕΡΓΑΝΗ	Αυτόματα όταν το ΕΡΓΑΝΗ δεν λειτουργούσε, απέρριψε το αίτημα, ή δεν ήταν προσβάσιμο.

Ο κωδικός επιλέγεται από την πρώτη αποτυχία και κρατιέται για τις επόμενες προσπάθειες. Αν ξέρετε ότι η πραγματική αιτία ήταν άλλη (π.χ. διακοπή ρεύματος στο κατάστημα), καταχωρίστε το χτύπημα με το «Τεχνικό πρόβλημα» και διαλέξτε τον σωστό κωδικό.

Ένα ξεχασμένο χτύπημα δεν δηλώνεται ποτέ ως εκπρόθεσμο. Δεν είναι τεχνικό πρόβλημα, οπότε δεν ισχύει κανένας κωδικός. Κλείστε το με το «Ξέχασε να χτυπήσει» (μόνο στην Karta, δεν στέλνεται ποτέ).

Αβέβαιες υποβολές («Προς έλεγχο»)

Μερικές φορές το αίτημα μπορεί να έφτασε στο ΕΡΓΑΝΗ αλλά η απάντηση χάθηκε: η απάντηση άργησε, η σύνδεση κόπηκε στη μέση, ένας ενδιάμεσος server έδωσε HTTP 504, ή η απάντηση δεν μπορούσε να διαβαστεί. Αν σταλεί ξανά, το ίδιο χτύπημα μπορεί να δηλωθεί δύο φορές, οπότε η Karta δεν το ξαναστέλνει. Αντί γι' αυτό:

1. Βγάζει επείγουσα ειδοποίηση.
2. Ελέγχετε εσείς στο ΕΡΓΑΝΗ αν το χτύπημα υπάρχει.
3. Στις «Κινήσεις» επιλέγετε:
   • «Υπάρχει στο ΕΡΓΑΝΗ»: υπάρχει. Προαιρετικά γράψτε τον αριθμό πρωτοκόλλου.
   • «Δεν υπάρχει — νέα αποστολή»: δεν υπάρχει· στέλνεται ξανά.

Οι αποτυχίες που σίγουρα έγιναν πριν σταλεί οτιδήποτε (σφάλμα DNS, άρνηση σύνδεσης, απόρριψη της σύνδεσης χρήστη) ξαναδοκιμάζονται πάντα αυτόματα.

Οι λειτουργίες είναι ξεχωριστοί κόσμοι

Κάθε χτύπημα θυμάται σε ποια λειτουργία έγινε (dry_run, trial, production). Το ποιος είναι μέσα ή έξω, οι ειδοποιήσεις και οι αναφορές λαμβάνουν υπόψη μόνο την τρέχουσα λειτουργία. Δείτε Έναρξη κανονικής λειτουργίας.