aeat.application.live._errors module

Application-level live AEAT read workflow errors.

class LiveIvaAcquisitionFailureMode(*values)[source]

Bases: StrEnum

Application-level IVA live acquisition failure modes.

AUTHENTICATED
NO_CLAVE_PROMPT
OPERATOR_TIMEOUT
QR_REQUIRED
CERTIFICATE_REQUIRED
WRONG_IDENTITY
AEAT_403
DOM_DRIFT
PENDING_CLAVE_REQUEST
LIVE_NAVIGATION_FAILED
UNKNOWN
exception LiveApplicationError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: AeatError

Raised when live AEAT read orchestration fails.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception LiveApplicationInputError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: LiveApplicationError

Raised when a live AEAT read request is not executable.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception LiveIvaSurfaceTimeoutError(message, *, surface, timeout_ms, progress_context=None)[source]

Bases: LiveApplicationError

Raised when one live IVA read surface exceeds its orchestration timeout.

Parameters:

  • message (str)

  • surface (str)

  • timeout_ms (int)

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

Return type:

None

code: ClassVar[ErrorCode]
classify_live_iva_acquisition_failure(exc)[source]

Map adapter exceptions to the live IVA acquisition result vocabulary.

Returns a LiveIvaAcquisitionFailureMode member identifying the failure category.

Return type:

LiveIvaAcquisitionFailureMode

Parameters:

exc (BaseException)