Obtener documento específico
Obtiene toda la información completa de un documento tributario específico, incluyendo:
- PDF y XML cuando están disponibles (el PDF siempre se incluye en la respuesta, campo
pdf_url) - Detalles (productos/líneas) del documento (campo
details) - Header completo con información de transacción, pago y tipo de compra (campo
header) - Información del emisor completa (campo
document_issuer) - Información del receptor completa (campo
document_receiver) - Referencias a otros documentos, como notas de crédito (campo
references)
Este endpoint es útil para consultar detalles completos de un documento ya emitido o recibido.
Seguridad: El usuario solo puede acceder al documento si es emisor (sender) o receptor (receiver) del documento. Si el usuario no tiene acceso, se retorna un error 403 Forbidden.
Qué hace
Obtiene toda la información completa de un documento tributario específico, incluyendo PDF, XML, productos, información del emisor y receptor, header, y referencias. Este endpoint es útil para consultar detalles completos de un documento ya emitido o recibido.Ejemplos de uso
- Consultar detalles completos de un documento ya emitido
- Descargar el PDF de un documento específico
- Obtener el XML para procesos de integración
- Verificar información de un documento recibido
- Auditar documentos antes de procesarlos
Trazabilidad SII
La respuesta incluye siempre el arraytraces con cada traza del documento en el SII y, dentro de cada una, la lista events con los eventos registrados (acuse de recibo, reclamos, notas de crédito asociadas, etc.). Revisa los schemas Trace y TraceEvent en la referencia para el detalle de cada campo.
A diferencia del endpoint de listado — donde estos eventos son opt-in vía include_trace_events=true — aquí no necesitas ningún flag adicional.Authorizations
API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)
Path Parameters
ID único del documento a consultar (entero)
Response
Documento obtenido exitosamente con toda la información completa: PDF, XML, detalles (productos), header, información del emisor y receptor, y referencias
ID único del documento
Número de folio del documento
Fecha de emisión del documento
Monto total con IVA
Código del tipo de DTE (ej: "33" para Factura Electrónica)
Fecha de creación del registro (ISO 8601)
Fecha de última actualización (ISO 8601)
true si el documento tiene al menos una traza registrada del SII.
Resumen liviano de la última traza del documento. Siempre se incluye en las respuestas de listado y detalle (es null cuando el documento no tiene trazas).
Monto del IVA
Monto sin IVA
Moneda del documento
CLP, UF, USD, EUR "CLP"
ID de la entidad emisora
Nombre de la entidad emisora
RUT de la entidad emisora
ID de la entidad receptora (como string, puede ser null para algunos tipos de documentos)
Nombre de la entidad receptora
RUT de la entidad receptora
Indica si el documento tiene una nota de crédito asociada
Indica si el documento está marcado como pagado
Parámetros JSON almacenados del documento
Array de trazas del documento en el SII, cada una con su lista de events. En el endpoint de detalle siempre se incluye; en el endpoint de listado solo se incluye cuando se pasa include_trace_events=true.
Log de actualización de trazas
Array de estados del documento (rechazado, con NC, acuse, pagado, mérito ejecutivo)
Indica si se retuvo IVA
Tipo de cambio para facturas internacionales
Monto original en moneda extranjera para facturas internacionales
Estado del documento (draft, issued, etc.)
Descripción del tipo de DTE
URL presignada al PDF del documento (válida por tiempo limitado, generalmente 1 hora)
Contenido completo del XML del documento tributario electrónico
Mensaje de error si no se pudo obtener el XML (null si está disponible)
Array de documentos referenciados (para notas de crédito, etc.)
Array de productos/líneas del documento
Información del encabezado del documento (transacción, pago, etc.)
Información completa del emisor del documento
Información completa del receptor del documento
