ΟΔΗΓΟΣ

Ποιο παραστατικό και ποιος χαρακτηρισμός στο myDATA: e-shop, εστίαση, υπηρεσίες, B2B

Τα παραστατικά που εκδίδουν συχνότερα οι ελληνικές επιχειρήσεις, από την απόδειξη του e-shop ως το πιστωτικό τιμολόγιο και το δελτίο αποστολής, το καθένα με το invoice_type_code του, το classification_category και το classification_type του, και πλήρες JSON για το POST /invoices.

Κάθε παραστατικό που στέλνεις στο myDATA έχει invoice_type_code, και κάθε γραμμή του classification_category και classification_type. Ποια μπαίνουν εξαρτάται από το τι πουλάς και σε ποιον. Εδώ θα βρεις την απάντηση για τα παραστατικά που εκδίδουν συχνότερα οι ελληνικές επιχειρήσεις, το καθένα με πλήρες JSON για το POST /invoices.

Αυτές είναι οι συνηθισμένες περιπτώσεις, όχι το όριο. Το API εκδίδει πολλά ακόμα είδη παραστατικών, και κάθε είδος δέχεται κι άλλους συνδυασμούς χαρακτηρισμών. Τις πλήρεις λίστες του myDATA θα τις βρεις στα είδη παραστατικών, στις κατηγορίες χαρακτηρισμού και στους τύπους χαρακτηρισμού, και κάθε πεδίο στην τεκμηρίωση του API.

Τι εκδίδειςinvoice_type_codeΧαρακτηρισμός
Αγαθά σε καταναλωτή, και e-shop11.1category1_1 (μεταπώληση) ή category1_2 (δική σου παραγωγή), με E3_561_003
Το ίδιο, με πληρωμή σε τερματικό POS11.1 με pos_device_idΌπως παραπάνω
Παραγγελία σε τραπέζι εστίασης8.6category1_95 με "_"
Υπηρεσίες σε καταναλωτή11.2category1_3 με E3_561_003
Υπηρεσίες σε επιχείρηση2.1category1_3 με E3_561_001
Αγαθά σε επιχείρηση1.1category1_1 με E3_561_001
Εμπορεύματα που πουλάς για εντολέα1.4category1_7 με E3_881_001
Πληρωμή με κάρτα για παραστατικά που έχεις εκδώσει8.4category1_95 με "_"
Πίστωση σε επιχείρηση5.2Όπως η γραμμή του αρχικού
Εμπορεύματα σε διακίνηση9.3category3 με "_"
Επιστροφή σε απόδειξη11.4Όπως η γραμμή του αρχικού, με E3_561_003
Τέλος ανθεκτικότητας κλιματικής κρίσης8.2category1_95 με "_"
Εκκαθάριση πωλήσεων εντολέα1.5category2_9 με "_", μετά category1_3 με E3_561_001

Πριν ξεκινήσεις

  • Μπλοκ: κάθε είδος εκδίδεται από μπλοκ του ίδιου είδους, με το billing_book_id από το GET /billing_books. Ένα μπλοκ 1.1 εκδίδει και 1.2 και 1.3, και ένα μπλοκ 2.1 και 2.2 και 2.3. Τα παραστατικά λιανικής δεν μοιράζονται μπλοκ.
  • Ρητά ποσά: κάθε γραμμή στέλνει net_total_price, vat_total και subtotal, και το παραστατικό τα τέσσερα σύνολά του. Τίποτα δεν υπολογίζεται για σένα: χωρίς αυτά, το παραστατικό αποθηκεύεται με αξία 0,00.
  • Τρόπος πληρωμής: το payment_method_type παίρνει τους αριθμούς του Wrapp από την τεκμηρίωση του API, όχι τους κωδικούς του myDATA: 0 μετρητά, 1 επί πιστώσει, 3 κάρτα. Οι αποδείξεις λιανικής, το 11.4, το 8.2 και το 8.4 απορρίπτονται χωρίς αυτό, με σφάλμα 204.
  • Πώς διαβάζεις τους κωδικούς: οι λίστες του myDATA γράφουν «1.3», και το πεδίο παίρνει category1_3. Το "_" σημαίνει ότι η γραμμή δεν παίρνει τύπο χαρακτηρισμού: στείλε ακριβώς αυτό, κενό κείμενο ή null δεν δουλεύουν.
  • Χαρακτηρισμοί: εδώ θα βρεις τους συνήθεις για κάθε περίπτωση. Ποιος ισχύει για μια επιχείρηση το αποφασίζει ο λογιστής της.
  • Μοναδικό external_id: αν επαναληφθεί, απορρίπτεται, οπότε μια κλήση που ξαναστέλνεις δεν εκδίδει ποτέ δεύτερο παραστατικό.

