Παραστατικό (document)

Ο κωδικός είδους παραστατικού myDATA (`invoiceType`)· καθορίζει ποιοι κανόνες της ΑΑΔΕ εφαρμόζονται και πώς συντάσσεται το XML. Κωδικοί εκτός του 1.1-11.5 (π.χ. 13.x, 14.x, 15.x, 16.x, 17.x) υπάρχουν στο σχήμα αλλά απορρίπτονται ως «Unknown document type».

• έως 50 χαρακτήρες

{
  "provider_details": {
    "document_type": "1.1"
  }
}

Ο κωδικός τρόπου πληρωμής myDATA για όλο το ποσό (παλαιότερη μορφή). Χρησιμοποιείται μόνο αν δεν στείλετε `provider_details.payment_methods`· ο πάροχος στέλνει ένα `paymentMethodDetails` με `type` και `amount` ίσο με το `totals.payable_amount`.

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "payment_method_type": 3
  }
}

Λίστα μέσων πληρωμής, ως ελεύθερα αντικείμενα· κάθε στοιχείο πρέπει να έχει `type` (1-8) και `amount` με 2 δεκαδικά. Όταν η λίστα δεν είναι κενή, ο πάροχος στέλνει ένα `paymentMethodDetails` ανά στοιχείο και αγνοεί το `payment_method_type`.

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "payment_methods": [
      {
        "type": 3,
        "amount": "20.00"
      },
      {
        "type": 7,
        "amount": "104.00"
      }
    ]
  }
}

Αριθμός κυκλοφορίας οχήματος. Δηλώνεται εδώ μόνο για τον πάροχο `oxygen`· στη διαβίβαση προς το myDATA ο αριθμός διαβάζεται από το `dispatch.vehicle_number`.

• έως 15 χαρακτήρες
• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "vehicle_number": "IKA-7358"
  }
}

Ένδειξη παραστατικού καυσίμων. Όταν είναι `true`, ο πάροχος γράφει `fuelInvoice` στο `invoiceHeader` και ενεργοποιεί το `fuelCode` στις γραμμές και το `supplyAccountNumber` στον αντισυμβαλλόμενο.

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "fuel_invoice": true
  }
}

Κωδικός ειδικής κατηγορίας παραστατικού (myDATA `specialInvoiceCategory`, Παράρτημα 8.19), που γράφεται στο `invoiceHeader` μόνο όταν δίνεται τιμή. Η διαθέσιμη λίστα περιορίζεται στους κωδικούς 1-7 και 10-12 (οι 8, 9 και 13 δεν υποβάλλονται μέσω ERP).

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "special_invoice_category": "1"
  }
}

Ένδειξη μεταβολής παραστατικού. Το πεδίο υπάρχει στο σχήμα αλλά κανένας πάροχος δεν το διαβάζει: δεν εκπέμπεται `invoiceVariationType` στο XML και δεν αποστέλλεται τιμή («We do not support invoice variation types yet»).

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "invoice_variation_type": null
  }
}

Λίστα πρόσθετων συσχετιζόμενων οντοτήτων (myDATA `otherCorrelatedEntities`, Παράρτημα 8.20) με `type` (1-6) και `entity_data` (ΑΦΜ, χώρα, υποκατάστημα, όνομα). Ο πάροχος στέλνει ένα `otherCorrelatedEntities` ανά στοιχείο στο `invoiceHeader`.

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "other_correlated_entities": [
      {
        "type": 1,
        "entity_data": {
          "vat_number": "094259216",
          "country": "GR",
          "branch": 0,
          "name": "Φορολογικός Εκπρόσωπος ΑΕ"
        }
      }
    ]
  }
}

{
  "type": 1
}

{
  "entity_data": {
    "vat_number": "094259216",
    "country": "GR",
    "branch": 0,
    "name": "Φορολογικός Εκπρόσωπος ΑΕ"
  }
}

{
  "vat_number": "094259216"
}

{
  "country": "GR"
}

{
  "branch": 0
}

{
  "name": "Φορολογικός Εκπρόσωπος ΑΕ"
}

Διευθύνσεις διακίνησης (myDATA `otherDeliveryNoteHeader`): περιέχει `loading_address`, `delivery_address`, `start_shipping_branch` και `complete_shipping_branch`. Σε 9.x/10.x τα δεδομένα διαβάζονται πάντα από εδώ.

• δέχεται null

