B2G (Δημόσιο)¶

Q: Πού βρίσκω τον Κωδικό Αναθέτουσας Αρχής και πώς επιβεβαιώνω τα στοιχεία της σύμβασης (ΑΔΑΜ, ΑΔΑ, CPV);

Τον Κωδικό Αναθέτουσας Αρχής τον βρίσκετε στο Μητρώο Αναθετουσών Αρχών της ΓΓΠΣΔΔ, με αναζήτηση βάσει ΑΦΜ του φορέα ή κωδικού ΑΑΗΤ. Μπαίνει στο buyerIdentifiers[].buyerIdentifier, και με αυτόν δρομολογείται το τιμολόγιο. Τα στοιχεία της σύμβασης τα επιβεβαιώνετε στο ΚΗΜΔΗΣ, μενού «Συμβάσεις», με αναζήτηση βάσει ΑΔΑΜ: εκεί φαίνονται ο ΑΔΑ, οι κωδικοί CPV των ειδών και ο Ενάριθμος ΠΔΕ. Ο ΑΔΑΜ μπαίνει στο contractReference και ο CPV σε κάθε γραμμή, στο itemClassificationIdentifiers. Αν κάτι δεν ταιριάζει, ο πελάτης σας το διορθώνει με τον φορέα πριν από την έκδοση. Δείτε: Δημόσιο (B2G)

Q: Τι είναι ο ΑΔΑ και τι ο Ενάριθμος; Τι κάνω αν δεν έχω σύμβαση;

ΑΔΑ: ο μοναδικός αριθμός της Απόφασης Ανάληψης Υποχρέωσης (ΑΑΥ) στη Διαύγεια. Με την ΑΑΥ ο φορέας δεσμεύει την πίστωση πριν από τη δαπάνη, και ο ΑΔΑ αναφέρεται στη σύμβαση. Σε πολυετείς δαπάνες υπάρχουν περισσότερες ΑΑΥ: αν η σύμβαση δεν γράφει ποια ισχύει, ρωτήστε την υπηρεσία του φορέα που εκτελεί τη σύμβαση. Ενάριθμος: ο 14ψήφιος κωδικός ενός έργου του ΠΔΕ, από το σύστημα e-ΠΔΕ. Τα 4 πρώτα ψηφία είναι το έτος πρώτης ένταξης, ακολουθούν ο κωδικός της Συλλογικής Απόφασης (ΣΑ) και ο αύξων αριθμός του έργου. Αναφέρεται στη σύμβαση ως πηγή χρηματοδότησης· αν δεν τον βρίσκετε, ρωτήστε την Αναθέτουσα Αρχή. Χωρίς σύμβαση: στο contractReference βάζετε "0". Για το budget.identifier επικοινωνήστε με τον φορέα. Δείτε: Δημόσιο (B2G)

Q: Τι σημαίνουν τα σφάλματα BR-CL-23, BT-158-EMPTY-VALUES και 222 σε τιμολόγιο B2G;

BR-CL-23 «Unit code MUST be coded according to the UN/ECE Recommendation 20…» – Η μονάδα μέτρησης δεν είναι κωδικός UN/ECE Rec. 20 – Αντιστοιχίστε τις μονάδες σας σε κωδικό UBL στο QuantityUnitsUblCode, π.χ. H87 ή EA (τεμάχιο / μονάδα), KGM (κιλό), LTR (λίτρο), HUR (ώρα). BT-158-EMPTY-VALUES – Λείπει ο κωδικός CPV σε μια γραμμή – Συμπληρώστε itemClassificationIdentifiers[].classificationIdentifier σε κάθε γραμμή. Τον CPV τον βρίσκετε στη σύμβαση. 222 «NetValue per line must have value greater than 0…» – Γραμμή με μηδενική καθαρή αξία – Κάθε γραμμή πρέπει να έχει netValue μεγαλύτερο από 0. Τα BR-… / BT-… έρχονται από την πλατφόρμα ηλεκτρονικής τιμολόγησης του Δημοσίου (ΚΕΔ). Για ό,τι δεν λύνεται από την πλευρά σας, τα στοιχεία επικοινωνίας είναι στη σελίδα ηλεκτρονικής τιμολόγησης της ΓΓΠΣΔΔ. Το 222 είναι σφάλμα της ΑΑΔΕ. Δείτε: Δημόσιο (B2G)

