Configura el teu perfil de contribuent

Un perfil conté les dades d’un contribuent que cada ordre aeat app llegeix i actualitza. Configura’n un abans d’importar transaccions, calcular un modelo o exportar una presentació.

Un perfil és local. Crear, editar, mostrar, exportar o importar un perfil mai no presenta res a l’Agencia Estatal de Administración Tributaria (AEAT). Cadrumo construeix i verifica la teva presentació a la teva màquina; tu la puges.

Si encara no has instal·lat Cadrumo ni has executat l’ordre aeat, comença per la guia ràpida i després torna aquí.

Què significa el perfil actiu

El perfil actiu és el context de contribuent per a les ordres aeat app. Mentre un perfil és actiu, les ordres com ara la importació al ledger, la classificació de transaccions, el càlcul de modelos, l’exportació i l’historial de presentacions local llegeixen i actualitzen les dades d’aquell perfil.

Mantén un perfil per contribuent. Afegeix un segon perfil quan preparis presentacions per a un altre contribuent, separis un perfil de proves d’un de real, o restauris una còpia amb un nom diferent. Per entendre per què l’eina és local abans que res i controlada per una persona, consulta les guies d’explicació.

Llisteu els vostres perfils amb aeat config profile list i vegeu quin és actiu. Creeu cada contribuent addicional de manera interactiva perquè la seva frase de contrasenya es triï al terminal; després canvieu per nom exacte. L’exemple executable comprova la composició actual del perfil actiu sense fabricar un altre contribuent:

