diff --git a/docs/README.md b/docs/README.md
index 5024000..551614c 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -43,6 +43,7 @@ atingi zona X, citeste fisierul Y"). Restul se deschid doar la declansator.
 | `tipuri_documente_facturare.md` | `VANZARI.TIP` si seturile de contare `ID_SET` |
 | `sold-neexigibil-reportat-jc2007-jv2007.md` | interogari pe sold TVA neexigibil |
 | `view-uri-efactura.md` | view-urile `ANAF_VEFACTURA_*` si potrivirea eFacturilor cu registrul de TVA |
+| `machete-note-xrequest-explicatii.md` | schimbi ce campuri cere o operatie la introducere (`XREQUEST`/`XITEMS`/`XNOTE`); explicatie, explicatia4, explicatia5 |
 | `email-thunderbird.md` | citirea mailurilor de pe conturile romfast |
 
 `onboarding\` — proceduri rulate o singura data per proiect (inrolare in fluxul git-text,
diff --git a/docs/machete-note-xrequest-explicatii.md b/docs/machete-note-xrequest-explicatii.md
new file mode 100644
index 0000000..283b0ba
--- /dev/null
+++ b/docs/machete-note-xrequest-explicatii.md
@@ -0,0 +1,42 @@
+# Macheta de introducere (XREQUEST) si campurile de explicatie
+
+Ce campuri cere o operatie la introducere e dat de **XREQUEST** (`id_set`, `nr_item`, `id_item`),
+nu de formular. Definitia campului e in **XITEMS**; slotul in care ajunge valoarea la generarea
+notei e o coloana `Xn` din **XNOTE**, care trebuie sa contina numele campului din act (`XACT` tine
+maparea implicita).
+
+| id_item | XITEMS.label_item | XITEMS.x_item | slot XNOTE | camp act |
+|---|---|---|---|---|
+| 44  | explicatie   | `x44` | **`X9`** (nu exista coloana `X44`) | `explicatia` |
+| 103 | explicatia 4 | `x39` | `X39` | `explicatia4` |
+| 12  | explicatia 5 | `x12` | `X12` | `explicatia5` |
+
+Capcana: la itemul 44, `x_item` (`x44`) **nu** e slotul din XNOTE - slotul e `X9`, si de regula e
+deja `'explicatia'`. Pentru 103 si 12, `x_item` chiar da slotul.
+
+Ca sa apara un item pe o operatie:
+
+1. `XREQUEST` - un rand per set, cu `nr_item` = urmatoarele libere (`max(nr_item)` pe set + 1, +2...).
+2. `XNOTE` - slotul corespunzator pe toate notele setului, ex.
+   `update xnote set x39 = 'explicatia4', x12 = 'explicatia5' where id_set in (...)`.
+   Fara asta itemul se cere in macheta dar nu ajunge in nota.
+
+Coloanele `XACT.X39/X12` si itemele `XITEMS` 103/12 exista deja (`ff_2025_11_05_01_CONTABILITATE.sql`)
+- nu se mai creeaza.
+
+Scripturi model, in `DATABASE\SCRIPTURI_CLAR`:
+
+- `2025\11\ff_2025_11_05_01_CONTABILITATE.sql` - creaza coloanele + itemul 103; terti/furnizori.
+- `2026\01\ff_2026_01_13_01_COMUN.sql` - facturi achizitie gestiune.
+- `2026\02\ff_2026_02_13_01_CONTABILITATE.sql` - banca/casa plati cheltuieli.
+- `2026\09\ff_2026_09_10_03_GESTIUNE.sql` - ob. inventar > consum, toate seturile din meniu.
+
+Primele trei deriva `nr_item` din randul cu `id_item = 44`. **Nu merge pe seturile de gestiune**
+care nu au itemul 44 (ex. 55, 273): acolo `nr_item` se ia din `max(nr_item)` pe set.
+
+Set de referinta pentru o macheta de consum completa: **53** (Bon de consum materiale).
+Meniul de gestiune: `Clase\gestiuni.vc2` (`Pagefr1.pN.CwM.do_actiune`) -> `.mpr` din
+`COMUN\meniuri`, unde `lans(<id_set>)` da setul.
+
+Ob. inventar > Consum in ROAGEST = `COMUN\meniuri\consum2.mn2`, seturile
+55, 70, 71, 72, 73, 104, 273, 274.