aeat.application.invoices._wizard module¶

Guided, non-blocking manual-entry path for one catalogue Invoice.

aeat app ledger invoice catalogue wizard is the fallback entry point for when automated extraction (ledger evidence extract / vision OCR) is unavailable or insufficient: the operator (an autonomous LLM agent that cannot answer an interactive prompt) supplies every invoice field as CLI options in one call. This module validates each field independently – reusing the same grounded heuristics validate_spanish_tax_id() and the ISO-8601 / canonical-decimal parsers already enforce on the extract/confirm path – and accumulates every failing field into one refusal (no-silent-under-declaration: a malformed field is named, never silently dropped or reported one-at-a-time when several are wrong).

The write itself delegates to create_catalogue_invoice() – the sole sanctioned Invoice writer (composition-service-no-parallel-write-path); this module never persists a row itself. Because Invoice identity is a content-derived hash, a retry that resolves to an already-catalogued identity is a guarded no-op (single-subject-mutation-is-idempotent-guarded): the existing record is returned, not re-written or raised as an error, mirroring the re-import-of-an-unchanged-file semantics import_invoices_from_rows() already implements for the bulk path.