1List the profiles and see which one is active.
aeat --format json config profile list
aeat --format json config profile list
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.list",
  "notices": [],
  "result": {
    "active_profile": "docs-sequence-sandbox",
    "profiles": [
      {
        "active": true,
        "bucket_id": "<bucket-id>",
        "name": "docs-sequence-sandbox"
      }
    ]
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the profile list identifies the active taxpayer exactly.

Iniciar la sessió canvia quin ledger local, quins esborranys de modelo i quins marcadors de presentació utilitzen les ordres aeat app. El verb d’inici de sessió és aeat config login, no aeat config profile login.

Anomena el perfil exactament. aeat config login accepta un UUID de perfil o l’etiqueta exacta, i res més: rebutja un nom parcial, una capitalització diferent o una forma abreujada en lloc d’endevinar. Omet el nom per iniciar sessió al perfil que ja està seleccionat. El rebuig és deliberat: endevinar quin contribuent volies és com les presentacions acaben al perfil equivocat.

Tanca la sessió amb aeat config logout quan acabis. Tancar la sessió tanca la sessió d’emmagatzematge però conserva el perfil seleccionat per al pròxim inici de sessió exacte; no elimina res.

Decideix les teves dades abans de començar

La configuració del perfil fa una sèrie de preguntes. La majoria són condicionals: les respostes que dones al principi decideixen quines preguntes posteriors apareixen. Decideix primer aquestes dades i la resta de la configuració ve tota sola:

  • Qui és el contribuent. Una persona física (un particular), una persona jurídica (una empresa com ara una SL o SA) o una entitat en atribució (una cotitularitat com ara una comunidad de bienes, on la renda es transmet als seus membres).

  • Quin identificador tributari aplica. Els ciutadans espanyols utilitzen el seu DNI com a identificador tributari (NIF). Els particulars estrangers utilitzen el seu NIE. Les empreses utilitzen un NIF o CIF.

  • Què fa el contribuent. L’activitat econòmica i quins tipus de renda apliquen: activitat empresarial o professional, treball assalariat, rendes del lloguer, rendes d’inversió, guanys patrimonials o una pensió.

  • Quin règim d’IVA aplica. L’Impost sobre el Valor Afegit (IVA) determina si el contribuent el repercuteix i el declara, i com. El règim general presenta l’IVA mitjançant el Modelo 303.

  • On resideix el contribuent. La comunitat autònoma per a un resident espanyol, o el país de residència per a un no resident.

  • Quin idioma de sortida vols. L’idioma que utilitza cadrumo per a la seva sortida.

No cal que memoritzis els noms de les opcions. L’assistent guiat et porta per aquestes decisions. Per obtenir la llista completa i actual d’opcions i els seus valors acceptats, executa aeat config profile create --help i aeat config profile edit --help:

1List every flag the create command accepts.
aeat config profile create --help
aeat config profile create --help
Usage: aeat config profile create [OPTIONS] [profile_name]

  Create a profile protected by a passphrase. At a terminal it then offers an
  optional recovery code; skip it, or add it later with 'aeat config profile
  recovery enable'.

Arguments:
  profile_name  Profile name to write the answers into

Options:
  --quiet                         Run non-interactively using only the
                                  supplied flag values; required flags left
                                  unset cause an error. Sufficient on its own;
                                  combine with --accept-defaults to fill the
                                  rest from descriptor defaults.
  --accept-defaults               Fill every unsupplied flag from the
                                  descriptor defaults, without prompting. Use
                                  alongside --quiet, or on its own for an all-
                                  defaults create.
  --output-language <es|en|ca|hu>
                                  CLI output language for this profile
  --entity-type <str>             Natural person, legal entity, or attribution
                                  entity
  --legal-entity-form <str>       Recognised legal form when the entity type
                                  is a legal entity
  --tax-id <str>                  Tax identifier (NIF/CIF/DNI/NIE) for the
                                  active profile
  --name <str>                    Display name shown in local reviews
  --surnames <str>                Surnames or company name for export headers
  --legal-name <str>              Legal or company name for legal-entity
                                  export headers
  --fiscal-residency <str>        Fiscal residency category: resident_irpf
                                  (habitual resident in Spain) or
                                  non_resident_irnr (non-resident, IRNR
                                  taxation RDLeg 5/2004).
  --country-of-fiscal-residence <str>
                                  ISO 3166-1 alpha-2 code of the country of
                                  fiscal residence (e.g. GB, DE, FR). Required
                                  when fiscal-residency is non_resident_irnr.
  --representante-fiscal-nif <str>
                                  NIF/NIE of the fiscal representative in
                                  Spain. Required for non-EU/EEA non-residents
                                  (Art. 47 LGT + Art. 10 TRLIRNR RDLeg
                                  5/2004).
  --representante-fiscal-nombre <str>
                                  Full name of the fiscal representative in
                                  Spain.
  --tax-residence-jurisdiction-scope <str>
                                  Declared territorial regime: common
                                  territory or the not-yet-supported foral
                                  territory.
  --tax-residence-ccaa <str>      Tax-residence autonomous community, under
                                  the common regime. If the value is not
                                  recognised, the error lists the accepted
                                  communities.
  --address-postcode <str>        Tax address postcode
  --irpf-income-categories <str>  IRPF income category; pass --irpf-income-
                                  categories once per category
  --activity <str>                Business activity as plain text, or the IAE
                                  heading if you know it
  --activity-start-date <str>     Censo registration / start-of-activity date
                                  (YYYY-MM-DD). Optional; when set,
                                  obligations for periods before this date are
                                  not shown.
  --incn-prior-12-months <str>    Net turnover (importe neto de la cifra de
                                  negocios) over the prior 12 months, in
                                  euros. Above 6,000,000 EUR Modelo 202
                                  mandates the Art. 40.3 LIS modality; below
                                  it both modalities are available. Optional.
  --new-entity-first-two-profit-periods / --no-new-entity-first-two-profit-periods
                                  Mark this when a newly-created legal entity
                                  is in one of its first two profit-making tax
                                  periods (LIS Art. 29) to opt into the 15
                                  percent reduced rate. Optional; unset leaves
                                  the entity on its otherwise-applicable rate.
  --ley-49-2002-option-declared / --no-ley-49-2002-option-declared
                                  Record whether Modelo 036 casilla 651
                                  declares the Ley 49/2002 Title II option.
  --ley-49-2002-option-date <str>
                                  Record the Modelo 036 casilla 653 date for
                                  the Ley 49/2002 Title II option.
  --ley-49-2002-renunciation-declared / --no-ley-49-2002-renunciation-declared
                                  Record whether Modelo 036 casilla 652
                                  declares renunciation of the Ley 49/2002
                                  Title II regime.
  --ley-49-2002-renunciation-date <str>
                                  Record the Modelo 036 casilla 654 date for
                                  the Ley 49/2002 Title II renunciation.
  --iva-regime <str>              IVA regime
  --iva-m303-regime-composition <str>
                                  Modelo 303 regime composition: general,
                                  simplified, or mixed.
  --iva-roi-enrolled / --no-iva-roi-enrolled
                                  Enrolled in ROI
  --iva-oss-enrolled / --no-iva-oss-enrolled
                                  Enrolled in OSS
  --iva-group-member-enrolled / --no-iva-group-member-enrolled
                                  Enrolled as a member entity of an IVA group
  --iva-group-dominant-entity-enrolled / --no-iva-group-dominant-entity-enrolled
                                  Enrolled as the dominant entity of an IVA
                                  group
  --iva-sii-enrolled / --no-iva-sii-enrolled
                                  Whether the taxpayer is enrolled in the SII
  --iva-redeme-enrolled / --no-iva-redeme-enrolled
                                  Whether the taxpayer is registered in REDEME
  --iva-intracommunity-operations-exceed-50000-eur / --no-iva-intracommunity-operations-exceed-50000-eur
                                  Intra-community operations exceed 50,000 EUR
  --iva-cash-accounting-regime-enrolled / --no-iva-cash-accounting-regime-enrolled
                                  Declare enrolment in the special IVA cash-
                                  accounting regime.
  --iva-voluntary-sii-enrolled / --no-iva-voluntary-sii-enrolled
                                  Declare voluntary SII enrolment separately
                                  from mandatory inclusion triggers.
  --iva-hydrocarbon-deposit-advance-payment-deduction-entitled / --no-iva-hydrocarbon-deposit-advance-payment-deduction-entitled
                                  Declare entitlement to deduct advance
                                  payments under the hydrocarbon tax-deposit
                                  regime.
  --enrollment-large-company / --no-enrollment-large-company
                                  Large-company enrollment
  --enrollment-public-administration-budget-gt-6000000 / --no-enrollment-public-administration-budget-gt-6000000
                                  Public administration budget over 6,000,000
  --taxation-type <str>           Income-tax return type: 1 = individual, 2 =
                                  joint (family unit).
  --taxpayer-sex <str>            First taxpayer sex: H = male, M = female.
  --taxpayer-marital-status <1|2|3|4|5>
                                  First taxpayer marital status: 1 = single, 2
                                  = married, 3 = widowed, 4 = separated or
                                  divorced, 5 = registered civil partnership.
  --situacion-familiar <casado|pareja_hecho_registrada|pareja_hecho_no_registrada|soltero|separado_divorciado>
                                  Family situation under Art. 82 LIRPF:
                                  determines whether joint taxation is
                                  available and which family unit variant
                                  applies.
  --taxpayer-marriage-date <str>  Start date of the current marriage (YYYY-MM-
                                  DD). Only when marital status = 2 (married).
                                  Derives casillas 0245/0246/0247 (matrimonio
                                  sobrevenido, Art. 82 LIRPF).
  --taxpayer-birth-date <str>     First taxpayer birth date
  --taxpayer-disability-grade <str>
                                  First taxpayer disability grade: 1 =
                                  33%-64%, 2 = 65% or higher, 3 = judicial
                                  incapacity, 4 = third-party assistance or
                                  reduced mobility.
  --taxpayer-death-date <str>     First taxpayer death date
  --spouse-tax-id <str>           Spouse NIF/NIE
  --spouse-name <str>             Spouse given name
  --spouse-surnames <str>         Spouse surnames
  --spouse-birth-date <str>       Spouse birth date
  --spouse-sex <str>              Spouse sex: H = male, M = female.
  --spouse-disability-grade <str>
                                  Spouse disability grade (if applicable): 1 =
                                  33%-64%, 2 = 65% or higher, 3 = judicial
                                  incapacity, 4 = third-party assistance or
                                  reduced mobility.
  --spouse-non-resident-irpf / --no-spouse-non-resident-irpf
                                  Spouse is non-resident IRPF
  --spouse-eu-eea-resident / --no-spouse-eu-eea-resident
                                  Spouse is EU/EEA resident
  --spouse-eu-eea-country <str>   Spouse EU/EEA country
  --family-descendants-eu-eea-deduction / --no-family-descendants-eu-eea-deduction
                                  EU/EEA descendants in family-unit deduction
  --family-minor-children-in-unit / --no-family-minor-children-in-unit
                                  Minor children in family unit
  --has-employees / --no-has-employees
                                  Has employees and pays salaries with
                                  retención
  --pays-professionals-with-retencion / --no-pays-professionals-with-retencion
                                  Pays professionals with retención
  --art109-activity-income-withholding-ge-70pct / --no-art109-activity-income-withholding-ge-70pct
                                  Art. 109 coverage - at least 70% of covered
                                  professional, agricultural, livestock, or
                                  forestry activity income subject to
                                  withholding or payment on account
  --pays-rent-with-retencion / --no-pays-rent-with-retencion
                                  Pays local rent with retención
  --pays-capital-income-with-retencion / --no-pays-capital-income-with-retencion
                                  Pays capital income with retención
  --modelo-111-no-retenciones-periods <str>
                                  Comma-separated Modelo 111 no-obligation
                                  periods, format YYYY:PERIOD (for example
                                  2025:2T,2025:3T). Use only when no subject
                                  payments were made.
  --irpf-estimation-regime <str>  IRPF estimation regime for economic-activity
                                  income
  --objective-estimation-modulos-iae-epigraph <str>
                                  IAE epigraph for objective-estimation
                                  modules, such as 972.
  --objective-estimation-modulos-module-1-units <str>
                                  Annual module 1 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-2-units <str>
                                  Annual module 2 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-3-units <str>
                                  Annual module 3 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-4-units <str>
                                  Annual module 4 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-5-units <str>
                                  Annual module 5 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-6-units <str>
                                  Annual module 6 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-7-units <str>
                                  Annual module 7 units for objective-
                                  estimation modules.
  --irpf-special-regime <str>     IRPF special regime. "general" for most
                                  taxpayers. "impatriado" for workers who
                                  relocated to Spain and elected the Beckham
                                  Law regime (Art. 93 LIRPF), available for
                                  the first 6 years after relocation.
  --irpf-special-regime-start-date <str>
                                  Date the worker elected the inpatriate
                                  regime (YYYY-MM-DD). Only when irpf-special-
                                  regime is "impatriado". RIRPF Art. 116. The
                                  regime expires at the end of the 6th
                                  calendar year.
  --does-intracomunitario / --no-does-intracomunitario
                                  Conducts intracomunitario operations
  --third-party-transactions-above-347-threshold / --no-third-party-transactions-above-347-threshold
                                  Third-party transactions exceed Modelo 347
                                  threshold
  --bienes-extranjero-above-threshold / --no-bienes-extranjero-above-threshold
                                  Foreign-held assets above legal threshold
  --monedas-virtuales-extranjero-above-threshold / --no-monedas-virtuales-extranjero-above-threshold
                                  Virtual currencies held abroad above Modelo
                                  721 threshold
  --llm-vision / --no-llm-vision  Enable on-host LLM vision for reading
                                  invoices.
  --google-export / --no-google-export
                                  Enable Google Sheets export.
  --notes <str>                   Notes for your own records (optional)
  --secrets-stdin                 Read the secrets as one bounded JSON object
                                  from standard input instead of prompting.
  --secrets-fd <int>              File descriptor to read machine secrets
                                  from.
  --install-completion            Install completion for the current shell.
  --show-completion               Show completion for the current shell, to
                                  copy it or customize the installation.
  --help                          Show this message and exit.
2List every flag the edit command accepts.
aeat config profile edit --help
aeat config profile edit --help
Usage: aeat config profile edit [OPTIONS] [profile_name]

  Re-run the wizard against an existing profile and update values in place

Arguments:
  profile_name  Profile name to write the answers into

Options:
  --quiet                         Run non-interactively using only the
                                  supplied flag values; required flags left
                                  unset cause an error. Sufficient on its own;
                                  combine with --accept-defaults to fill the
                                  rest from descriptor defaults.
  --accept-defaults               Fill every unsupplied flag from the
                                  descriptor defaults, without prompting. Use
                                  alongside --quiet, or on its own for an all-
                                  defaults create.
  --output-language <es|en|ca|hu>
                                  CLI output language for this profile
  --entity-type <str>             Natural person, legal entity, or attribution
                                  entity
  --legal-entity-form <str>       Recognised legal form when the entity type
                                  is a legal entity
  --tax-id <str>                  Tax identifier (NIF/CIF/DNI/NIE) for the
                                  active profile
  --name <str>                    Display name shown in local reviews
  --surnames <str>                Surnames or company name for export headers
  --legal-name <str>              Legal or company name for legal-entity
                                  export headers
  --fiscal-residency <str>        Fiscal residency category: resident_irpf
                                  (habitual resident in Spain) or
                                  non_resident_irnr (non-resident, IRNR
                                  taxation RDLeg 5/2004).
  --country-of-fiscal-residence <str>
                                  ISO 3166-1 alpha-2 code of the country of
                                  fiscal residence (e.g. GB, DE, FR). Required
                                  when fiscal-residency is non_resident_irnr.
  --representante-fiscal-nif <str>
                                  NIF/NIE of the fiscal representative in
                                  Spain. Required for non-EU/EEA non-residents
                                  (Art. 47 LGT + Art. 10 TRLIRNR RDLeg
                                  5/2004).
  --representante-fiscal-nombre <str>
                                  Full name of the fiscal representative in
                                  Spain.
  --tax-residence-jurisdiction-scope <str>
                                  Declared territorial regime: common
                                  territory or the not-yet-supported foral
                                  territory.
  --tax-residence-ccaa <str>      Tax-residence autonomous community, under
                                  the common regime. If the value is not
                                  recognised, the error lists the accepted
                                  communities.
  --address-postcode <str>        Tax address postcode
  --irpf-income-categories <str>  IRPF income category; pass --irpf-income-
                                  categories once per category
  --activity <str>                Business activity as plain text, or the IAE
                                  heading if you know it
  --activity-start-date <str>     Censo registration / start-of-activity date
                                  (YYYY-MM-DD). Optional; when set,
                                  obligations for periods before this date are
                                  not shown.
  --incn-prior-12-months <str>    Net turnover (importe neto de la cifra de
                                  negocios) over the prior 12 months, in
                                  euros. Above 6,000,000 EUR Modelo 202
                                  mandates the Art. 40.3 LIS modality; below
                                  it both modalities are available. Optional.
  --new-entity-first-two-profit-periods / --no-new-entity-first-two-profit-periods
                                  Mark this when a newly-created legal entity
                                  is in one of its first two profit-making tax
                                  periods (LIS Art. 29) to opt into the 15
                                  percent reduced rate. Optional; unset leaves
                                  the entity on its otherwise-applicable rate.
  --ley-49-2002-option-declared / --no-ley-49-2002-option-declared
                                  Record whether Modelo 036 casilla 651
                                  declares the Ley 49/2002 Title II option.
  --ley-49-2002-option-date <str>
                                  Record the Modelo 036 casilla 653 date for
                                  the Ley 49/2002 Title II option.
  --ley-49-2002-renunciation-declared / --no-ley-49-2002-renunciation-declared
                                  Record whether Modelo 036 casilla 652
                                  declares renunciation of the Ley 49/2002
                                  Title II regime.
  --ley-49-2002-renunciation-date <str>
                                  Record the Modelo 036 casilla 654 date for
                                  the Ley 49/2002 Title II renunciation.
  --iva-regime <str>              IVA regime
  --iva-m303-regime-composition <str>
                                  Modelo 303 regime composition: general,
                                  simplified, or mixed.
  --iva-roi-enrolled / --no-iva-roi-enrolled
                                  Enrolled in ROI
  --iva-oss-enrolled / --no-iva-oss-enrolled
                                  Enrolled in OSS
  --iva-group-member-enrolled / --no-iva-group-member-enrolled
                                  Enrolled as a member entity of an IVA group
  --iva-group-dominant-entity-enrolled / --no-iva-group-dominant-entity-enrolled
                                  Enrolled as the dominant entity of an IVA
                                  group
  --iva-sii-enrolled / --no-iva-sii-enrolled
                                  Whether the taxpayer is enrolled in the SII
  --iva-redeme-enrolled / --no-iva-redeme-enrolled
                                  Whether the taxpayer is registered in REDEME
  --iva-intracommunity-operations-exceed-50000-eur / --no-iva-intracommunity-operations-exceed-50000-eur
                                  Intra-community operations exceed 50,000 EUR
  --iva-cash-accounting-regime-enrolled / --no-iva-cash-accounting-regime-enrolled
                                  Declare enrolment in the special IVA cash-
                                  accounting regime.
  --iva-voluntary-sii-enrolled / --no-iva-voluntary-sii-enrolled
                                  Declare voluntary SII enrolment separately
                                  from mandatory inclusion triggers.
  --iva-hydrocarbon-deposit-advance-payment-deduction-entitled / --no-iva-hydrocarbon-deposit-advance-payment-deduction-entitled
                                  Declare entitlement to deduct advance
                                  payments under the hydrocarbon tax-deposit
                                  regime.
  --enrollment-large-company / --no-enrollment-large-company
                                  Large-company enrollment
  --enrollment-public-administration-budget-gt-6000000 / --no-enrollment-public-administration-budget-gt-6000000
                                  Public administration budget over 6,000,000
  --taxation-type <str>           Income-tax return type: 1 = individual, 2 =
                                  joint (family unit).
  --taxpayer-sex <str>            First taxpayer sex: H = male, M = female.
  --taxpayer-marital-status <1|2|3|4|5>
                                  First taxpayer marital status: 1 = single, 2
                                  = married, 3 = widowed, 4 = separated or
                                  divorced, 5 = registered civil partnership.
  --situacion-familiar <casado|pareja_hecho_registrada|pareja_hecho_no_registrada|soltero|separado_divorciado>
                                  Family situation under Art. 82 LIRPF:
                                  determines whether joint taxation is
                                  available and which family unit variant
                                  applies.
  --taxpayer-marriage-date <str>  Start date of the current marriage (YYYY-MM-
                                  DD). Only when marital status = 2 (married).
                                  Derives casillas 0245/0246/0247 (matrimonio
                                  sobrevenido, Art. 82 LIRPF).
  --taxpayer-birth-date <str>     First taxpayer birth date
  --taxpayer-disability-grade <str>
                                  First taxpayer disability grade: 1 =
                                  33%-64%, 2 = 65% or higher, 3 = judicial
                                  incapacity, 4 = third-party assistance or
                                  reduced mobility.
  --taxpayer-death-date <str>     First taxpayer death date
  --spouse-tax-id <str>           Spouse NIF/NIE
  --spouse-name <str>             Spouse given name
  --spouse-surnames <str>         Spouse surnames
  --spouse-birth-date <str>       Spouse birth date
  --spouse-sex <str>              Spouse sex: H = male, M = female.
  --spouse-disability-grade <str>
                                  Spouse disability grade (if applicable): 1 =
                                  33%-64%, 2 = 65% or higher, 3 = judicial
                                  incapacity, 4 = third-party assistance or
                                  reduced mobility.
  --spouse-non-resident-irpf / --no-spouse-non-resident-irpf
                                  Spouse is non-resident IRPF
  --spouse-eu-eea-resident / --no-spouse-eu-eea-resident
                                  Spouse is EU/EEA resident
  --spouse-eu-eea-country <str>   Spouse EU/EEA country
  --family-descendants-eu-eea-deduction / --no-family-descendants-eu-eea-deduction
                                  EU/EEA descendants in family-unit deduction
  --family-minor-children-in-unit / --no-family-minor-children-in-unit
                                  Minor children in family unit
  --has-employees / --no-has-employees
                                  Has employees and pays salaries with
                                  retención
  --pays-professionals-with-retencion / --no-pays-professionals-with-retencion
                                  Pays professionals with retención
  --art109-activity-income-withholding-ge-70pct / --no-art109-activity-income-withholding-ge-70pct
                                  Art. 109 coverage - at least 70% of covered
                                  professional, agricultural, livestock, or
                                  forestry activity income subject to
                                  withholding or payment on account
  --pays-rent-with-retencion / --no-pays-rent-with-retencion
                                  Pays local rent with retención
  --pays-capital-income-with-retencion / --no-pays-capital-income-with-retencion
                                  Pays capital income with retención
  --modelo-111-no-retenciones-periods <str>
                                  Comma-separated Modelo 111 no-obligation
                                  periods, format YYYY:PERIOD (for example
                                  2025:2T,2025:3T). Use only when no subject
                                  payments were made.
  --irpf-estimation-regime <str>  IRPF estimation regime for economic-activity
                                  income
  --objective-estimation-modulos-iae-epigraph <str>
                                  IAE epigraph for objective-estimation
                                  modules, such as 972.
  --objective-estimation-modulos-module-1-units <str>
                                  Annual module 1 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-2-units <str>
                                  Annual module 2 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-3-units <str>
                                  Annual module 3 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-4-units <str>
                                  Annual module 4 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-5-units <str>
                                  Annual module 5 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-6-units <str>
                                  Annual module 6 units for objective-
                                  estimation modules.
  --objective-estimation-modulos-module-7-units <str>
                                  Annual module 7 units for objective-
                                  estimation modules.
  --irpf-special-regime <str>     IRPF special regime. "general" for most
                                  taxpayers. "impatriado" for workers who
                                  relocated to Spain and elected the Beckham
                                  Law regime (Art. 93 LIRPF), available for
                                  the first 6 years after relocation.
  --irpf-special-regime-start-date <str>
                                  Date the worker elected the inpatriate
                                  regime (YYYY-MM-DD). Only when irpf-special-
                                  regime is "impatriado". RIRPF Art. 116. The
                                  regime expires at the end of the 6th
                                  calendar year.
  --does-intracomunitario / --no-does-intracomunitario
                                  Conducts intracomunitario operations
  --third-party-transactions-above-347-threshold / --no-third-party-transactions-above-347-threshold
                                  Third-party transactions exceed Modelo 347
                                  threshold
  --bienes-extranjero-above-threshold / --no-bienes-extranjero-above-threshold
                                  Foreign-held assets above legal threshold
  --monedas-virtuales-extranjero-above-threshold / --no-monedas-virtuales-extranjero-above-threshold
                                  Virtual currencies held abroad above Modelo
                                  721 threshold
  --llm-vision / --no-llm-vision  Enable on-host LLM vision for reading
                                  invoices.
  --google-export / --no-google-export
                                  Enable Google Sheets export.
  --notes <str>                   Notes for your own records (optional)
  --install-completion            Install completion for the current shell.
  --show-completion               Show completion for the current shell, to
                                  copy it or customize the installation.
  --help                          Show this message and exit.
3Confirm which profile those flags would apply to.
aeat --format json config profile status
aeat --format json config profile status
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.status",
  "notices": [],
  "result": {
    "active_profile": "docs-sequence-sandbox",
    "activity_present": true,
    "configured": true,
    "iva_regime": "GENERAL",
    "precondition_action": null,
    "profile_id": "<profile-id>",
    "profile_record_error": null,
    "profile_record_present": null,
    "registered_profile": null,
    "tax_id_present": true,
    "tax_residence_ccaa": ""
  },
  "schema_version": "2",
  "status": "success"
}