{
  "provider_details": {
    "document_type": "9.3",
    "other_delivery_note_header": {
      "loading_address": {
        "street": "Πανεπιστημίου",
        "number": "123",
        "city": "Αθήνα",
        "postal_code": "10678"
      },
      "delivery_address": {
        "street": "Stadiou",
        "number": "10",
        "city": "Athens",
        "postal_code": "10562"
      }
    }
  }
}

{
  "loading_address": {
    "street": "Πανεπιστημίου",
    "number": "123",
    "city": "Αθήνα",
    "postal_code": "10678"
  }
}

{
  "street": "Πανεπιστημίου"
}

{
  "number": "123"
}

{
  "city": "Αθήνα"
}

{
  "postal_code": "10678"
}

{
  "zip": "10678"
}

{
  "address_line": "Πανεπιστημίου 123"
}

{
  "delivery_address": {
    "street": "Stadiou",
    "number": "10",
    "city": "Athens",
    "postal_code": "10562"
  }
}

{
  "street": "Πανεπιστημίου"
}

{
  "number": "123"
}

{
  "city": "Αθήνα"
}

{
  "postal_code": "10678"
}

{
  "zip": "10678"
}

{
  "address_line": "Πανεπιστημίου 123"
}

{
  "start_shipping_branch": 0
}

{
  "complete_shipping_branch": 1
}

Αντίστροφη διακίνηση. Όταν είναι `true`, ο πάροχος γράφει `reverseDeliveryNote` στο `invoiceHeader` και `is_reverse_delivery_note=true` στο header του Oxygen.

• δέχεται null

{
  "provider_details": {
    "document_type": "9.3",
    "move_purpose": "1",
    "reverse_delivery_note": true,
    "reverse_delivery_note_purpose": 2
  }
}

Η αιτία έκδοσης της αντίστροφης διακίνησης (myDATA `reverseDeliveryNotePurpose`, Παράρτημα 8.21). Εκπέμπεται μόνο όταν συνοδεύεται από `reverse_delivery_note=true`.

• ελάχιστη τιμή 1
• μέγιστη τιμή 5
• δέχεται null

{
  "reverse_delivery_note_purpose": 2
}

Σκοπός διακίνησης (myDATA `movePurpose`, Παράρτημα 8.18)· γίνεται δεκτό και το `dispatch.move_purpose`, το οποίο υπερισχύει. Σε 9.3, αν ο αντισυμβαλλόμενος είναι ο ίδιος ο εκδότης και η τιμή λείπει ή είναι `1`, μετατρέπεται αυτόματα σε `8` (ενδοδιακίνηση).

• δέχεται null

{
  "provider_details": {
    "document_type": "9.3",
    "move_purpose": "1"
  }
}

Λίστα αναγνωριστικών Oxygen ή αντικειμένων για συμπληρωματικά παραστατικά (1.6, 2.4, 5.1). Γίνεται δεκτή, αλλά σε 1.6/2.4/5.1 ο πάροχος `oxygen` διαβάζει τα ΜΑΡΚ από το `related_documents` και τα μετατρέπει σε Oxygen ULID.

• δέχεται null

{
  "provider_details": {
    "document_type": "5.1",
    "correlated_documents": [
      "<OXYGEN_ID>"
    ]
  }
}

Σημαίες PEPPOL/Oxygen. Ο πάροχος `oxygen` (τύποι 1.1/2.1/5.1/5.2) διαβάζει το `provider_details.options.is_peppol` και, όταν είναι `true`, στέλνει `options` με `is_peppol: true`· η διαβίβαση προς το myDATA δεν το αγγίζει.

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "options": {
      "is_peppol": true
    }
  }
}

{
  "options": {
    "is_peppol": true
  }
}

{
  "options": {
    "ignore_classifications": false
  }
}

ΑΑΗΤ ή ΑΦΜ αγοραστή για PEPPOL (BT-46). Ο πάροχος `oxygen` (τύποι 5.2/2.1/1.1) το γράφει στο `counterpart.identification`· η διαβίβαση προς το myDATA δεν το αγγίζει.

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "counterpart_identification": "1007.8020000000.0001"
  }
}