Q: Σε ποια πεδία του API αντιστοιχούν τα στοιχεία του τιμολογίου B2G (π.χ. BT-10 «Στοιχεία αναφοράς αγοραστή», BT-9, BT-70) και τι πρέπει να συμπληρώσω για να εκδοθεί;

Τα στοιχεία EN 16931 μπαίνουν στο providerB2gAdditionalInvoiceDetails. Το BT-10 είναι το buyerReference, το BT-9 το dueDate (καταληκτική ημερομηνία πληρωμής· σε τμηματικές πληρωμές, η πρώτη) και το BT-70 το partyName: η οργανική μονάδα του φορέα που παραλαμβάνει φυσικά τα αγαθά ή τις υπηρεσίες, χωρίς να είναι η ίδια η Αναθέτουσα Αρχή (π.χ. «Αποθήκη Υγειονομικού Υλικού»). Χρειάζονται επίσης contractReference, budget, ο Κωδικός Αναθέτουσας Αρχής στο buyerIdentifiers, και σε κάθε γραμμή τα QuantityUnitsUblCode, itemClassificationIdentifiers (CPV) και itemCodification. Ο τρόπος πληρωμής είναι πάντα 5 (επί πιστώσει), με τον τραπεζικό λογαριασμό που θα πληρωθεί στο credits[]. Αν λείπουν υποχρεωτικά πεδία, το τιμολόγιο δεν εκδίδεται, οπότε ξεκινήστε από τα έτοιμα παραδείγματα B2G. Δείτε: Δημόσιο (B2G)

Q: Χρειάζομαι ξεχωριστό API key για να δοκιμάσω τιμολόγια προς το Δημόσιο (SendInvoicesB2G) στο Sandbox;

Ναι. Για το SendInvoicesB2G χρειάζεστε ξεχωριστό δοκιμαστικό κλειδί B2G, που το ζητάτε από τη Novus. Με το κανονικό κλειδί η κλήση απορρίπτεται με HTTP 401 «You don't have the authority…». Στην παραγωγή, η έκδοση B2G ενεργοποιείται χωριστά και έχει δικό της υπόλοιπο credits. Δείτε: Δημόσιο (B2G)

Q: Γιατί δεν φεύγει πιστωτικό τιμολόγιο 5.1 προς φορέα του Δημοσίου (B2G);

Στο SendInvoicesB2G το πιστωτικό είναι 5.2. Ο τύπος 5.1 δεν είναι στους επιτρεπτούς τύπους B2G (1.1, 1.6, 2.1, 2.4, 3.1, 3.2, 5.2, 6.1, 6.2, 7.1). Στο 5.2 το contractReference μένει κενό, και για προϋπολογισμό τύπου 1 ή 3 κενό μένει και το budget.identifier. Δείτε: SendInvoicesB2G

Τιμολόγια προς φορείς του Δημοσίου.

Πού βρίσκω τον Κωδικό Αναθέτουσας Αρχής και πώς επιβεβαιώνω τα στοιχεία της σύμβασης (ΑΔΑΜ, ΑΔΑ, CPV);

Τον Κωδικό Αναθέτουσας Αρχής τον βρίσκετε στο Μητρώο Αναθετουσών Αρχών της ΓΓΠΣΔΔ, με αναζήτηση βάσει ΑΦΜ του φορέα ή κωδικού ΑΑΗΤ. Μπαίνει στο buyerIdentifiers[].buyerIdentifier, και με αυτόν δρομολογείται το τιμολόγιο.

Τα στοιχεία της σύμβασης τα επιβεβαιώνετε στο ΚΗΜΔΗΣ, μενού «Συμβάσεις», με αναζήτηση βάσει ΑΔΑΜ: εκεί φαίνονται ο ΑΔΑ, οι κωδικοί CPV των ειδών και ο Ενάριθμος ΠΔΕ. Ο ΑΔΑΜ μπαίνει στο contractReference και ο CPV σε κάθε γραμμή, στο itemClassificationIdentifiers. Αν κάτι δεν ταιριάζει, ο πελάτης σας το διορθώνει με τον φορέα πριν από την έκδοση.

