Δωρεάν API τιμολογίων για προγραμματιστές

Βασικό URL

https://freebillgen.com/api/v1

Αυθεντικοποίηση

Κάθε αίτημα χρησιμοποιεί Bearer token. Δημιουργήστε ένα στις Ρυθμίσεις → Κλειδιά API, εκχωρήστε του τα απαραίτητα δικαιώματα ανάγνωσης/εγγραφής ανά πόρο, ορίστε προαιρετική ημερομηνία λήξης και στείλτε το σε κάθε αίτημα:

Authorization: Bearer <your-api-key>

Τα αιτήματα ταυτοποιούνται με τον λογαριασμό που δημιούργησε το κλειδί και ελέγχονται ως προς τα εκχωρημένα δικαιώματα. Κρατήστε το token μυστικό και ανακαλέστε το εάν εκτεθεί ή δεν χρειάζεται πλέον.

Τι μπορείτε να κάνετε

Ανάγνωση τιμολογίων, πελατών, εταιρειών, πληρωμών και επαναλαμβανόμενων χρονοδιαγραμμάτων
Δημιουργία και ενημέρωσή τους (API εγγραφής - Pro)
Λήψη αναφορών ΦΠΑ και παλαιότητας σε μορφή JSON
Ανάγνωση της ίδιας περιορισμένης ουράς «Επόμενες ενέργειες» που χρησιμοποιείται από τον πίνακα ελέγχου
Ανάγνωση αρχείων ηλεκτρονικών τιμολογίων προμηθευτών που μεταφορτώσατε χειροκίνητα στα Εισερχόμενα (δεν αποτελεί σημείο λήψης Peppol/email)
Λήψη γενικών αντιστοιχίσεων OASIS UBL και UN/CEFACT CII για έλεγχο (χωρίς επικύρωση προφίλ)
Καταχώριση τελικών σημείων webhook για συμβάντα τιμολογίων και πληρωμών (Pro)
Idempotency-Key σε υποστηριζόμενες εγγραφές - τροποποιημένα δεδομένα αιτήματος με το ίδιο κλειδί επιστρέφουν 409
Σελιδοποίηση με δρομέα μέσω links.next, ρυθμιζόμενη με per_page (μέγ. 100)
Επιτρέψτε σε πράκτορες AI να διαβάζουν οποιοδήποτε κοινοποιημένο τιμολόγιο - schema.org/Invoice JSON-LD, καθώς και Accept: application/json ή text/markdown σε κάθε υπογεγραμμένο σύνδεσμο κοινοποίησης
Διακομιστής MCP μόνο για ανάγνωση, χωρίς αυθεντικοποίηση, στη διεύθυνση https://freebillgen.com/api/mcp (get_invoice, verify_invoice) για πράκτορες AI

Συμβάσεις

Αποφυγή διπλής εκτέλεσης (idempotency): Σε υποστηριζόμενες κλήσεις δημιουργίας και ενέργειας, στείλτε ένα μοναδικό Idempotency-Key. Η επανάληψη πανομοιότυπων δεδομένων αιτήματος αναπαράγει την αρχική επιτυχία· τροποποιημένα δεδομένα αιτήματος επιστρέφουν 409.
Σελιδοποίηση: Οι λίστες αποθηκευμένων πόρων χρησιμοποιούν σελιδοποίηση με δρομέα - ακολουθήστε το links.next (ή περάστε ?cursor=...) και ρυθμίστε το ?per_page= (μέγιστο 100). Η περιορισμένη ροή ενεργειών αναφέρει το όριό της και την κατάσταση περικοπής.
Χρηματικά ποσά: Τα χρηματικά ποσά είναι ακριβείς συμβολοσειρές JSON μορφοποιημένες σύμφωνα με την κλίμακα ISO 4217 του νομίσματος, όπως "121.00" για EUR ή "500" για JPY. Οι μοναδιαίες τιμές μπορούν να διατηρήσουν πρόσθετη ακρίβεια εισόδου.
Αναγνωριστικά: Κάθε πόρος προσπελάζεται μέσω ενός αδιαφανούς αναγνωριστικού (id), ποτέ μέσω διαδοχικού αριθμού.