Στοιχεία σύμβασης B2G. Ο πάροχος `oxygen` (τύποι 1.1/2.1/5.1/5.2) διαβάζει κάθε πεδίο και τα στέλνει ως `contract`· η διαβίβαση προς το myDATA δεν τα αγγίζει.

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "contract": {
      "buyer_reference": "ΣΥΝΗΓΟΡΟΣ ΤΟΥ ΠΟΛΙΤΗ",
      "project_reference": "1|ΩΕΧΜ465ΦΥΟ-5ΜΓ",
      "document_reference": "20SYMV006467658"
    }
  }
}

{
  "buyer_reference": "ΣΥΝΗΓΟΡΟΣ ΤΟΥ ΠΟΛΙΤΗ"
}

{
  "project_reference": "1|ΩΕΧΜ465ΦΥΟ-5ΜΓ"
}

{
  "document_reference": "20SYMV006467658"
}

{
  "contract_id": "FWK-2025-001"
}

{
  "contract_reference": "IT services 2025-2027"
}

Στοιχεία αποστολής B2G. Ο πάροχος `oxygen` (τύποι 1.1/2.1/5.1/5.2) διαβάζει το `delivery_party_name` και το `delivery_address` (`street`, `number`, `city`, `postal_code`) και τα στέλνει ως `shipping_details`.

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "shipping_details": {
      "delivery_party_name": "ΣΥΝΗΓΟΡΟΣ ΤΟΥ ΠΟΛΙΤΗ",
      "delivery_address": {
        "street": "Λεωφ. Βασιλέως Κωνσταντίνου",
        "number": "3",
        "city": "Κρωπία",
        "postal_code": "19400"
      }
    }
  }
}

{
  "delivery_party_name": "ΣΥΝΗΓΟΡΟΣ ΤΟΥ ΠΟΛΙΤΗ"
}

{
  "delivery_address": {
    "street": "Λεωφ. Βασιλέως Κωνσταντίνου",
    "number": "3",
    "city": "Κρωπία",
    "postal_code": "19400"
  }
}

{
  "street": "Λεωφ. Βασιλέως Κωνσταντίνου"
}

{
  "number": "3"
}

{
  "city": "Κρωπία"
}

{
  "postal_code": "19400"
}

Όροι πληρωμής PEPPOL (BT-20), που ο πάροχος `oxygen` (τύποι 1.1/2.1/5.1/5.2) στέλνει ως `payment_terms`· η διαβίβαση προς το myDATA δεν τους αγγίζει. Σε B2G συμπληρώνεται εδώ η ελληνική ονομασία του `payment_method_type` (π.χ. «Επί Πιστώσει»).

• δέχεται null

{
  "provider_details": {
    "document_type": "1.1",
    "payment_method_type": "5",
    "payment_terms": "Επί πιστώσει"
  }
}

Η επωνυμία του εκδότη όπως είναι καταχωρημένη στο ΓΕΜΗ ή στο επαγγελματικό μητρώο. Δεν έχει μέγιστο μήκος και διαβιβάζεται ως κείμενο στο myDATA XML.

{
  "issuer": {
    "legal_name": "Test Company ΕΠΕ"
  }
}

ΑΦΜ του εκδότη με πρόθεμα χώρας (π.χ. `EL123456789` ή `GR123456789`)· ο πάροχος αφαιρεί τα προθέματα `EL` και `GR` πριν τη διαβίβαση και κρατά το εννιαψήφιο ΑΦΜ. Με τον πάροχο `flexy` ο ΑΦΜ πρέπει να αντιστοιχεί στον ΑΦΜ του δηλωμένου API client.

{
  "issuer": {
    "legal_number": "EL123456789"
  }
}

Περιγραφή της δραστηριότητας του εκδότη. Δεν διαβιβάζεται στο myDATA XML και δεν τη διαβάζει ο πάροχος `oxygen`· απλώς αποθηκεύεται.

{
  "issuer": {
    "legal_activity": "Χονδρικό Εμπόριο"
  }
}

Η διεύθυνση του εκδότη, στην κοινή δομή διεύθυνσης. Τα `address_line` (ή τα `street` και `number`) γίνονται `street` και `number` στο myDATA XML, ενώ τα `zip` και `country` γίνονται `postalCode` και `country`.

{
  "issuer": {
    "address": {
      "address_line": "Πανεπιστημίου 123",
      "city": "Αθήνα",
      "state": "Αττική",
      "zip": "10678",
      "country": "GR",
      "branch_code": 0
    }
  }
}

{
  "issuer": {
    "address": {
      "address_line": "Πανεπιστημίου 123"
    }
  }
}

