# Test data — pilot ΑΦΜ, signers and βεβαιώσεις to try

Concrete values for driving the app end to end, all drawn from **Παράρτημα Ε** of the ΚΕΔ
spec (transcribed in `docs/internal/parartima-z-notes.md` §5). They are pilot dummies
published in the spec — **not real debtors, and not credentials** — so they are safe for the
fake driver, for fixtures and for typing into the form.

> **Driver changes what you see — και οι δύο δεν υπόσχονται ποτέ τις ίδιες αποτυχίες.**
> `KED_DRIVER=fake` (προεπιλογή): κανένα δίκτυο· πιστοποιεί κάθε ΑΦΜ εκτός από τα δύο «μαγικά»
> ΑΦΜ αποτυχίας παρακάτω, δέχεται κάθε υπογράφοντα εκτός από το `012703950`. Τα σενάρια
> αποτυχίας του fake είναι **μοντελοποίηση των διαδρομών αποτυχίας του spec** — όχι παρατηρημένη
> συμπεριφορά του pilot.
> `KED_DRIVER=soap`: ο πραγματικός πιλότος της ΑΑΔΕ. Επίσημα δημοσιευμένα δεδομένα είναι **μόνο**
> τα «καλά» του Παραρτήματος Ε — το spec δεν δημοσιεύει κανένα αποτυχημένο fixture. Ό,τι έχουμε
> δει πραγματικά να αποτυγχάνει στον pilot σημειώνεται ρητά «παρατηρημένο» και έχει την πηγή του
> στο `docs/internal/parartima-z-notes.md` §7a.

---

## 1. Υπογράφοντες — `declare_signers` / `retrieveNames`

**Prerequisite for every βεβαίωση:** declare a signer first, and wait for ΚΕΔ to accept the
list. Nothing certifies otherwise.

### Valid signer ΑΦΜ (ΚΕΔ accepts)

| ΑΦΜ | Όνομα (Παράρτημα Ε) |
|---|---|
| `003067224` | ΧΡΙΣΤΟΠΟΥΛΟΥ ΕΥΓΕΝ |
| `010020485` | ΠΙΠΕΡΑΚΗΣ ΕΜΜΑΝ |
| `010800987` | ΣΤΑΘΟΠΟΥΛΟΣ ΕΛΕΥΘ |
| `010820206` | ΜΑΝΩΛΑΚΟΣ ΑΝΑΡΓ |
| `011564265` | ΠΑΡΑΣΚΕΥΑΣ ΔΗΜΗΤΡ |
| `011586270` | ΛΟΥΚΙΣΣΑΣ ΕΜΜΑΝ |
| `013349550` | ΣΤΑΜΑΤΗΣ ΓΕΩΡΓ |
| `013379910` | ΚΑΡΑΒΑΣΙΛΗΣ ΧΑΡΑΛ |
| `014075592` | ΛΟΥΚΑΙΤΟΥ ΕΛΠΙΣ |
| `014193897` | ΠΑΠΑΓΕΩΡΓΙΟΥ ΓΕΩΡΓ |

Στη δική μας πλευρά τα ονόματα είναι μόνο για εμφάνιση, αλλά **ο pilot ελέγχει το επώνυμο
εναντίον του μητρώου ΑΦΜ** (παρατηρημένο 2026-09-03: `WS_PROCEDURE_ERROR` / «Λανθασμένο
Επώνυμο Υπογράφοντος»). Χρησιμοποίησε το επώνυμο του Παραρτήματος Ε **όπως το δημοσιεύει** —
είναι ήδη περικομμένο εκεί (π.χ. `ΠΑΡΑΣΚΕΥΑΣ ΔΗΜΗΤΡ`), μην το «διορθώσεις» ούτε μην
εφεύρεις άλλο.

