Χωρίς internet ή με το myDATA κάτω: επανάληψη με external_id και κλείσιμο ημέρας χωρίς Ζ
Τρία πράγματα μπορεί να σταματήσουν να απαντούν σε μια βάρδια, και το σύστημα παραγγελιοληψίας χειρίζεται το καθένα αλλιώς. Τι γίνεται όταν πέφτει το internet, όταν δεν απαντά η ΑΑΔΕ, πώς ξαναστέλνεις χωρίς διπλό παραστατικό, και πώς κλείνει η ημέρα χωρίς Ζ.
Παρασκευή βράδυ, γεμάτη σάλα, και κάτι σταματά να απαντά: το internet του καταστήματος, το δίκτυο του κινητού, ή το myDATA. Ένα σύστημα παραγγελιοληψίας πρέπει να ξέρει από πριν τι κάνει σε κάθε περίπτωση, γιατί οι τρεις δεν είναι ίδιες. Και στο τέλος της βραδιάς, τι σημαίνει «κλείσιμο ημέρας» όταν δεν υπάρχει ταμειακή.
Όταν πέφτει το internet του καταστήματος
Ένα παραστατικό εκδίδεται τη στιγμή που η κλήση φτάνει στο Wrapp. Το API δεν έχει πεδίο για ώρα έκδοσης εκτός σύνδεσης, οπότε δεν υπάρχει έκδοση offline που στέλνεται αργότερα. Αυτό που κρατά τη βάρδια όρθια είναι μια δεύτερη σύνδεση, για παράδειγμα ένα router 4G που μπαίνει σε λειτουργία όταν πέσει η κύρια γραμμή.
Τι κάνει νόμιμα η επιχείρηση όσο δεν έχει καμία σύνδεση, το απαντά ο λογιστής της.
Όταν δεν απαντά η ΑΑΔΕ
Αυτή είναι η καθησυχαστική περίπτωση. Αν το myDATA δεν απαντά, το παραστατικό δημιουργείται με το αναγνωριστικό του (UID) και το QR, η απάντηση είναι pending, και το Wrapp το ξαναστέλνει μόνο του μόλις η ΑΑΔΕ γυρίσει. Δεν χρειάζεται να ξαναστείλεις τίποτα από τη δική σου πλευρά.
Επανάληψη χωρίς διπλό παραστατικό: το external_id
Η δύσκολη περίπτωση είναι η ενδιάμεση: η κλήση φεύγει, η απάντηση δεν έρχεται, και δεν ξέρεις αν το παραστατικό εκδόθηκε. Αν ξαναστείλεις στα τυφλά, μπορεί να βγάλεις δεύτερη απόδειξη. Γι' αυτό υπάρχει το external_id.
- Βάλε εκεί τον αριθμό της παραγγελίας σου. Είναι μοναδικό ανά λογαριασμό, χωρίς διάκριση πεζών και κεφαλαίων.
- Μια δεύτερη κλήση με το ίδιο
external_idαπορρίπτεται (422, «external_id is already used by another invoice») πριν φτάσει στο myDATA, και δεν χαλάει αριθμό σειράς. - Μπορείς να διαβάσεις το παραστατικό με το
external_idστη θέση του id του Wrapp. Αν έχει ΜΑΡΚ, εκδόθηκε: μην το ξαναστείλεις. - Αν το myDATA απέρριψε την κλήση, παραστατικό δεν δημιουργήθηκε, οπότε το ίδιο
external_idξαναστέλνεται μετά τη διόρθωση.
Πρακτικά, ο κύκλος μετά από ένα timeout είναι: διάβασε με το external_id. Αν το παραστατικό υπάρχει, χρησιμοποίησέ το. Αν δεν υπάρχει, στείλε ξανά με το ίδιο external_id.
Κλείσιμο ημέρας χωρίς Ζ
Όταν η έκδοση γίνεται μέσω παρόχου, δεν υπάρχει Ζ και δεν υπάρχει ημερήσια αναφορά προς την ΑΑΔΕ: κάθε παραστατικό είναι ήδη στο myDATA με το ΜΑΡΚ του τη στιγμή που εκδίδεται. Στην πλευρά του Wrapp δεν κλείνει τίποτα.
Το κλείσιμο της ημέρας είναι δική σου συμφωνία, και το API σου δίνει τα δύο κομμάτια που χρειάζεσαι:
| Έλεγχος | Κλήση |
|---|---|
| Τι εκδόθηκε σήμερα | GET / για τη μία ημέρα, με συμφωνία στο external_id |
| Ποια δελτία παραγγελίας είναι ακόμη ανοιχτά | GET / |
Ο δεύτερος έλεγχος έχει προθεσμία: ένα δελτίο που δεν συσχετίστηκε με απόδειξη μέσα σε 24 ώρες σταματά την έκδοση όλης της επιχείρησης. Τι ορίζει ο κανόνας και πώς κλείνουν τα δελτία το εξηγεί ο οδηγός για το Δελτίο Παραγγελίας Εστίασης και τις 24 ώρες.
Πώς ξεκινάς
Κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και πάτα «Δοκίμασε το API». Στο staging δοκιμάζεις την επανάληψη με το ίδιο external_id και το κλείσιμο ημέρας, χωρίς φορολογική ισχύ. Τα σώματα αιτήματος είναι στα παραδείγματα JSON για παραγγελιοληψία.
Συχνές ερωτήσεις
Μπορώ να εκδίδω χωρίς internet και να στέλνω αργότερα;
Όχι μέσω του API. Ένα παραστατικό εκδίδεται τη στιγμή που η κλήση φτάνει στο Wrapp, και δεν υπάρχει πεδίο για ώρα έκδοσης εκτός σύνδεσης. Το κατάστημα χρειάζεται δεύτερη σύνδεση, για παράδειγμα router 4G. Τι κάνει νόμιμα όσο δεν έχει σύνδεση, το απαντά ο λογιστής.
Τι γίνεται αν το myDATA δεν απαντά;
Το παραστατικό δημιουργείται με UID και QR, η απάντηση είναι pending, και το Wrapp το ξαναστέλνει μόνο του όταν η ΑΑΔΕ γυρίσει. Από τη δική σου πλευρά δεν ξαναστέλνεις τίποτα.
Πώς ξαναστέλνω μετά από timeout χωρίς να βγάλω διπλή απόδειξη;
Με το external_id. Βάλε τον αριθμό της παραγγελίας σου: μια δεύτερη κλήση με το ίδιο external_id απορρίπτεται πριν φτάσει στο myDATA, χωρίς να χαλάσει αριθμό σειράς. Διάβασε πρώτα το παραστατικό με το external_id, και αν δεν υπάρχει, στείλε ξανά.
Υπάρχει Ζ όταν εκδίδω μέσω παρόχου;
Όχι. Δεν υπάρχει Ζ ούτε ημερήσια αναφορά προς την ΑΑΔΕ, γιατί κάθε παραστατικό είναι ήδη στο myDATA με το ΜΑΡΚ του. Το κλείσιμο ημέρας είναι δική σου συμφωνία, με τα εκδοθέντα της ημέρας από το find_all_invoices.
Τι πρέπει να ελέγχω στο τέλος της ημέρας;
Ότι ό,τι εκδόθηκε συμφωνεί με το σύστημά σου, με συμφωνία στο external_id, και ότι δεν έμειναν ανοιχτά δελτία παραγγελίας, από το list_open_catering_order_notes. Ένα δελτίο έχει 24 ώρες για να συσχετιστεί με απόδειξη.
Χρειάζεσαι βοήθεια;
Αν έχεις απορία για αυτό το θέμα ή θέλεις να σιγουρευτείς ότι όλα ρυθμίστηκαν σωστά, επικοινώνησε μαζί μας και θα το δούμε μαζί.