{
  "issuer": {
    "address": {
      "street": "Πανεπιστημίου",
      "number": "123"
    }
  }
}

{
  "issuer": {
    "address": {
      "street": "Πανεπιστημίου",
      "number": "123"
    }
  }
}

{
  "issuer": {
    "address": {
      "city": "Αθήνα"
    }
  }
}

{
  "issuer": {
    "address": {
      "state": "Αττική"
    }
  }
}

{
  "issuer": {
    "address": {
      "zip": "10678"
    }
  }
}

{
  "issuer": {
    "address": {
      "country": "GR"
    }
  }
}

{
  "issuer": {
    "address": {
      "branch_code": 0
    }
  }
}

Η επωνυμία του αντισυμβαλλομένου. Στους τύπους 1.2 και 1.3 (εκτός Ελλάδας) διαβιβάζεται πάντα, σε εγχώριο 1.1 μόνο όταν η χώρα δεν είναι `GR`, και στους 3.1 και 3.2 ελέγχεται ρητά.

{
  "counterpart": {
    "legal_name": "Customer Company ΑΕ"
  }
}

ΑΦΜ ή φορολογικός αριθμός του αντισυμβαλλομένου, με πρόθεμα χώρας (π.χ. `EL123456789`, `DE000000000`). Ο πάροχος αφαιρεί το πρόθεμα `EL` ή `GR` πριν τη διαβίβαση.

{
  "counterpart": {
    "legal_number": "EL123456789"
  }
}

Περιγραφή της δραστηριότητας του αντισυμβαλλομένου. Δεν διαβιβάζεται στο myDATA XML και δεν τη διαβάζει ο πάροχος `oxygen`.

{
  "counterpart": {
    "legal_activity": "Λιανικό Εμπόριο"
  }
}

Η διεύθυνση του αντισυμβαλλομένου, στην ίδια κοινή δομή διεύθυνσης. Διαβιβάζεται ως `address` μόνο όταν στείλετε το αντικείμενο.

{
  "counterpart": {
    "address": {
      "address_line": "Σταδίου 456",
      "city": "Θεσσαλονίκη",
      "state": "Θεσσαλονίκη",
      "zip": "54625",
      "country": "GR",
      "branch_code": 0
    }
  }
}

{
  "counterpart": {
    "address": {
      "address_line": "Σταδίου 456"
    }
  }
}

{
  "counterpart": {
    "address": {
      "street": "Σταδίου",
      "number": "456"
    }
  }
}

{
  "counterpart": {
    "address": {
      "number": "456"
    }
  }
}

{
  "counterpart": {
    "address": {
      "city": "Θεσσαλονίκη"
    }
  }
}

{
  "counterpart": {
    "address": {
      "state": "Θεσσαλονίκη"
    }
  }
}

{
  "counterpart": {
    "address": {
      "zip": "54625"
    }
  }
}

{
  "counterpart": {
    "address": {
      "country": "GR"
    }
  }
}

{
  "counterpart": {
    "address": {
      "branch_code": 0
    }
  }
}

Email επικοινωνίας του αντισυμβαλλομένου, έως 100 χαρακτήρες. Δεν διαβιβάζεται στο myDATA· το διαβάζει μόνο ο πάροχος `oxygen` για PEPPOL (BT-9/BT-10).

• έως 100 χαρακτήρες
• δέχεται null

{
  "counterpart": {
    "email": "[email protected]"
  }
}

Τηλέφωνο επικοινωνίας του αντισυμβαλλομένου, έως 20 χαρακτήρες. Δεν διαβιβάζεται στο myDATA· το διαβάζει μόνο ο πάροχος `oxygen`.

• έως 20 χαρακτήρες
• δέχεται null

{
  "counterpart": {
    "phone": "+302101234567"
  }
}

Αριθμός εγγράφου ταυτοποίησης (π.χ. διαβατήριο ή ταυτότητα) για αντισυμβαλλόμενους χωρίς ΑΦΜ, έως 20 χαρακτήρες. Δεν διαβιβάζεται στο myDATA· τον διαβάζει μόνο ο πάροχος `oxygen`.

• έως 20 χαρακτήρες
• δέχεται null

{
  "counterpart": {
    "document_id_no": "AB123456"
  }
}