1. Αγαθά σε καταναλωτή, και e-shop: Απόδειξη Λιανικής Πώλησης 11.1 (ΑΛΠ)

Μια παραγγελία από e-shop, ή μια πώληση στο κατάστημα με μετρητά, κάρτα online ή μεταφορά, μπαίνει σε 11.1. Τα εμπορεύματα που μεταπωλείς παίρνουν category1_1, τα προϊόντα που φτιάχνεις category1_2 και η γραμμή μεταφορικών category1_3, όλα με E3_561_003. Counterpart δεν χρειάζεται: παράλειψε το κλειδί.

POST /invoices
{
  "invoice_type_code": "11.1",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 3,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Κάλτσες βαμβακερές",
      "code": "SOCK-COT-01",
      "quantity": 2,
      "quantity_type": 1,
      "unit_price": 8.00,
      "vat_rate": 24,
      "classification_category": "category1_1",
      "classification_type": "E3_561_003",
      "net_total_price": 16.00,
      "vat_total": 3.84,
      "subtotal": 19.84
    },
    {
      "line_number": 2,
      "name": "Μέλι θυμαρίσιο 450gr",
      "code": "HONEY-450",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 9.00,
      "vat_rate": 13,
      "classification_category": "category1_1",
      "classification_type": "E3_561_003",
      "net_total_price": 9.00,
      "vat_total": 1.17,
      "subtotal": 10.17
    },
    {
      "line_number": 3,
      "name": "Μεταφορικά",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 3.50,
      "vat_rate": 24,
      "classification_category": "category1_3",
      "classification_type": "E3_561_003",
      "net_total_price": 3.50,
      "vat_total": 0.84,
      "subtotal": 4.34
    }
  ],
  "net_total_amount": 28.50,
  "vat_total_amount": 5.85,
  "total_amount": 34.35,
  "payable_total_amount": 34.35
}

2. Πληρωμή σε τερματικό POS: το ίδιο 11.1 με pos_device_id

Όταν ο πελάτης πληρώνει με κάρτα σε τερματικό συνδεδεμένο με το Wrapp, πρόσθεσε το pos_device_id, το id του τερματικού από το GET /pos_devices, και στείλε payment_method_type 3. Το τερματικό χρεώνει το ποσό της απόδειξης, και η απόδειξη παίρνει ΜΑΡΚ μόλις εγκριθεί η πληρωμή. Το λαμβάνεις με webhook.

POST /invoices
{
  "invoice_type_code": "11.1",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 3,
  "pos_device_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Είδη λιανικής",
      "quantity": 2,
      "quantity_type": 1,
      "unit_price": 10.08,
      "net_total_price": 20.16,
      "vat_rate": 24,
      "vat_total": 4.84,
      "subtotal": 25.00,
      "classification_category": "category1_1",
      "classification_type": "E3_561_003"
    }
  ],
  "net_total_amount": 20.16,
  "vat_total_amount": 4.84,
  "total_amount": 25.00,
  "payable_total_amount": 25.00
}

3. Παραγγελία σε τραπέζι: Δελτίο Παραγγελίας Εστίασης 8.6

Κάθε γύρος σε τραπέζι μπαίνει σε 8.6, σε ανοιχτό τραπέζι από τα catering_tables. Οι γραμμές του παίρνουν category1_95 με "_", και δεν χρειάζεται ούτε τρόπο πληρωμής ούτε counterpart. Τα δελτία τα κλείνει αργότερα ένα 11.1: αυτή την απόδειξη, και κάθε άλλο παραστατικό μιας βάρδιας, θα τα βρεις στα παραδείγματα JSON για παραγγελιοληψία.

POST /invoices
{
  "invoice_type_code": "8.6",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "catering_table_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "net_total_amount": 19.11,
  "vat_total_amount": 2.99,
  "total_amount": 22.10,
  "payable_total_amount": 22.10,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Μπριάμ",
      "quantity": 2,
      "quantity_type": 1,
      "unit_price": 8.85,
      "net_total_price": 17.70,
      "vat_rate": 13,
      "vat_total": 2.30,
      "subtotal": 20.00,
      "classification_category": "category1_95",
      "classification_type": "_"
    },
    {
      "line_number": 2,
      "name": "Νερό 1lt",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 1.41,
      "net_total_price": 1.41,
      "vat_rate": 24,
      "vat_total": 0.69,
      "subtotal": 2.10,
      "classification_category": "category1_95",
      "classification_type": "_"
    }
  ]
}

