# Which myDATA document type and classification: e-shop, restaurant, services, B2B

> The documents Greek businesses issue most, from the e-shop receipt to the credit invoice and the delivery note, each with its invoice_type_code, its classification_category and classification_type, and a complete JSON body for POST /invoices.
>
> AI-friendly Markdown version. HTML version: https://wrapp.ai/en/resources/mydata-document-type-classification-guide
> EL version: https://wrapp.ai/el/resources/poio-parastatiko-kai-xaraktirismos-mydata.md

Every document you send to myDATA carries an `invoice_type_code`, and every line a `classification_category` and a `classification_type`. Which ones depends on what you sell and who buys it. This page answers it for the documents Greek businesses issue most often, each with a complete JSON body for `POST /invoices`.

**These are the common cases, not the limit.** The API issues many more document types, and each type accepts other classification pairs. The full myDATA lists are in [invoice types](/en/resources/invoice-types), [classification categories](/en/resources/classification-categories) and [classification types](/en/resources/classification-types), and every field is in the [API documentation](https://wrapp.ai/api/documentation).

| What you issue | invoice_type_code | Classification |
| --- | --- | --- |
| Goods to a consumer, e-shop included | 11.1 | `category1_1` (resold) or `category1_2` (made), with `E3_561_003` |
| The same, paid on a POS terminal | 11.1 with `pos_device_id` | As above |
| An order at a restaurant table | 8.6 | `category1_95` with `"_"` |
| Services to a consumer | 11.2 | `category1_3` with `E3_561_003` |
| Services to a business | 2.1 | `category1_3` with `E3_561_001` |
| Goods to a business | 1.1 | `category1_1` with `E3_561_001` |
| Goods you sell for a principal | 1.4 | `category1_7` with `E3_881_001` |
| A card payment for documents already issued | 8.4 | `category1_95` with `"_"` |
| A credit to a business | 5.2 | As the original line |
| Goods on the move | 9.3 | `category3` with `"_"` |
| A refund on a receipt | 11.4 | As the original line, with `E3_561_003` |
| The climate resilience fee | 8.2 | `category1_95` with `"_"` |
| Settling a principal's sales | 1.5 | `category2_9` with `"_"`, then `category1_3` with `E3_561_001` |

## Before you start

- **Billing books:** each type issues from a book of its own type, with the `billing_book_id` from `GET /billing_books`. A 1.1 book also issues 1.2 and 1.3, and a 2.1 book also issues 2.2 and 2.3. Retail types don't share books.
- **Explicit amounts:** every line carries `net_total_price`, `vat_total` and `subtotal`, and the document its four totals. Nothing is computed for you: without them the document is stored at 0.00.
- **Payment method:** `payment_method_type` takes Wrapp's own numbers from the [API documentation](https://wrapp.ai/api/documentation#payment-method-types), not myDATA's codes: 0 is cash, 1 on credit, 3 card. Retail receipts, the 11.4, the 8.2 and the 8.4 are refused without it, with error 204.
- **Reading the codes:** myDATA's lists write «1.3», and the field takes `category1_3`. `"_"` means the line has no classification type: send exactly that, an empty string or `null` does not work.
- **Classifications:** the ones on this page are the usual ones for each case. Which one applies to a business is its accountant's call.
- **A unique `external_id`:** a repeated one is refused, so a call you retry never issues a second document.

## 1. Goods to a consumer, e-shop included: Retail Sales Receipt 11.1 (ΑΛΠ)

An e-shop order, or a sale at the counter paid in cash, by card online or by transfer, goes on an 11.1. Goods you resell take `category1_1`, products you make `category1_2`, and a shipping line `category1_3`, all with `E3_561_003`. No counterpart is needed: leave the key out.

POST /invoices

```json
{
  "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. Paid on a POS terminal: the same 11.1 with pos_device_id

When the customer pays by card on a terminal connected to Wrapp, add `pos_device_id`, the terminal's id from `GET /pos_devices`, and send `payment_method_type` 3. The terminal charges the receipt's amount, and the receipt takes its ΜΑΡΚ once the payment is approved. You receive it by webhook.

POST /invoices

```json
{
  "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. An order at a restaurant table: Catering Order Note 8.6

Every round at a table goes on an 8.6, on an open table from `catering_tables`. Its lines take `category1_95` with `"_"`, and it needs no payment method and no counterpart. An 11.1 settles the notes later: that receipt, and every other document of a shift, is in the [restaurant JSON examples](/en/resources/restaurant-ordering-mydata-api-json-examples).

POST /invoices

```json
{
  "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. Services to a consumer: Service Rendered Receipt 11.2 (ΑΠΥ)

A service sold to a consumer goes on an 11.2, with `category1_3` and `E3_561_003`. Don't carry over `E3_561_001` from a services invoice: on an 11.2 myDATA refuses it with error 313.

POST /invoices

```json
{
  "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. Services to a business: Services Invoice 2.1

Services billed to a business take a 2.1, with the buyer's ΑΦΜ in the counterpart and `category1_3` with `E3_561_001` on each line.

POST /invoices

```json
{
  "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. Goods to a business: Sales Invoice 1.1

Goods sold to a business take a 1.1, with the buyer's ΑΦΜ and `category1_1` with `E3_561_001`.

POST /invoices

```json
{
  "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. Goods you sell for a principal: Sale on Behalf of Third Parties 1.4

When you invoice the buyer for goods that belong to your principal, the document is a 1.4 and its lines take `category1_7` with `E3_881_001`. The whole pair, 1.4 and 1.5, is explained in [sales on behalf of third parties](/en/resources/mydata-sales-on-behalf-of-third-parties-api).

POST /invoices

```json
{
  "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. A card payment for documents already issued: POS Payment Receipt 8.4

An 8.4 records a card payment for documents you already issued, such as a room charge. Its line takes `category1_95` with `"_"`, at `vat_rate` 0. With `pos_device_id`, the terminal charges its amount.

POST /invoices

```json
{
  "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. A credit to a business: Credit Invoice 5.2

A 5.2 credits a business without linking to the original invoice, so it carries no `correlated_invoices`. Each line repeats the classification of the line it credits. When the credit has to point to the original, use the 5.1 instead, with the original's ΜΑΡΚ.

POST /invoices

```json
{
  "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. Goods on the move: Delivery Note 9.3

A 9.3 records goods moving to a customer or another location, not a sale, so it carries no amounts and its lines take `category3` with `"_"`. Send `is_delivery_note: true` and the `delivery_detail` block, with a counterpart that has an address. The dispatch date and time can't be in the past, or myDATA refuses the note with error 280. A payment method is optional.

POST /invoices

```json
{
  "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. A refund on a receipt: Retail Credit Note 11.4

A refund or cancellation of an 11.1 or 11.2 goes on an 11.4, with the original receipt's ΜΑΡΚ in `correlated_invoices`. Each line repeats the original line, VAT included, so the refund reverses the VAT too. For a partial refund, credit only the lines returned.

POST /invoices

```json
{
  "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. The climate resilience fee: 8.2

Accommodation businesses issue the fee on its own 8.2, next to the 11.2 for the stay. `accommodation_tax` is the amount per night, and `other_taxes_percent_category` goes on the line, not on the document. The line takes `category1_95` with `"_"`. More on the fee in [the climate resilience fee](/en/resources/climate-resilience-fee).

POST /invoices

```json
{
  "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. Settling a principal's sales: Clearance 1.5

A 1.5 settles your principal's sales and bills your fee, on two lines. The first, the principal's sale, takes `category2_9` with `"_"`, `expense: true` and `invoice_detail_type` 1. The second, your fee, takes `category1_3` with `E3_561_001` and `invoice_detail_type` 2. The full explanation is in [sales on behalf of third parties](/en/resources/mydata-sales-on-behalf-of-third-parties-api).

POST /invoices

```json
{
  "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"
    }
  ]
}
```

## How to start

[Sign up free at wrapp.ai](https://wrapp.ai/en/users/new) with your VAT number and press "Try the API". You get a login email and an API key for staging.wrapp.ai, and you can send every example on this page with no tax effect. Where to find the key is in the guide to your [test API key](/en/resources/mydata-sandbox-api-key-test-environment), and every endpoint is in the [API documentation](https://wrapp.ai/api/documentation).

## Frequently asked questions

### Which myDATA document does an e-shop issue for an order?

An e-shop selling goods to consumers issues the Retail Sales Receipt 11.1 (ΑΛΠ), with category1_1 and E3_561_003 on each product line, or category1_2 for products it makes itself. A shipping line takes category1_3. An e-shop selling services issues the Service Rendered Receipt 11.2 (ΑΠΥ).

### What is the difference between 11.1 and 11.2?

The 11.1 is the retail receipt for goods and the 11.2 for services. They follow the same rules for the counterpart and the payment method. The 11.2's lines take category1_3 with E3_561_003, and E3_561_001 is refused on it with error 313.

### Does a retail receipt need a counterpart?

No. On the 11.1, 11.2 and 11.4 you can leave the counterpart key out entirely. Invoices to a business carry the counterpart with the buyer's ΑΦΜ.

### What does "_" mean in classification_type?

That the line has no classification type. It goes on the lines of the 8.6, 8.4 and 8.2 with category1_95, on the 9.3 with category3, and on the first line of a 1.5 with category2_9. Send exactly "_": an empty string or null does not work.

### Why does myDATA return error 204, Payment Methods is mandatory?

Because the document has no payment_method_type. The 11.1, 11.2, 11.4, 8.2 and 8.4 need one. It takes Wrapp's own numbers, not myDATA's codes: 0 is cash and 3 is card. The rejection uses up the document's series number.

### Why was my document stored with a zero value?

Because its amounts were missing. Nothing is computed from quantity and price: every line needs net_total_price, vat_total and subtotal, and the document net_total_amount, vat_total_amount, total_amount and payable_total_amount.

### Can an 11.2 be issued from an 11.1 billing book?

No. Each retail type needs a book of its own type, and the API refuses the draft otherwise. A 1.1 book also issues 1.2 and 1.3, and a 2.1 book also issues 2.2 and 2.3.

### Where can I try the examples?

Need help? Contact us: https://wrapp.ai/contact
