Agenti

Se non usi una skill: stessa allowlist, Bearer, centesimi interi.

Base: https://app.spartisco.casa/api/v1

/api/v1/openapi.json

POST /spaces/:id/expenses (scope draft.write) crea sempre una bozza. L’agente non conferma.

Header opzionale `Idempotency-Key`: stessa chiave e stessa key entro 24 ore restituisce la stessa spesa (201), senza un duplicato.

Corpo JSON:

| Campo | Tipo | Obbligatorio | Note |
|---|---|---|---|
| `voce` | stringa | no | Voce già esistente. `tag` e `name` sono campi sconosciuti (422). Una voce sconosciuta è 422 `unknown_voce`: l’API non ne crea di nuove. Senza voce la bozza si salva e la Conferma chiede «Scegli la voce.» |
| `amount_cents` | intero | sì | Centesimi. `12850` = 128,50 €. Maggiore di zero |
| `period_id` | stringa | sì | Id da GET /periods. Periodo pareggiato → 409 |
| `payer` | stringa | no | Id persona da GET /people, solo la stringa. Un oggetto (`{id}`, `{person_id}`, `{type,id}`) è 422 `invalid_body`. Se manca, la bozza non ha pagatore: lo scegli tu al conferma |
| `competence_from` | stringa | no | Data `YYYY-MM-DD` |
| `competence_to` | stringa | no | Data `YYYY-MM-DD` |
| `note` | stringa | no | Nota visibile sulla bozza |

Qualsiasi altro campo in cima (`correction`, `corrections`, `correction_units`, …) è 422 `invalid_body`; `fields` elenca i nomi.

Esempio:

```json
{
  "voce": "Luce agosto",
  "amount_cents": 12850,
  "period_id": "01PERIODO",
  "payer": "01PERSONA",
  "competence_from": "2026-08-01",
  "competence_to": "2026-08-31",
  "note": "bolletta luce"
}
```

Risposta 201, e ogni spesa nei GET, ha questi campi:

| Campo | Note |
|---|---|
| `id` | Id della spesa |
| `review_state` | `draft` oppure `confirmed`. Una bozza non entra nei totali |
| `created_via` | `agent` oppure `app` |
| `voce` | Voce, oppure `null` se la bozza non ne ha |
| `title` | Titolo `Voce · competenza`. Senza voce è il nome già in archivio |
| `amount_cents` | Centesimi |
| `currency` | `EUR` |
| `period_id` | Periodo |
| `competence_from` | Data `YYYY-MM-DD`, oppure `null` |
| `competence_to` | Data `YYYY-MM-DD`, oppure `null` |
| `note` | Nota, oppure `null` |
| `payer` | Id persona, oppure `null` se non c’è pagatore |

GET `/spaces/:id/expenses/:eid` aggiunge `split_line` (persona, alloggio, centesimi). L’agente non conferma.