Τύποι δεδομένων
Τύπος InvoiceHeader
Ο τύπος InvoiceHeader
περιγράφει τα στοιχεία της επικεφαλίδας του τιμολογίου.
Το αντικείμενο αυτό περιέχει τα εξής πεδία:
Πεδίο | Υποχρεωτικό | Περιγραφή |
---|---|---|
series | Ναι | Σειρά παραστατικού |
aa | Ναι | ΑΑ Παραστατικού |
issueDate | Ναι | Ημ. Έκδοσης Παραστατικού (yyyy-mm-dd) |
invoiceType | Ναι | Είδος Παραστατικού |
vatPaymentSuspension | Όχι | Αναστολή Καταβολής ΦΠΑ |
currency | Όχι | Νόμισμα |
exchangeRate | Όχι | Ισοτιμία (ελάχιστη τιμή 0, δεκαδικά 5) |
correlatedInvoices[] | Όχι | Συσχετιζόμενα Παραστατικά |
selfPricing | Όχι | Ένδειξη Αυτοτιμολόγησης (bool) |
dispatchDate | Όχι | Ημερομηνία Έναρξης Αποστολή (yyyy-mm-dd) |
dispatchTime | Όχι | Ώρα Έναρξης Αποστολής |
vehicleNumber | Όχι | Αριθμός Μεταφορικού Μέσου |
movePurpose | Όχι | Σκοπός Διακίνησης |
fuelInvoice | Όχι | Ένδειξη παραστατικού καυσίμων (bool) |
specialInvoiceCategory | Όχι | Ειδική Κατηγορία Παραστατικού |
invoiceVariationType | Όχι | Τύπος Απόκλισης (Διαφοροποίησης) Παραστατικού |
otherCorrelatedEntities[] | Όχι | Λοιπές συσχετιζόμενες οντότητες |
otherDeliveryNoteHeader | Όχι | Λοιπά Γενικά Στοιχεία Διακίνησης |
isDeliveryNote | Όχι | Ένδειξη παραστατικού διακίνησης (bool) |
otherMovePurposeTitle | Όχι | Τίτλος της Λοιπής Αιτίας Διακίνησης |
thirdPartyCollection | Όχι | Ένδειξη είσπραξης τρίτων |
multipleConnectedMarks | Όχι | Δεν είναι αποδεκτό για τα παραστατικά των τύπων 1.6, 2.4 και 5.1 |
tableAA | Ναι | Αποδεκτό μόνο για παραστατικό τύπου 8.6 - Μέγιστο επιτρεπτό μήκος 50 |
totalCancelDeliveryOrders | Όχι | Αποδεκτό μόνο για παραστατικό τύπου 8.6 |
Παρατηρήσεις
- To πεδίο
exchangeRate
είναι η ισοτιμία του νομίσματος σε σχέση με το ευρώ. Πρέπει να συμπληρώνεται μόνο όταν το νόμισμα δεν έχει τιμή EUR. - Ο κωδικός νομισμάτων προέρχεται από την αντίστοιχη λίστα σύμφωνα με το
πρότυπο
ISO4217
. - Το στοιχείο
correlatedInvoices
είναι λίστα και περιέχει τα ΜΑΡΚ των συσχετιζόμενων παραστατικών. - Σε περίπτωση μή έκδοσης σειράς παραστατικού, το πεδίο
series
πρέπει να έχει την τιμή0
. - Το πεδίο
selfPricing
ορίζει αν πρόκειται για Τιμολόγιο Αυτοτιμολόγησης. - Το πεδίο
fuelInvoice
ορίζει αν πρόκειται για παραστατικό πώλησης υγρών καυσίμων και επιτρέπεται η αποστολή μόνο για την περίπτωση των παρόχων. - Οι πιθανές τιμές του πεδίου
invoiceVariationType
περιγράφονται αναλυτικά στον αντίστοιχο πίνακα του Παραρτήματος. Λεπτομέρειες σχετικά με τον τρόπο χρήσης τους από επιχειρησιακής σκοπιάς περιγράφονται στο σχετικό επιχειρησιακό έγγραφο. - Το πεδίο
otherCorrelatedEntities
(Λοιπές συσχετιζόμενες οντότητες) είναι λίστα τύπου EntityType. - Το πεδίο
isDeliveryNote
ορίζει αν πρόκειται για τιμολόγιο που είναι και δελτίο αποστολής (π.χ το παραστατικό τύπου1.1
- Τιμολόγιο Πώλησης, εφόσον φέρει την ένδειξηisDeliveryNote = true
, τότε είναι και δελτίο διακίνησης και θα πρέπει να αποσταλούν και επιπλέον στοιχεία διακίνησης). - Το πεδίο
otherMovePurposeTitle
συμπληρώνεται όταν έχει επιλεγεί ωςmovePurpose = 19
(Λοιπές Διακινήσεις) και ορίζει τον τίτλο της άλλης διακίνησης. - Το πεδίο
thirdPartyCollection
ορίζει αν η επιχείρηση που κάνει χρήση Μέσων Πληρωμών ως Χρήστης υπηρεσιών πληρωμών και εισπράττει για λογαριασμό τρίτων (περίπτωση παραστατικού 8.4 - Απόδειξη Είσπραξης POS) ή αν επιστρέφει ποσά συναλλαγής για λογαριασμό τρίτων (περίπτωση παραστατικού8.5
- Απόδειξη Επιστροφής POS). - Το πεδίο
multipleConnectedMarks
είναι λίστα που περιέχει πολλαπλά συνδεόμενα ΜΑΡΚs (π.χ μπορεί να χρησιμοποιηθεί κατά έκδοση τιμολογίου/απόδειξης για πολλά δελτία παραγγελιών εστίασης). - Το πεδίο
totalCancelDeliveryOrders
είναι έγκυρο μόνο για παραστατικά τύπου 8.6 (δελτίο παραγγελίας εστίασης) και ορίζει αν το παραστατικό αναιρεί («ακυρώνει») συνολικά τα MARKs των δελτίων παραγγελιών εστίασης που έχουν δηλωθεί στο πεδίοmultipleConnectedMarks
(σε αυτήν την περίπτωση στο πεδίοmultipleConnectedMarks
πρέπει να δηλωθούν MARKs των δελτίων παραγγελίας εστίασης – τύπου 8.6 – για τα οποία θα γίνει συνολική αναίρεση τους). Στην περίπτωση αυτή το παραστατικό πρέπει να διαβιβάζεται με μια μόνο γραμμή με μηδενικές αξίες και κατηγορία ΦΠΑ την 8 (Εγγραφές χωρίς ΦΠΑ).
Απλό παράδειγμα δόμησης τύπου InvoiceHeader
use Firebed\AadeMyData\Models\InvoiceHeader;
use Firebed\AadeMyData\Enums\InvoiceType;
$invoiceHeader = new InvoiceHeader();
// Σειρά παραστατικού, Σε περίπτωση μή έκδοσης σειράς παραστατικού,
// το πεδίο series πρέπει να έχει την τιμή 0
$invoiceHeader->setSeries('0');
// ΑΑ Παραστατικού, μέγιστο επιτρεπτό μήκος 50
$invoiceHeader->setAa('1');
// Ημερομηνία Έκδοσης Παραστατικού
$invoiceHeader->setIssueDate('2024-02-03');
// Είδος Παραστατικού Τιμολόγιο Πώλησης
$invoiceHeader->setInvoiceType(InvoiceType::TYPE_1_1);
// Νόμισμα
$invoiceHeader->setCurrency('EUR');