Σειρές αρίθμησης στο API

Χωρίς ενεργή σειρά τύπου fiscale, η έκδοση επιστρέφει 409 no_series_configured.

Το πρώτο τιμολόγιο σε 6 βήματα

Το GET /v1/series απαριθμεί τις σειρές αρίθμησης που έχουν ρυθμιστεί για τον Τενάντ.
Η έκδοση απαιτεί τουλάχιστον μία ΕΝΕΡΓΗ σειρά τύπου fiscale.
Χωρίς αυτήν, το POST /v1/invoices επιστρέφει 409 no_series_configured.
Οι σειρές δημιουργούνται και ενεργοποιούνται στο πάνελ, όχι μέσω του API.

Όλα τα Ένδποιντς

Μέθοδος	Endpoint	Scope	Idempotency-Key	Αιτήματα / λεπτό
GET	/series Λίστα σειρών αρίθμησης	invoices:read	—	120

Τι είναι το API 4invoices

bash
curl -sS https://api.4invoices.net/v1/series \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Πρέπει να υπάρχει τουλάχιστον μία ΕΝΕΡΓΗ σειρά τύπου "fiscale", αλλιώς
# το POST /invoices επιστρέφει 409 no_series_configured.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

Σφάλματα

Κατάσταση	Τύπος	Κωδικός
409	conflict_error	no_series_configured

Συχνά λάθη

Η απόκριση του POST /v1/invoices περιέχει σειρά και αριθμός — καταγράψτε και τα δύο για τη συμφωνία.
Ένα πιστωτικό ακυρωτικό καταναλώνει νέο αριθμό από τη σειρά· ο αριθμός του αρχικού τιμολογίου δεν επαναχρησιμοποιείται ποτέ.
Τα προτιμολόγια χρησιμοποιούν αρίθμηση ξεχωριστή από τις φορολογικές σειρές, οπότε δεν καταναλώνουν φορολογικούς αριθμούς.
Μην υποθέτετε μορφή αριθμού: χειριστείτε το αριθμός ως αδιαφανή συμβολοσειρά, όχι ως ακέραιο.

Ερωτήσεις και απαντήσεις για προγραμματιστές

Μπορώ να δημιουργήσω σειρά μέσω του API;

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

Τι γίνεται αν έχω πολλές ενεργές σειρές;

Χρησιμοποιείται η προεπιλεγμένη σειρά που έχει ρυθμιστεί στο πάνελ. Η έκδοση δεν επιλέγει μόνη της ανάμεσα σε αμφίσημες σειρές.

Γιατί το no_series_configured είναι 409 και όχι 422;

Είναι σύγκρουση κατάστασης λογαριασμού, όχι πρόβλημα με τα δεδομένα που στείλατε. Το Πέιλοντ σας είναι έγκυρο· λείπει η ρύθμιση.

Δείτε επίσης