Η χώρα έκδοσης του εγγράφου ταυτοποίησης (ISO 3166-1 alpha-2, 2 γράμματα). Δεν διαβιβάζεται στο myDATA· τη διαβάζει μόνο ο πάροχος `oxygen`.

• έως 2 χαρακτήρες
• δέχεται null

{
  "counterpart": {
    "document_country_code": "GR"
  }
}

Εσωτερικός αριθμός λογαριασμού πελάτη στο ERP ή στο λογιστικό σύστημα του προμηθευτή, έως 50 χαρακτήρες. Δεν διαβιβάζεται στο myDATA· τον διαβάζει μόνο ο πάροχος `oxygen`.

• έως 50 χαρακτήρες
• δέχεται null

{
  "counterpart": {
    "supply_account_no": "CUST-12345"
  }
}

ΑΑΗΤ (Αριθμός Ανάθεσης Ηλεκτρονικής Τιμολόγησης) ή ΑΦΜ αγοραστή για B2G. Δεν διαβιβάζεται στο myDATA· το διαβάζει μόνο ο πάροχος `oxygen` (PEPPOL BT-46, GR-R-010 με SchemeID 9933).

• έως 255 χαρακτήρες
• δέχεται null

{
  "counterpart": {
    "identification": "0001.123456789.0001"
  }
}

Η ημερομηνία αποστολής (`YYYY-MM-DD`). Αποθηκεύεται με το παραστατικό αλλά δεν διαβιβάζεται στο myDATA· τη χρησιμοποιεί μόνο ο πάροχος `oxygen`.

{
  "dispatch": {
    "dispatch_date": "2025-12-29"
  }
}

Η ώρα αποστολής (`HH:MM:SS`, 24ωρη)· η μορφή δεν ελέγχεται. Αποθηκεύεται με το παραστατικό αλλά δεν διαβιβάζεται στο myDATA· τη χρησιμοποιεί μόνο ο πάροχος `oxygen`.

{
  "dispatch": {
    "dispatch_time": "10:00:00"
  }
}

Ο αριθμός κυκλοφορίας του οχήματος. Αποθηκεύεται με το παραστατικό αλλά δεν διαβιβάζεται στο myDATA· τον διαβάζει μόνο ο πάροχος `oxygen`.

{
  "dispatch": {
    "vehicle_number": "ΑΒΓ-1234"
  }
}

Κωδικός σκοπού διακίνησης της ΑΑΔΕ (1-19). Στα δελτία διακίνησης 9.x/10.x είναι υποχρεωτικός μέσω του `provider_details.move_purpose` και διαβιβάζεται ως `movePurpose` (στους 1.1/2.1 ως δελτίο αποστολής) ή μέσα στην κεφαλίδα (στους 9.x/10.x).

{
  "dispatch": {
    "move_purpose": 1
  }
}

Ελεύθερη περιγραφή του σκοπού διακίνησης, που διαβιβάζεται ως `otherMovePurposeTitle` (έως 150 χαρακτήρες) μόνο όταν `move_purpose=19`.

{
  "dispatch": {
    "move_purpose": 19,
    "other_move_purpose_title": "Μεταφορά μεταξύ αποθηκών"
  }
}

Η διεύθυνση παράδοσης για το δελτίο αποστολής. Διαβιβάζεται ως `deliveryAddress` μέσα στο `otherDeliveryNoteHeader` και απαιτεί και το `loading_address`.

{
  "dispatch": {
    "shipping_address": {
      "address_line": "Σταδίου 456",
      "city": "Θεσσαλονίκη",
      "zip": "54625",
      "country": "GR"
    }
  }
}

{
  "dispatch": {
    "shipping_address": {
      "address_line": "Σταδίου 456"
    }
  }
}

{
  "dispatch": {
    "shipping_address": {
      "street": "Σταδίου",
      "number": "456"
    }
  }
}

{
  "dispatch": {
    "shipping_address": {
      "number": "456"
    }
  }
}

{
  "dispatch": {
    "shipping_address": {
      "city": "Θεσσαλονίκη"
    }
  }
}

{
  "dispatch": {
    "shipping_address": {
      "state": "Θεσσαλονίκη"
    }
  }
}

{
  "dispatch": {
    "shipping_address": {
      "zip": "54625"
    }
  }
}

{
  "dispatch": {
    "shipping_address": {
      "country": "GR"
    }
  }
}

{
  "dispatch": {
    "shipping_address": {
      "branch_code": 0
    }
  }
}

