Számlák és bizonylatok csatolása a főkönyvi tranzakciókhoz

Tároljon minden számlához vagy bizonylathoz egy bizonyítékrekordot, és kösse hozzá ahhoz a tranzakcióhoz, amelyet alátámaszt. Az ellenőrzések, az exportok és az év végi felülvizsgálatok így minden szám mögött rá tudnak mutatni a dokumentumra. A tárolt bizonyíték titkosított helyi őrizetben marad. A Google Drive lekérő parancsai az Ön engedélyezett fiókjához fordulnak, mielőtt a letöltött bájtokat helyben tárolják.

Mielőtt hozzákezd

Szüksége lesz:

  • Egy aktív adózói profilra. A bizonyíték az aktív profil alatt tárolódik; ha nincs beállítva, a parancs elutasítja a műveletet. Lásd: Állítsa be adózói profilját.

  • Egy mesterkulcs-jelmondatra. Az eszköz akkor kéri be, amikor egy munkamenetben először nyitja meg titkosított tárolóját.

  • Tranzakciókra a főkönyvében. Ha a főkönyve üres, előbb lásd: Tranzakciók importálása és kezelése.

  • A számlára vagy bizonylatra PDF- vagy képfájlként. A Cadrumo a fájl bájtjait a beírt tényekkel együtt bemásolja a titkosított tárolóba, egy tartalmi ujjlenyomattal és az eredeti hellyel mint eredetmegjelöléssel. Az eredeti fájlra az add után soha többé nincs szükség.

Bizonyítékrekord hozzáadása

Rögzítse a számlafájlt és annak adatait, majd tekintse meg a tárolt rekordot. Egyedül a fájlútvonal kötelező; minden metaadat-jelző opcionális. A --iva-rate 21 21%-ot jelent:

1Record the invoice file and its details as encrypted evidence.
aeat --format json app ledger evidence add fixtures/factura-material-oficina.pdf \
  --supplier Papelería Sol SL --invoice-number 2026-0142 --invoice-date 2026-03-10 \
  --taxable-base 100.00 --iva-rate 21 --iva-amount 21.00 --notes Office supplies, March