Confirm both flag listings run and name the active profile the flags apply to.

Crea el teu perfil

Crea un perfil de manera interactiva, o no interactiva amb opcions.

Executa l’assistent guiat quan configuris un perfil per primera vegada:

1Start the guided wizard for a new profile.
aeat config profile create my-profile
aeat config profile create my-profile

L’assistent és un recorregut de pàgina completa, pregunta per pregunta. Respon una pàgina i passa a la següent; torna enrere per canviar una resposta anterior en qualsevol moment. La primera pàgina demana la teva llengua de sortida. Respon-la i la resta de l’assistent es mostrarà en la llengua que hagis triat. Les pàgines recorren la teva identitat, residència fiscal, activitat econòmica, IVA, alta, situació familiar (inclosos els teus descendientes), obligacions recurrents i preferències de servei, i acaben en una pàgina de revisió que mostra cada resposta abans de comprometre res. Les preguntes són condicionals: l’assistent només pregunta allò que s’aplica a les respostes que ja has donat.

Cada pàgina explica les seves opcions i mostra el format esperat per a dates, imports i identificadors, i rebutja al moment un valor no vàlid. Una data o identificador fiscal mal format mai no arriba al perfil desat.

L’assistent demana la frase de contrasenya del perfil abans de desar res. Un cop el perfil existeix, pregunta si voleu configurar un codi de recuperació opcional, que permet restablir una frase de contrasenya oblidada; la resposta predeterminada és no i el podeu activar més tard. Consulteu protegiu l’accés a les vostres dades.