Η διεύθυνση φόρτωσης (αφετηρίας) για το δελτίο αποστολής. Διαβιβάζεται ως `loadingAddress` μέσα στο `otherDeliveryNoteHeader` και απαιτεί και το `shipping_address`.

{
  "dispatch": {
    "loading_address": {
      "address_line": "Πανεπιστημίου 123",
      "city": "Αθήνα",
      "zip": "10678",
      "country": "GR"
    }
  }
}

{
  "dispatch": {
    "loading_address": {
      "address_line": "Πανεπιστημίου 123"
    }
  }
}

{
  "dispatch": {
    "loading_address": {
      "street": "Πανεπιστημίου",
      "number": "123"
    }
  }
}

{
  "dispatch": {
    "loading_address": {
      "number": "123"
    }
  }
}

{
  "dispatch": {
    "loading_address": {
      "city": "Αθήνα"
    }
  }
}

{
  "dispatch": {
    "loading_address": {
      "state": "Αττική"
    }
  }
}

{
  "dispatch": {
    "loading_address": {
      "zip": "10678"
    }
  }
}

{
  "dispatch": {
    "loading_address": {
      "country": "GR"
    }
  }
}

{
  "dispatch": {
    "loading_address": {
      "branch_code": 0
    }
  }
}

Ο κωδικός νομίσματος στον οποίο αναφέρεται η ισοτιμία.

• έως 3 χαρακτήρες

{
  "exchange_rates": {
    "currency_code": "USD",
    "exchange_rate": "1.086400"
  }
}

Η ισοτιμία του νομίσματος σε σχέση με το ευρώ.

• 20 ψηφία συνολικά
• 6 δεκαδικά ψηφία

{
  "exchange_rates": {
    "currency_code": "USD",
    "exchange_rate": "1.086400"
  }
}

Ο κωδικός υποκαταστήματος παραλαβής (PEPPOL BG-14): `0` για την έδρα, `1` και πάνω για υποκατάστημα. Χρησιμοποιείται μόνο με `provider=oxygen`.

{
  "shipping_details": {
    "pickup_branch_code": 0
  }
}

Ο κωδικός υποκαταστήματος παράδοσης: `0` για την έδρα, `1` και πάνω για υποκατάστημα. Χρησιμοποιείται μόνο με `provider=oxygen`.

{
  "shipping_details": {
    "delivery_branch_code": 0
  }
}

Η διεύθυνση παραλαβής (PEPPOL BG-14), στην κοινή δομή διεύθυνσης. Χρησιμοποιείται μόνο με `provider=oxygen` και όχι στους τύπους 10.x.

{
  "shipping_details": {
    "pickup_address": {
      "address_line": "Πανεπιστημίου 123",
      "city": "Αθήνα",
      "zip": "10678",
      "country": "GR",
      "branch_code": 0
    }
  }
}

{
  "shipping_details": {
    "pickup_address": {
      "address_line": "Πανεπιστημίου 123"
    }
  }
}

{
  "shipping_details": {
    "pickup_address": {
      "street": "Πανεπιστημίου",
      "number": "123"
    }
  }
}

{
  "shipping_details": {
    "pickup_address": {
      "number": "123"
    }
  }
}

{
  "shipping_details": {
    "pickup_address": {
      "city": "Αθήνα"
    }
  }
}

{
  "shipping_details": {
    "pickup_address": {
      "state": "Αττική"
    }
  }
}

{
  "shipping_details": {
    "pickup_address": {
      "zip": "10678"
    }
  }
}

{
  "shipping_details": {
    "pickup_address": {
      "country": "GR"
    }
  }
}

{
  "shipping_details": {
    "pickup_address": {
      "branch_code": 0
    }
  }
}

Η διεύθυνση παράδοσης (PEPPOL BG-15), στην κοινή δομή διεύθυνσης. Χρησιμοποιείται μόνο με `provider=oxygen` και όχι στους τύπους 10.x.

{
  "shipping_details": {
    "delivery_address": {
      "address_line": "Hospital Wing B",
      "city": "Athens",
      "zip": "11527",
      "country": "GR",
      "branch_code": 0
    }
  }
}

{
  "shipping_details": {
    "delivery_address": {
      "address_line": "Hospital Wing B"
    }
  }
}

{
  "shipping_details": {
    "delivery_address": {
      "street": "Hospital Wing B",
      "number": "5"
    }
  }
}