4. Υπηρεσίες σε καταναλωτή: Απόδειξη Παροχής Υπηρεσιών 11.2 (ΑΠΥ)

Μια υπηρεσία σε καταναλωτή μπαίνει σε 11.2, με category1_3 και E3_561_003. Μη μεταφέρεις το E3_561_001 του τιμολογίου παροχής: σε 11.2 το myDATA το απορρίπτει με σφάλμα 313.

POST /invoices
{
  "invoice_type_code": "11.2",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 3,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Παροχή υπηρεσίας",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 50.00,
      "vat_rate": 24,
      "classification_category": "category1_3",
      "classification_type": "E3_561_003",
      "net_total_price": 50.00,
      "vat_total": 12.00,
      "subtotal": 62.00
    }
  ],
  "net_total_amount": 50.00,
  "vat_total_amount": 12.00,
  "total_amount": 62.00,
  "payable_total_amount": 62.00
}

5. Υπηρεσίες σε επιχείρηση: Τιμολόγιο Παροχής Υπηρεσιών 2.1

Οι υπηρεσίες σε επιχείρηση τιμολογούνται με 2.1, με το ΑΦΜ του αγοραστή στο counterpart και category1_3 με E3_561_001 σε κάθε γραμμή.

POST /invoices
{
  "invoice_type_code": "2.1",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 1,
  "counterpart": {
    "name": "ΠΕΛΑΤΗΣ Α.Ε.",
    "country_code": "GR",
    "vat": "123456783",
    "city": "ΑΘΗΝΑ",
    "street": "ΠΑΤΗΣΙΩΝ",
    "number": "112",
    "postal_code": "11257"
  },
  "net_total_amount": 300.00,
  "vat_total_amount": 72.00,
  "total_amount": 372.00,
  "payable_total_amount": 372.00,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Παροχή υπηρεσίας μηνός",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 300.00,
      "net_total_price": 300.00,
      "vat_rate": 24,
      "vat_total": 72.00,
      "subtotal": 372.00,
      "classification_category": "category1_3",
      "classification_type": "E3_561_001"
    }
  ]
}

6. Αγαθά σε επιχείρηση: Τιμολόγιο Πώλησης 1.1

Τα αγαθά σε επιχείρηση τιμολογούνται με 1.1, με το ΑΦΜ του αγοραστή και category1_1 με E3_561_001.

POST /invoices
{
  "invoice_type_code": "1.1",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 1,
  "counterpart": {
    "name": "ΠΕΛΑΤΗΣ Α.Ε.",
    "country_code": "GR",
    "vat": "123456783",
    "city": "ΑΘΗΝΑ",
    "street": "ΠΑΤΗΣΙΩΝ",
    "number": "112",
    "postal_code": "11257"
  },
  "net_total_amount": 500.00,
  "vat_total_amount": 120.00,
  "total_amount": 620.00,
  "payable_total_amount": 620.00,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Εμπορεύματα",
      "quantity": 10,
      "quantity_type": 1,
      "unit_price": 50.00,
      "net_total_price": 500.00,
      "vat_rate": 24,
      "vat_total": 120.00,
      "subtotal": 620.00,
      "classification_category": "category1_1",
      "classification_type": "E3_561_001"
    }
  ]
}

7. Εμπορεύματα που πουλάς για εντολέα: Πώληση για Λογαριασμό Τρίτων 1.4

Όταν τιμολογείς τον αγοραστή για εμπόρευμα του εντολέα σου, το παραστατικό είναι 1.4 και οι γραμμές του παίρνουν category1_7 με E3_881_001. Όλο το ζεύγος, 1.4 και 1.5, το εξηγούμε στις πωλήσεις για λογαριασμό τρίτων.

POST /invoices
{
  "invoice_type_code": "1.4",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 1,
  "counterpart": {
    "name": "ΠΕΛΑΤΗΣ Α.Ε.",
    "country_code": "GR",
    "vat": "123456783",
    "city": "ΑΘΗΝΑ",
    "street": "ΠΑΤΗΣΙΩΝ",
    "number": "112",
    "postal_code": "11257"
  },
  "currency": "EUR",
  "net_total_amount": 1000.00,
  "vat_total_amount": 130.00,
  "total_amount": 1130.00,
  "payable_total_amount": 1130.00,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Πώληση για λογαριασμό τρίτου",
      "quantity": 1000,
      "quantity_type": 2,
      "unit_price": 1.00,
      "net_total_price": 1000.00,
      "vat_rate": 13,
      "vat_total": 130.00,
      "subtotal": 1130.00,
      "classification_category": "category1_7",
      "classification_type": "E3_881_001"
    }
  ]
}

