Τεκμηρίωση API
Flexy Provider API
Τεκμηρίωση για τα συστήματα (ERP, POS) που διαβιβάζουν παραστατικά στο myDATA μέσω της Flexy.
Το Flexy Provider API δέχεται παραστατικά από τα συστήματα των πελατών μας, τα αποθηκεύει, τα διαβιβάζει στο myDATA της ΑΑΔΕ και σας ενημερώνει για την κατάστασή τους.
Διαδικασία ένταξης
Για να συνδέσετε το ERP σας με τα APIs μας:
- Κάντε εγγραφή ως συνεργάτης στο portal.flexy.gr/register-erp με τα στοιχεία σας, το ΑΦΜ της εταιρείας σας, email και τηλέφωνο.
- Πάρτε αμέσως τα στοιχεία του staging. Μετά την εγγραφή μεταφέρεστε στη σελίδα συνεργάτη. Εκεί βλέπετε το staging token, το base URL του staging, και email και κωδικό για το staging portal, όπου βλέπετε τα παραστατικά που εκδίδουν οι δοκιμές σας.
- Πρόσβαση στην παραγωγή. Η Flexy ενεργοποιεί την πρόσβασή σας στην παραγωγή· μέχρι τότε η σελίδα συνεργάτη τη δείχνει σε αναμονή. Μόλις ενεργοποιηθεί, η σελίδα δείχνει και το token παραγωγής.
Περιβάλλοντα
Στέλνετε τα ίδια αιτήματα και στα δύο περιβάλλοντα· αλλάζουν μόνο το base URL και το token:
| Στοιχείο | Staging (δοκιμές) | Παραγωγή |
|---|---|---|
| Base URL | https://provider-staging.flexy.gr/api/v1/ | https://provider-api.flexy.gr/api/v1/ |
| Token | ξεκινά με staging_ | ξεκινά με production_ |
| Αυθεντικοποίηση | Header Authorization: Bearer <token> | Header Authorization: Bearer <token> |
| Μορφή δεδομένων | JSON | JSON |
Στο staging η δοκιμαστική εταιρεία σας εκδίδει παραστατικά αμέσως. Στην παραγωγή ένα παραστατικό γίνεται δεκτό μόνο για εταιρεία που έχει ολοκληρώσει την ένταξη στη Flexy.
Τα tokens που εκδόθηκαν πριν από τα προθέματα staging_ / production_ ξεκινούν με sk_live_ και
συνεχίζουν να λειτουργούν.
Αφού κάνετε την εγγραφή και έχετε το staging token, είστε έτοιμοι να ξεκινήσετε με το βήμα 1.
Για έτοιμα αιτήματα για κάθε τύπο παραστατικού δείτε τα Παραδείγματα.