aeat.adapters.outbound.aeat package

Outbound adapter package for AEAT integrations.

This package is the adapter-layer entry point for code that talks to the Agencia Tributaria. Subpackages keep external concerns separated:

• adapters.outbound.aeat.auth owns certificate and Cl@ve Móvil authentication plus the adapters.outbound.aeat.auth.AeatSession records consumed by live readers.

• adapters.outbound.aeat.browser owns Playwright session creation, site-health classification, and browser failure envelopes.

• adapters.outbound.aeat.sede owns authenticated, read-only Sede navigation, downloads, parsing, and observation records.

• adapters.outbound.aeat.verify owns public CSV verification through the reviewed read-only Sede verifier.

• adapters.outbound.aeat.export owns read-only export and preflight helpers.

See also

adapters.outbound.aeat._playwright

Import-safe Playwright exception aliases shared by browser and Sede modules when the optional browser extra is absent.

application.auth

Application facade that selects auth providers and owns operator-facing session lifecycle commands.

application.live

Read-only acquisition facade that consumes Sede, browser, and verification adapters.

core.access_gate

Core live-read gate and permanent live-write refusal applied before authenticated AEAT access proceeds.

adapters.outbound

Parent outbound adapter layer for all external counterparts.

Subpackages

• aeat.adapters.outbound.aeat.auth package
  • select_provider()
  • Subpackages
    • aeat.adapters.outbound.aeat.auth._certificate_backends package
      • Submodules
  • Submodules
    • aeat.adapters.outbound.aeat.auth._authenticator module
      • AEAT_SESSION_IDLE_TTL
      • AEAT_LOGIN_NAVIGATION_TIMEOUT_MS
      • AeatAuthenticator
    • aeat.adapters.outbound.aeat.auth._authenticator_persistence module
      • AEAT_STORAGE_STATE_SCHEMA_VERSION
      • PersistedSessionMetadata
      • persisted_session_reason_code()
      • persisted_session_reason_from_error()
    • aeat.adapters.outbound.aeat.auth._authenticator_types module
      • AeatLoginAssertion
      • AeatSession
      • BrowserPageLike
      • BrowserResponseLike
      • BrowserContextLike
      • BrowserSessionProfileLike
      • BrowserSessionLike
      • CertificateHealthCheck
      • BrowserSessionFactory
    • aeat.adapters.outbound.aeat.auth._clave_movil module
      • ClaveMovilAuthProvider
    • aeat.adapters.outbound.aeat.auth._clave_movil_metadata module
      • AEAT_CLAVE_MOVIL_METADATA_SCHEMA_VERSION
      • ClaveMovilSessionMetadata
    • aeat.adapters.outbound.aeat.auth._clave_movil_page_flow module
    • aeat.adapters.outbound.aeat.auth._clave_movil_support module
      • auth_browser_action_policy()
      • ClaveMovilConfigurationError
      • ClaveMovilApprovalTimeoutError
      • ClaveMovilFailureMode
      • classify_identity()
      • extract_verification_code_from_html()
      • url_diagnostic()
      • diagnostic_fingerprint()
      • render_progress_banner()
    • aeat.adapters.outbound.aeat.auth._clave_permanente module
      • ClavePermanenteAuthProvider
    • aeat.adapters.outbound.aeat.auth._clave_permanente_metadata module
      • AEAT_CLAVE_PERMANENTE_METADATA_SCHEMA_VERSION
      • ClavePermanenteSessionMetadata
    • aeat.adapters.outbound.aeat.auth._clave_permanente_support module
      • clave_permanente_auth_browser_action_policy()
      • ClavePermanenteFailureMode
      • clave_permanente_configuration_error()
      • clave_permanente_login_error()
    • aeat.adapters.outbound.aeat.auth._errors module
      • AuthError
      • AuthConfigurationError
      • AuthValidationError
      • AeatLoginAssertionError
      • AeatSessionExpiredError
    • aeat.adapters.outbound.aeat.auth._fixtures module
    • aeat.adapters.outbound.aeat.auth._providers module
      • CertificateSessionDetail
      • ClaveMovilSessionDetail
      • ClavePermanenteSessionDetail
      • CertificateLoginAssertionDetail
      • ClaveMovilLoginAssertionDetail
      • ClavePermanenteLoginAssertionDetail
      • BrowserContextKwargs
      • BrowserContextProvisioner
      • CertificateContextProvisioner
      • describe_certificate_provider()
    • aeat.adapters.outbound.aeat.auth._session_store module
      • PersistedBrowserSession
      • exists()
      • save()
      • load()
      • delete()
      • storage_state_sha256()
      • logical_object_key()
    • aeat.adapters.outbound.aeat.auth.certificate module
      • CertificateError
      • CertificateLoadError
      • CertificatePasswordError
      • CertificateExpiredError
      • CertificatePreExpiryError
      • CertificateHandshakeError
      • CertificateNifParseError
      • CertificateHealthSeverity
      • CertificateBundle
      • LoadedCertificate
      • CertificateHealth
      • HandshakeResult
      • load_certificate()
      • evaluate_loaded_certificate_health()
      • health()
      • extract_nif_from_subject()
      • preload_into_browser_context()
      • verify_handshake()
