Adjunta factures i rebuts a les transaccions del ledger

Desa un registre d’evidència per a cada factura o rebut i vincula’l a la transacció que justifica. Així, les comprovacions, les exportacions i les revisions de tancament d’exercici poden apuntar al document que hi ha darrere de cada xifra. L’evidència desada roman sota custòdia local xifrada. Les ordres de baixada de Google Drive accedeixen al teu compte autoritzat abans de desar localment els bytes descarregats.

Abans de començar

Necessites:

  • Un perfil de contribuent actiu. L’evidència es desa sota el perfil actiu; si no n’hi ha cap de definit, l’ordre es nega a continuar. Consulta Configura el teu perfil de contribuent.

  • Una contrasenya de clau mestra. L’eina la demana la primera vegada que obre el teu emmagatzematge xifrat dins d’una sessió.

  • Transaccions al teu ledger. Si el ledger és buit, consulta primer Importa i gestiona transaccions.

  • La factura o el rebut com a fitxer PDF o d’imatge. Cadrumo copia els bytes del fitxer a l’emmagatzematge xifrat juntament amb les dades que introdueixes, més una empremta del contingut i la ubicació original com a procedència. El teu fitxer original ja no torna a caldre després de add.

Afegeix un registre d’evidència

Registra el fitxer de la factura i les seves dades, i després consulta el registre desat. El camí del fitxer és l’única part obligatòria; totes les opcions de metadades són opcionals. --iva-rate 21 vol dir el 21 %:

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.

L’ordre imprimeix l’ID de l’evidència. Apunta l’ID complet: les ordres posteriors el necessiten. Afegeix ara el que sàpigues i actualitza la resta més tard.

El registre desat conserva el número de factura que vas escriure, però evidence add, view, list, update i remove només en mostren un resum breu (sha256: seguit de vuit caràcters hexadecimals), no el número mateix.

Vincula un registre d’evidència a una transacció

Adjunta el registre d’evidència a la transacció que justifica. La seqüència registra un fitxer d’evidència i una despesa, i tot seguit adjunta l’un a l’altre:

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.

Una transacció porta com a màxim un registre d’evidència de factura de compra. L’ordre en rebutja un segon i rebutja tornar a adjuntar el mateix.

No facis servir aeat app ledger link aquí. attach i link són operacions diferents sobre la mateixa transacció: attach incorpora el document d’evidència, mentre que link vincula la transacció a una factura i requereix --invoice-id. Aquest identificador prové d’una factura importada, conciliada o afegida manualment; l’identificador que imprimeix aeat app ledger invoice add és exactament el que has de passar.

Per a la majoria de rebuts i factures, --purchase-invoice-evidence-id de més amunt és l’opció que has d’utilitzar; l’id de l’evidència prové directament d”evidence add.

L’ordre attach també té una opció --attachment-id (repetible) per a un adjunt segur genèric que no té el rol de factura de compra. Espera l’identificador de contingut de 64 caràcters d’un blob que ja es trobi a l’emmagatzematge xifrat d’adjunts, i rebutja qualsevol identificador que no tingui cap blob desat (attachment_ids must reference existing secure attachment manifests and blobs). Actualment cap ordre de l’operador no imprimeix aquest identificador de 64 caràcters: l”evidence_id d”evidence add és un identificador diferent i més curt, i aquí no s’accepta. Fins que una ordre mostri l’identificador de l’adjunt, utilitza --purchase-invoice-evidence-id o evidence pull.

O bé baixa un document de Google Drive

Quan el document és a Google Drive, baixa’l directament a l’emmagatzematge xifrat d’evidències. Aquesta ordre accedeix a Google Drive, de manera que s’executa contra el teu propi compte autoritzat i no pas a l’entorn de proves de la documentació:

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

L’ordre descarrega el fitxer de Drive, en desa els bytes xifrats amb la transacció i conserva l’enllaç original com a procedència. L’evidència sempre porta el document mateix, mai un enllaç sol: es rebutgen els enllaços de Gmail, els URL arbitraris i els fitxers de Drive fora de l’abast concedit. Per a una font rebutjada, descarrega tu mateix el document i adjunta’l amb aeat app ledger evidence add o aeat app ledger attach --attachment-id.

Recupera de cop totes les factures d’una carpeta de Drive

Recupera alhora totes les factures en PDF i en imatge d’una carpeta de Drive, en lloc d’un document cada vegada. Igual que evidence pull, aquesta ordre accedeix a Google Drive i s’executa amb el teu propi compte autoritzat:

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

L’ordre llista el contingut de la carpeta, descarrega cada PDF o imatge i desa cada fitxer com a evidència xifrada. Els fitxers recuperats encara no queden vinculats a cap transacció; vincula cadascun després amb aeat app ledger attach --attachment-id <attachment-id>.

Torna a executar la mateixa ordre sempre que vulguis. Un fitxer que ja s’ha recuperat es reconeix pel seu contingut i no es desa dues vegades. Un fitxer fora de l’abast de Drive concedit es rebutja individualment i no atura la resta del recorregut; descarrega’l tu mateix i adjunta’l amb aeat app ledger attach --attachment-id.

La recuperació massiva des de Gmail encara no està disponible.

Els registres de factura són una funcionalitat a part

Un registre de factura -qui deu a qui, i per quin import- no és un document desat. Gestiona factures de negoci és qui gestiona els registres de factura: el registre de factures emeses i rebudes, el catàleg de conciliació i la vinculació d’una factura del catàleg amb la transacció que la liquida. Aquesta pàgina tracta dels documents -PDF i imatges- que deses com a evidència i vincules a transaccions.

Llista, consulta, actualitza i elimina registres d’evidència

Llista tots els registres desats, consulta’n un de complet, actualitza’n les dades i elimina el que ja no necessitis. La seqüència registra un fitxer d’evidència, el llista i l’inspecciona, canvia el proveïdor i confirma el canvi:

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.

Elimina un registre d’evidència que ja no necessitis, adreçant-t’hi per id:

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.

L’eliminació s’aplica als registres d’evidència, no a les transaccions. Per corregir la fila d’una transacció, consulta Corregeix errors al teu ledger.

Després de corregir una fila

Si fusiones o divideixes transaccions, revisa les files noves i torna a adjuntar l’evidència on calgui. Corregeix errors al teu ledger tracta els canvis de files.

On apareix l’evidència

Les exportacions del ledger inclouen l’enllaç de l’evidència amb cada transacció. Els càlculs derivats del ledger arrosseguen el rastre d’evidència fins als artefactes de presentació.

Llegeix Importació, exportació i evidència per entendre la diferència entre l’evidència del ledger vinculada, un fitxer de pujada a l’AEAT, la prova oficial de presentació i un paquet d’auditoria.

On demanar ajuda

  • Si una ordre falla o es nega a continuar, consulta Resolució de problemes.

  • Si algun terme no et resulta familiar, consulta el Glossari.

  • Abans de compartir la sortida d’una ordre amb ningú, elimina els identificadors tributaris com ara el teu NIF, CIF, DNI, NIE o NII.

Passos següents