Per a execucions desateses, proporcioneu la frase de contrasenya pel canal per a màquines descrit a Executeu sense sol·licitud de frase de contrasenya; en aquesta via no s’ofereix mai la recuperació.

Fes servir --language en, es, ca o hu per a una ordre. Un perfil també pot desar el seu idioma de sortida per defecte.

Desa ara i acaba més tard

Atura una configuració inicial en qualsevol moment i conserva allò que has respost. Tria desa i surt en qualsevol pàgina: cada resposta ja està desada i el perfil queda marcat com a configuració incompleta. Després de desbloquejar-lo, aeat config profile show informa d’aquest estat; profile list informa deliberadament només dels noms desats i de quin perfil és actiu.

Reprèn executant de nou la mateixa ordre de creació amb el mateix nom de perfil. L’assistent continua on ho vas deixar amb les respostes anteriors. Respon les pàgines restants i confirma la pàgina de revisió per acabar la configuració. El perfil passa a estar actiu i preparat per a les ordres de Btaeat app`.

Descendientes és l’excepció en reprendre: l’assistent els torna a demanar perquè el conjunt que confirmes sigui sempre complet i actual.

Fes servir opcions amb --quiet quan vulguis una configuració repetible i apta per a scripts, passant el tipus d’entitat, l’identificador tributari, el nom i els cognoms a aeat config profile create. L”exemple resolt de més avall executa una creació completa amb script.

--quiet s’executa sense indicacions i utilitza només les opcions que proporciones. Una execució amb --quiet es nega si falta una opció obligatòria i t’indica quines has d’afegir. Una creació amb script necessita la identitat de presentació: l’identificador tributari, el tipus d’entitat i el nom i els cognoms:

Refused. Profile creation is missing filing identity details. Add these flags
and run the command again: --entity-type --name --surnames.

Afegeix --accept-defaults quan vulguis intencionadament que Cadrumo empleni les preguntes que ometis amb els seus valors per defecte integrats.

Exemple resolt: una persona física amb una activitat

Aquest exemple crea un perfil de persona física per a un particular amb una activitat econòmica, i després l’inspecciona i el valida abans de refiar-te’n:

1Inspect the stored facts.
aeat config profile view docs-sequence-sandbox
aeat config profile view docs-sequence-sandbox
Profile record is valid.
record_validity	valid	issues=0
profile_id	<profile-id>
display_name	docs-sequence-sandbox
setup_state	complete
activities.description	documentation examples
identity.name	Docs
identity.surnames	Sandbox
identity.tax_id	sha256:1c9f9632
iva.cash_accounting_regime_enrolled	false
iva.hydrocarbon_deposit_advance_payment_deduction_entitled	false
iva.m303_regime_composition	general
iva.redeme_enrolled	false
iva.regime	GENERAL
iva.voluntary_sii_enrolled	false
tax_residence.jurisdiction_scope	common_regime
taxpayer_type.entity_type	natural_person
2Validate a profile against the loaded schema (defaults to the active profile).
aeat --format json config profile validate docs-sequence-sandbox
aeat --format json config profile validate docs-sequence-sandbox
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.validate",
  "notices": [],
  "result": {
    "display_name": "docs-sequence-sandbox",
    "issues": [],
    "profile_id": "<profile-id>",
    "schema_version": 6,
    "setup_state": "complete",
    "valid": true
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the scripted create produces a natural-person profile that validates.

Les dades que demana la configuració

La configuració agrupa les seves preguntes per àrea de decisió. Aquests valors són tokens d’ordre estables: distingeixen majúscules i minúscules i no es tradueixen. Executa aeat config profile create --help per obtenir la llista exhaustiva d’opcions. Inclou les preguntes condicionals de cònjuge, unitat familiar, no resident i altes que aquesta guia resumeix en lloc de repetir.

Qui és el contribuent

Tria el tipus d’entitat:

  • natural_person - un particular.

  • legal_entity - una empresa. Registra’n també la forma jurídica, com ara sl, sa o cooperativa.

  • attribution_entity - una cotitularitat o comunidad de bienes la renda de la qual s’atribueix als seus membres.

Per a una persona física, llista cada tipus de renda que apliqui, repetint l’opció una vegada per categoria:

  • actividad_economica - activitat empresarial o professional.

  • trabajo - treball assalariat.

  • capital_inmobiliario - rendes del lloguer d’immobles.

  • capital_mobiliario - rendes d’inversió com ara dividends o interessos.

  • ganancias_patrimoniales - guanys patrimonials.

  • pension - una pensió de jubilació o d’incapacitat.

Tria actividad_economica només quan el contribuent duu a terme una activitat. Un arrendador pur, un contribuent només assalariat o un pensionista sense activitat no l’haurien de seleccionar.

Per a una activitat, registra com l’IRPF n’estima el rendiment. L’estimación directa és el valor per defecte i presenta el Modelo 130. Fes servir --irpf-estimation-regime objetiva per al règim d’estimación objetiva (módulos), que presenta el Modelo 131 en el seu lloc.

Identitat

L’identificador tributari (NIF, CIF, DNI o NIE) és obligatori. Els ciutadans espanyols utilitzen el seu DNI com a NIF; els particulars estrangers utilitzen el seu NIE; les empreses utilitzen un NIF o CIF. Registra el nom i els cognoms (o el nom visible de l’entitat), l’activitat econòmica quan n’hi ha, i el codi postal del domicili fiscal.

On resideix el contribuent

Per a un resident a efectes de l’IRPF espanyol, estableix la comunitat autònoma (--tax-residence-ccaa), com ara madrid o cataluna.

Aquesta eina no modela els règims forals. Establir la comunitat a pais_vasco o navarra es rebutja, perquè els residents d’aquests territoris presenten davant la seva Hacienda Foral sota el Concierto Económico, no davant l’AEAT:

Invalid value for '--tax-residence-ccaa': Residents in pais_vasco file with the
corresponding Hacienda Foral under the Concierto Económico (Ley 12/2002), not
with the AEAT. This CLI does not model foral declarations.

Per a un no resident, estableix --fiscal-residency non_resident_irnr (no --tax-residence-ccaa), després aporta el país de residència amb --country-of-fiscal-residence (un codi ISO 3166-1 alfa-2, com ara DE) i, quan calgui, un representant fiscal amb --representante-fiscal-nif i --representante-fiscal-nombre.

Quin règim d’IVA aplica

Estableix --iva-regime al règim d’IVA del contribuent:

  • GENERAL - el règim estàndard; presenta l’IVA trimestral mitjançant el Modelo 303.

  • SIMPLIFICADO - el règim simplificat basat en mòduls.

  • RECARGO_EQUIVALENCIA - el recàrrec d’equivalència per als comerciants minoristes que hi tenen dret.

  • REAGP - el règim especial de l’agricultura, la ramaderia i la pesca.

  • EXENTO - activitats exemptes, com ara alguns serveis d’educació o sanitat.

Registra qualsevol alta d’IVA que apliqui, com ara el ROI (operadors intracomunitaris) o l’OSS (finestreta única per a vendes B2C transfrontereres).

Quines obligacions recurrents apliquen

Aquestes dades decideixen quins formularis ha de presentar el contribuent. Registra les que siguin certes:

  • --has-employees o --pays-professionals-with-retencion - paga salaris o honoraris professionals amb retenció.

  • --pays-rent-with-retencion - paga el lloguer d’un local de negoci amb retenció.

  • --does-intracomunitario - fa operacions amb empreses d’altres països de la UE.

  • --third-party-transactions-above-347-threshold - les operacions amb terceres persones superen el llindar del Modelo 347.

  • --bienes-extranjero-above-threshold - els béns a l’estranger superen el llindar legal.

  • --art109-activity-income-withholding-ge-70pct - s’aplica l’excepció del 70 per cent de cobertura d’ingressos de l’art. 109 del RIRPF per a rendes d’activitat professional, agrícola, ramadera o forestal cobertes. Per als inicis d’activitat, registra la dada de cobertura per al període de pagament actual.

Deixar una opció d’obligació sense assignar no és el mateix que marcar-la com a falsa. Quan una dada no està declarada, la comprovació de preparació informa del formulari relacionat com a incomplet (no es pot determinar), no com a no aplicable. Registra cada dada que coneguis.

Comprova les teves dades abans de calcular

Una dada errònia o que falti produeix una presentació errònia. Confirma el perfil abans de calcular un modelo. L’exemple mostra el resum de preparació del perfil actiu i les dades desades, les valida contra l’esquema i, tot seguit, comprova si el perfil conté les dades que un formulari concret necessita per a un context de presentació concret:

1Show the active profile's readiness summary.
aeat config profile status
aeat config profile status
profile	docs-sequence-sandbox
profile_id	<profile-id>
identity.tax_id	sha256:1c9f9632
activities.description	documentation examples
iva.regime	GENERAL
tax_residence.ccaa	<unset>
Next step: `aeat app overview status`
2Show the stored facts in full.
aeat config profile view
aeat config profile view
Profile record is valid.
record_validity	valid	issues=0
profile_id	<profile-id>
display_name	docs-sequence-sandbox
setup_state	complete
activities.description	documentation examples
identity.name	Docs
identity.surnames	Sandbox
identity.tax_id	sha256:1c9f9632
iva.cash_accounting_regime_enrolled	false
iva.hydrocarbon_deposit_advance_payment_deduction_entitled	false
iva.m303_regime_composition	general
iva.redeme_enrolled	false
iva.regime	GENERAL
iva.voluntary_sii_enrolled	false
tax_residence.jurisdiction_scope	common_regime
taxpayer_type.entity_type	natural_person
3Validate the facts against the schema.
aeat config profile validate
aeat config profile validate
readiness	ready	issues=0
profile_id	<profile-id>
display_name	docs-sequence-sandbox
setup_state	complete
schema_version	6
valid	True
4Report whether the active profile is ready to file one modelo / year / period.
aeat --format json app modelo readiness --modelo 303 --year 2026 --period 1T
aeat --format json app modelo readiness --modelo 303 --year 2026 --period 1T
{
  "active_profile": "docs-sequence-sandbox",
  "command": "modelo.readiness",
  "notices": [
    {
      "action": null,
      "code": "modelo.readiness.per_operation_axis_not_assessed",
      "context": {
        "modelo": "303",
        "profile_ready": "True"
      },
      "message": "No schema-required profile field is currently declared for Modelo 303, so profile_ready reflects only the export-identity and conditional checks, not a per-modelo assessment. Do not read profile_ready as a complete check for this modelo.",
      "severity": "warning"
    },
    {
      "action": null,
      "code": "modelo.readiness.ledger_preflight_scope",
      "context": {
        "binding_ready": "false",
        "ledger_ready": "true",
        "missing_bindings": "4"
      },
      "message": "ledger_ready only means the period ledger rows passed transaction preflight; missing_bindings/source_binding_ready still decide source completeness.",
      "severity": "info"
    }
  ],
  "result": {
    "binding_ready": false,
    "filing_year": 2026,
    "ledger_checked_transaction_count": 0,
    "ledger_issues": [],
    "ledger_period": {
      "code": "1T",
      "filing_year": 2026
    },
    "ledger_preflight_required": true,
    "ledger_ready": true,
    "missing": [],
    "missing_bindings": [
      {
        "binding_id": "modelo-303-autoconsumo-promotor-base",
        "input_channel": "decimal",
        "source": "profile"
      },
      {
        "binding_id": "modelo-303-bienes-inversion-regularizacion-casilla-43",
        "input_channel": "decimal",
        "source": "bienes_inversion_regularizacion"
      },
      {
        "binding_id": "modelo-303-compensacion-pendiente-anteriores",
        "input_channel": "decimal",
        "source": "previous_filing"
      },
      {
        "binding_id": "modelo-303-prorrata-regularizacion-casilla-44",
        "input_channel": "decimal",
        "source": "prorrata_regularizacion"
      }
    ],
    "modelo": "303",
    "operation": "modelo.readiness",
    "period": {
      "code": "1T",
      "filing_year": 2026
    },
    "profile_id": "<profile-id>",
    "profile_ready": true,
    "profile_refusal": "",
    "ready": false,
    "registry_ready": true,
    "registry_refusal": "",
    "revision_id": "2026-y-siguientes"
  },
  "schema_version": "2",
  "status": "warning"
}

Confirm the active profile's facts validate and see what a specific filing still needs.

preflight anomena els camps que falten per a aquell context (modelo, any de presentació, període). Fes servir Tria quin modelo presentar per trobar els codis de període que accepta un modelo. Corregeix qualsevol dada errònia amb edit abans de continuar.

Com les teves dades decideixen quins formularis apliquen

Les dades del perfil que has registrat determinen quins modelos ha de presentar el contribuent. Fes servir aquesta correspondència per fer una comprovació de coherència del teu perfil i, tot seguit, confirma un formulari concret amb preflight:

Quan això és cert del contribuent

S’apliquen aquests formularis

És una persona física

Modelo 100 (Renta anual)

És una empresa

Modelo 200 (IS anual, impost sobre societats), Modelo 202 (pagaments a compte)

Duu a terme una activitat en estimación directa

Modelo 130 (IRPF trimestral)

Duu a terme una activitat en estimación objetiva (módulos)

Modelo 131

S’aplica l’excepció de cobertura d’ingressos d’activitat de l’art. 109

Elimina l’obligació del Modelo 130

Repercuteix l’IVA sota el règim general

Modelo 303 (trimestral), Modelo 390 (anual)

Paga empleats o professionals amb retenció

Modelo 111 (trimestral), Modelo 190 (anual)

Paga el lloguer d’un local de negoci amb retenció

Modelo 115 (trimestral), Modelo 180 (anual)

Fa operacions amb empreses de la UE

Modelo 349

Té operacions amb terceres persones per sobre del llindar del 347

Modelo 347

Té béns a l’estranger per sobre del llindar legal

Modelo 720

Això és una guia, no l’autoritat. L’eina decideix l’aplicabilitat a partir del perfil complet i de les regles del registre. Per veure què s’aplica al teu perfil, fes servir Tria quin modelo presentar.

Manté el teu perfil

Torna a executar l’assistent sobre un perfil existent per canviar-ne les dades:

1Re-run the wizard over an existing profile to change its facts.
aeat config profile edit my-profile
aeat config profile edit my-profile

El mode d’edició recorre les mateixes pàgines amb les respostes actuals ja emplenades. Canvia el que necessitis i confirma després la pàgina de revisió. No s’escriu res fins que confirmes: les edicions romanen preparades durant el recorregut i una edició interrompuda les descarta totes. En el mode d’edició no hi ha desar i sortir. Acaba el recorregut d’una tirada. L’eina t’explica totes dues coses al final de cada edició interactiva, de manera que una edició mai no s’aplica a mitges en silenci.

Els descendientes no formen part de l’edició del perfil. Gestiona’ls amb l’ordre descendiente que hi ha més avall. El resum de l’edició t’ho recorda cada vegada.

Per a un canvi programat, passa --quiet amb només les opcions que vulguis canviar; cada dada que no anomenis conserva el seu valor.

Gestiona els teus descendientes

Els descendientes alimenten el mínimo por descendientes de la Renda anual. Declara’ls durant la configuració inicial i gestiona’ls després amb l’ordre descendiente.

Obre l’editor paginat de descendientes:

1Open the paged descendant editor for the active profile.
aeat config profile descendiente
aeat config profile descendiente

L’editor mostra els descendientes declarats, et permet canviar qualsevol resposta, afegir-ne un o reduir-ne el nombre, i desa el conjunt complet quan confirmes. Reduir el nombre elimina els descendientes que queden més enllà. El conjunt desat coincideix sempre exactament amb el que has confirmat.

Programa els mateixos canvis amb els verbs d’opcions:

1List the declared descendientes with their positions.
aeat --format json config profile descendiente list
aeat --format json config profile descendiente list
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.descendiente.list",
  "notices": [],
  "result": {
    "descendientes": [],
    "profile": "docs-sequence-sandbox",
    "total": 0
  },
  "schema_version": "2",
  "status": "success"
}
2Add one descendiente as comma-separated KEY=VALUE pairs.
aeat --format json config profile descendiente add --descendiente \
  NACIMIENTO=2018-04-01,DISCAPACIDAD=0,CONVIVENCIA=true
aeat --format json config profile descendiente add --descendiente `
  NACIMIENTO=2018-04-01,DISCAPACIDAD=0,CONVIVENCIA=true
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.descendiente.add",
  "notices": [],
  "result": {
    "added": 1,
    "profile": "docs-sequence-sandbox",
    "total": 1
  },
  "schema_version": "2",
  "status": "success"
}
3Remove the descendiente at position 0.
aeat --format json config profile descendiente remove 0
aeat --format json config profile descendiente remove 0
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.descendiente.remove",
  "notices": [],
  "result": {
    "profile": "docs-sequence-sandbox",
    "removed_index": 0,
    "total": 0
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the descendiente count returns to zero after the removal.

add accepta una opció --descendiente per criatura, com a parelles KEY=VALUE separades per comes. NACIMIENTO (data de naixement, AAAA-MM-DD) és obligatori; ADOPCION, DISCAPACIDAD (0, 33 o 65), CONVIVENCIA, CUSTODIA, MESES_TRABAJO, GASTOS_GUARDERIA i NIF són opcionals. Un descendiente sense identificador fiscal és correcte: omet NIF. remove pren la posició de list, comptant des de 0.

MESES_TRABAJO anomena quins mesos va treballar la mare, no quants. Escriviu el mes amb dos dígits, un interval com a MM-MM, i separeu les entrades amb ;. Escriviu MESES_TRABAJO=05-08 per a maig a agost. Escriviu MESES_TRABAJO=01;03;09-12 per a gener, març i de setembre a desembre.

Anomeneu els mesos. L’increment per llar d’infants compta només els mesos en què la mare va treballar i el menor hi va assistir, de manera que un recompte no pot indicar si tots dos coincideixen.

Manté el teu perfil

Els passos següents editen una dada i fan una còpia de seguretat del perfil en un arxiu segellat:

1Edit a fact with the flags you want to change.
aeat config profile edit docs-sequence-sandbox --quiet --address-postcode 28013
aeat config profile edit docs-sequence-sandbox --quiet --address-postcode 28013
Profile	docs-sequence-sandbox
Status	updated
Next	aeat app modelo work create
2Back up the profile to a sealed, encrypted archive.
aeat --format json config profile archive export docs-sequence-sandbox --output \
  docs-sequence-sandbox.cadrumo-bucket.tar.gz
aeat --format json config profile archive export docs-sequence-sandbox --output `
  docs-sequence-sandbox.cadrumo-bucket.tar.gz
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.archive.export",
  "notices": [],
  "result": {
    "archive_schema_version": 4,
    "bucket_id": "<bucket-id>",
    "recovery_enrolled": false,
    "target": "docs-sequence-sandbox.cadrumo-bucket.tar.gz"
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the profile survives an edit and a sealed archive backup.

Què fa cada pas:

  • Edit canvia només les opcions que passes. Torna a executar show, status o validate després d’editar.

  • L’exportació de l’arxiu escriu una còpia segellada i xifrada del perfil. El nom del fitxer de destinació ha d’acabar en .cadrumo-bucket.tar.gz. L’arxiu es xifra amb la frase de contrasenya del perfil i no conté l’etiqueta del perfil. Restaura’l amb aeat config profile archive import i llegeix la capçalera d’un arxiu segellat sense desxifrar-lo amb aeat config profile archive inspect.

Un fitxer de perfil portable conté dades del contribuent, inclosos l’identificador tributari, l’activitat i l’historial de presentacions local. Desa’l com a dada tributària sensible i no l’adjuntis a una sol·licitud d’ajuda. Consulta importació, exportació i evidència.

Tria les capacitats de servei

Cada perfil porta la seva pròpia acceptació per a tres serveis opcionals. L’assistent de configuració fa aquestes preguntes quan crees o edites un perfil, i les pots canviar en qualsevol moment. Aquests passos mostren la postura actual, desactiven una capacitat i tornen a mostrar la postura:

1Show the resolved capability posture.
aeat config profile capabilities view
aeat config profile capabilities view
llm_vision	enabled	default	llm_vision is on by default (no profile opt-in)
google_export	enabled	default	google_export is on by default (no profile opt-in)
cloud_evidence_upload	disabled	default	cloud_evidence_upload is off by default (no profile opt-in)
2Turn the on-host vision model off for the active profile.
aeat config profile capabilities set llm_vision off
aeat config profile capabilities set llm_vision off
capability	llm_vision
state	off
3Show the resolved state of every service capability for the active profile.
aeat --format json config profile capabilities view
aeat --format json config profile capabilities view
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.capabilities.show",
  "notices": [],
  "result": {
    "capabilities": [
      {
        "capability": "llm_vision",
        "enabled": false,
        "reason": "profile opted out of llm_vision",
        "source": "profile"
      },
      {
        "capability": "google_export",
        "enabled": true,
        "reason": "google_export is on by default (no profile opt-in)",
        "source": "default"
      },
      {
        "capability": "cloud_evidence_upload",
        "enabled": false,
        "reason": "cloud_evidence_upload is off by default (no profile opt-in)",
        "source": "default"
      }
    ],
    "profile_id": "<profile-id>"
  },
  "schema_version": "2",
  "status": "success"
}

Confirm a capability change updates the active profile.

Les tres capacitats són:

  • cloud_evidence_upload - permet enviar evidència sensible a un proveïdor d’LLM al núvol. Desactivat per defecte. Vedat per als perfils de gestor.

  • llm_vision - llegeix factures amb el model de visió local. Activat per defecte.

  • google_export - exporta càlculs a Google Sheets. Activat per defecte.

Activa o desactiva qualsevol capacitat amb aeat config profile capabilities set. L’exemple desactiva llm_vision. Passa cloud_evidence_upload on per habilitar la pujada al núvol. Els extres de paquet que faltin produeixen l’ordre d’instal·lació exacta. Consulta Instal·la Cadrumo per als extres.

Tanca la sessió sense esborrar el perfil amb aeat config logout després de les comprovacions de manteniment i capacitats protegides per inici de sessió anteriors. El tancament de sessió tanca la sessió d’emmagatzematge activa, descarta les seves claus en memòria, allibera els motors de bucket i esborra el punter local del perfil actiu:

1Sign out of the active profile.
aeat config logout
aeat config logout
logged_out_profile	docs-sequence-sandbox
2Confirm that no profile remains active.
aeat --format json config profile status
aeat --format json config profile status
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.profile.status",
  "error": {
    "action": {
      "action": {
        "action_id": "operator.profile.login",
        "cli_path": [
          "config",
          "login"
        ],
        "target_command_key": "config.login"
      },
      "argument_bindings": [
        {
          "argument_name": "name",
          "source": "operator_action.verdict_context",
          "source_evidence_id": null,
          "source_key": "name",
          "status": "resolved",
          "value": "docs-sequence-sandbox"
        }
      ],
      "conditionality": "immediate",
      "evidence": [
        {
          "condition_id": "profile.session.logged_in",
          "evidence_id": "profile.session.resume",
          "provenance": "persisted_state",
          "values": {
            "profile_name": "docs-sequence-sandbox",
            "session_refusal_reason": "absent",
            "session_resumed": false
          }
        }
      ],
      "failed_condition_id": "profile.session.logged_in",
      "missing_argument_names": [],
      "no_recovery_outcome": null
    },
    "category": "REFUSED",
    "code": "REFUSED_CLI_BOUNDARY",
    "context": {
      "reason": "absent"
    },
    "message": "You are not logged in. Run `aeat config login` to unlock your profile.",
    "retryable": false,
    "runbook_id": null,
    "trace_id": null
  },
  "notices": [],
  "schema_version": "2",
  "status": "error"
}

Confirm logout closes the active session without deleting the profile.

Mira què ha canviat

Cada canvi a un perfil -creació, edicions, importacions, classificacions, càlculs i presentacions- es registra com un esdeveniment a l’historial només d’afegit d’aquell perfil (un registre que pots llegir però no alterar). Llegir l’historial necessita un perfil actiu, així que canvia-hi primer després de tancar la sessió. L’exemple crea, canvia de nom i edita un perfil abans de navegar i filtrar el seu historial:

1Review the available history filters before querying a profile.
aeat config profile history --help
aeat config profile history --help
Usage: aeat config profile history [OPTIONS] [profile]

  Show the append-only event history for one profile

Arguments:
  profile  Profile name whose event history should be inspected

Options:
  --event-type <str>              Filter the history to one or more event
                                  types (repeatable)
  --since <str>                   Filter the history to events at or after
                                  this ISO-8601 timestamp (e.g.
                                  2026-04-01T00:00:00+00:00)
  --until <str>                   Filter the history to events at or before
                                  this ISO-8601 timestamp (e.g.
                                  2026-04-30T23:59:59+00:00)
  --object-id <str>               Filter the history to events targeting a
                                  specific object_id (exact match)
  --actor <str>                   Filter the history to events recorded by a
                                  specific actor (exact match)
  --output-language, --language <es|en|ca|hu>
                                  Output language for the response text (es,
                                  en, ca, hu).
  --install-completion            Install completion for the current shell.
  --show-completion               Show completion for the current shell, to
                                  copy it or customize the installation.
  --help                          Show this message and exit.

Confirm the profile history records each change and can be filtered.

Repeteix --event-type per incloure diversos tipus. Un tipus desconegut es rebutja amb la llista acceptada completa, de manera que un valor buit és una manera ràpida de descobrir el vocabulari.

Un canvi de nom apareix com a dos esdeveniments a propòsit: profile.renamed registra que les dades han canviat, i bucket.renamed registra que has executat l’acció de canvi de nom. L’un respon «què ha canviat» i l’altre «què s’ha fet».

Elimina un perfil permanentment

Elimina definitivament un perfil només després de tancar-ne la sessió activa. Cadrumo es nega a eliminar el perfil actiu, per tant, primer tanca la sessió i després confirma l’eliminació irreversible d’aquell perfil amb el nom exacte. Aquest exemple terminal apareix després de totes les operacions de perfil de la guia perquè el perfil eliminat no es pot tornar a utilitzar:

1Log out so the profile is no longer active before deletion.
aeat --format json config logout
aeat --format json config logout
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.logout",
  "notices": [],
  "result": {
    "already_logged_out": false,
    "logged_out_profile": "docs-sequence-sandbox"
  },
  "schema_version": "2",
  "status": "success"
}
2Delete only the named sandbox profile after confirming the irreversible operation.
aeat --format json config profile delete docs-sequence-sandbox --yes
aeat --format json config profile delete docs-sequence-sandbox --yes
{
  "active_profile": null,
  "command": "config.profile.delete",
  "notices": [
    {
      "action": null,
      "code": "config.profile.delete.deleted",
      "context": {
        "profile_id": "<profile-id>"
      },
      "message": "Profile deleted along with its local state.",
      "severity": "info"
    }
  ],
  "result": {
    "completed_at": "2026-04-01T09:00:00+00:00",
    "deleted": true,
    "display_name": "docs-sequence-sandbox",
    "earliest_safe_erase_date": null,
    "fingerprint": {
      "digest": "<masked>",
      "file_count": 4,
      "schema_version": 1,
      "total_bytes": 1850
    },
    "profile_id": "<profile-id>",
    "retained_record_count": 0
  },
  "schema_version": "2",
  "status": "success"
}

Confirm logout makes the sandbox profile inactive before deleting only that exact profile.

Si la configuració sembla incorrecta

Si una ordre informa que no hi ha cap perfil actiu, d’un valor de camp no vàlid, o que estàs treballant sota el perfil incorrecte, consulta Diagnostica i repara la teva configuració local.

Quan els passos de resolució de problemes no ho resolen, segueix Prepara una sol·licitud d’ajuda segura per a la privadesa. Anomena les sortides que has d’incloure i les dades personals que has de deixar fora abans de portar el problema al seguidor d’incidències del projecte.

Passos següents