{
  "shipping_details": {
    "delivery_address": {
      "number": "5"
    }
  }
}

{
  "shipping_details": {
    "delivery_address": {
      "city": "Athens"
    }
  }
}

{
  "shipping_details": {
    "delivery_address": {
      "state": "Attica"
    }
  }
}

{
  "shipping_details": {
    "delivery_address": {
      "zip": "11527"
    }
  }
}

{
  "shipping_details": {
    "delivery_address": {
      "country": "GR"
    }
  }
}

{
  "shipping_details": {
    "delivery_address": {
      "branch_code": 0
    }
  }
}

Το όνομα του παραλήπτη της παράδοσης (PEPPOL `DeliverToPartyName`). Χρήσιμο σε B2G για παραδόσεις σε τμήματα ή εγκαταστάσεις μεγαλύτερου οργανισμού, και χρησιμοποιείται μόνο με `provider=oxygen`.

{
  "shipping_details": {
    "delivery_party_name": "Athens General Hospital - Cardiology Dept"
  }
}

Αναγνωριστικό του σημείου παράδοσης (PEPPOL `DeliverToLocationIdentifier`). Συνήθως GLN 13 ψηφίων ή εσωτερικό αναγνωριστικό (π.χ. `HOSP-ATH-001`), και χρησιμοποιείται μόνο με `provider=oxygen`.

{
  "shipping_details": {
    "delivery_location_id": "5790000435685"
  }
}

Το σχήμα του αναγνωριστικού σημείου παράδοσης (PEPPOL): `0088` για GLN, `0177` για ODETTE, ή δικός σας κωδικός. Χρησιμοποιείται μόνο με `provider=oxygen`.

{
  "shipping_details": {
    "delivery_location_id": "5790000435685",
    "delivery_location_scheme_id": "0088"
  }
}

Είδος γραμμής myDATA (`recType`): δηλώνεται ως κείμενο 1-7 χαρακτήρων, αλλά το myDATA δέχεται μόνο ακέραιες τιμές 1-7. Ο πάροχος δεν διαβάζει αυτό το πεδίο· για ειδικές γραμμές (π.χ. γραμμή τέλους με ΦΠΑ ή λοιπών φόρων) χρησιμοποιήστε `items[].taxes[]` με τα κατάλληλα `tax_type`.

• έως 7 χαρακτήρες
• τουλάχιστον 1 χαρακτήρες
• δέχεται null

Εσωτερικός κωδικός προϊόντος ή υπηρεσίας (SKU), που διαβιβάζεται ως `itemCode`. Το myDATA τον δέχεται μόνο σε δελτία διακίνησης (9.x, 10.x)· σε κανονικά τιμολόγια απορρίπτεται με «itemCode is forbidden».

• έως 50 χαρακτήρες
• δέχεται null

{
  "items": [
    {
      "title": "Product A",
      "description": "Delivered product A",
      "item_code": "PROD-001",
      "quantity": "10.00",
      "unit_measure": "ΤΕΜ",
      "unit_value": "0.00",
      "unit_total": "0.00"
    }
  ]
}

Σύντομη ονομασία του προϊόντος ή της υπηρεσίας. Εμφανίζεται στο εκτυπωμένο παραστατικό και γίνεται το `itemDescr` του myDATA όταν λείπει το `description`, αλλιώς χρησιμοποιείται το `description`.

{
  "items": [
    {
      "title": "Premium Widget",
      "description": "High-quality widget product"
    }
  ]
}

Αναλυτική περιγραφή του προϊόντος ή της υπηρεσίας, που χρησιμοποιείται ως `itemDescr` στο myDATA όταν δίνεται (προτιμάται έναντι του `title`). Το όριο των 300 χαρακτήρων το επιβάλλει ο Oxygen· το myDATA δέχεται περισσότερους.

• έως 300 χαρακτήρες

{
  "items": [
    {
      "title": "Premium Widget",
      "description": "High-quality widget product"
    }
  ]
}

Είδος λεπτομέρειας γραμμής (myDATA `invoiceDetailType`), με `1` για αγαθά και `2` για υπηρεσίες. ΔΕΝ ΧΡΗΣΙΜΟΠΟΙΕΙΤΑΙ σήμερα: στον τύπο 1.5 χρησιμοποιήστε το `provider_details.detail_type`, ενώ στους 9.x/10.x ο πάροχος στέλνει πάντα `1`.

