aeat.domain.transactions._errors module

Domain exceptions for aeat.domain.transactions.

exception TransactionError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: AeatError

Base error for every transaction-catalogue failure.

Parameters:

• message (str | None)

• context (dict[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception TransactionCatalogueError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionError

Raised when a transaction catalogue is invalid or inconsistent.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception TransactionPersistenceError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionCatalogueError

Raised when catalogue persistence cannot be completed.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception StoredTransactionDriftError(bucket_id, error)

Bases: TransactionPersistenceError

Raised when a persisted transaction catalogue fails schema validation on load.

Mirrors StoredProfileDriftError: the catalogue was valid when written; schema evolution or an out-of-band edit caused the on-disk envelope payload to drift from the current TransactionCatalogue schema. The original pydantic.ValidationError is preserved on original_exception so callers can inspect the typed field errors without losing the deserialization detail.

Variables:

• bucket_id – Identifier of the bucket whose catalogue drifted.

• original_exception – The underlying pydantic.ValidationError.

Parameters:

• bucket_id (str)

• error (ValidationError)

Return type:

None

code: ClassVar[ErrorCode]

exception LedgerStorageError(message=None, *, context=None, suggestion=None, translated_message='errors.fail.fail_financial_ledger_storage')

Bases: TransactionPersistenceError

Raised when bucket-scoped ledger storage cannot be resolved or used.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str)

Return type:

None

code: ClassVar[ErrorCode]

exception LedgerNoActiveBucketError(message=None, *, context=None, suggestion=None, translated_message='errors.fail.fail_financial_ledger_storage')

Bases: LedgerStorageError

Raised when a ledger operation requires an active profile bucket.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str)

Return type:

None

code: ClassVar[ErrorCode]

exception TransactionNotFoundError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionCatalogueError

Raised when a catalogue lookup targets a missing transaction.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception TransactionIdPrefixError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionCatalogueError

Raised when a transaction-id prefix matches zero or multiple transactions.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception LLMClassifierError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionError

Raised when an LLM classification attempt fails.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception TransactionValidationError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionError, ValueError

Raised on invalid transaction field values. Inherits from ValueError for Pydantic.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception LedgerLinkError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionError

Raised when linking a ledger transaction to a modelo binding fails.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception LedgerCheckError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionError

Raised when a ledger consistency check surfaces a blocking finding.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception LedgerPreflightError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionError

Raised when ledger preflight rejects a modelo run as un-fileable.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception ClassificationRuleError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: TransactionError, ValueError

Raised when a ledger classification rule is invalid.

Inherits from ValueError so Pydantic field validators can raise it directly from @field_validator without wrapping.

Parameters:

• message (str | None)

• context (Mapping[str, object] | None)

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]