• aeat.adapters.outbound.aeat.browser package
  • Submodules
    • aeat.adapters.outbound.aeat.browser._errors module
      • BrowserError
      • BrowserValidationError
      • BrowserEvasionError
      • BrowserFailureMode
    • aeat.adapters.outbound.aeat.browser._factory module
      • DefaultBrowserSession
      • default_browser_session_factory()
      • create_browser_session()
      • shared_playwright_runtime()
      • opened_browser_page()
    • aeat.adapters.outbound.aeat.browser._site_health module
      • SiteHealthState
      • SiteHealthEvidence
      • SiteHealthStatus
    • aeat.adapters.outbound.aeat.browser._site_health_parsers module
      • parse_mantenimiento_banner()
      • parse_waf_challenge()
      • parse_rate_limit_response()
      • evaluate_response()
    • aeat.adapters.outbound.aeat.browser._site_health_probe module
      • probe_response()
    • aeat.adapters.outbound.aeat.browser.evasion module
      • EvasionStrategy
      • PlaywrightStealthEvasion
    • aeat.adapters.outbound.aeat.browser.health module
      • run_health_check()
      • main()
    • aeat.adapters.outbound.aeat.browser.profile module
      • Profile
    • aeat.adapters.outbound.aeat.browser.session module
      • BrowserSession
• aeat.adapters.outbound.aeat.export package
  • Subpackages
    • aeat.adapters.outbound.aeat.export._formats package
      • Submodules
    • aeat.adapters.outbound.aeat.export._submitters package
  • Submodules
    • aeat.adapters.outbound.aeat.export._errors module
      • ExportError
      • AeatExportFormatError