• δέχεται null

Η ποσότητα της γραμμής. Το myDATA δεν περιορίζει τα δεκαδικά και τη δέχεται ως έχει, ενώ ο Oxygen δέχεται έως 4 δεκαδικά.

• 15 ψηφία συνολικά
• 4 δεκαδικά ψηφία

{
  "items": [
    {
      "quantity": "1.00",
      "unit_measure": "ΤΕΜ",
      "unit_value": "100.00"
    }
  ]
}

Η μονάδα μέτρησης. Δέχεται είτε τον ακέραιο κωδικό myDATA (π.χ. `1` για τεμάχια) είτε το ελληνικό ή αγγλικό σύμβολο (π.χ. `ΤΕΜ`, `KG`, `LT`), και ο πάροχος το κανονικοποιεί σε κωδικό 1-7.

{
  "items": [
    {
      "quantity": "50.00",
      "unit_measure": "LT",
      "unit_value": "1.80"
    }
  ]
}

Τιμή μονάδας πριν από έκπτωση και ΦΠΑ. Η ΑΑΔΕ δεν έχει ξεχωριστό πεδίο τιμής μονάδας (μόνο `quantity` και `netValue` στο `InvoiceRowType`), οπότε ο πάροχος υπολογίζει `netValue` = `quantity` × `unit_value`, ή χρησιμοποιεί το `unit_total` όταν δίνεται.

• 15 ψηφία συνολικά
• 4 δεκαδικά ψηφία

{
  "items": [
    {
      "unit_value": "100.00",
      "quantity": "1.00",
      "unit_total": "100.00"
    }
  ]
}

Σταθερή έκπτωση ανά μονάδα, σε ευρώ. ΔΕΝ ΧΡΗΣΙΜΟΠΟΙΕΙΤΑΙ: ο πάροχος δεν διαβάζει ποτέ αυτό το πεδίο, ενώ ο Oxygen υπολογίζει μόνος του την έκπτωση ως (`quantity` × `unit_value`) − `unit_total`.

• 15 ψηφία συνολικά
• 2 δεκαδικά ψηφία
• δέχεται null

Ποσοστό έκπτωσης (π.χ. `10` για 10%). ΔΕΝ ΧΡΗΣΙΜΟΠΟΙΕΙΤΑΙ: ο πάροχος δεν διαβάζει πουθενά αυτό το πεδίο· χρησιμοποιήστε τα `unit_value` και `unit_total` για να εκφράσετε την έκπτωση.

• δέχεται null

Ο τρόπος υπολογισμού της έκπτωσης (myDATA `discountOption`). ΔΕΝ ΧΡΗΣΙΜΟΠΟΙΕΙΤΑΙ: ο πάροχος δεν το διαβάζει πουθενά.

• δέχεται null

Τύπος έκπτωσης myDATA: `1` για έκπτωση γραμμής, `2` για έκπτωση παραστατικού. ΔΕΝ ΧΡΗΣΙΜΟΠΟΙΕΙΤΑΙ: ο Oxygen τον υπολογίζει μόνος του και βάζει πάντα `2` όταν υπάρχει διαφορά ακαθάριστης και καθαρής αξίας.

• ελάχιστη τιμή 1
• μέγιστη τιμή 2
• δέχεται null

Λίστα φόρων ανά γραμμή· κάθε στοιχείο γίνεται μία εγγραφή `taxes` μέσα στο `invoiceDetails` του myDATA XML ή `lines[].taxes` στο JSON του Oxygen. Διαβιβάζονται μόνο οι φόροι ανά γραμμή: οι φόροι σε επίπεδο παραστατικού (`taxes`) προβάλλονται εδώ πριν την αποστολή.

• δέχεται null

{
  "items": [
    {
      "title": "Premium Widget",
      "unit_value": "100.00",
      "unit_total": "100.00",
      "taxes": [
        {
          "title": "ΦΠΑ 24%",
          "tax_type": "1",
          "value_type": "percentage",
          "tax_sign": "+",
          "value": "24.00",
          "provider_details": {
            "provider_code": "1"
          }
        },
        {
          "title": "Χαρτόσημο 3.6%",
          "tax_type": "stamp_duty",
          "value_type": "percentage",
          "tax_sign": "+",
          "value": "3.6",
          "provider_details": {
            "provider_code": "3"
          }
        }
      ]
    }
  ]
}