Pain001: συχνές ερωτήσεις για ταμείο, λειτουργίες, μηχανικούς

Ξεκάθαρες απαντήσεις για τα στελέχη ταμειακής διαχείρισης, τις λειτουργίες πληρωμών, τους μηχανικούς και τους ελεγκτές. Οι ερωτήσεις είναι διατυπωμένες όπως τις θέτουν πραγματικά οι άνθρωποι. Για βαθύτερη τεχνική ανάλυση, δείτε την Τεχνική αναφορά.

Για στελέχη ταμειακής διαχείρισης και οικονομικών#

Τι είναι το pain.001, σε μία παράγραφο;

Το pain.001 είναι το μήνυμα ISO 20022 που στέλνει ένας πελάτης στην τράπεζά του για να ξεκινήσει μεταφορές πίστωσης — ο διάδοχος σε XML μορφών όπως το SWIFT MT101 και τα εγχώρια αρχεία επίπεδης δομής. Η τράπεζά σας το επικυρώνει ως προς ένα σχήμα και έναν κανονισμό συστήματος πριν το αποδεχθεί. Το Pain001 (το λογισμικό) παράγει αυτά τα αρχεία από τα δεδομένα που ήδη διαθέτετε και αποδεικνύει ότι είναι έγκυρα πριν τα υποβάλετε.

Ποια είναι η διαφορά μεταξύ pain.001 και pain.008;

Η κατεύθυνση της ροής των χρημάτων. Το pain.001 ξεκινά μεταφορές πίστωσης — στέλνετε χρήματα προς τα έξω. Το pain.008 ξεκινά άμεσες χρεώσεις — εισπράττετε χρήματα που σας οφείλονται βάσει εντολής. Το Pain001 παράγει και τα δύο: δέκα εκδόσεις του pain.001 (από .001.03 έως .001.12) και το pain.008.001.02.

Στέλνουμε ακόμη αρχεία MT101. Πόσο επείγουσα είναι η μετάβαση;

Επείγουσα. Η SWIFT απέσυρε τα μηνύματα MT των κατηγοριών 1, 2 και 9 για τις διασυνοριακές διατραπεζικές εντολές πληρωμής τον Νοέμβριο του 2025· τα εταιρικά κανάλια που εξακολουθούν να δέχονται MT το κάνουν κατά τη διακριτική ευχέρεια κάθε τράπεζας και για περιορισμένο χρόνο ακόμη. Ο φορτωτής MT101 μετατρέπει τις υπάρχουσες ροές MT101 σε επικυρωμένο pain.001 χωρίς καμία επανακαταχώριση δεδομένων.

Τι σημαίνει για εμάς η προθεσμία του Νοεμβρίου 2026 για τις δομημένες διευθύνσεις;

Από το τέλος Νοεμβρίου 2026, οι πλήρως αδόμητες ταχυδρομικές διευθύνσεις δεν γίνονται πλέον δεκτές στις διασυνοριακές πληρωμές CBPR+· οι διευθύνσεις πρέπει να είναι δομημένες ή υβριδικές — διακριτά στοιχεία όπως πόλη () και χώρα () αντί για γραμμές ελεύθερου κειμένου. Αν τα κύρια δεδομένα σας τηρούν τις διευθύνσεις ως ενιαία κείμενα, η δουλειά βρίσκεται στα δεδομένα σας, όχι στη σύνδεση με την τράπεζα. Ξεκινήστε από εκεί. Η ενημέρωση για το 2026 καλύπτει αναλυτικά το χρονοδιάγραμμα.

Πόσο κοστίζει το Pain001;

Τίποτα. Ο πυρήνας διατίθεται με διπλή άδεια Apache-2.0 / MIT· τα συνοδευτικά πακέτα με Apache-2.0. Η εμπορική χρήση, η τροποποίηση και η αναδιανομή επιτρέπονται όλες. Ως μέτρο σύγκρισης, μόνο το SDK μετάφρασης της SWIFT τιμολογείται στα €10,000–30,000 ετησίως.

