Registra una declaración del Modelo 036 que presentaste ante la AEAT¶

El Modelo 036 es la declaración censal de la AEAT: el formulario que usas para darse de alta, modificar o darse de baja en tu situación tributaria. Lo presentas tú mismo en la Sede Electrónica de la AEAT (la sede), el portal oficial en línea. Los comandos de esta página solo registran ese hecho en su rastro de auditoría local a posteriori; nunca presentan nada ante la AEAT. Para mantener al día en tu perfil los datos censales registrados, consulta mantén los datos censales del Modelo 036 en tu perfil.

Antes de empezar¶

Necesita:

Un perfil activo; consulta configura tu perfil de contribuyente. Los comandos siguientes se niegan a continuar sin uno (No hay un perfil activo).
Tu frase de contraseña de la clave maestra. Estos comandos abren el almacén cifrado, por lo que solicitan la frase de contraseña.
La fecha en que presentaste la declaración en la sede.
Opcional: el justificante, el número de resguardo que la sede muestra tras la presentación.

El entorno de ejecución muestra la ayuda, las solicitudes y los mensajes en español.

Registra la declaración¶

Elige el comando que corresponda a lo que presentaste:

Si dio de alta una actividad, registra un alta.
Si modificó datos registrados, registra una modificación.
Si se dio de baja, registra una baja.

Registra un alta:

1Record the alta you filed at the sede, with the sede receipt number.

aeat --format json app modelo m036 alta --declared-on 2026-01-10 --sede-justificante \
  ACUSE-036-2026