8. Πληρωμή με κάρτα για παραστατικά που έχεις εκδώσει: Απόδειξη Είσπραξης POS 8.4

Το 8.4 καταγράφει μια πληρωμή με κάρτα για παραστατικά που έχεις ήδη εκδώσει, όπως μια χρέωση δωματίου. Η γραμμή του παίρνει category1_95 με "_", με vat_rate 0. Με pos_device_id, το τερματικό χρεώνει το ποσό του.

POST /invoices
{
  "invoice_type_code": "8.4",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 3,
  "net_total_amount": 3.00,
  "vat_total_amount": 0.00,
  "total_amount": 3.00,
  "payable_total_amount": 3.00,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Είσπραξη κατανάλωσης μπαρ",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 3.00,
      "net_total_price": 3.00,
      "vat_rate": 0,
      "vat_total": 0.00,
      "subtotal": 3.00,
      "classification_category": "category1_95",
      "classification_type": "_",
      "vat_exemption_code": "0"
    }
  ]
}

9. Πίστωση σε επιχείρηση: Πιστωτικό Τιμολόγιο 5.2

Το 5.2 πιστώνει μια επιχείρηση χωρίς σύνδεση με το αρχικό τιμολόγιο, οπότε δεν έχει correlated_invoices. Κάθε γραμμή επαναλαμβάνει τον χαρακτηρισμό της γραμμής που πιστώνει. Όταν η πίστωση πρέπει να δείχνει στο αρχικό, χρησιμοποίησε το 5.1, με το ΜΑΡΚ του αρχικού.

POST /invoices
{
  "invoice_type_code": "5.2",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 3,
  "counterpart": {
    "name": "ΠΕΛΑΤΗΣ Α.Ε.",
    "country_code": "GR",
    "vat": "123456783",
    "city": "ΑΘΗΝΑ",
    "street": "ΠΑΤΗΣΙΩΝ",
    "number": "112",
    "postal_code": "11257"
  },
  "net_total_amount": 100.00,
  "vat_total_amount": 24.00,
  "total_amount": 124.00,
  "payable_total_amount": 124.00,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Πίστωση προμήθειας πλατφόρμας",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 100.00,
      "net_total_price": 100.00,
      "vat_rate": 24,
      "vat_total": 24.00,
      "subtotal": 124.00,
      "classification_category": "category1_3",
      "classification_type": "E3_561_001"
    }
  ]
}

10. Εμπορεύματα σε διακίνηση: Δελτίο Αποστολής 9.3

Το 9.3 καταγράφει εμπορεύματα που μεταφέρονται σε πελάτη ή σε άλλη τοποθεσία, όχι πώληση, γι' αυτό δεν έχει ποσά και οι γραμμές του παίρνουν category3 με "_". Στείλε is_delivery_note: true και το μπλοκ delivery_detail, με counterpart που έχει διεύθυνση. Η ημερομηνία και η ώρα αποστολής δεν μπορούν να είναι στο παρελθόν, αλλιώς το myDATA απορρίπτει το δελτίο με σφάλμα 280. Ο τρόπος πληρωμής είναι προαιρετικός.

POST /invoices
{
  "invoice_type_code": "9.3",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 1,
  "counterpart": {
    "name": "ΠΕΛΑΤΗΣ Α.Ε.",
    "country_code": "GR",
    "vat": "123456783",
    "city": "ΑΘΗΝΑ",
    "street": "ΠΑΤΗΣΙΩΝ",
    "number": "112",
    "postal_code": "11257"
  },
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Εμπορεύματα προς αποστολή",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 0.00,
      "vat_rate": 24,
      "classification_category": "category3",
      "classification_type": "_"
    }
  ],
  "delivery_detail": {
    "dispatch_date": "DD-MM-YYYY",
    "dispatch_time": "HH:MM",
    "vehicle_number": "ABC1234",
    "purpose_of_movement": "1",
    "issuer_of_movement": "WRAPP",
    "from_address": "Νέστορος",
    "from_number": "1",
    "from_city": "Αθήνα",
    "from_zipcode": "15231",
    "to_address": "ΠΑΤΗΣΙΩΝ",
    "to_number": "112",
    "to_city": "ΑΘΗΝΑ",
    "to_zipcode": "11257"
  },
  "is_delivery_note": true
}