Δείτε: Δημόσιο (B2G)

Ποιον τύπο προϋπολογισμού (budget.type) βάζω και τι μπαίνει στο budget.identifier;

Ο τύπος ορίζει σε ποιο σύστημα του Δημοσίου πηγαίνει το τιμολόγιο για πληρωμή, γι' αυτό τον επιβεβαιώνετε με τον φορέα:

`budget.type`	Πότε	`budget.identifier`	Πού πηγαίνει
`1`	Φορέας της Κεντρικής Διοίκησης (άρθρο 14 ν. 4270/2014), δαπάνη του Τακτικού Προϋπολογισμού	ΑΔΑ της απόφασης ανάληψης υποχρέωσης	ΟΠΣΔΠ
`2`	Δαπάνη του Προγράμματος Δημοσίων Επενδύσεων (ΠΔΕ)	Ενάριθμος του έργου, όπως στη ΣΑ και στη σύμβαση	e-ΠΔΕ
`3`	Δαπάνη του προϋπολογισμού του ίδιου του φορέα (π.χ. Δήμος, ΝΠΔΔ)	ΑΔΑ της απόφασης ανάληψης υποχρέωσης	Το πληροφοριακό σύστημα του φορέα

Στο πιστωτικό 5.2, για τύπο 1 ή 3, το budget.identifier μένει κενό.

Δείτε: Δημόσιο (B2G)

Τι είναι ο ΑΔΑ και τι ο Ενάριθμος; Τι κάνω αν δεν έχω σύμβαση;

ΑΔΑ: ο μοναδικός αριθμός της Απόφασης Ανάληψης Υποχρέωσης (ΑΑΥ) στη Διαύγεια. Με την ΑΑΥ ο φορέας δεσμεύει την πίστωση πριν από τη δαπάνη, και ο ΑΔΑ αναφέρεται στη σύμβαση. Σε πολυετείς δαπάνες υπάρχουν περισσότερες ΑΑΥ: αν η σύμβαση δεν γράφει ποια ισχύει, ρωτήστε την υπηρεσία του φορέα που εκτελεί τη σύμβαση.
Ενάριθμος: ο 14ψήφιος κωδικός ενός έργου του ΠΔΕ, από το σύστημα e-ΠΔΕ. Τα 4 πρώτα ψηφία είναι το έτος πρώτης ένταξης, ακολουθούν ο κωδικός της Συλλογικής Απόφασης (ΣΑ) και ο αύξων αριθμός του έργου. Αναφέρεται στη σύμβαση ως πηγή χρηματοδότησης· αν δεν τον βρίσκετε, ρωτήστε την Αναθέτουσα Αρχή.
Χωρίς σύμβαση: στο contractReference βάζετε "0". Για το budget.identifier επικοινωνήστε με τον φορέα.

Δείτε: Δημόσιο (B2G)

Τι σημαίνουν τα σφάλματα BR-CL-23, BT-158-EMPTY-VALUES και 222 σε τιμολόγιο B2G;

Σφάλμα	Τι σημαίνει	Τι κάνετε
`BR-CL-23` «Unit code MUST be coded according to the UN/ECE Recommendation 20…»	Η μονάδα μέτρησης δεν είναι κωδικός UN/ECE Rec. 20	Αντιστοιχίστε τις μονάδες σας σε κωδικό UBL στο `QuantityUnitsUblCode`, π.χ. `H87` ή `EA` (τεμάχιο / μονάδα), `KGM` (κιλό), `LTR` (λίτρο), `HUR` (ώρα).
`BT-158-EMPTY-VALUES`	Λείπει ο κωδικός CPV σε μια γραμμή	Συμπληρώστε `itemClassificationIdentifiers[].classificationIdentifier` σε κάθε γραμμή. Τον CPV τον βρίσκετε στη σύμβαση.
`222` «NetValue per line must have value greater than 0…»	Γραμμή με μηδενική καθαρή αξία	Κάθε γραμμή πρέπει να έχει `netValue` μεγαλύτερο από 0.

