Nordlet για προγραμματιστές εφαρμογών

Προσθέστε τιμολόγηση, τήρηση λογιστικών βιβλίων και φορολογικές δηλώσεις της ΕΕ στο λογισμικό σας μέσω ενός JSON API, τυπωμένων SDK, webhooks, ενός διακομιστή MCP και δοκιμαστικών εταιρειών (sandbox companies).

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

Το Nordlet είναι λογισμικό λογιστικής σχεδιασμένο με γνώμονα το API (API-first). Ό,τι κάνει η web εφαρμογή διατίθεται επίσης μέσω ενός ενιαίου JSON API. Η εφαρμογή σας αποστέλλει τα γεγονότα και το Nordlet ενημερώνει τα βιβλία και προετοιμάζει τις φορολογικές δηλώσεις.

Τι κάνει το Nordlet

Εκθέτει κάθε ενέργεια ως POST /v1/{module}/{resource}/{action} με σώμα JSON, για παράδειγμα /v1/sales/invoices/create.
Πιστοποιεί την ταυτότητα κάθε αιτήματος με ένα κλειδί API που ανήκει σε μία εταιρεία. Κάθε κλειδί διαθέτει εύρη δικαιωμάτων (scopes), όπως sales:read ή sales:write, τα οποία περιορίζουν τις δυνατότητές του.
Δέχεται τα ποσά ως δεκαδικές συμβολοσειρές και ποτέ ως αριθμούς κινητής υποδιαστολής (floating-point numbers), ώστε να μην χάνονται σεντς από στρογγυλοποιήσεις.
Δέχεται μια κεφαλίδα Idempotency-Key σε κάθε αλλαγή. Μια επανάληψη με το ίδιο κλειδί επιστρέφει την πρώτη απάντηση αντί να εκτελέσει ξανά την εργασία. Η ιδιοποτελεια (idempotency) σημαίνει ότι ένα επαναλαμβανόμενο αίτημα έχει το ίδιο αποτέλεσμα με ένα μόνο αίτημα.
Επιστρέφει κάθε σφάλμα σε μία κοινή μορφή.
Επιτρέπει 300 αιτήματα ανά λεπτό ανά κλειδί API.
Καταγράφει κάθε αλλαγή σε ένα αρχείο καταγραφής ελέγχου (audit log).

Ο οδηγός συμβάσεων API καλύπτει καθים μία από αυτές τις απόλυτα λεπτομερείς κανόνες.

Βιβλία που παραμένουν ακριβή

Η έκδοση ενός τιμολογίου αποδίδει έναν αριθμό χωρίς κενά, ελέγχει ότι η λογιστική περίοδος είναι ανοιχτή και καταχωρεί την εγγραφή ημερολογίου (journal entry) στην ίδια συναλλαγή βάσης δεδομένων.
Κάθε καταχώριση πρέπει να ισοσκελίζεται. Η ίδια η βάση δεδομένων το ελέγχει αυτό κατά την αποθήκευση της συναλλαγής.
Τα εκδοθέντα και καταχωρισμένα έγγραφα δεν μπορούν να διαγραφούν. Μια εσφαλμένη αντιστοίχιση τράπεζας αναιρείται με μια αντιστρόφως ανάλογη εγγραφή και όχι με την επεξεργασία της παλιάς. Αυτό ακριβώς σημαίνει ένα αμετάβλητο καθολικό (immutable ledger).

SDK, MCP και webhooks

Τα τυπωμένα (typed) SDK παράγονται από την ίδια περιγραφή OpenAPI για TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift και Rust. Μέχρι να δημοσιευτεί ένα SDK, το εγκαθιστάτε από το αποθετήριο πηγαίου κώδικα (source repository) του. Δείτε τον οδηγό SDK.
Διατίθεται μια συλλογή Postman (Postman collection) με κάθε τελικό σημείο (endpoint).
Ο διακομιστής MCP επιτρέπει σε έναν βοηθό τεχνητής νοημοσύνης όπως το Claude Code να αναζητά στο API και να το καλεί με το κλειδί API σας. Κάθε κλήση είναι ένα συνήθες αίτημα API με τα ίδια εύρη δικαιωμάτων και όρια.
Τα webhooks ειδοποιούν την εφαρμογή σας όταν συμβαίνει κάτι, για παράδειγμα sale_invoice.issued ή sale_invoice.paid. Κάθε παράδοση υπογράφεται με μια υπογραφή HMAC, ώστε να μπορείτε να επαληθεύσετε ότι προέρχεται από το Nordlet. Οι αποτυχίες παράδοσης επαναλαμβάνονται για περίπου 24 ώρες.

Δοκιμές με δοκιμαστικές εταιρείες

Δημιουργήστε μια εταιρεία με την παράμετρο isSandbox: true ή επιλέξτε το πλαίσιο sandbox όταν ρυθμίζετε μια εταιρεία στην εφαρμογή.
Μια δοκιμαστική εταιρεία λειτουργεί όπως μια πραγματική: ίδια δομικά στοιχεία (modules), ίδιο API.
Επισημαίνεται σαφώς ως δεδομένα δοκιμής και δεν μπορείτε να μετατρέψετε μια πραγματική εταιρεία σε δοκιμαστική ή το αντίστροφο.
Οι δηλώσεις και τα e-τιμολόγια (e-invoices) μιας δοκιμαστικής εταιρείας αποστέλλονται στις υπηρεσίες δοκιμών των διοικητικών αρχών.
Η χρήση σε μια δοκιμαστική εταιρεία μετράται και χρεώνεται ακριβώς όπως η χρήση σε μια πραγματική εταιρεία.

Ο οδηγός ξεκινήματος σας καθοδηγεί βήμα προς βήμα στο πρώτο κλειδί API, το πρώτο τιμολόγιο και τον πλήρη κύκλο.

FAQ

Μπορεί μία εφαρμογή να εξυπηρετήσει πολλές εταιρείες;

Ναι. Κάθε κλειδί API ανήκει σε μία εταιρεία, οπότε δημιουργείτε ένα κλειδί ανά εταιρεία. Κάθε παράδοση webhook μεταφέρει το αναγνωριστικό companyId της εταιρείας στην οποία ανήκει, επομένως ένας μόνο δέκτης μπορεί να εξυπηρετήσει πολλές εταιρείες.

Πρέπει να δημιουργήσω τις φορολογικές δηλώσεις μόνος μου;

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