11. Επιστροφή σε απόδειξη: Πιστωτικό Στοιχείο Λιανικής 11.4

Η επιστροφή ή ακύρωση ενός 11.1 ή 11.2 μπαίνει σε 11.4, με το ΜΑΡΚ της αρχικής απόδειξης στο correlated_invoices. Κάθε γραμμή επαναλαμβάνει την αρχική, μαζί με τον ΦΠΑ, ώστε η επιστροφή να αντιστρέφει και τον ΦΠΑ. Σε μερική επιστροφή, πίστωσε μόνο τις γραμμές που επιστρέφονται.

POST /invoices
{
  "invoice_type_code": "11.4",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 3,
  "correlated_invoices": [
    "400001xxxxxxxx1"
  ],
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Ακύρωση απόδειξης",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 50.00,
      "vat_rate": 24,
      "classification_category": "category1_3",
      "classification_type": "E3_561_003",
      "net_total_price": 50.00,
      "vat_total": 12.00,
      "subtotal": 62.00
    }
  ],
  "net_total_amount": 50.00,
  "vat_total_amount": 12.00,
  "total_amount": 62.00,
  "payable_total_amount": 62.00
}

12. Τέλος ανθεκτικότητας κλιματικής κρίσης: 8.2

Τα καταλύματα εκδίδουν το τέλος σε δικό του 8.2, δίπλα στο 11.2 της διαμονής. Το accommodation_tax είναι το ποσό ανά διανυκτέρευση, και το other_taxes_percent_category μπαίνει στη γραμμή, όχι στο παραστατικό. Η γραμμή παίρνει category1_95 με "_". Περισσότερα για το τέλος θα βρεις στο τέλος ανθεκτικότητας κλιματικής κρίσης.

POST /invoices
{
  "invoice_type_code": "8.2",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 3,
  "net_total_amount": 0.00,
  "vat_total_amount": 0.00,
  "total_amount": 2.00,
  "payable_total_amount": 2.00,
  "other_taxes_amount": 2.00,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Τέλος ανθεκτικότητας κλιματικής κρίσης",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 0.00,
      "net_total_price": 0.00,
      "vat_total": 0.00,
      "subtotal": 0.00,
      "accommodation_tax": 2.00,
      "other_taxes_amount": 2.00,
      "other_taxes_percent_category": 24,
      "classification_category": "category1_95",
      "classification_type": "_"
    }
  ]
}

13. Εκκαθάριση πωλήσεων εντολέα: 1.5

Το 1.5 εκκαθαρίζει τις πωλήσεις του εντολέα σου και χρεώνει την αμοιβή σου, σε δύο γραμμές. Η πρώτη, η πώληση του εντολέα, παίρνει category2_9 με "_", expense: true και invoice_detail_type 1. Η δεύτερη, η αμοιβή σου, παίρνει category1_3 με E3_561_001 και invoice_detail_type 2. Όλη την εξήγηση θα τη βρεις στις πωλήσεις για λογαριασμό τρίτων.

POST /invoices
{
  "invoice_type_code": "1.5",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 1,
  "counterpart": {
    "name": "ΠΕΛΑΤΗΣ Α.Ε.",
    "country_code": "GR",
    "vat": "123456783",
    "city": "ΑΘΗΝΑ",
    "street": "ΠΑΤΗΣΙΩΝ",
    "number": "112",
    "postal_code": "11257"
  },
  "currency": "EUR",
  "net_total_amount": 1100.00,
  "vat_total_amount": 154.00,
  "total_amount": 1254.00,
  "payable_total_amount": 1254.00,
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Εκκαθάριση πωλήσεων τρίτων",
      "quantity": 100,
      "quantity_type": 1,
      "unit_price": 10.00,
      "net_total_price": 1000.00,
      "vat_rate": 13,
      "vat_total": 130.00,
      "subtotal": 1130.00,
      "invoice_detail_type": 1,
      "expense": true,
      "classification_category": "category2_9",
      "classification_type": "_"
    },
    {
      "line_number": 2,
      "name": "Αμοιβή από πωλήσεις τρίτων",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 100.00,
      "net_total_price": 100.00,
      "vat_rate": 24,
      "vat_total": 24.00,
      "subtotal": 124.00,
      "invoice_detail_type": 2,
      "classification_category": "category1_3",
      "classification_type": "E3_561_001"
    }
  ]
}

