Εγχώριες Πωλήσεις Φαρμακαποθηκών Τεχνικές Προδιαγραφές Σειραϊκού Αρχείου Έκδοση 2.0.0 26/08/2013 Έκδοση 2.0.0 1 / 11
Κατάλογος περιεχομένων 1.0 Γενικά.... 3 2.0 Περιγραφή δομής.... 3 2.1 Πεδίο C0 Έτος εξαγωγής.... 3 2.2 Πεδίο C1 Μήνας εξαγωγής.... 3 2.3 Πεδίο C2 Barcode φαρμακευτικού προϊόντος.... 4 2.4 Πεδίο C3 Αριθμός παρτίδας.... 4 2.5 Πεδίο C4 Ποσότητα.... 4 2.6 Πεδίο C5 Κατηγορία πελάτη... 4 2.7 Πεδίο C6 Ταχυδρομικός κώδικας πελάτη.... 5 Παράρτημα 1.... 6 Παράρτημα 2.... 7 26/08/2013 Έκδοση 2.0.0 2 / 11
1.0 Γενικά. Το παρόν κείμενο περιγράφει τη δομή του σειριακού αρχείου που υποστηρίζεται από την διαδικτυακή εφαρμογή «Εγχώριες Πωλήσεις Φαρμακαποθηκών». 2.0 Περιγραφή δομής. Κάθε γραμμή του αρχείου αποτελείται από 7 πεδία και τερματίζεται με Cariage Return <CR> και Line Feed <LF>. Πεδίο 1 Πεδίο 2 Πεδίο 3 Πεδίο 4 Πεδίο 5 Πεδίο 6 Πεδίο 7 <CR> <LF> Η ονομασία του πεδίου που θα χρησιμοποιήσουμε στο εξής, θα αποτελείται από το γράμμα C και έναν αριθμό που περιγράφει τη θέση του πεδίου στη γραμμή. (π.χ. Η ονομασία του Πεδίου 1 θα είναι C0, ενώ το C3 αντιστοιχεί στο Πεδίο 4). Η γραμμή λοιπόν αναπαρίσταται ως εξής: C0 C1 C2 C3 C4 C5 C6 <CR> <LF> Κάθε πεδίο τερματίζεται με το σύμβολο «;» (Semi column) εκτός του τελευταίου πεδίου. Παράδειγμα: C0 C1 C2 C3 C4 C5 C6 2013; 08; 2802858801062; 873215; 25; 01; 11144 <CR> <LF> ΠΡΟΣΟΧΗ: Η κωδικοποίηση (encoding) του αρχείου πρέπει να είναι UTF-8. 2.1 Πεδίο C0 Έτος πώλησης. Το πεδίο C0 είναι το έτος που επωλήθη η συγκεκριμένη παρτίδα και έχει μορφή ΕΕΕΕ (2013). Η τιμή του πεδίου δεν πρέπει να είναι μεγαλύτερη από την τιμή του τρέχοντος έτους. 2.2 Πεδίο C1 Μήνας πώλησης. Το πεδίο C1 είναι αριθμητικό, περιέχει τον μήνα που έγινε η πώληση και έχει μήκος 2 χαρακτήρες. Αναλυτικά: Ιανουάριος 01 Φεβρουάριος 02 Μάρτιος 03 Απρίλιος 04 Μάιος 05 Ιούνιος 06 Ιούλιος 07 Αύγουστος 08 Σεπτέμβριος 09 26/08/2013 Έκδοση 2.0.0 3 / 11
Οκτώβριος 10 Νοέμβριος 11 Δεκέμβριος 12 Αν σε οποιαδήποτε περίπτωση το πεδίο έχει μήκος διαφορετικό από 2 χαρακτήρες, η εγγραφή θα απορρίπτεται αυτόματα από το σύστημα κατά την διαδικασία εισαγωγής. Επιπλέον, αν η τιμή του πεδίου δεν αντιστοιχεί στην τρέχουσα περίοδο (μήνα) ή είναι διαφορετική από 01 έως 12, η εγγραφή θα απορρίπτεται από το σύστημα. 2.3 Πεδίο C2 Barcode φαρμακευτικού προϊόντος. Το πεδίο C2 είναι αριθμητικό, περιέχει το barcode του φαρμακευτικού προϊόντος και έχει μήκος 13 χαρακτήρες. Αν σε οποιαδήποτε περίπτωση το πεδίο έχει μήκος διαφορετικό από 13 χαρακτήρες, η εγγραφή θα απορρίπτεται αυτόματα από το σύστημα κατά την διαδικασία εισαγωγής. Επιπλέον, αν η τιμή του πεδίου δεν αντιστοιχεί σε barcode προϊόντος, η εγγραφή θα απορρίπτεται από το σύστημα. Το πεδίο είναι αριθμητικό και δεν μπορεί να περιέχει αλφαβητικούς χαρακτήρες. 2.4 Πεδίο C3 Αριθμός παρτίδας. Το πεδίο C3 είναι ο αριθμός παρτίδας (Lot Number). Το μήκος του πεδίου είναι μεταβλητό με μέγιστη τιμή 50 χαρακτήρες. Η τιμή του πεδίου είναι αλφαριθμητική. Το πεδίο είναι προαιρετικό. Παράδειγμα εγγραφής δίχως αριθμό παρτίδας: 2012;03;2800000405021;;10;01;11144 2.5 Πεδίο C4 Ποσότητα. Το πεδίο C4 είναι ο αριθμός συσκευασιών που πωλήθηκαν. Η τιμή του πεδίου είναι αριθμητική με μέγιστη τιμή 2.147.483.647. Το πεδίο πρέπει να έχει ακέραια τιμή χωρίς διαχωριστικό χιλιάδων (Digit grouping symbol). Παράδειγμα: για τον αριθμό 2.123 η τιμή του πεδίου θα είναι 2123. 2.6 Πεδίο C5 Κατηγορία πελάτη. Το πεδίο C5 είναι ο κωδικός της κατηγορίας του πελάτη σύμφωνα με την κωδικοποίηση του Οργανισμού. Το μήκος του πεδίου είναι 2 χαρακτήρες. Αν σε οποιαδήποτε περίπτωση το πεδίο έχει μήκος διαφορετικό από 2 χαρακτήρες, η εγγραφή θα απορρίπτεται αυτόματα από το σύστημα κατά την διαδικασία εισαγωγής. Επιπλέον, αν η τιμή του πεδίου δεν αντιστοιχεί σε κωδικό κατηγορίας, η εγγραφή θα απορρίπτεται από το σύστημα. 26/08/2013 Έκδοση 2.0.0 4 / 11
Ανατρέξτε στο Παράρτημα 1 για την πλήρη λίστα των κατηγοριών με τους κωδικούς. Παράδειγμα: για την πώληση σε ένα φαρμακείο ο κωδικός είναι 02. 2.7 Πεδίο C6 Ταχυδρομικός κώδικας πελάτη. Το πεδίο C6 είναι ο ταχυδρομικός κώδικας του πελάτη. Το μήκος του πεδίου είναι 5 χαρακτήρες. 26/08/2013 Έκδοση 2.0.0 5 / 11
Παράρτημα 1. Κωδικοί και περιγραφές των κατηγοριών του πελάτη. 01 Φαρμακαποθήκη 02 Φαρμακείο 03 Ιδ. Κλινική 04 Νοσοκομείο 26/08/2013 Έκδοση 2.0.0 6 / 11
Παράρτημα 2. Παράδειγμα σειριακού αρχείου με στοιχεία πώλησης φαρμακευτικών προϊόντων για την περίοδο: Αύγουστος 2013. 2013;08;2802858801062;9873215;25;01;11144 2013;08;2802871401010;9873215;50;01;11144 2013;08;2802871601014;9873215;10;01;11144 2013;08;2802858801079;9873215;25;01;11144 2013;08;2802858801086;9873215;50;01;11144 2013;08;2802858801093;9873215;10;01;11144 2013;08;2802858801109;9873215;25;01;11144 2013;08;2802858802014;9873215;50;01;11144 2013;08;2802858802021;9873215;10;01;11144 2013;08;2802858802038;9873215;25;01;11144 2013;08;2802858802045;9873215;50;01;11144 2013;08;2802858802052;9873215;10;01;11144 2013;08;2802858802069;9873215;25;01;11144 2013;08;2800000402020;9873215;50;01;11144 2013;08;2800000403010;9873215;10;01;11144 2013;08;2800000404017;9873215;25;01;11144 2013;08;2800000405014;9873215;50;01;11144 2013;08;2800000405021;;10;01;11144 26/08/2013 Έκδοση 2.0.0 7 / 11