Λογισμικό λογιστικής με API

Κάθε μέρος του Nordlet είναι διαθέσιμο μέσω ενός API τύπου JSON, με SDK, webhooks, επαναλήψεις ασφαλείς ως προς την ταυτότητα (idempotent retries) και έναν διακομιστή MCP για βοηθούς τεχνητής νοημοσύνης.

Ένα API (διεπαφή προγραμματισμού εφαρμογών) είναι ο τρόπος με τον οποίο ένα πρόγραμμα επικοινωνεί με ένα άλλο. Ένα λογιστικό API επιτρέπει στο δικό σας λογισμικό να δημιουργεί τιμολόγια, να καταχωρεί πληρωμές και να διαβάζει αναφορές, χωρίς να χρειάζεται κάποιος χρήστης να κάνει κλικ σε οθόνες.

Το Nordlet είναι λογισμικό λογιστικής όπου το API αποτελεί τον βασικό τρόπο πρόσβασης. Ό,τι κάνει η διαδικτυακή εφαρμογή είναι διαθέσιμο μέσω του ίδιου API τύπου JSON. Αυτή η σελίδα απευθύνεται σε προγραμματιστές και σε όσους αποφασίζουν με τι συνδέεται το προϊόν τους.

Τι κάνει το Nordlet

Ενιαία δομή αιτημάτων. Κάθε κλήση είναι της μορφής POST /v1/{module}/{resource}/{action} με σώμα JSON, για παράδειγμα sales/invoices/create ή bank/transactions/match.
Κλειδιά API με πεδία εμβέλειας (scopes). Κάθε κλειδί ανήκει σε μία εταιρεία και φέρει πεδία εμβέλειας όπως sales:read ή bank:write. Ένα κλειδί χωρίς το απαραίτητο πεδίο εμβέλειας λαμβάνει απάντηση 403.
Χρηματικά ποσά ως κείμενο. Τα ποσά είναι συμβολοσειρές δεκαδικών με έως 4 δεκαδικά ψηφία, ποτέ αριθμοί κινητής υποδιαστολής, ώστε να μη χάνονται σεντς λόγω στρογγυλοποίησης.
Ενιαία μορφή σφαλμάτων. Κάθε σφάλμα έχει τον ίδιο φάκελο με κωδικό, μήνυμα και αναγνωριστικό αίτησης.
Κοινά ερωτήματα λιστών. Κάθε κλήση list δέχεται τα ίδια πεδία σελιδοποίησης, ταξινόμησης και φιλτραρίσματος, και μπορεί να επιστρέφει σύνολα.
Πραγματικοί λογιστικοί κανόνες. Οι λογιστικές εγγραφές πρέπει να ισοσκελίζονται, οι αριθμοί παραστατικών δεν έχουν κενά, και μια κλειστή λογιστική περίοδος απορρίπτει νέες καταχωρίσεις με απάντηση 409. Κάθε αλλαγή καταγράφεται σε ένα αρχείο καταγραφής ελέγχου (audit log).

Ασφαλείς επαναλήψεις με αναλλοιοτητα (idempotency)

Ένα δίκτυο μπορεί να αποτύχει αφού το αίτημά σας έχει υποσταθεί επεξεργασία αλλά πριν λάβετε την απάντηση. Η επανάληψη θα μπορούσε τότε να δημιουργήσει το ίδιο τιμολόγιο δύο φορές. Η αναλλοιότητα (idempotency) σημαίνει ότι ένα επαναλαμβανόμενο αίτημα έχει το ίδιο αποτέλεσμα με το πρώτο.

Στείλτε μια κεφαλίδα Idempotency-Key με οποιαδήποτε κλήση τροποποιεί δεδομένα.
Μια επανάληψη με το ίδιο κλειδί και το ίδιο σώμα λαμβάνει πίσω την αποθηκευμένη απάντηση, με x-idempotent-replay: true.
Το ίδιο κλειδί με διαφορετικό σώμα απορρίπτεται.
Τα κλειδιά διατηρούνται για 24 ώρες.

Webhooks

Ένα webhook είναι ένα μήνυμα που στέλνει το Nordlet στον διακομιστή σας όταν συμβαίνει κάτι, όπως το sale_invoice.paid.

Τα γεγονότα γράφονται στην ίδια συναλλαγή βάσης δεδομένων με την αλλαγή, οπότε μια αλλαγή που αναιρείται δεν στέλνει κανένα γεγονός.
Κάθε παράδοση υπογράφεται με HMAC-SHA256 χρησιμοποιώντας το μυστικό της συνδρομής σας, ώστε να μπορείτε να επαληθεύσετε ότι προέρχεται από το Nordlet.
Μια αποτυχημένη παράδοση επαναλαμβάνεται για περίπου 24 ώρες. Μπορείτε επίσης να τη στείλετε ξανά με το χέρι.
Οι συνδρομές διαχειρίζονται στην ενότητα Account → Webhooks ή μέσω του API.

Εργαλεία για προγραμματιστές

Αναφορά API. Μια διαδραστική αναφορά API κατασκευασμένη από την περιγραφή OpenAPI, συν μια συλλογή Postman.
SDK. Πελάτες με τύπους για TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift και Rust, παραγόμενοι από την ίδια περιγραφή. Δείτε τον οδηγό SDK.
Διακομιστής MCP. Βοηθοί τεχνητής νοημοσύνης όπως το Claude μπορούν να κάνουν αναζήτηση και να καλούν το API χρησιμοποιώντας το κλειδί API σας. Δείτε τον οδηγό διακομιστή MCP.
Εταιρείες δοκιμών (sandbox). Μια εταιρεία δοκιμών λειτουργεί όπως μια πραγματική, επισημαίνεται ως δεδομένα δοκιμών και στέλνει υποβολές και ηλεκτρονικά τιμολόγια μόνο στα τελικά σημεία δοκιμών των αρχών.
Όριο ρυθμού κλήσεων (rate limit). 300 αιτήματα ανά λεπτό ανά κλειδί API, με κεφαλίδες που δείχνουν τι απομένει.

FAQ

Τι μπορώ να κάνω μέσω του API;

Τα πάντα στο προϊόν: τιμολόγηση, αγορές, γενικό καθολικό, αντιστοίχιση τραπεζών, αποθέματα, πάγια, μισθοδοσία, αναφορές και υποβολές ανά χώρα. Ο οδηγός ξεκινήματος παρουσιάζει έναν πλήρη κύκλο από το τιμολόγιο έως τα στοιχεία ΦΠΑ.

Μπορώ να ενσωματώσω τη λογιστική στο δικό μου προϊόν;

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