Pregunta de dónde salió el archivo
En un proceso de compras puedes recibir un XML, un PDF adjunto o una imagen. No tienen el mismo grado de estructura ni la misma procedencia. Mantén el archivo recibido, su origen y la relación con la compra; no sustituyas el original por una extracción de texto sin dejar constancia.
Ejemplo: un PDF permite leer seis bolsas de un producto, pero el dato extraído debe revisarse junto a su unidad y presentación. «6» no basta para saber si son seis kilos, seis bolsas de veinticinco kilos o seis cajas. El OCR ayuda a leer; la homologación resuelve qué significa ese dato en tu catálogo.
Qué entrega la API de Ruka
El endpoint de documentos permite pedir el XML almacenado, su conversión a JSON o una representación PDF generada por Ruka. Consulta por folio, tipo DTE y RUT emisor; cuando una identidad coincide en varias empresas receptoras, company_id permite desambiguar.
La respuesta JSON del documento conserva etiquetas del XML y valores de texto. No es el mismo contrato que el libro de compras. Los cambios de clasificación y la información operativa de Ruka se consultan en el libro, no se deben buscar necesariamente dentro del XML original.
Un archivo faltante no equivale a una factura inexistente
La referencia contempla XML no disponible y PDF temporalmente no disponible como situaciones distintas. El PDF puede generarse con datos guardados aunque falte el XML. No lo presentes como recuperación del archivo original ni como certificación fiscal.
En tu integración, diferencia permiso insuficiente, documento fuera de alcance, identidad ambigua y un error transitorio de generación. Reintentar indefinidamente cualquier 404 no resuelve una falta de autorización o de archivo.
Guarda evidencia sin duplicar información sensible
Conserva identidad, tipo de representación, fecha de obtención y referencia de almacenamiento. Limita quién puede descargar documentos y evita ponerlos en URLs públicas. Para ejemplos, capturas y pruebas utiliza documentos ficticios identificados como tales.
Ni leer un PDF ni recibir un XML acredita que la mercadería llegó, que un usuario revisó la compra o que se informó un evento al SII. Son comprobaciones separadas. Diseña la integración para mostrar qué sabe y qué no sabe de cada una.
Fuentes y alcance
Contrastado con las fuentes enlazadas el 26 de octubre de 2026. Los ejemplos son ilustrativos. Esta guía orienta la revisión del proceso; no determina el tratamiento tributario de una operación particular ni ejecuta trámites ante el SII.
- Ruka: contrato de documentos JSON, XML y PDF (abre otra pestaña)
- Ruka: libro de compras (abre otra pestaña)
- SII: acuse de recibo (abre otra pestaña)
Fecha de la fuente: 25 de junio de 2025