Για τις λειτουργίες πληρωμών#

Γιατί οι τράπεζες απορρίπτουν αρχεία πληρωμών;

Τέσσερις επαναλαμβανόμενες αιτίες: παραβιάσεις σχήματος (λάθος στοιχείο, λάθος έκδοση, λάθος namespace), εσφαλμένα αναγνωριστικά (αποτυχία αθροίσματος ελέγχου IBAN, κακοσχηματισμένα BIC), λανθασμένα σύνολα ελέγχου (NbOfTxs / CtrlSum που δεν συμφωνούν με τις συναλλαγές) και χαρακτήρες εκτός του λατινικού συνόλου ISO 20022. Το Pain001 ελέγχει και τα τέσσερα προτού καν δημιουργηθεί αρχείο: επικύρωση JSON Schema ανά εγγραφή, έλεγχοι IBAN με mod-97 και BIC κατά ISO 9362, επανυπολογισμένα σύνολα ελέγχου, μεταγραφή χαρακτήρων και τελική επικύρωση XSD του παραχθέντος XML.

Μπορούμε να επικυρώσουμε ένα αρχείο χωρίς να παραχθεί τίποτα;

Ναι — pain001 --dry-run (ή η υποεντολή validate ή το POST /api/v1/validate). Ο κωδικός εξόδου 0 σημαίνει έγκυρο· ο 1 σημαίνει ότι η επικύρωση απέτυχε με σφάλματα σε επίπεδο πεδίου. Εντάξτε το στο CI ή σε μια λίστα ελέγχου πριν από την υποβολή.

Ποιοι κανονισμοί SEPA καλύπτονται;

Πέντε κανονισμοί συστημάτων παρέχονται ενσωματωμένοι: SEPA Credit Transfer (sepa-sct), SEPA Instant (sepa-inst), SEPA Direct Debit Core (sepa-sdd), SEPA B2B (sepa-b2b) και διασυνοριακή μεταφορά πίστωσης (xborder-ct). Χρησιμοποιήστε --scheme --explain για να δείτε κάθε κανόνα που πέρασε ή απέτυχε.

Τα δεδομένα μας βρίσκονται σε Excel. Πού είναι η παγίδα;

Το Excel μετατρέπει σιωπηρά σε αριθμούς τις συμβολοσειρές που μοιάζουν με IBAN. Ο φορτωτής Excel διαβάζει απευθείας αρχεία .xlsx/.xlsm και σταματά αμέσως αν οι στήλες IBAN περιέχουν αριθμητικά κελιά — η αλλοίωση εντοπίζεται κατά τη φόρτωση, όχι στην τράπεζα.

Πώς διαχειρίζεται μια παρτίδα 500,000 γραμμών;

Η --streaming επεξεργάζεται την είσοδο σε τμήματα με περιορισμένη χρήση μνήμης (προεπιλογή 1,000 συναλλαγές), καθένα από τα οποία εξάγεται ως ξεχωριστό αρχείο XML με σωστά επανυπολογισμένα σύνολα ελέγχου. Το REST API προσφέρει το POST /api/v1/generate/async με παρακολούθηση κατάστασης εργασίας για τον ίδιο λόγο.

Για μηχανικούς και αρχιτέκτονες#

Πώς το ενσωματώνουμε — ως βιβλιοθήκη, CLI ή API;

Και οι τρεις επιλογές υπάρχουν ως ισότιμες επιφάνειες: ένα Python API με τύπους, ένα CLI με κωδικούς εξόδου φιλικούς προς CI και μια μικροϋπηρεσία FastAPI (pain001 serve) με τελικά σημεία σύγχρονης παραγωγής, ασύγχρονων εργασιών, ελέγχου υγείας και μετρικών Prometheus. Από κάτω λειτουργεί ο ίδιος αγωγός επικύρωσης, ώστε τα αποτελέσματα να μην αποκλίνουν ποτέ μεταξύ των επιφανειών.

