Számítások felülvizsgálata Google Táblázatokkal

Ez az oldal egy modelo-számítás táblázatos felülvizsgálatát tárgyalja: az exportálását Google Táblázatokba, annak ellenőrzését, hogyan áll össze az egyes összegek élő formulákkal, és a felülvizsgált szerkesztései visszahúzását tipizált benyújtási bemenetként. A visszahúzás anélkül adja vissza ezeket a szerkesztéseket, hogy tárolná őket. Ez a munkafolyamat a kiszámított értékek felülvizsgálatára szolgál, miután a profilja és a tranzakciói készen állnak. Nem bankszámlakivonat-importáló vagy tömeges szerkesztő eszköz.

A Google Táblázatok a felülvizsgálati felület. A kódbázis egy offline .xlsx szerializálót is tartalmaz, de a jelenlegi kezelői parancsfelület nem tárja fel. Használja a Google Táblázatokat, amikor felül szeretné vizsgálni és igazítani.

Az oldalon szereplő helyi konfigurációs parancsok (státusz, mappakötés, kijelentkezés) és a főkönyvi készenléti ellenőrzések élőben futnak az összeállítás idején. Azok a parancsok, amelyek elérik a Google Drive-ot és a Táblázatokat, az Ön saját engedélyezett fiókjával futnak, nem a dokumentációs tesztkörnyezetben, ezért csak megjelenítési keretekként szerepelnek.

Mielőtt hozzákezd

Szüksége lesz:

A Cadrumo a cadrumo-vault/ mappáját azon a Drive-mappán belül hozza létre. Nem használ egy régebbi aeat-vault/ mappát; exportáljon egy új munkafüzetet, mielőtt szerkesztéseket húzna vissza a Cadrumóba.

Google-hozzáférés beállítása

Regisztrálja az asztali OAuth-ügyfelet az aktív profilhoz, és futtassa a hozzájárulási folyamatot. Mindkettő eléri a Google-t, ezért itt csak megjelenítés:

1Register the Desktop OAuth client for the active profile.
aeat config google register --client-json ./client_secret.json
aeat config google register --client-json ./client_secret.json
2Run the Google consent flow.
aeat config google login
aeat config google login

Ellenőrizze a Google-státuszt, és állítsa be a Drive-mappát, ahol a Cadrumo táblázatokat fog létrehozni. Ezek helyi konfigurációs parancsok, ezért itt lefutnak. Egy be nem állított profilon a státusz nincs-csatlakoztatva értéket mutat, és a beállított mappa szó szerint olvasható vissza:

