Artefactos, entrega y correcciones

Un artefacto disponible debe tener una referencia estable, tipo, revisión, digest y fecha de generación. Obtén el PDF oficial desde el endpoint autenticado, no reconstruyas bytes ni publiques la identidad del almacenamiento:

import { createTimbroPayments } from "@timbro/payments";

const secretKey = process.env.TIMBRO_PAYMENTS_SECRET_KEY;
if (!secretKey) throw new Error("Missing TIMBRO_PAYMENTS_SECRET_KEY");
const timbro = createTimbroPayments({ secretKey });
const artifact = await timbro.fiscalDocuments.retrievePrintedRepresentation("fiscal_document_123");
const pdf = artifact.bytes;

Entrega enlaces con alcance y expiración adecuados; no expongas archivos de otra compra y no registres el contenido del PDF en logs.

Las correcciones fiscales crean una relación auditable con el documento original. No edites silenciosamente un e-CF ya emitido ni presentes una vista corregida como si fuera el documento original.

Sólo una revisión rejected se corrige. Envía una nueva revisión con POST /v1/fiscal_documents/{fiscalDocumentId}/corrections y una clave de idempotencia; una revisión issued es terminal. Mantén la relación entre la revisión original y la nueva en tu sistema.