cadrumo.application.live.filed_data_ports module

Application-owned ports for live filed-declaration acquisition.

The filed-data use case coordinates register walks and persistence, but it does not know how an authenticated Sede page is opened or how a browser adapter captures one row. Those transport details are supplied through this module’s small structural ports by an outer composition root.

class FiledRegisterDeclarationProtocol(*args, **kwargs)[source]

Bases: FiledDeclarationProtocol, Protocol

Full register-row view needed by listing and capture orchestration.

property ejercicio: int

Return the filing year carried by the register row.

property tipo_solicitud: str | None

Return the optional AEAT request type text.

property observaciones: str | None

Return optional register observations text.

property justificante_link_text: str | None

Return the receipt-link label when AEAT exposed one.

property archive_link_text: str | None

Return the submitted-file link label when AEAT exposed one.

property declaration_copy_link_text: str | None

Return the declaration-copy link label when AEAT exposed one.

property justificante_cell_index: int

Return the register cell containing the receipt link.

property archive_cell_index: int | None

Return the register cell containing the submitted-file link.

property declaration_copy_cell_index: int | None

Return the register cell containing the declaration-copy link.

class FiledDeclarationAvailabilityProtocol(*args, **kwargs)[source]

Bases: Protocol

One modelo and the years the external register offered for it.

property modelo: str

Return the offered modelo code.

property ejercicios: Sequence[int]

Return offered filing years in register order.

class FiledDeclarationAvailabilityReportProtocol(*args, **kwargs)[source]

Bases: Protocol

Read-only offered-option report returned by the acquisition port.

property items: Sequence[FiledDeclarationAvailabilityProtocol]

Return one offered-year record per register modelo option.

property offered_pairs: tuple[tuple[str, int], ...]

Return the offered (modelo, ejercicio) pairs.

class FiledDataRegisterPort(*args, **kwargs)[source]

Bases: Protocol

Authenticated register session used by one filed-data operation.

property walk_timeout_ms: int

Return the configured timeout for one register walk.

async walk(*, modelo, ejercicio)[source]

Read one modelo/year register result.

Return type:

tuple[FiledRegisterDeclarationProtocol, ...]

Parameters:

  • modelo (str)

  • ejercicio (int)

async capture_observation(declaration, *, artefact_sink=None)[source]

Capture one register row’s evidence through the authenticated session.

Return type:

FiledObservationProtocol

Parameters:
class FiledDataCapturePort(*args, **kwargs)[source]

Bases: Protocol

Outer-composed Sede capability for filed-data acquisition.

open_register(*, operation)[source]

Open one reusable register session for a walk or capture sweep.

Return type:

AbstractAsyncContextManager[FiledDataRegisterPort]

Parameters:

operation (str)

async discover_availability(*, operation)[source]

Read the register’s offered modelo/year options.

Return type:

FiledDeclarationAvailabilityReportProtocol

Parameters:

operation (str)

async capture_source_observations(revision, *, filing_year, period, artefact_sink=None, operation)[source]

Capture registry-selected previous-filing and relation sources.

Core types: ModeloRevision.

Return type:

tuple[FiledObservationProtocol, ...]

Parameters: