SBOX-II B Driver B version 1.01
Κατάλογος περιεχομένων Eγκατάσταση...3 SETUP...3 Βασικές Λειτουργίες...3 Αλλαγή Λεκτικού ΕΑΦΔΣΣ...3 Εκτύπωση Φορολογικών Δελτίων από την ΕΑΦΔΣΣ...3 Φάκελοι αποθήκευσης αρχείων...3 Προβολή Παραστατικού...3 Αναζήτηση Παραστατικού...3 Παράμετροι Ζ...4 Ειδικές εργασίες...4 Εγκατάσταση πολλαπλών ΕΑΦΔΣΣ για παράλληλη λειτουργία...4 DRIVER B...4 Τρόπος λειτουργίας...4 Εντολή κατάστασης...5 Εντολή σήμανσης...5 Εντολή Ζ...6 Εντολή X...6 Κωδικοί επιστροφής - σφάλματα από Driver Β...7 DRIVER B ActiveX DLL...7 ΜΕΘΟΔΟΙ...7 GetStatus...8 GetSIGN...8 SignTimeoutSecs...8 ZReport...8 XReport...8 DriverAlive...8 ΠΑΡΑΜΕΤΡΟΙ...9 ABCDIR...9 ΑΠΟΤΕΛΕΣΜΑΤΑ...9 SOLIDUS FISCAL SYSTEMS Σελίδα 2/9
Eγκατάσταση SETUP Εκτελούμε το setup_sboxiib.exe. Επιλέγουμε Επομενο όπου αυτό ζητηθεί. Μετά το τέλος της εγκατάστασης : Εναρξη - > Προγράμματα -> SOLIDUS -> SBOX-II -> SBOX-IIB Ρυθμίζουμε τις παραμέτρους σύνδεσης και πατάμε Σύνδεση. Θα πρέπει να εφμανιστεί ο Αριθμός Μητρώου. Πληκτρολογούμε τον κωδικό ενεργοποίησης της εφαρμογής. Και πατάμε ΟΚ. Στην μπάρα εικονιδίων των Windows θα εμφανιστεί ένα νέο εικονίδιο : Με δεξί κλικ στο εικονίδιο, Εκδοση ΔΗΦΑΣΣ (ΔελτιοΖ) Εφαρμογή SBOX-II : Aνοίγει το interface της εφαρμογής. Με διπλό κλικ στο εικονίδιο, ανοίγει το interface της εφαρμογής. Βασικές Λειτουργίες Αλλαγή Λεκτικού ΕΑΦΔΣΣ Ρυθμίσεις -> Στοιχεία Εκδότη. Δυνατότητα εισαγωγής 32 χαρακτήρων x 8 γραμμές λεκτικού της ΕΑΦΔΣΣ. Αυτόματο κεντράρισμα. Μετά την εισαγωγή του επιθυμητού λεκτικού πατάμε Αλλαγή ΕΑΦΔΣΣ εκτυπώνει παράνομη δελτίο με το νέο λεκτικό για να επαληθεύσουμε. Το λογισμικό ρωτάει προκειμένου να κάνει τελική καταχώρηση στην ΕΑΦΔΣΣ. Εκτύπωση Φορολογικών Δελτίων από την ΕΑΦΔΣΣ Το λογισμικό παρέχει την δυνατότητα εκτύπωσης από την ΕΑΦΔΣΣ Δελτίου Ζ,Δελτίου Χ,Περιοδικής αναφοράς ΦΜ από Ημερομηνία σε Ημερομηνία και Περιοδικής αναφοράς ΦΜ από Αριθμό Ζ σε Αριθμό Ζ. Φάκελοι αποθήκευσης αρχείων Ρυθμίσεις -> Γενικές Παράμετροι (καρτέλα Αρχεία) Τά αρχεία _a, _b, _c τηρούνται σε μορφή δέντρου ( \0001...\1800) Πατάμε το κουμπί αρίστερα από 'Κύριο φάκελο αποθήκευσης αρχείων' για επίλογη φακέλου σε έναν από τους τοπικούς δίσκους του Η/Υ. Πατάμε το κουμπί αρίστερα από 'Εναλλακτικό φάκελο αποθήκευσης αρχείων' για επίλογη φακέλου σε έναν από τους τοπικούς δίσκους του Η/Υ ή σε αντιστοιχισμένο δίσκο δικτύου. Προβολή Παραστατικού Από την λίστα παραστατικών, με διπλό κλίκ σε γραμμή αυτής εμφανίζεται το παραστατκό (αρχείο a) και η αντίστοιχη ΠΑΗΨΣ αυτού (αρχείο b). Αναζήτηση Παραστατικού Προβολές -> Αναζήτηση Παραστατικών. Επιλέγουμε Ημερομηνία και κείμενο αναζήτησης. Εφόσον θέλουμε η αναζήτηση να γίνει σε όλο το μήνα, τσεκάρουμε το Σε όλο το μήνα. Πατάμε Εκκίνηση Το λογισμικό αναζητά παραστατικά που ικανοποιούν τα κριτήρια και τα εμφανίζει σε λίστα. Με διπλό κλίκ επι του παραστατικού, εμφανίζεται το παραστατικό και δίνεται η δυνατότητα αποθήκευσης αυτού συννενομένο με το αντίστοιχο αρχείο _b. SOLIDUS FISCAL SYSTEMS Σελίδα 3/9
Παράμετροι Ζ Ρυθμίσεις -> Γενικές Παράμετροι (καρτέλα Παράμετροι Ζ) Εδώ παρέχονται όλες οι ρυθμίσεις για αυτόματη έκδοση Δελτίου Ζ υπό συνθήκες. Ειδικές εργασίες Ρυθμίσεις -> Ειδικές εργασίες Το λογισμικό παρέχει την δυνατότητα επαναφοράς αρχείων _c από την ΦΜ της ΕΑΦΔΣΣ, επανατροφοδότησης αρχείων _a μετά από βλάβη CMOS και εγκατάστασης της ΕΑΦΔΣΣ. Εγκατάσταση πολλαπλών ΕΑΦΔΣΣ για παράλληλη λειτουργία Στή διαδρομή \Program files\sbox-ii υπάρχει το αρχείο SBOXIIB.exe. Με αντιγραφή και επικόλληση αυτού του αρχείο ώς SBOXIIB1.exe και στην συνέχεια εκτέλεση αυτού, δίνεται η δυνατότητα ενεργοποίησης 2ης ΕΑΦΔΣΣ με ξεχωριστό σετ εκτυπωτών σε παράλληλη λειτουργία με την 1η ΕΑΦΔΣΣ. Το λογισμικό επιτρέπει την λειτουργία μέχρι τεσσάρων (4) ΕΑΦΔΣΣ με επανάληψη της παραπάνω διαδικασίας για τα αρχεία SBOXIIB2.exe,SBOX-IIB3.exe DRIVER B Τρόπος λειτουργίας O Driver B δέχεται εντολές από αρχείο εντολών (CommandFile). Προκαθορισμένο αρχείο εντολών είναι : C:\SBOX\EXEC\cmdfile.txt Μπορεί να αλλάξει από Ρυθμίσεις->Γενικές Παράμετροι->Αρχείο Εντολών. Το CommandFile μπορεί να περιέχει τις εντολές : COMMAND =(υποχρεωτικός ορισμός εντολής) RESULTFILE =(υποχρεωτικός ορισμός αρχείου αποτελέσματος) ABCDIR =(προαιρετικός εναλλακτικός φάκελος αποθήκευσης αρχείων) CONVERT_TO_928 =(προαιρετικό) (για σήμανση και εφόσον το αρχείο εισόδου είναι DOS737, βάζουμε =1) DATAFILE =(για σήμανση, το αρχείο που περιέχει τα δεδομένα προς σήμανση) Το αρχείο αποτελέσματος είναι της μορφής: DataFile =(ποιο ήταν το αρχείο προς σήμανση) Command =(ποια ήταν η εντολή) Command_Param =(αδιάφορο) ReturnCode =(ο κωδικός επιστροφής από τον driver) =(σχόλιο σχετικό με την επιστροφή από τον driver) =(Αριθμός Μητρώου ΕΑΦΔΣΣ) Z_Signature =(Υπογραφή Ζ στην αντίστοιχη εντολή) SlipSignature =(Υπογραφή Σήμανσης στην αντίστοιχη εντολή) DaySignatures =(Αριθμός υπογραφών ημέρας) NumberOfZ =(Α/Α Ζ) TotalOfSignatures=(Συνολικός αριθμός υπογραφών) DateTime =(Ημερομηνία ώρα στη μορφή YYMMDDHHmm πχ.1203301344) Firmware =(Έκδοση λογισμικού ΕΑΦΔΣΣ) DeviceModel =(Μοντέλο ΕΑΦΔΣΣ) AFilename =(Σήμανση : Το αρχείο _a.txt με πλήρη διαδρομή) BFilename =(Σήμανση : Το αρχείο _b.txt με πλήρη διαδρομή) CFilename =(Z : Το αρχείο _c.txt με πλήρη διαδρομή) SOLIDUS FISCAL SYSTEMS Σελίδα 4/9
Εντολή κατάστασης Το CommandFile πρέπει να περιέχει τις εντολές: COMMAND=? RESULTFILE=C:\SBOX\EXEC\result.txt Το αρχείο αποτελέσματος έχει την μορφή: DataFile = Command =? Command_Param = ReturnCode =000 =No Errors =EYP11111111 Z_Signature =- SlipSignature =- DaySignatures =0000 NumberOfZ =0455 TotalOfSignatures=- DateTime =1203301344 Firmware =1.14 DeviceModel =SBOXII AFilename =- BFilename =- CFilename =- Εντολή σήμανσης Το CommandFile πρέπει να περιέχει τις εντολές: COMMAND=I DATAFILE=C:\SBOX\EXEC\DATAFILE.txt RESULTFILE=C:\SBOX\EXEC\result.txt H εντολή CONVERT_TO_928 αφορά μόνο σε περιπτώσεις όπου τα δεδομένα είναι σε κωδικοσελίδα DOS737. Σε αυτή την περίπτωση βάζουμε στο CommandFile: CONVERT_TO_928=1 Το αρχείο αποτελέσματος έχει την μορφή: DataFile =C:\SBOX\EXEC\DATAFILE.txt Command =I Command_Param = ReturnCode =000 =No Errors =EYP11111111 Z_Signature =- SlipSignature =83E09A07700E88C6133A37C448CE4430E4D79913 0001 00007199 1203301347 EYP11111111 DaySignatures =0001 NumberOfZ =0455 TotalOfSignatures=00007199 DateTime =1203301347 Firmware =1.14 DeviceModel =SBOXII AFilename =C:\SBOX\DATA\EYP11111111\0455\EYP1111111112033004550001_a.txt BFilename =C:\SBOX\DATA\EYP11111111\0455\EYP1111111112033004550001_b.txt CFilename =- SOLIDUS FISCAL SYSTEMS Σελίδα 5/9
Εντολή Ζ Το CommandFile πρέπει να περιέχει τις εντολές: COMMAND=Z RESULTFILE=C:\SBOX\EXEC\result.txt Το αρχείο αποτελέσματος έχει την μορφή: DataFile = Command =Z Command_Param = ReturnCode =000 =No Errors =EYP11111111 Z_Signature =133B87A84EE1287718CB24F8E9D22D32BFD4C9A4 SlipSignature =- DaySignatures =0000 NumberOfZ =0454 TotalOfSignatures=- DateTime =1203301334 Firmware =1.14 DeviceModel =SBOXII AFilename =- BFilename =- CFilename =C:\SBOX\DATA\EYP11111111\0454\EYP1111111112033013340454_c.txt Εντολή X Το CommandFile πρέπει να περιέχει τις εντολές: COMMAND=X RESULTFILE=C:\SBOX\EXEC\result.txt Το αρχείο αποτελέσματος έχει την μορφή: DataFile = Command =X Command_Param = ReturnCode =000 =No Errors =EYP11111111 Z_Signature =- SlipSignature =- DaySignatures =0001 NumberOfZ =0455 TotalOfSignatures=- DateTime =1203301350 Firmware =1.14 DeviceModel =SBOXII AFilename =- BFilename =- CFilename =- SOLIDUS FISCAL SYSTEMS Σελίδα 6/9
Κωδικοί επιστροφής - σφάλματα από Driver Β Ο driver επιστρέφει αποτέλεσμα στο πεδίο ReturnCode 000 Κανένα σφάλμα 001 Ο Driver Β είναι απασχολημένος 002 Πλήρωση Φορολογικής Μνήμης 003 Πρέπει να γίνει επανατροφοδότηση παραστατικών 004 Πλήρωση μνήμης εργασίας (9.999 σημάνσεις) 005 Υποχρεωτική έκδοση Ζ 006 Σφάλμα. Το πεδίο περιέχει την περιγραφή του σφάλματος 007 Δεν βρέθηκε το datafile 008 Άγνωστη εντολή 009 Το datafile έχει μέγεθος < 10 bytes 010 Ψευδοσήμανση (ο driver βρίσκεται σε δοκιμή λειτουργίας) 011 Το datafile δεν είναι προσπελάσιμο 012 Τέλος χαρτιού 013 Το datafile έχει μέγεθος > 102400 bytes DRIVER B ActiveX DLL Με την εγκατάσταση του driver, καταχωρείται στα Windows (system32) το ActiveX DLL sboxiib.dll To Dlll περιέχει την κλάση SBOXIIB.BClient ΜΕΘΟΔΟΙ Όλες οι μέθοδοι επιστρέφουν : 0 Κανένα σφάλμα 1 Ο Driver Β είναι απασχολημένος 2 Πλήρωση Φορολογικής Μνήμης 3 Πρέπει να γίνει επανατροφοδότηση παραστατικών 4 Πλήρωση μνήμης εργασίας (9.999 σημάνσεις) 5 Υποχρεωτική έκδοση Ζ 6 Σφάλμα. Το πεδίο περιέχει την περιγραφή του σφάλματος 7 Δεν βρέθηκε το datafile 8 Άγνωστη εντολή 9 Το datafile έχει μέγεθος < 10 bytes 10 Ψευδοσήμανση (ο driver βρίσκεται σε δοκιμή λειτουργίας) 11 Το datafile δεν είναι προσπελάσιμο 12 Τέλος χαρτιού 13 Το datafile έχει μέγεθος > 102400 bytes 14 Timeout 15 Δεν βρέθηκε B Driver 16 Υπάρχει εκτέλεση σε εξέλιξη SOLIDUS FISCAL SYSTEMS Σελίδα 7/9
GetStatus GetStatus() As Long Επιστρέφει στοιχεία ΕΑΦΔΣΣ και κατάσταση. GetSIGN GetSIGN(Data As String, [IsDOS As Boolean = False]) As Long Λήψη σήμανσης. Data είναι τα δεδομένα προς σήμανση. IsDOS = true μόνο αν τα δεδομένα είναι σε κωδικοσελίδα DOS737. SignTimeoutSecs SignTimeoutSecs(NewTimeout As Integer) As Boolean Ορίζει το timeout για την σήμανση. Προκαθορισμένο 15 secs. Επιτρεπτές τιμές από 5 έως 30 secs. Επιστρέφει True/False. ZReport ZReport() As Long Έκδοση Ζ XReport XReport() As Long Έκδοση Χ DriverAlive DriverAlive() As Long Επαληθεύει ότι ο Driver Β εκτελείτε κανονικά. SOLIDUS FISCAL SYSTEMS Σελίδα 8/9
ΠΑΡΑΜΕΤΡΟΙ ABCDIR Ο Driver B πάντα παράγει αρχεία στο C:\SBOX\DATA\<SERIALNUMBER>\ και εναλλακτικά στο C:\SBOX\BACKUP\<SERIALNUMBER>\. Με την παράμετρο αυτή μπορούμε να ορίσουμε τον εναλλακτικό φάκελο αποθήκευσης δεδομένων. ΑΠΟΤΕΛΕΣΜΑΤΑ AFilename BFilename Σήμανση : Το αρχείο _a.txt με πλήρη διαδρομή Σήμανση : Το αρχείο _b.txt με πλήρη διαδρομή CFilename Z : Το αρχείο _c.txt με πλήρη διαδρομή DateTime DayID DaySignatures DeviceModelID ErrorDescription SerialNumber SlipSignature TotalSignatures ZSignature Ημερομηνία ώρα στη μορφή YYMMDDHHmm πχ.1203301344 Α/Α Ζ Αριθμός υπογραφών ημέρας Μοντέλο ΕΑΦΔΣΣ Σχόλιο σχετικό με την επιστροφή από τον driver Αριθμός Μητρώου ΕΑΦΔΣΣ Υπογραφή Σήμανσης στην αντίστοιχη εντολή Συνολικός αριθμός υπογραφών Υπογραφή Ζ στην αντίστοιχη εντολή SOLIDUS FISCAL SYSTEMS Σελίδα 9/9