Τύποι δεδομένων

Τύπος 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'); 
Προηγούμενο
ECRToken
Επόμενο
InvoiceRow