TimbreArtefactos
El XML firmado, la respuesta de Hacienda, el PDF y cómo verificarlos.
Todo lo que Timbre produjo por el camino queda descargable. Los tres XML no son copias regeneradas: son exactamente los bytes que se firmaron y se presentaron. La representación en PDF es otra cosa — se dibuja a partir de esos mismos datos congelados, se guarda una sola vez y no se vuelve a generar, pero no es el documento legal.
El panel también los ofrece: cada documento en Facturas trae sus descargas —los tres XML siempre, el PDF cuando existe— sin que tengas que armar la petición. Lo de abajo es para bajarlos por código.
curl https://api.timbre.cr/internal/v1/invoices/{id}/artifacts/signed_xml \
-H "Authorization: Bearer timbre_sk_…"Los cuatro
| Artefacto | Qué es |
|---|---|
generated_xml | El XML de la factura, antes de firmar |
signed_xml | El XML firmado con XAdES que se presentó |
hacienda_response_xml | La respuesta firmada de Hacienda |
representation_pdf | La representación impresa, solo aceptadas |
El tercero es el que probás ante un tercero: no es lo que Timbre dice que pasó, es lo que Hacienda firmó.
Verificables por hash
La descarga trae un ETag que es el SHA-256 del contenido. Si guardás el
artefacto en tu lado, podés comprobar años después que el archivo que tenés es
el mismo que se presentó.
El documento legal es el XML firmado. representation_pdf es una vista de ese
XML — lo que lee quien recibe la factura — y solo existe para comprobantes
aceptados: un documento rechazado no produce ninguno. Se descarga por la misma
ruta que los otros tres y llega como application/pdf. El logo, el color y
los datos de contacto que aparecen en él se configuran en el panel.