**Προσοχή (παρατηρημένο 2026-09-18 & 2026-10-27):** ο pilot απορρίπτει πλέον τους
`011586270` ΛΟΥΚΙΣΣΑΣ και `013349550` ΣΤΑΜΑΤΗΣ με `WS_PROCEDURE_ERROR` / «Υπογράφων με ΑΦΜ
πεθαμένου» — **όλη η λίστα**. (Το `012703950` παραμένει δεκτό — η σημαία «πεθαμένος»
εφαρμόζεται επιλεκτικά, βλ. §7a.) Επιβεβαιωμένοι ζωντανοί (27-10): τα πέντε πρώτα του
πίνακα — `003067224`, `010020485`, `010800987`, `010820206`, `011564265`.

### Invalid signer

| Driver | Τι γίνεται |
|---|---|
| **fake** | `012703950` → `WS_PROCEDURE_ERROR_DEAD`. **Απορρίπτεται όλη η λίστα**, όχι μόνο αυτός. |
| **soap (pilot)** | `012703950` → **δεκτός**. Παρατηρημένο 2026-08-07 και ξανά 2026-09-03 (τέσσερις κλήσεις, call log #33/#34/#36/#39): ο pilot δεν εφαρμόζει τη σημαία «πεθαμένος» του Παραρτήματος Ε. |

| ΑΦΜ | Όνομα | Σημείωση |
|---|---|---|
| `012703950` | ΧΡΙΣΤΟΔΟΥΛΟΥ ΝΙΚΟΛ | Παράρτημα Ε: «πεθαμένος» — η μοναδική αποτυχημένη δοκιμή που δημοσιεύει το spec, και ο pilot την αγνοεί. |

### Pilot — παρατηρημένες απορρίψεις υπογραφόντων (2026-09-03, §7a)

Ο pilot απορρίπτει **όλη τη λίστα** για έναν κακό υπογράφοντα:

| ΑΦΜ | Τι στείλαμε | Απάντηση |
|---|---|---|
| `139270450` | επώνυμο ≠ μητρώο | `WS_PROCEDURE_ERROR` / «Λανθασμένο Επώνυμο Υπογράφοντος» |
| `800915091` | ΑΦΜ εκτός μητρώου | `WS_PROCEDURE_ERROR` / «Δεν βρέθηκε ο ΑΦΜ» |

### Έτοιμη εντολή

```bash
./vendor/bin/sail artisan bff:publish declare_signers \
  --params='{"signers":[{"afm":"003067224","firstName":"ΕΥΓΕΝ","lastName":"ΧΡΙΣΤΟΠΟΥΛΟΥ"}],"auditUserId":"demo-user","auditUserIp":"127.0.0.1"}'
```

Για να δοκιμάσεις την απόρριψη, βάλε `"afm":"012703950"` στον υπογράφοντα — **στο fake
driver**· στον pilot θα περάσει (βλ. §1).

---

## 2. Βεβαιώσεις — `submit_beveosi` / `retrieveKedeAmount`

Όλα τα ποσά ως **κείμενο με 2 δεκαδικά** (`600.00`), ποτέ αριθμός. Το `sunolo` πρέπει να
ισούται **και** με το άθροισμα των δόσεων **και** με το άθροισμα των ΚΑΕ.

### Valid — πιστοποιείται

Η κανονική περίπτωση (driver=soap: πραγματικό βάρος στο test TAXIS· driver=fake: canned
απάντηση):

| Πεδίο | Τιμή |
|---|---|
| `afm` | `137569280` |
| `sunolo` | `600.00` |
| `kaeLines` | `[{ "kae": "82838", "amount": "600.00" }]` |
| `installments` | `[{ "aa": "1", "dueDate": "<τελευταία εργάσιμη επόμενου μήνης>", "amount": "600.00" }]` |
| `fiscalYear` | τρέχον έτος |
| `apofNoEtos` | `10/2026` |
| `comments` | `Απόφαση 10/2026` (υποχρεωτικό· βάσει προδιαγραφής αναφέρει την απόφαση) |
| `afmYpogr` | `003067224` (πρέπει να έχει δηλωθεί πρώτα) |
| `unitId` | π.χ. `1204` — **υποχρεωτικό στην υποβολή** (από 27-10), δικό μας μεταδεδομένο, δεν πάει στο ΚΕΔ |
| `unitAcronym` | π.χ. `ΙΝΡΑ` — προαιρετικό, για εμφάνιση |
| `insFrequency` | `1` |
| `lastDayRule` | `1` |
| `doyFlag` | `0` |

Αποτέλεσμα (fake): `certified_pending_closeday`, `doy=9776`, με `mcNo`/`lineNo`· ο ΑΤΒ
έρχεται με το κλείσιμο ημέρας (βλ. §3).

Άλλα pilot ΑΦΜ οφειλέτη (Παράρτημα Ε) — αντάλλαξε το `afm` με όποιο από αυτά:

```
137569280 001303242 028633507 139267407 139269609 139281402 038573262 137664663 137671863
099062654 099803657 099556992 099339555 099631554 073943479 034051630 140404502 054454734
018617850 137231140 027527018 046403980 066111650 036607380 003842491
```

**Προσοχή — νεκρά/προβληματικά ΑΦΜ οφειλέτη (παρατηρημένο 2026-09-18 έως 2026-10-27, §7a):**
ο pilot απορρίπτει με `WS_PROCEDURE_ERROR` / «ΑΠΟΒΙΩΣΑΣ ΑΦΜ» τους `001303242`, `028633507`,
`139267407`, `139281402`, `137664663`· και τον `003842491` με «ΠΡΟΒΛΗΜΑΤΙΚΟΣ ΑΦΜ». Μην τους
χρησιμοποιείς. Επιβεβαιωμένοι ζωντανοί οφειλέτες (27-10): `137569280`, `099631554`,
`137231140`, `099803657` — προτίμα αυτούς.

**`123456789` / «ΝΙΚΟΣ ΝΙΚΟΥ» — αδήλωτο ΑΦΜ εκτός Παραρτήματος Ε.** Το `123456789`
**πιστοποιείται κανονικά** στον pilot (παρατηρημένο 2026-10-28), ενώ το
`543543543` απορρίπτεται με «Δεν βρέθηκε ο ΑΦΜ» — άρα το ΑΦΜ του οφειλέτη ελέγχεται **θετικά**
ενάντια στο μητρώο του pilot (όχι μόνο για σημαίες), και το `123456789` είναι **αδήλωτη**
εγγραφή του: μηδενική αναφορά σε όλο το spec (Παράρτημα Ε, σελ. 45–46, συμπεριλαμβάνεται),
στο xlsx, στο Postman και στα .docx. Το χρησιμοποιεί η ομάδα του BFF για smoke tests. **Μην
χτίζεις πάνω του** — αδήλωτη εγγραφή μπορεί να εξαφανιστεί χωρίς ειδοποίηση, και η Ταυτότητα
Οφειλής του αποτυγχάνει πάντα στο `get_payment_progress` («Πληκτρολογήσατε λάθος Α.Φ.Μ.» —
το endpoint πληρωμών επικυρώνει το ΑΦΜ πολύ αυστηρότερα από την υποβολή).

Σημείωση για τον πίνακα: το ονοματεπώνυμο του οφειλέτη (`debtorName`) είναι **καθαρά δικό
μας πεδίο εμφάνισης** — δεν ταξιδεύει ποτέ στο ΚΕΔ (το `retrieveKedeAmount` στέλνει μόνο
`afm`/`code`/`category`/`amount` ανά οφειλέτη). Όποιο όνομα εμφανίζεται στις απαντήσεις μας
είναι αυτό που πληκτρολογήθηκε στην υποβολή.

Με συνυπόχρεο: `afm 137569280` + `synypochreoi [{ "afm": "063745180", "code": "1", "category": "2", "amount": "150.00" }]` — ολόκληρο έτοιμο παράδειγμα στο `tests/fixtures/beveosi.json`.

```bash
./vendor/bin/sail artisan bff:publish submit_beveosi --params=@tests/fixtures/beveosi.json
```

### Invalid — τι να δοκιμάσεις και τι περιμένεις

Πού γίνεται η απόρριψη — τρία επίπεδα, και τα τρία χρήσιμα:

**1. Τοπική επικύρωση — δεν φτάνει ποτέ στο ΚΕΔ, ίδιο και στους δύο drivers:**

| Τι αλλάζεις | Τιμή | Αποτέλεσμα |
|---|---|---|
| `kaeLines[].kae` | οτιδήποτε ≠ `82838` | «Μη αποδεκτός ΚΑΕ» |
| `afmYpogr` | μη δηλωμένος | «Ο υπογράφων δεν έχει δηλωθεί στο ΚΕΔ» |
| `sunolo` vs δόσεις | διαφορετικά | «Το σύνολο δεν ισούται με το άθροισμα των δόσεων» |
| `sunolo` vs ΚΑΕ | διαφορετικά | «Το σύνολο δεν ισούται με το άθροισμα των ΚΑΕ» |
| `doyFlag` | `1` | «Η βεβαίωση σε ΔΟΥ ακινήτου (doyFlag=1) δεν υποστηρίζεται» |
| `afm` οφειλέτη | όχι 9 ψηφία | «Το ΑΦΜ πρέπει να είναι ακριβώς 9 ψηφία» |
| `fiscalYear` | `<2010` ή `>τρέχον` | «Το έτος πρέπει να είναι από 2010 έως το τρέχον έτος» |

**2. Fake driver — μοντελοποίηση των διαδρομών αποτυχίας του spec (κανένα δίκτυο):**

| Τι αλλάζεις | Τιμή | Αποτέλεσμα |
|---|---|---|
| `afm` οφειλέτη | `000000000` | `GEN_INVALID_DATA` — «απόρριψη από ΚΕΔ». Η γραμμή **ξεκλειδώνει** (επαναποστείσιμη), κρατά το `audit_protocol`. |
| `afm` οφειλέτη | `999999999` | Καμία απάντηση (SoapFault). Η γραμμή **μένει κλειδωμένη** στο «Εκκρεμεί έλεγχο» — **ΜΗΝ** την ξαναυποβάλεις (μπορεί να υπάρχει χρέος στη ΔΟΥ). |
| υπογράφων (`declare_signers`) | `012703950` | `WS_PROCEDURE_ERROR_DEAD` — απορρίπτεται η λίστα. |
| δόση ή ΚΑΕ ποσό | `0.00` | «Μηδενικό ποσό» — το ΚΕΔ απορρίπτει ολόκληρη τη βεβαίωση. |

**Και ένα μη-αποτυχίας sentinel:** με `afm` οφειλέτη **`888888888`** η βεβαίωση **δεν
απορρίπτεται** — μπαίνει στον ΧΚ που η ημέρα έχει ήδη ανοίξει, στην επόμενη γραμμή: ίδιο
`mcNo`, συνεχόμενο `lineNo` (2η και 3η βεβαίωση κ.ο.κ.). Μοντελοποιεί την πραγματική
ομαδοποίηση του ΔΟΥ (παρατηρημένο στον pilot 2026-08-07, ΧΚ 3· αναπαρήχθη ζωντανά
2026-10-26, ΧΚ 21). Υπόβαλε **δύο** βεβαιώσεις με ίδιο ΑΦΜ `888888888` και διαφορετικό αρ.
απόφασης την ίδια μέρα, μετά `ked:reconcile`, και κοίτα ότι η καθεμία κράτησε τη δική της
Ταυτότητα Οφειλής.

**3. Pilot (soap) — παρατηρημένο, 2026-09-03 (πηγή: §1 παραπάνω και §7a):**

| Τι αλλάζεις | Τιμή | Αποτέλεσμα |
|---|---|---|
| επώνυμο υπογράφοντος | ≠ μητρώο (`139270450`) | `WS_PROCEDURE_ERROR` / «Λανθασμένο Επώνυμο Υπογράφοντος» — όλη η λίστα |
| ΑΦΜ υπογράφοντος | εκτός μητρώου (`800915091`) | `WS_PROCEDURE_ERROR` / «Δεν βρέθηκε ο ΑΦΜ» |
| `afm` οφειλέτη | εκτός Παραρτήματος Ε (`543543543`) | `WS_PROCEDURE_ERROR` / «Δεν βρέθηκε ο ΑΦΜ» — παρατηρημένο 2026-10-28: ο pilot **ελέγχει θετικά την ύπαρξη** του ΑΦΜ οφειλέτη, όχι μόνο σημαίες |
| `afm` οφειλέτη | `123456789` (εκτός Παραρτήματος Ε) | **πιστοποιείται** — αδήλωτη ζωντανή εγγραφή του μητρώου του pilot· βλ. την ενότητα `123456789` παραπάνω |
| `afm` οφειλέτη | `028633507`, `139281402` (Παράρτημα Ε) | `WS_PROCEDURE_ERROR` / «ΑΠΟΒΙΩΣΑΣ ΑΦΜ» — παρατηρημένο 2026-10-09· η βεβαίωση γίνεται `failed`, επαναποστολή με `id` + νέο `afm` πέρασε. Ολόκληρη η νεκρή λίστα στο **Προσοχή** παραπάνω |

---

## 3. Τι επιστρέφει το fake driver (για να ξέρεις τι περιμένεις)

- `doy` = `9776`, `mcNo` αυξανόμενο, `lineNo` ανά ΑΦΜ.
- Εξαίρεση στο αυξανόμενο `mcNo`: ΑΦΜ `888888888` → ο ΧΚ της ημέρας ξαναχρησιμοποιείται
  (ίδιο `mcNo`, επόμενο `lineNo`) — το batching, όπως πάνω.
- ΑΤΒ (με το `retrieveCloseDay`): `861675 + mcNo`.
- Ταυτότητα Οφειλής (`payId`) ανά ΑΦΜ — π.χ. για `137569280`: `137569280910104293686167500001`.

Πραγματικά νούμερα από το soap pilot βλέπεις στα `docs/internal/open-points.md` (η πιλοτική
sessία 2026-08-07).

---

## 4. ΚΑΕ, extOrg, txtCode

- **ΚΑΕ `82838`** — ο μοναδικός ενεργός ΚΑΕ στο seed (`Αχρεωστήτως καταβληθέντα`,
  `database/seeders`, βλ. `docs/data-model.md`). Οτιδήποτε άλλο → «Μη αποδεκτός ΚΑΕ».
- **extOrg `82838`** — η τιμή-δείγμα του Postman. Η πραγματική τιμή για το soap είναι το
  `KED_EXT_ORG` στο `.env` (δίνει ο ΑΑΔΕ).
- **txtCode** — `config('ked.txt_code')`, ανατεθεί στον φορέα από τον ΑΑΔΕ· δεν είναι επιλογή
  χρήστη.

---

## Προέλευση & επιφυλάξεις

- Pilot ΑΦΜ/υπογράφοντες: **Παράρτημα Ε** του spec (`ked-progress-api_101.pdf`, σελ. 45–46),
  `docs/internal/parartima-z-notes.md` §5.
- Η συμπεριφορά των `000000000` / `999999999` / `012703950` στο **fake** είναι η
  **μοντελοποίηση του fake driver** (`app/Ked/Progress/FakeKedeProgressClient.php`) για τις
  διαδρομές αποτυχίας του spec. Ασκούν το error handling μας χωρίς δίκτυο. Το `888888888`
  είναι ο batching sentinel — μοντελοποιεί παρατηρημένη επιτυχή συμπεριφορά του ΔΟΥ, όχι
  αποτυχία.
- Ό,τι σημειώνεται «παρατηρημένο» προέρχεται από πραγματικές κλήσεις στον pilot και καταγράφεται
  με ημερομηνία στο `docs/internal/parartima-z-notes.md` **§7a** — εκεί τρέχουν και οι νέες
  παρατηρήσεις.
- Το spec **δεν δημοσιεύει αποτυχημένα fixtures** για δανειολήπτες· ό,τι τέτοιο έχουμε είναι
  δικές μας παρατηρήσεις ή μοντελοποίηση.