Τα BR-… / BT-… έρχονται από την πλατφόρμα ηλεκτρονικής τιμολόγησης του Δημοσίου (ΚΕΔ). Για ό,τι δεν λύνεται από την πλευρά σας, τα στοιχεία επικοινωνίας είναι στη σελίδα ηλεκτρονικής τιμολόγησης της ΓΓΠΣΔΔ. Το 222 είναι σφάλμα της ΑΑΔΕ.

Δείτε: Δημόσιο (B2G)

Σε ποια πεδία του API αντιστοιχούν τα στοιχεία του τιμολογίου B2G (π.χ. BT-10 «Στοιχεία αναφοράς αγοραστή», BT-9, BT-70) και τι πρέπει να συμπληρώσω για να εκδοθεί;

Τα στοιχεία EN 16931 μπαίνουν στο providerB2gAdditionalInvoiceDetails. Το BT-10 είναι το buyerReference, το BT-9 το dueDate (καταληκτική ημερομηνία πληρωμής· σε τμηματικές πληρωμές, η πρώτη) και το BT-70 το partyName: η οργανική μονάδα του φορέα που παραλαμβάνει φυσικά τα αγαθά ή τις υπηρεσίες, χωρίς να είναι η ίδια η Αναθέτουσα Αρχή (π.χ. «Αποθήκη Υγειονομικού Υλικού»). Χρειάζονται επίσης contractReference, budget, ο Κωδικός Αναθέτουσας Αρχής στο buyerIdentifiers, και σε κάθε γραμμή τα QuantityUnitsUblCode, itemClassificationIdentifiers (CPV) και itemCodification. Ο τρόπος πληρωμής είναι πάντα 5 (επί πιστώσει), με τον τραπεζικό λογαριασμό που θα πληρωθεί στο credits[]. Αν λείπουν υποχρεωτικά πεδία, το τιμολόγιο δεν εκδίδεται, οπότε ξεκινήστε από τα έτοιμα παραδείγματα B2G.

Δείτε: Δημόσιο (B2G)

Χρειάζομαι ξεχωριστό API key για να δοκιμάσω τιμολόγια προς το Δημόσιο (SendInvoicesB2G) στο Sandbox;

Ναι. Για το SendInvoicesB2G χρειάζεστε ξεχωριστό δοκιμαστικό κλειδί B2G, που το ζητάτε από τη Novus. Με το κανονικό κλειδί η κλήση απορρίπτεται με HTTP 401 «You don't have the authority…». Στην παραγωγή, η έκδοση B2G ενεργοποιείται χωριστά και έχει δικό της υπόλοιπο credits.

Δείτε: Δημόσιο (B2G)

Γιατί δεν φεύγει πιστωτικό τιμολόγιο 5.1 προς φορέα του Δημοσίου (B2G);

Στο SendInvoicesB2G το πιστωτικό είναι 5.2. Ο τύπος 5.1 δεν είναι στους επιτρεπτούς τύπους B2G (1.1, 1.6, 2.1, 2.4, 3.1, 3.2, 5.2, 6.1, 6.2, 7.1). Στο 5.2 το contractReference μένει κενό, και για προϋπολογισμό τύπου 1 ή 3 κενό μένει και το budget.identifier.

Δείτε: SendInvoicesB2G

Γιατί αποτυγχάνει η έκδοση τιμολογίου B2G για έναν πελάτη, ενώ τα υπόλοιπα παραστατικά του εκδίδονται κανονικά;

Η υπηρεσία B2G ενεργοποιείται χωριστά για κάθε πελάτη και χρεώνεται από ξεχωριστό υπόλοιπο B2G (1 credit ανά τιμολόγιο). Αν η υπηρεσία B2G του πελάτη δεν είναι ενεργή ή δεν έχει ανανεωθεί, τα τιμολόγια προς το Δημόσιο δεν εκδίδονται, ενώ τα υπόλοιπα παραστατικά συνεχίζουν κανονικά. Επικοινωνήστε με τη Novus για ενεργοποίηση ή ανανέωση και ξαναστείλτε μόλις επιβεβαιωθεί.

Δείτε: SendInvoicesB2G