1Check the Google connection status for the active profile.
aeat --format json config google status
aeat --format json config google status
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.google.status",
  "notices": [],
  "result": {
    "account_email": null,
    "client_id": null,
    "client_registered": false,
    "granted_scopes": [],
    "issued_at": null,
    "last_refresh_at": null,
    "operation": "config.google.status",
    "profile": "<profile-id>",
    "reauth_required": null,
    "session_present": false
  },
  "schema_version": "2",
  "status": "success"
}
2Set the Drive folder where Cadrumo will create spreadsheets.
aeat config google folder set docs-folder-123
aeat config google folder set docs-folder-123
operation	config.google.folder.set
profile	<profile-id>
root_folder_id	docs-folder-123
3Confirm the folder binding.
aeat --format json config google folder view
aeat --format json config google folder view
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.google.folder.view",
  "notices": [],
  "result": {
    "configured": true,
    "operation": "config.google.folder.view",
    "profile": "<profile-id>",
    "root_folder_id": "docs-folder-123"
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the Drive folder binding reads back the value you set.

Vizsgálja a kapcsolatot, amint az OAuth-ügyfél regisztrálva van. A vizsgálat eléri a Google-t, ezért itt csak megjelenítés:

1Probe the Google connection.
aeat config google probe
aeat config google probe

A Google-integráció profilra korlátozott. Ha profilokat vált, ellenőrizze újra a Google-státuszt és a mappakötést.

Egy számítási munkafüzet exportálása

Exportálja a nyilvántartási számítási felületet egy modelóhoz, évhez és időszakhoz. Az export egy Google Táblázatok munkafüzetet hoz létre a Drive-ban beállított cadrumo-vault/ területen belül:

1Export the calculation surface for one modelo, year, and period.
aeat app modelo spreadsheet push --modelo 303 --year 2026 --period 1T
aeat app modelo spreadsheet push --modelo 303 --year 2026 --period 1T

Ez egy számítás-felülvizsgálati felület, nem bankszámlakivonat-export. Használja az aeat app ledger export parancsot, amikor a főkönyvi sorok CSV-, JSONL- vagy XLSX-pillanatképére van szüksége.

A --prefill-relations opciót csak akkor használja, amikor azt szeretné, hogy a táblázat tartalmazza a kapcsolódó benyújtásokból áthozott értékeket, például éves összesítőket vagy korábbi negyedévi áthozatokat.

Húzza vissza a szerkesztéseit

A munkafüzet felülvizsgálata vagy szerkesztése után húzza vissza a tipizált szerkesztéseket a Táblázatból. Adja hozzá az --assemble-observations opciót, amikor azt szeretné, hogy a parancs kimenete tartalmazza a szerkesztett sorszintű adatokat strukturált megfigyelésekként összeállítva. A parancs nem tárolja ezeket a megfigyeléseket:

1Pull typed edits back from the reviewed spreadsheet.
aeat app modelo spreadsheet pull --modelo 303 --year 2026 --period 1T --spreadsheet-id \
  <spreadsheet-id>
aeat app modelo spreadsheet pull --modelo 303 --year 2026 --period 1T --spreadsheet-id `
  <spreadsheet-id>

A visszahúzó parancs ellenőrzi, hogy a táblázat az aktuális profilhoz tartozik, és megegyezik a várt benyújtási időszakkal. Ha elutasít, exportáljon újra, és próbálja újra az új táblázatból.

Casilla-értékek kiszámítása a Táblázatból

Futtassa a compute parancsot, amikor azt szeretné, hogy a Cadrumo a Táblázatban lévő szerkesztésekből számítson casilla-értékeket. Behúzza a kezelő által szerkesztett cellákat, lefuttatja rajtuk a számítási motort, és megjeleníti az eredményt. Semmit nem tárol:

1Compute casilla values from the operator-edited cells.
aeat app modelo spreadsheet calculate --modelo 303 --year 2026 --period 1T \
  --spreadsheet-id <spreadsheet-id>
aeat app modelo spreadsheet calculate --modelo 303 --year 2026 --period 1T `
  --spreadsheet-id <spreadsheet-id>

A compute parancs ellenőrzi, hogy a táblázat megegyezik a várt benyújtási időszakkal. Ha elutasít, exportáljon újra, és próbálja újra az új táblázatból.

Ellenőrizze a táblázat számítását

Futtassa a calc-sheets ellenőrző parancsot ugyanarra a modelóra, évre és időszakra. Ha van egy forgatókönyv-JSON-ja kezelői bemenetekkel és várt Agencia Estatal de Administración Tributaria (AEAT) kimenetekkel, adja át kifejezetten a --scenario opcióval:

1Verify the spreadsheet calculation for the modelo, year, and period.
aeat app modelo spreadsheet verify --modelo 303 --year 2026 --period 1T
aeat app modelo spreadsheet verify --modelo 303 --year 2026 --period 1T
2Verify against an explicit scenario JSON of inputs and expected outputs.
aeat app modelo spreadsheet verify --modelo 303 --year 2026 --period 1T --scenario \
  ./scenario.json
aeat app modelo spreadsheet verify --modelo 303 --year 2026 --period 1T --scenario `
  ./scenario.json

Az ellenőrzés összehasonlítja az alkalmazás által megvalósított számítási felületeket. Nem nyújt be benyújtást az AEAT-hoz.

Mentse a titkosított rekordjait a Drive-ra

Tartson egy gépen kívüli másolatot a titkosított rekordjairól úgy, hogy tükrözi őket a beállított Drive-mappába. Előbb tekintse meg a --dry-run opcióval; ez jelenti, mit töltene fel tárolási területenként anélkül, hogy bármit módosítana. Szűkítsen egy nagy feltöltést a --namespace vagy a --limit opcióval:

1Preview the encrypted backup to Drive without uploading.
aeat config profile archive push --dry-run
aeat config profile archive push --dry-run
2Mirror the encrypted records to the Drive folder.
aeat config profile archive push
aeat config profile archive push

Csak titkosított szöveg kerül feltöltésre. A rekordjai pontosan úgy hagyják el a gépet, ahogy titkosítva vannak a lemezen, és a mesterkulcs soha nem hagyja el a számítógépét, így a Drive-másolat olvashatatlan nélküle. A tükrözés egyirányú: a Cadrumo megírja a másolatot, és soha nem olvassa vissza a Drive-ot a rekordjai hiteles forrásaként.

Jelentkezzen ki a Google-ból

Törölje a Google-munkamenetet az aktív profilhoz. A kijelentkezés helyi parancs, ezért itt lefut. Eltávolítja a mentett munkamenet-tokent és annak metaadatait. A regisztrált OAuth-ügyfél szándékosan megmarad, így egy későbbi aeat config google login újra bejelentkezhet a Cloud Console JSON újbóli importálása nélkül:

1Clear the Google session for the active profile.
aeat --format json config google logout
aeat --format json config google logout
{
  "active_profile": "docs-sequence-sandbox",
  "command": "config.google.logout",
  "notices": [],
  "result": {
    "client_preserved": true,
    "metadata_removed": false,
    "operation": "config.google.logout",
    "profile": "<profile-id>",
    "token_removed": false
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the Google session clears for the active profile.

Hová illeszkedik ez

Ezt a tranzakció-felülvizsgálat és -osztályozás után használja. Erősítse meg, hogy az időszak készen áll, mielőtt a számítási munkafüzetre hagyatkozna:

1Run the period preflight.
aeat app ledger preflight --year 2026 --period 1T
aeat app ledger preflight --year 2026 --period 1T
bucket	<profile-id>
period	2026 1T
checked	2
issues	2
ready	false
issue	71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518	missing_business_classification	business classification 'NOT_YET_PROCESSED' is not ready for modelo calculation
issue	e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d	missing_business_classification	business classification 'NOT_YET_PROCESSED' is not ready for modelo calculation
2Read the overall ledger state for the period.
aeat --format json app ledger status --year 2026 --period 1T
aeat --format json app ledger status --year 2026 --period 1T
{
  "active_profile": "docs-sequence-sandbox",
  "command": "ledger.status",
  "notices": [],
  "result": {
    "active_count": 2,
    "archived_count": 0,
    "bucket_id": "<bucket-id>",
    "business_expense_total": "0",
    "business_income_total": "0",
    "business_net_total": "0",
    "checked_transaction_count": 2,
    "pending_review_count": 2,
    "period": {
      "code": "1T",
      "filing_year": 2026
    },
    "readiness_issue_count": 2,
    "readiness_issues": [
      {
        "business_classification": "NOT_YET_PROCESSED",
        "category_id": null,
        "detail": "business classification 'NOT_YET_PROCESSED' is not ready for modelo calculation",
        "iva_amount": null,
        "iva_rate": null,
        "reason": "missing_business_classification",
        "taxable_base": null,
        "transaction_id": "71a5db2bb891df295bee72544c40497d24d5c8cfc7edab745ce7339dcf8d6518",
        "transaction_present": true
      },
      {
        "business_classification": "NOT_YET_PROCESSED",
        "category_id": null,
        "detail": "business classification 'NOT_YET_PROCESSED' is not ready for modelo calculation",
        "iva_amount": null,
        "iva_rate": null,
        "reason": "missing_business_classification",
        "taxable_base": null,
        "transaction_id": "e3eeac5e306efe4e82a72896e92e7c236245ec85348834b2c10b120c67fe087d",
        "transaction_present": true
      }
    ],
    "ready": false,
    "reviewed_count": 0,
    "skipped_count": 0,
    "split_count": 0,
    "stale_filings": [],
    "stashed_count": 0,
    "total_count": 2,
    "unconverted_currency_count": 0
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the period's readiness before relying on the workbook.

Ha a főkönyvből még hiányoznak kategóriák, áfamezők, deviza vagy arányossági hivatkozások, fejezze be azokat a Tranzakciók osztályozása oldalon, mielőtt a számítási munkafüzetre hagyatkozna.

A casilla-szintű kézi bemenetekhez, kötésekhez, ellentételezésekhez és revíziókhoz használja a Számítási bemenetek felülvizsgálata és megadása oldalt.

Következő lépések