aeat --format json app modelo m036 alta --declared-on 2026-01-10 --sede-justificante `
  ACUSE-036-2026

{
  "active_profile": "docs-sequence-sandbox",
  "command": "modelo.m036.alta",
  "notices": [],
  "result": {
    "bucket_id": "<bucket-id>",
    "declaration_id": "6404ccf339e0bcea77eb0212f286d77d3b2d3f7ce6969118850266649125e7c7",
    "declared_on": "2026-01-10",
    "event_kind": "alta",
    "note": null,
    "profile_id": "<profile-id>",
    "recorded_at": "2026-04-01T09:00:00+00:00",
    "sede_justificante": "ACUSE-036-2026"
  },
  "schema_version": "2",
  "status": "success"
}

2Read the saved record back by its id to confirm it persisted.

aeat --format json app modelo m036 view {declaration_id}

aeat --format json app modelo m036 view {declaration_id}

{
  "active_profile": "docs-sequence-sandbox",
  "command": "modelo.m036.view",
  "notices": [],
  "result": {
    "bucket_id": "<bucket-id>",
    "declaration_id": "6404ccf339e0bcea77eb0212f286d77d3b2d3f7ce6969118850266649125e7c7",
    "declared_on": "2026-01-10",
    "event_kind": "alta",
    "note": null,
    "operation": "modelo.m036.view",
    "profile_id": "<profile-id>",
    "recorded_at": "2026-04-01T09:00:00+00:00",
    "sede_justificante": "ACUSE-036-2026"
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the recorded alta is saved and readable by its id.

Registra una modificación (el mismo flujo de registrar y consultar que el alta anterior, con un tipo de evento distinto):

1Record the modificacion you filed at the sede, with the sede receipt number.

aeat app modelo m036 modificacion --declared-on 2026-03-15 --sede-justificante <acuse>

aeat app modelo m036 modificacion --declared-on 2026-03-15 --sede-justificante <acuse>

Registra una baja:

1Record the baja you filed at the sede, with the sede receipt number.

aeat app modelo m036 baja --declared-on 2026-12-31 --sede-justificante <acuse>

aeat app modelo m036 baja --declared-on 2026-12-31 --sede-justificante <acuse>

--declared-on es obligatorio: la fecha en formato ISO (año-mes-día) en que presentaste en la sede. --sede-justificante es opcional y admite hasta 128 caracteres. --note añade una nota opcional para tu propio archivo, de hasta 512 caracteres.

Cómo se ve el éxito¶

El comando imprime el registro guardado:

Un declaration_id: un número de referencia largo para el registro.
El tipo de evento: alta, modificación o baja.
La fecha de presentación.
Cuándo se guardó el registro.
El justificante, si lo proporcionó.

Esa salida impresa es su confirmación. Guárdala con su documentación.

Lista y consulta las declaraciones registradas¶

Lista las declaraciones que has registrado en el perfil activo y abre después una por su id (el paso de preparación registra la misma alta mostrada arriba para que la lista tenga una fila):

1List the declarations recorded in the active profile.

aeat --format json app modelo m036 list

aeat --format json app modelo m036 list

{
  "active_profile": "docs-sequence-sandbox",
  "command": "modelo.m036.list",
  "notices": [],
  "result": {
    "bucket_id": "<bucket-id>",
    "declaration_count": 1,
    "declarations": [
      {
        "bucket_id": "<bucket-id>",
        "declaration_id": "6404ccf339e0bcea77eb0212f286d77d3b2d3f7ce6969118850266649125e7c7",
        "declared_on": "2026-01-10",
        "event_kind": "alta",
        "note": null,
        "profile_id": "<profile-id>",
        "recorded_at": "2026-04-01T09:00:00+00:00",
        "sede_justificante": "ACUSE-036-2026"
      }
    ],
    "operation": "modelo.m036.list"
  },
  "schema_version": "2",
  "status": "success"
}

2View one declaration in full by its id (or an unambiguous prefix of it).

aeat --format json app modelo m036 view {declaration_id}

aeat --format json app modelo m036 view {declaration_id}

{
  "active_profile": "docs-sequence-sandbox",
  "command": "modelo.m036.view",
  "notices": [],
  "result": {
    "bucket_id": "<bucket-id>",
    "declaration_id": "6404ccf339e0bcea77eb0212f286d77d3b2d3f7ce6969118850266649125e7c7",
    "declared_on": "2026-01-10",
    "event_kind": "alta",
    "note": null,
    "operation": "modelo.m036.view",
    "profile_id": "<profile-id>",
    "recorded_at": "2026-04-01T09:00:00+00:00",
    "sede_justificante": "ACUSE-036-2026"
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the recorded declaration appears in the list and opens by its id.

La lista muestra, de cada declaración, su id, el tipo de evento, la fecha de presentación, la marca de tiempo de registro y si proporcionó un justificante. Una lista vacía significa que aún no ha registrado ninguna declaración. La consulta muestra el registro completo, incluidos el justificante y su nota si los proporcionó. Un id que no coincida con ninguna declaración registrada se rechaza.

Ningún comando edita ni elimina una declaración registrada.

Si escribió algo mal¶

Volver a ejecutar el comando con valores idénticos es seguro: no registra ninguna declaración adicional y le devuelve el mismo ID de declaración.

Ejecutar el comando con un tipo, una fecha o un justificante corregidos registra una declaración adicional. Añade una --note que explique la corrección para que tu rastro de auditoría siga siendo legible. Cambiar solo --note no crea un registro nuevo. Ningún comando edita ni elimina una declaración registrada.

Qué hace y qué no hace el registro¶

El registro es una nota local para tu propio rastro de auditoría. No cambia tu calendario de presentaciones, sus obligaciones ni los datos de tu perfil.

Después de que la AEAT procesa tu declaración, actualiza a mano los datos censales de tu perfil para que coincidan con lo que presentaste; consulta mantén los datos censales del Modelo 036 en tu perfil.

Dónde obtener ayuda¶

Si un comando falla, consulta resolución de problemas.
Para términos que te resulten desconocidos, consulta el glosario.
Antes de compartir la salida de un comando con nadie, elimina los identificadores fiscales como el NIF, CIF, DNI, NIE o NII.