aeat.domain.submission package

Public facade for local-only submission audit records.

This package exposes preflight gates, historical/imported audit records, repository storage, and narrow protocol types for submission-adjacent flows. SubmissionEngine is read-only: it runs Preflight and reads persisted ModeloPresentado records. It does not present to AEAT, create submission records, or transition a draft or revision into presentado.

Preflight checks approved draft status, absence of error findings, the deadline window unless skipped, and auth-provider readiness. The engine depends on deadline and auth-provider probes; ModeloDraftLoader remains an exported adapter contract, not a dependency consumed by SubmissionEngine.

ModeloPresentado is a strict local-only historical/imported audit record persisted through the SubmissionRepositoryProtocol port — implemented by the adapter SubmissionRepository — as encrypted AUDIT data under aeat.domain.submission.records. It is distinct from domain.modelos.ModeloRecord: application.modelo.file_modelo_revision() creates a local work-unit filing record with aeat_accepted=False and no external evidence, while application.filing.import_filing_from_justificante() imports historical filing evidence into the audit trail.

Live AEAT writes are blocked by core.access_gate.AeatAccessGate.require_live_write(), which raises core.access_gate.LiveSubmitForbiddenError; preflight denials raise SubmissionPreflightError.

Major declarations:

• SubmissionEngine — runs preflight and reads historical audit records.

• Preflight and SubmissionPreflightError — the pre-submission checks and their refusal.

• ModeloPresentado, SubmissionAttempt, and SubmissionStatus — the persisted lifecycle records, keyed by make_submission_id().

• SubmissionRepositoryProtocol — the read-side persistence port (the concrete repository lives in the persistence adapter).

• The ModeloDraftLoader, ModeloDraftLike, DeadlineWindowChecker, and AuthProviderProbe protocols — exported narrow contracts that keep the domain free of live adapters.

See also

application.modelo.file_modelo_revision()

Local work-unit filing action that creates domain.modelos.ModeloRecord entries without AEAT acceptance.

application.live

Read-only AEAT evidence capture and justificante verification surface; it is not a live-submit path.

application.filing.import_filing_from_justificante()

Historical filing-evidence import into the submission audit trail.

domain.justificante

Receipt metadata that can seed imported submission-audit baselines without becoming casilla-value authority.

application.modelo.import_external_filing_evidence()

Separate work-unit path that stamps domain.modelos.ExternalEvidence on current filing records; it does not create ModeloPresentado audit records.

domain.filing

Draft construction and review records used before preflight or evidence import.

core.access_gate.AeatAccessGate

Core live-write refusal authority that keeps these audit records local.

Submodules

• aeat.domain.submission._engine module
  • SubmissionEngine
    • SubmissionEngine.preflight()
    • SubmissionEngine.load_submission()
    • SubmissionEngine.list_submissions()
• aeat.domain.submission._errors module
  • SubmissionError
    • SubmissionError.code
  • SubmissionPreflightError
    • SubmissionPreflightError.code
  • SubmissionValidationError
    • SubmissionValidationError.code
• aeat.domain.submission._models module
  • SubmissionStatus
    • SubmissionStatus.PENDIENTE_DE_PRESENTAR
    • SubmissionStatus.EN_TRAMITACION
    • SubmissionStatus.PRESENTADA
    • SubmissionStatus.ACEPTADA
    • SubmissionStatus.RECHAZADA
    • SubmissionStatus.FALLIDA
  • SubmissionAttempt
    • SubmissionAttempt.attempt_id
    • SubmissionAttempt.started_at
    • SubmissionAttempt.ended_at
    • SubmissionAttempt.status
    • SubmissionAttempt.error_code
    • SubmissionAttempt.error_message
    • SubmissionAttempt.browser_trace_path
  • ModeloPresentado
    • ModeloPresentado.submission_id
    • ModeloPresentado.draft_id
    • ModeloPresentado.modelo
    • ModeloPresentado.period
    • ModeloPresentado.profile_tax_id
    • ModeloPresentado.status
    • ModeloPresentado.justificante_csv
    • ModeloPresentado.justificante_pdf_path
    • ModeloPresentado.submitted_at
    • ModeloPresentado.acknowledged_at
    • ModeloPresentado.attempts
  • make_submission_id()
• aeat.domain.submission._preflight module
  • Preflight
    • Preflight.check()
• aeat.domain.submission._protocols module
  • AuthProviderDescriptionLike
    • AuthProviderDescriptionLike.kind
    • AuthProviderDescriptionLike.label
    • AuthProviderDescriptionLike.configured
    • AuthProviderDescriptionLike.available
    • AuthProviderDescriptionLike.subject
    • AuthProviderDescriptionLike.expires_on
  • AuthProviderProbe
    • AuthProviderProbe.kind
    • AuthProviderProbe.describe()
  • DeadlineWindowChecker
    • DeadlineWindowChecker.is_window_open()
  • ModeloFinding
    • ModeloFinding.severity
    • ModeloFinding.message
  • ModeloDraftStatus
    • ModeloDraftStatus.BORRADOR
    • ModeloDraftStatus.VALIDADO
    • ModeloDraftStatus.LISTO_PARA_PRESENTAR
    • ModeloDraftStatus.APROBADO
    • ModeloDraftStatus.APROBACION_CADUCADA
    • ModeloDraftStatus.PRESENTADA
    • ModeloDraftStatus.ACEPTADA
    • ModeloDraftStatus.RECHAZADA
    • ModeloDraftStatus.ENMENDADO
    • ModeloDraftStatus.ANULADO
  • ModeloDraftLike
    • ModeloDraftLike.draft_id
    • ModeloDraftLike.modelo
    • ModeloDraftLike.period
    • ModeloDraftLike.profile_tax_id
    • ModeloDraftLike.status
    • ModeloDraftLike.values
    • ModeloDraftLike.findings
  • ModeloDraftLoader
    • ModeloDraftLoader.load()
  • SubmissionRepositoryProtocol
    • SubmissionRepositoryProtocol.load()
    • SubmissionRepositoryProtocol.iter_submissions()
    • SubmissionRepositoryProtocol.list_submission_ids()