Είναι όντως ασφαλής η παραγωγή XML απέναντι στη στρογγυλοποίηση κινητής υποδιαστολής;

Τα ποσά είναι decimal.Decimal από άκρη σε άκρη στην παραγωγή και στην επικύρωση συστήματος — αναλύονται ως ακριβείς δεκαδικοί, αθροίζονται ως ακριβείς δεκαδικοί και αποδίδονται χωρίς αναπαράσταση κινητής υποδιαστολής. Τα σύνολα ελέγχου επανυπολογίζονται από τις επικυρωμένες εγγραφές και δεν λαμβάνονται ποτέ ως δεδομένα από την είσοδο.

Ποια είναι η στάση ασφαλείας;

Κάθε ανάλυση XML περνά από το defusedxml (αποκλείοντας επιθέσεις XXE και επέκτασης οντοτήτων)· δεν υπάρχει lxml στο δέντρο εξαρτήσεων. Οι είσοδοι περνούν από επικυρωτή έναντι διάσχισης διαδρομών. Η εικόνα Docker εκτελείται χωρίς δικαιώματα root. Για τις εκδόσεις του πυρήνα παράγεται SBOM σε μορφή CycloneDX, ενώ ο εντοπισμός προσθέτων τρίτων μπορεί να απενεργοποιηθεί εντελώς με PAIN001_DISABLE_PLUGINS=1.

Πώς διασφαλίζεται η ποιότητα;

100% κάλυψη γραμμών και διακλαδώσεων ως αυστηρή πύλη CI στον πυρήνα (επαληθεύσιμα: 3,828 γραμμές, 926 διακλαδώσεις στο 100%), αυστηρό mypy, 100% κάλυψη docstring, έλεγχος ασφαλείας με Bandit και pip-audit, καθώς και σάρωση CodeQL. Τα συνοδευτικά πακέτα τηρούν την ίδια πειθαρχία κάλυψης 100%.

Μπορούμε να το επεκτείνουμε για μια ιδιόκτητη μορφή;

Ναι — τέσσερις ομάδες entry point για πρόσθετα (pain001.loaders, pain001.validators, pain001.schemes, pain001.writers). Ο φορτωτής Excel είναι ο ίδιος πρόσθετο που χρησιμοποιεί το δημόσιο πρωτόκολλο, οπότε λειτουργεί και ως υλοποίηση αναφοράς.

Για ελεγκτές και κανονιστική συμμόρφωση#

Μπορούμε να αναπαράγουμε ένα αρχείο που παρήχθη το προηγούμενο τρίμηνο;

Ναι. Καθηλώστε την έκδοση του πακέτου, επαναλάβετε την ίδια είσοδο και η έξοδος είναι ντετερμινιστική. Επειδή η αλυσίδα εργαλείων είναι ανοικτού κώδικα, η διαδρομή ελέγχου επεκτείνεται και στην ίδια τη διαδρομή του κώδικα — όχι απλώς σε μια βεβαίωση προμηθευτή.

Φεύγουν τα δεδομένα πληρωμών από το περιβάλλον μας;

Όχι. Κάθε συστατικό — CLI, βιβλιοθήκη, REST API, διακομιστής MCP, LSP — εκτελείται τοπικά. Δεν υπάρχει τηλεμετρία, ούτε κλήση προς SaaS, ούτε εξωτερική υπηρεσία επικύρωσης. Ο διακομιστής MCP επικοινωνεί αποκλειστικά μέσω stdio και όλα τα 17 εργαλεία του χαρακτηρίζονται ως μόνο ανάγνωσης και ιδεμποτικά.

Ποιος συντηρεί το Pain001;

Ο Sebastien Rousseau, στέλεχος μηχανικής fintech με έδρα το Λονδίνο, μαζί με συνεισφέροντες από την κοινότητα. Η ανάπτυξη είναι δημόσια στο GitHub, οι εκδόσεις δημοσιεύονται στο PyPI και το ιστορικό αλλαγών ενημερώνεται με κάθε κυκλοφορία.