• aeat.adapters.outbound.aeat.sede package
  • Submodules
    • aeat.adapters.outbound.aeat.sede._adapter_utils module
      • assert_query_browser_action_for()
      • require_playwright_page()
      • make_locate_helper()
      • normalize_response_text()
      • registry_failure_message()
      • first_visible_locator()
    • aeat.adapters.outbound.aeat.sede._auth_state module
      • storage_state_for_session()
    • aeat.adapters.outbound.aeat.sede._browser_constants module
      • PLAYWRIGHT_WAIT_DOMCONTENTLOADED
      • PLAYWRIGHT_WAIT_NETWORKIDLE
      • PLAYWRIGHT_TIMEOUT_SHORT_MS
      • SEDE_BODY_ENCODING
      • default_viewport()
      • selector_probe_timeout_ms()
    • aeat.adapters.outbound.aeat.sede._browser_stage module
      • PlaywrightStageRunner
      • build_playwright_stage_runner()
      • run_playwright_stage()
    • aeat.adapters.outbound.aeat.sede._censo module
      • CensoFactSet
      • CensoParseError
      • parse_g313_html()
    • aeat.adapters.outbound.aeat.sede._censo_live module
      • BrowserSessionFactory
      • G313_LAUNCHER_URL
      • fetch_g313_censo()
      • censo_fact_set_to_mapping()
    • aeat.adapters.outbound.aeat.sede._declarations module
      • shared_playwright()
      • DeclaracionesRegisterSession
      • open_declarations_register()
      • walk_declarations_register()
      • capture_declaration()
      • capture_filed_declaration_observation()
      • capture_previous_filing_observations()
      • capture_relation_source_observations()
    • aeat.adapters.outbound.aeat.sede._declarations_diagnostics module
      • declarations_page_shape_context_from_page()
      • declarations_page_shape_context()
      • redacted_url()
    • aeat.adapters.outbound.aeat.sede._declarations_listbox module
    • aeat.adapters.outbound.aeat.sede._declarations_observations module
      • observed_casillas_from_submitted_file()
      • registry_observation_from_filed_declaration()
      • resolve_previous_filing_bindings_from_filed_declarations()
      • resolve_relation_values_from_filed_declarations()
    • aeat.adapters.outbound.aeat.sede._declarations_remote module
      • assert_read_http()
      • assert_read_browser_action()
      • extract_csv_from_url()
    • aeat.adapters.outbound.aeat.sede._declarations_schema module
      • Declaracion
    • aeat.adapters.outbound.aeat.sede._errors module
      • SedeError
      • SedeFailureMode
      • SedeNavigationError
      • SedeParseError
      • ExpedienteNotFoundError
      • JustificanteFetchError
      • SedeValidationError
      • BrowserAdapterTypeError
    • aeat.adapters.outbound.aeat.sede._groi_check module
      • GroiNifVerdict
      • GroiResult
      • GroiSedeDriver
      • collect_groi_observations()
      • extract_verdict_from_response_text()
    • aeat.adapters.outbound.aeat.sede._iva_compensation_wallet module
      • fetch_iva_compensation_wallet()
    • aeat.adapters.outbound.aeat.sede._iva_compensation_wallet_parsing module
      • parse_iva_compensation_wallet_html()
      • discover_iva_compensation_wallet_entrypoint()
      • is_aeat_wallet_auth_gate_redirect()
    • aeat.adapters.outbound.aeat.sede._nif_iva_check module
      • SedeNifIvaCheckObservation
      • NifIvaCheckResult
      • NifIvaCheckSedeDriver
      • collect_nif_iva_check_observations()
      • is_aeat_auth_gate_redirect()
      • extract_verdict_from_response_text()
    • aeat.adapters.outbound.aeat.sede._notifications module
      • RemoteNotification
      • NotificationsSnapshot
      • parse_notifications_query()
      • parse_notifications_summary()
      • fetch_notifications_summary()
      • fetch_notifications_query()
    • aeat.adapters.outbound.aeat.sede._observation_store module
      • FiledDeclaracionObservationStore
      • filed_declaracion_observation_object_key()
      • iva_compensation_wallet_observation_object_key()
    • aeat.adapters.outbound.aeat.sede._parse module
      • parse_resumen_tree()
      • parse_expediente_detail()
    • aeat.adapters.outbound.aeat.sede._renta_web_open module
      • RentaWebOpenSedeDriver
      • collect_renta_web_open_observation()
      • extract_renta_web_open_summary_value()
    • aeat.adapters.outbound.aeat.sede._renta_web_open_safety module
      • assert_click_target_safe()
      • install_page_safety_net()
    • aeat.adapters.outbound.aeat.sede._schema module
      • Expediente
      • JustificanteRef
      • SedeCapture
      • FiledDeclaracionArtefact
      • ObservedCasillaValue
      • IvaCompensationWalletRow
      • IvaCompensationWalletObservation
      • FiledDeclaracionObservation
    • aeat.adapters.outbound.aeat.sede._walker module
      • walk_expedientes_tree()
      • resolve_justificante_ref()
      • capture_justificante()
      • find_expediente()
• aeat.adapters.outbound.aeat.verify package
  • VerifyBrowserKeyboardLike
    • VerifyBrowserKeyboardLike.type()
    • VerifyBrowserKeyboardLike.press()
  • VerifyBrowserPageLike
    • VerifyBrowserPageLike.keyboard
    • VerifyBrowserPageLike.goto()
    • VerifyBrowserPageLike.fill()
    • VerifyBrowserPageLike.press()
    • VerifyBrowserPageLike.content()
  • VerifyBrowserContextLike
    • VerifyBrowserContextLike.new_page()
    • VerifyBrowserContextLike.close()
  • VerifyBrowserSessionLike
    • VerifyBrowserSessionLike.create_context()
    • VerifyBrowserSessionLike.close()
  • VerifyBrowserSessionFactory
  • DEFAULT_BROWSER_SESSION_FACTORY()
  • verify_csv()

Submodules

• aeat.adapters.outbound.aeat._playwright module