Παράδειγμα: λίστα των τιμολογίων σας

curl https://freebillgen.com/api/v1/invoices \
  -H "Authorization: Bearer $FREEBILLGEN_API_KEY"

Ανοίξτε την πλήρη διαδραστική αναφορά API →

Ερωτήσεις για το API τιμολογίων

Είναι δωρεάν το API τιμολογίων;

Ναι - το API ανάγνωσης περιλαμβάνεται στο δωρεάν επίπεδο χωρίς κόστος. Το API εγγραφής και τα εξερχόμενα webhooks περιλαμβάνονται στο Lifetime Pro των 49 € συμπεριλαμβανομένου του φόρου: μία πληρωμή, χωρίς μηνιαία συνδρομή ή ετήσια ανανέωση.

Πώς πραγματοποιώ ταυτοποίηση;

Δημιουργήστε ένα Bearer token στις Ρυθμίσεις -> Κλειδιά API, αντιστοιχίστε του δικαιώματα ανάγνωσης/εγγραφής ανά πόρο και στείλτε το ως κεφαλίδα Authorization: Bearer σε κάθε αίτημα. Τα κλειδιά περιορίζονται στον δικό σας λογαριασμό και μπορούν να ανακληθούν ή να λήξουν.

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

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

Πώς αποφεύγω τη δημιουργία διπλότυπων τιμολογίων σε επανάληψη;

Στείλτε ένα μοναδικό Idempotency-Key στην κλήση δημιουργίας. Η επανάληψη πανομοιότυπων δεδομένων αιτήματος με αυτό το κλειδί επιστρέφει το αρχικό αποτέλεσμα. Η επαναχρησιμοποίησή του με τροποποιημένα δεδομένα αιτήματος επιστρέφει 409 αντί να αναπαράγει σιωπηλά ένα διαφορετικό τιμολόγιο.

Μπορώ να διαβάσω τα τιμολόγια που έχω λάβει;

Ναι, δωρεάν. Το GET /api/v1/inbox εμφανίζει λίστα υποστηριζόμενων αρχείων προμηθευτών UBL/CII που μεταφορτώσατε χειροκίνητα και το FreeBillGen ανέλυσε, με το πρωτότυπο να διατηρείται για λογιστικό έλεγχο· το GET /api/v1/inbox/{id} επιστρέφει ένα. Η αναγνώριση σύνταξης δεν αποτελεί επικύρωση προφίλ και αυτά τα τελικά σημεία δεν καθιστούν το FreeBillGen τελικό σημείο λήψης Peppol, κυβερνητικού δικτύου ή email.

Μπορεί ένας πράκτορας τεχνητής νοημοσύνης να διαβάσει ένα τιμολόγιο χωρίς λογαριασμό;

Ναι. Κάθε τιμολόγιο που κοινοποιείτε μέσω του υπογεγραμμένου δημόσιου συνδέσμου είναι αναγνώσιμο από πράκτορα στην ίδια διεύθυνση URL: η σελίδα ενσωματώνει JSON-LD schema.org/Invoice και η αποστολή Accept: application/json επιστρέφει ένα δομημένο τιμολόγιο (συμβαλλόμενα μέρη, γραμμές ειδών, σύνολα, οφειλόμενο υπόλοιπο, επιλογές πληρωμής), ενώ η αποστολή Accept: text/markdown επιστρέφει μια καθαρή απόδοση χαμηλού αριθμού token. Υπάρχει επίσης ένας διακομιστής Model Context Protocol (MCP) χωρίς ταυτοποίηση και μόνο για ανάγνωση στη διεύθυνση https://freebillgen.com/api/mcp με εργαλεία get_invoice και verify_invoice. Η υπογραφή του συνδέσμου είναι το διακριτικό πρόσβασης. Θεωρήστε ολόκληρο το URL ως μυστικό, καθώς οποιοσδήποτε το λάβει μπορεί να ανοίξει το τιμολόγιο.

API Τιμολογίων