Στο Απλές λύσεις σε σύνθετα προβλήματαφτιάξαμε ένα απλό πρόγραμμα για να μετατρέψουμε μια λίστα με objects σε xml αρχείο.
Σε αυτό το άρθρο θα δούμε τη λύση για ένα πολύ σύνθετο πρόβλημα.
Η λύση που παρουσιάζετε είναι σχετικά περίπλοκη, αλλά συνάμα μας επιτρέπει να δούμε και άλλες πτυχές της C# και το πως μπορούμε να την χρησιμοποιήσουμε για πραγματικά προβλήματα…
Στη σύγχρονη εποχή που ζούμε, όλα έχουν γίνει ψηφιακά. Οι τράπεζες για να γλυτώσουν κόστος διευκολύνουν τους πελάτες, έχουν εναρμονιστεί με τα ευρωπαϊκά πρότυπα που επιτρέπουν την αλληλεπίδραση με τα συστήματα τους.
Σε αυτό το άρθρο θα δούμε πως οι επιχειρήσεις μπορούν να κάνουν μαζικές πληρωμές προς τους προμηθευτές, μέσα από το σύστημα του SEPA.
Αυτό γλυτώνει χρόνο τόσο στις επιχειρήσεις όσο και στις τράπεζες. Οι επιχειρήσεις γλυτώνουν το κόστος εκτύπωσης και υπογραφής των επιταγών, οι δε τράπεζες γλυτώνουν το κόστος του υπάλληλου που θα καθίσει να καταχωρίσει την επιταγή .
Στην περίπτωση μας θα μελετήσουμε την δημιουργία ενός class library που ο σκοπός του είναι να δημιουργία το xml με βάση σύνθετων παραμέτρων.
Η ολοκληρωμένη λύση, συνάδει απόλυτα με τις προϋποθέσεις που θέτει η Τράπεζα Κύπρου στη κατηγορία ψηφιακά κανάλια οι προδιαγραφές βρίσκονται εδώ και ισχύουν σήμερα 15/11/2021
Πιθανό το εργαλείο να δουλεύει και για άλλες τράπεζες αλλά δεν το έχω δοκιμάσει.
Τι είναι το Class Library;
Με απλά λόγια είναι μια συλλογή με λειτουργίες.
Στη C# όταν χτιστεί παράγει DLL, το οποίο θα ενσωματώσουμε στη περίπτωση μου σε λογιστικό πρόγραμμα.
Το πρόβλημα.
Το λογιστήριο μιας επιχείρησης μέσω του λογιστικού προγράμματος του εκδίδει πληρωμές προς τους προμηθευτές. Πρότινος εκτυπώνονταν οι επιταγές και ο ιδιοκτήτης τις υπέγραφε.
Ένα άτομο καθόταν όλη μέρα και καλούσε τους προμηθευτές να έρθουν να παραλάβουν τις πληρωμές.
Όπως αντιλαμβανόμαστε η διαδικασία είναι χρονοβόρα.
Λύση…
Ενσωματώνουμε στο λογιστικό μας πρόγραμμα αντί για εκτύπωση επιταγών να περνά τις πληροφορίες στο dll μας και αυτό να επιστρέφει πίσω το xml αρχείο.
Η εγκρίσεις θα γίνονται ηλεκτρονικά (μεσώ διαχείρισης του λογιστικού).
Στη προκειμένη περίπτωση πάμε με αυτή τη μεθοδολογία γιατί μας επιτρέπει το λογιστικό πρόγραμμα μας να το πειράξουμε…
Στη περίπτωση που δεν μπορούσε να γίνει κάτι τέτοιο, τότε θα έπρεπε με κάποιο τρόπο να εξαχθούν τα δεδομένα από το λογιστικό και να γίνει η xml διαδικασία σε εξωτερικό πρόγραμμα.
Δεδομένα που πρέπει να “έχουμε“.
Η διαδικασία του SEPA με βάση το πρότυπο ISO 20022 (βλέπουμε τον οδηγό της τράπεζας) ορίζει ότι σαν βασικά στοιχεία:
- Ημερομηνία εκτέλεσης
- Αριθμός πληρωμών
- Σύνολο πληρωμής
- Όνομα του αποστολέα
- Το IBAN και το SWIFT του αποστολέα
- Λίστα με πληρωμές:
- Κωδικό προμηθευτή (προαιρετικό, αλλά μπορούμε να το χρησιμοποιήσουμε)
- Όνομα προμηθευτή
- Χώρα προμηθευτή (προαιρετικό, σε μορφή CY, GR κτλ.)
- Διεύθυνση αλληλογραφίας (μέχρι 3 γραμμές)
- IBAN
- SWIFT
- Ποσό πληρωμής
Όλα πεδία και τι πληροφορίες χρειάζονται, περιέχονται στο Schema μόνο για σκληροπυρηνικούς 😁🐱👤
Εκτέλεση: 👷♂️
Καταρχάς πρέπει να κατεβάσουμε το Schema, θα το αποθηκεύσουμε πχ στα Downloads.
θα χρησιμοποιήσουμε τα εργαλεία του Visual Studio ώστε να μετατρέψουμε το XSD αρχείο σε Κλάσεις (Classes) της C#.
Θα μπορούσαμε να γράψουμε μόνοι μας την Class;
Η απάντηση είναι ναι αλλά για τέτοιες περίπλοκες περιπτώσεις που ο πάροχος μας δίνει το schema συνιστάτε να μετατρέπουμε το schema σε κλάση. Εξάλλου η περιπλοκότητα που υπάρχει σε αυτές τις περιπτώσεις μπορεί να οδηγήσει σε λάθη και χρειάζεστε απίστευτος χρόνος για να δημιουργηθούν και να δοκιμαστούν
Η τοποθεσία του εργαλείου XSD.exe στη περίπτωση μου είναι στο
c:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\Βήμα πρώτο είναι να ανοίξουμε ένα command line και να σιγουρευτούμε ότι το αρχείο που κατεβάσαμε είναι στο ίδιο φάκελο.
Η εντολή που πρέπει να δώσουμε είναι η εξής
c:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\xsd.exe pain.001.001.03.xsd /cΘα μας δημιουργήσει ένα αρχείο που ονομάζεται pain_001_001_03.cs
Το εργαλείο μετάτρεψε το schema σε συγγενής κλάσεις, δηλαδή που συσχετίζονται μεταξύ τους.
Κρατάμε αυτό το αρχείο και προχωράμε με την δημιουργία της Class Library
Πιο κάτω θα πάμε επιγραμματικά να δούμε τη διαδικασία, για λεπτομέρειες, μπορείτε να δείτε τη συνέχεια στο βίντεο από το κανάλι μου στο YouTube
🎫Στη κλάση που δημιουργήθηκε αφού της αλλάξουμε όνομα σε SepaPaymentManager θα προσθέσουμε την constructor διαδικασία για τα δεδομένα που χρειαζόμαστε, όπως τα δηλώσαμε προηγουμένους
✨Οι πληρωμές όπως είπαμε είναι ξεχωριστός πίνακας με αντικείμενα και θα ορίσουμε και την κλάση που θα έχει μέσα μια constructor διαδικασία με τις πληροφορίες.
🏛 Στη συνέχεια θα δημιουργήσουμε ένα καινούργιο class αρχείο, όπου θα προσθέσουμε με αντιγραφή και επικόλληση τον κώδικα που μετατρέψαμε προηγουμένους, δηλαδή το Schema, κατόπιν θα αντικαταστήσουμε το public class σε όλο το αρχείο με sealed public class και φυσικά θα διαγράψουμε το namespace από το αρχείο μας ώστε να μπορούμε να ορίσουμε τα variables με το τύπο από διάφορες κλάσεις.
Το sealed class θα αποτρέψει την εμφάνιση κατά το declaration από εφαρμογές που θα χρησιμοποιούν το library μας, αλλά εσωτερικά θα μας επιτρέπει να το διαχειριστούμε. Άρα θα είναι μόνο για εσωτερική χρήση.
🧾Στην class SepaPaymentManager θα δηλώσουμε και μία μέθοδο που επιστρέφει string για να μπορεί το πρόγραμμα να επιστρέφει των XML κώδικα πίσω στο πρόγραμμα. Θα ονομάσουμε την μέθοδο μας ως GetXml.
Η GetXml θα δημιουργεί το header της πληρωμής με τα βασικά στοιχεία που θέλει η Τράπεζα και τις πληρωμές.
Ως τελικός χρήστης για να δημιουργήσουμε ένα SEPA xml αρχείο πρέπει απλά να περάσουμε τις πιο κάτω πληροφορίες και το class μας επιστρέφει σε μορφή string το xml.