aeat --format json app ledger evidence add fixtures/factura-material-oficina.pdf `
  --supplier Papelería Sol SL --invoice-number 2026-0142 --invoice-date 2026-03-10 `
  --taxable-base 100.00 --iva-rate 21 --iva-amount 21.00 --notes Office supplies, March
{
  "active_profile": "docs-sequence-sandbox",
  "command": "ledger.evidence.add",
  "notices": [],
  "result": {
    "attachment_id": "725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16",
    "bucket_event_ids": [
      "55fe6f63d8763568849f8ca8f05b45fc7a714987593755df7695f448a4b48b92"
    ],
    "bucket_id": "<bucket-id>",
    "created_at": "2026-04-01T09:00:00Z",
    "evidence_id": "ee678fa9b328d79d",
    "invoice_date": "2026-03-10",
    "invoice_number": "sha256:d3693bea",
    "iva_amount": "21.00",
    "iva_rate": "21",
    "media_kind": "pdf",
    "notes": "Office supplies, March",
    "source_path": "fixtures/factura-material-oficina.pdf",
    "source_sha256": "725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16",
    "supplier": "Papelería Sol SL",
    "taxable_base": "100.00",
    "updated_at": "2026-04-01T09:00:00Z"
  },
  "schema_version": "2",
  "status": "success"
}
2Confirm the stored record carries the details you typed, with the invoice number shown as a short digest.
aeat --format json app ledger evidence view {evidence_id}
aeat --format json app ledger evidence view {evidence_id}
{
  "active_profile": "docs-sequence-sandbox",
  "command": "ledger.evidence.view",
  "notices": [],
  "result": {
    "attachment_id": "725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16",
    "bucket_event_ids": [],
    "bucket_id": "<bucket-id>",
    "created_at": "2026-04-01T09:00:00Z",
    "evidence_id": "ee678fa9b328d79d",
    "invoice_date": "2026-03-10",
    "invoice_number": "sha256:d3693bea",
    "iva_amount": "21.00",
    "iva_rate": "21",
    "media_kind": "pdf",
    "notes": "Office supplies, March",
    "source_path": "fixtures/factura-material-oficina.pdf",
    "source_sha256": "725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16",
    "supplier": "Papelería Sol SL",
    "taxable_base": "100.00",
    "updated_at": "2026-04-01T09:00:00Z"
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the evidence record stored the supplier and invoice details.

A parancs kiírja a bizonyíték azonosítóját. Jegyezze fel a teljes azonosítót: a későbbi parancsoknak szükségük van rá. Adja meg most, amit tud; a többit később frissítse.

A tárolt rekord megőrzi a beírt számlaszámot, de az evidence add, view, list, update és remove csak egy rövid kivonatot mutat belőle (sha256:, majd nyolc hexadecimális karakter), magát a számot nem.

Bizonyítékrekord összekapcsolása egy tranzakcióval

Csatolja a bizonyítékrekordot ahhoz a tranzakcióhoz, amelyet alátámaszt. A parancssorozat rögzít egy bizonyítékfájlt és egy kiadást, majd egymáshoz csatolja őket:

1Attach the evidence record to the transaction it supports.
aeat app ledger attach {transaction_id} --purchase-invoice-evidence-id {evidence_id}
aeat app ledger attach {transaction_id} --purchase-invoice-evidence-id {evidence_id}
ID	0cd656fe8ae4c7387bef5c335a4fcec3e8ffe314d34269147920f60a72052eec
Date	2026-03-10
Amount	121
Description	Material de oficina
Review status	pending
2Confirm the transaction now carries the purchase-invoice evidence.
aeat --format json app ledger view {transaction_id}
aeat --format json app ledger view {transaction_id}
{
  "active_profile": "docs-sequence-sandbox",
  "command": "ledger.view",
  "notices": [],
  "result": {
    "bucket_id": "<bucket-id>",
    "review_status": "pending",
    "transaction": {
      "amount": "121",
      "attachment_ids": [],
      "booked_date": "2026-03-10",
      "business_classification": "NOT_YET_PROCESSED",
      "business_pct": null,
      "category_id": "material_oficina",
      "classification_confidence": null,
      "classification_reason": "",
      "classified_at": null,
      "classified_by": "auto",
      "counterparty": "",
      "counterparty_country": null,
      "counterparty_identification_state": null,
      "created_at": "2026-04-01T09:00:00+00:00",
      "currency": "EUR",
      "date": "2026-03-10",
      "description": "Material de oficina",
      "direction": "OUTGOING",
      "fx_rate": null,
      "invoice_id": null,
      "irpf_category": null,
      "iva_amount": "21",
      "iva_category": null,
      "iva_rate": "0.21",
      "lifecycle_state": "ACTIVE",
      "m210_income_classification": null,
      "modified_at": "2026-04-01T09:00:00+00:00",
      "notes": "",
      "prorrata_reference": null,
      "purchase_invoice_evidence_id": "4fbeef4e52f5c0a8",
      "source_jurisdiction": "ES",
      "taxable_base": "100",
      "transaction_id": "0cd656fe8ae4c7387bef5c335a4fcec3e8ffe314d34269147920f60a72052eec",
      "usage_ratio_id": null,
      "value_date": null,
      "value_in_eur": null
    },
    "transaction_id": "0cd656fe8ae4c7387bef5c335a4fcec3e8ffe314d34269147920f60a72052eec"
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the purchase-invoice evidence attached to the transaction.

Egy tranzakció legfeljebb egy beszerzésiszámla-bizonyítékrekordot hordoz. A parancs elutasít egy másodikat, és elutasítja ugyanannak az újracsatolását is.

Itt ne használd a aeat app ledger link parancsot. A attach és a link ugyanazon tranzakció különböző műveletei: a attach csatolja az evidenciadokumentumot, a link pedig a tranzakciót számlához köti, és megköveteli a --invoice-id kapcsolót. Az azonosító importált, egyeztetett vagy kézzel hozzáadott számlából származik; pontosan ezt az azonosítót írja ki a aeat app ledger invoice add.

A legtöbb bizonylat és számla esetén a fenti --purchase-invoice-evidence-id a helyes út; a bizonyíték azonosítója közvetlenül az evidence add parancsból származik.

Az attach parancsnak van egy --attachment-id opciója is (ismételhető) egy általános biztonságos csatolmányhoz, amely nem hordozza a beszerzési számla szerepét. Egy titkosított csatolmánytárolóban már meglévő blob 64 karakteres tartalmi azonosítóját várja, és elutasít minden olyan azonosítót, amelyhez nem tartozik tárolt blob (attachment_ids must reference existing secure attachment manifests and blobs). Jelenleg egyetlen kezelői parancs sem írja ki azt a 64 karakteres azonosítót: az evidence add parancsból kapott evidence_id egy másik, rövidebb azonosító, amelyet itt nem fogad el a rendszer. Amíg egy parancs elő nem tárja a csatolmány azonosítóját, használja helyette a --purchase-invoice-evidence-id opciót vagy az evidence pull parancsot.

Dokumentum lekérése inkább a Google Drive-ról

Ha a dokumentum a Google Drive-on található, kérje le közvetlenül a titkosított bizonyítéktárolóba. Ez a parancs eléri a Google Drive-ot, ezért az Ön saját engedélyezett fiókjával fut, nem a dokumentációs tesztkörnyezetben:

1Pull the Drive document straight into encrypted evidence storage.
aeat app ledger evidence pull <transaction-id> --source GOOGLE_DRIVE --reference \
  <drive-file-id> --note Supplier invoice
aeat app ledger evidence pull <transaction-id> --source GOOGLE_DRIVE --reference `
  <drive-file-id> --note Supplier invoice

A parancs letölti a Drive-fájlt, a bájtjait titkosítva tárolja a tranzakcióval, és eredetmegjelölésként megőrzi az eredeti hivatkozást. A bizonyíték mindig magát a dokumentumot hordozza, sosem pusztán egy hivatkozást: a Gmail-hivatkozásokat, a tetszőleges URL-eket és az engedélyezett hatókörön kívüli Drive-fájlokat elutasítja a rendszer. Elutasított forrás esetén töltse le maga a dokumentumot, és csatolja az aeat app ledger evidence add vagy az aeat app ledger attach --attachment-id paranccsal.

Egy Drive-mappa összes számlájának tömeges lekérése

Kérje le egy Drive-mappa összes PDF- és képszámláját egyszerre, egyesével történő lekérés helyett. Az evidence pull parancshoz hasonlóan ez a parancs is eléri a Google Drive-ot, és az Ön saját engedélyezett fiókjával fut:

1Fetch every PDF and image invoice in one Drive folder at once.
aeat app ledger evidence pull-all --folder <drive-folder-id-or-url> --note \
  Q1 supplier invoices
aeat app ledger evidence pull-all --folder <drive-folder-id-or-url> --note `
  Q1 supplier invoices

A parancs kilistázza a mappa tartalmát, letölti az egyes PDF- vagy képfájlokat, és minden fájlt titkosított bizonyítékként tárol. A lekért fájlok még nincsenek tranzakcióhoz kötve; kösse mindegyiket utólag az aeat app ledger attach --attachment-id <attachment-id> paranccsal.

Futtassa ugyanezt a parancsot bármikor újra. A már lekért fájlt a rendszer a tartalma alapján felismeri, és nem tárolja kétszer. Az engedélyezett Drive-hatókörön kívüli fájlt egyenként elutasítja, és ez nem állítja le a söprés többi részét; töltse le maga, és csatolja az aeat app ledger attach --attachment-id paranccsal.

A Gmail tömeges lekérése még nem érhető el.

A számlarekordok külön funkció

Egy számlarekord (ki tartozik kinek, milyen összeggel) nem egy tárolt dokumentum. A számlarekordokat a Vállalkozási számlák kezelése oldal kezeli: a kiállított és beérkezett számlák nyilvántartásba vétele, az egyeztetési katalógus, valamint egy katalógusszámla összekapcsolása azzal a tranzakcióval, amely kiegyenlíti. Ez az oldal azokról a dokumentumokról szól (PDF-ekről és képekről), amelyeket bizonyítékként tárol, és tranzakciókhoz köt.

Bizonyítékrekordok listázása, megtekintése, frissítése és eltávolítása

Listázza ki az összes tárolt rekordot, tekintsen meg egyet teljes egészében, frissítse az adatait, és távolítson el egyet, amelyre már nincs szüksége. A parancssorozat rögzít egy bizonyítékfájlt, kilistázza és megvizsgálja, módosítja a beszállítót, majd megerősíti a változtatást:

1List every stored evidence record.
aeat app ledger evidence list
aeat app ledger evidence list
evidence_id	media_kind	supplier	invoice_number	invoice_date	taxable_base	notes
4fbeef4e52f5c0a8	pdf	Papelería Sol SL	sha256:d3693bea	2026-03-10	100.00	-
2View one evidence record in full.
aeat app ledger evidence view {evidence_id}
aeat app ledger evidence view {evidence_id}
evidence_id	4fbeef4e52f5c0a8
bucket_id	<bucket-id>
source_path	fixtures/factura-material-oficina.pdf
source_sha256	725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16
media_kind	pdf
supplier	Papelería Sol SL
invoice_number	sha256:d3693bea
invoice_date	2026-03-10
taxable_base	100.00
iva_rate	21
iva_amount	21.00
notes	-
created_at	2026-04-01T09:00:00Z
updated_at	2026-04-01T09:00:00Z
3Update a detail on the record - the same optional flags as add.
aeat app ledger evidence update {evidence_id} --supplier Papelería Central SL
aeat app ledger evidence update {evidence_id} --supplier Papelería Central SL
evidence_id	4fbeef4e52f5c0a8
bucket_id	<bucket-id>
source_path	fixtures/factura-material-oficina.pdf
source_sha256	725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16
media_kind	pdf
supplier	Papelería Central SL
invoice_number	sha256:d3693bea
invoice_date	2026-03-10
taxable_base	100.00
iva_rate	21
iva_amount	21.00
notes	-
created_at	2026-04-01T09:00:00Z
updated_at	2026-04-01T09:00:00Z
bucket_event_ids	8f439cce2a9b8972cff6a94ed9e944438548dcd2af320e2f2f4039d9b1c2d99f
4Confirm the supplier now reads the updated value.
aeat --format json app ledger evidence view {evidence_id}
aeat --format json app ledger evidence view {evidence_id}
{
  "active_profile": "docs-sequence-sandbox",
  "command": "ledger.evidence.view",
  "notices": [],
  "result": {
    "attachment_id": "725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16",
    "bucket_event_ids": [],
    "bucket_id": "<bucket-id>",
    "created_at": "2026-04-01T09:00:00Z",
    "evidence_id": "4fbeef4e52f5c0a8",
    "invoice_date": "2026-03-10",
    "invoice_number": "sha256:d3693bea",
    "iva_amount": "21.00",
    "iva_rate": "21",
    "media_kind": "pdf",
    "notes": "",
    "source_path": "fixtures/factura-material-oficina.pdf",
    "source_sha256": "725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16",
    "supplier": "Papelería Central SL",
    "taxable_base": "100.00",
    "updated_at": "2026-04-01T09:00:00Z"
  },
  "schema_version": "2",
  "status": "success"
}

Confirm the evidence record's supplier was updated.

Távolítson el egy bizonyítékrekordot, amelyre már nincs szüksége, azonosító szerint hivatkozva rá:

1Remove an evidence record by id, confirming with --yes.
aeat app ledger evidence remove {evidence_id} --yes
aeat app ledger evidence remove {evidence_id} --yes
evidence_id	4fbeef4e52f5c0a8
bucket_id	<bucket-id>
source_path	fixtures/factura-material-oficina.pdf
source_sha256	725afbe3c64d4e96faaed8b63b83ed2e7df161334681d98d8b877bd7cddbfc16
media_kind	pdf
supplier	Papelería Sol SL
invoice_number	sha256:d3693bea
invoice_date	2026-03-10
taxable_base	100.00
iva_rate	21
iva_amount	21.00
notes	-
created_at	2026-04-01T09:00:00Z
updated_at	2026-04-01T09:00:00Z
bucket_event_ids	e0cd1c6d0c07c20521672f7d19db3f8a22429bba593e3b33876e52d429a53c13
2Confirm the removed evidence id is no longer addressable, regardless of other evidence already recorded on this page.
aeat --format json app ledger evidence view {evidence_id}
aeat --format json app ledger evidence view {evidence_id}
{
  "active_profile": "docs-sequence-sandbox",
  "command": "ledger.evidence.view",
  "error": {
    "action": {
      "action": null,
      "argument_bindings": [],
      "conditionality": "not_applicable",
      "evidence": [
        {
          "condition_id": "ledger.evidence.reference_resolves",
          "evidence_id": "ledger.evidence.reference_resolves.observation",
          "provenance": "application_state",
          "values": {
            "evidence_record_present": false
          }
        }
      ],
      "failed_condition_id": "ledger.evidence.reference_resolves",
      "missing_argument_names": [],
      "no_recovery_outcome": "operator_decision"
    },
    "category": "REFUSED",
    "code": "REFUSED_LEDGER_EVIDENCE_NOT_FOUND",
    "context": null,
    "message": "No purchase-invoice evidence exists with the identifier provided.",
    "retryable": false,
    "runbook_id": null,
    "trace_id": null
  },
  "notices": [],
  "schema_version": "2",
  "status": "error"
}

Confirm the evidence record no longer appears in the catalogue.

Az eltávolítás a bizonyítékrekordokra vonatkozik, nem a tranzakciókra. Magának a tranzakciósornak a javításához lásd: Javítsa ki a főkönyvi hibákat.

Miután kijavított egy sort

Ha tranzakciókat egyesít vagy oszt meg, ellenőrizze az új sorokat, és szükség szerint csatolja újra a bizonyítékokat. A sormódosításokat a Javítsa ki a főkönyvi hibákat oldal tárgyalja.

Hol jelenik meg a bizonyíték

A főkönyvi exportok minden tranzakcióhoz tartalmazzák a bizonyíték hivatkozását. A főkönyvből származó számítások végigviszik a bizonyítéknyomvonalat egészen a benyújtási termékekig.

Olvassa el az Importálás, export és bizonyíték oldalt, hogy megértse a különbséget a hozzákötött főkönyvi bizonyíték, egy AEAT-feltöltési fájl, a hivatalos benyújtási igazolás és egy auditcsomag között.

Hol kérhet segítséget

  • Ha egy parancs meghiúsul vagy elutasít egy műveletet, lásd: Hibaelhárítás.

  • Ha egy kifejezés ismeretlen, lásd a Szójegyzék oldalt.

  • Mielőtt bárkivel megosztaná egy parancs kimenetét, távolítsa el az adóazonosítókat, például a NIF-, CIF-, DNI-, NIE- vagy NII-számát.

Következő lépések