Πώς ξεκινάς

Κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και, μόλις ορίσεις κωδικό, πάτα «Δοκίμασε το API». Παίρνεις email σύνδεσης και API key για το staging.wrapp.ai, με τα μπλοκ ήδη στημένα, και στέλνεις κάθε παράδειγμα αυτής της σελίδας χωρίς φορολογική ισχύ. Πού βρίσκεις το key το δείχνει ο οδηγός για το δοκιμαστικό API key, και όλα τα endpoints είναι στην τεκμηρίωση του API.

Συχνές ερωτήσεις

Ποιο παραστατικό εκδίδει ένα e-shop για μια παραγγελία;

Ένα e-shop που πουλά αγαθά σε καταναλωτές εκδίδει Απόδειξη Λιανικής Πώλησης 11.1 (ΑΛΠ), με category1_1 και E3_561_003 σε κάθε γραμμή προϊόντος, ή category1_2 για προϊόντα που φτιάχνει το ίδιο. Η γραμμή μεταφορικών παίρνει category1_3. Ένα e-shop που πουλά υπηρεσίες εκδίδει Απόδειξη Παροχής Υπηρεσιών 11.2 (ΑΠΥ).

Ποια η διαφορά ανάμεσα σε 11.1 και 11.2;

Το 11.1 είναι η απόδειξη λιανικής για αγαθά και το 11.2 για υπηρεσίες. Ακολουθούν τους ίδιους κανόνες για το counterpart και τον τρόπο πληρωμής. Οι γραμμές του 11.2 παίρνουν category1_3 με E3_561_003, και το E3_561_001 απορρίπτεται εκεί με σφάλμα 313.

Χρειάζεται counterpart σε απόδειξη λιανικής;

Όχι. Στο 11.1, το 11.2 και το 11.4 μπορείς να παραλείψεις εντελώς το κλειδί counterpart. Τα τιμολόγια σε επιχείρηση έχουν counterpart με το ΑΦΜ του αγοραστή.

Τι σημαίνει το "_" στο classification_type;

Ότι η γραμμή δεν παίρνει τύπο χαρακτηρισμού. Μπαίνει στις γραμμές του 8.6, του 8.4 και του 8.2 με category1_95, στο 9.3 με category3, και στην πρώτη γραμμή ενός 1.5 με category2_9. Στείλε ακριβώς "_": κενό κείμενο ή null δεν δουλεύουν.

Γιατί το myDATA απαντά με σφάλμα 204, Payment Methods is mandatory;

Γιατί το παραστατικό δεν έχει payment_method_type. Το 11.1, το 11.2, το 11.4, το 8.2 και το 8.4 το χρειάζονται. Παίρνει τους αριθμούς του Wrapp, όχι τους κωδικούς του myDATA: το 0 είναι μετρητά και το 3 κάρτα. Η απόρριψη χάνει τον αριθμό σειράς του παραστατικού.

Γιατί το παραστατικό μου αποθηκεύτηκε με μηδενική αξία;

Γιατί έλειπαν τα ποσά του. Τίποτα δεν υπολογίζεται από ποσότητα και τιμή: κάθε γραμμή χρειάζεται net_total_price, vat_total και subtotal, και το παραστατικό net_total_amount, vat_total_amount, total_amount και payable_total_amount.

Μπορεί ένα 11.2 να εκδοθεί από μπλοκ 11.1;

Όχι. Κάθε παραστατικό λιανικής θέλει μπλοκ του ίδιου είδους, αλλιώς το API απορρίπτει το προσχέδιο. Ένα μπλοκ 1.1 εκδίδει και 1.2 και 1.3, και ένα μπλοκ 2.1 και 2.2 και 2.3.

Πού δοκιμάζω τα παραδείγματα;
Στο staging, που το ανοίγεις μόνος σου: κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και, μόλις ορίσεις κωδικό, πάτα «Δοκίμασε το API». Εκεί έχεις email σύνδεσης και API key για το staging.wrapp.ai, με τα μπλοκ ήδη στημένα, και ό,τι εκδίδεις δεν έχει φορολογική ισχύ. Πού βρίσκεις το key το δείχνει ο οδηγός για το δοκιμαστικό API key.

Χρειάζεσαι βοήθεια;

Αν έχεις απορία για αυτό το θέμα ή θέλεις να σιγουρευτείς ότι όλα ρυθμίστηκαν σωστά, επικοινώνησε μαζί μας και θα το δούμε μαζί.