Skip to main content
GET
Obtener documento específico
Detalle línea a línea, totales y eventos de la traza SII.

Authorizations

Authorization
string
header
required

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

document_id
integer
required

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
integer

ID único del documento

folio
string | null

Número de folio del documento

date_issued
string<date>

Fecha de emisión del documento

amount_with_iva
number<float>

Monto total con IVA

dte_type_code
string

Código del tipo de DTE (ej: "33" para Factura Electrónica)

created_at
string<date-time>

Fecha de creación del registro (ISO 8601)

updated_at
string<date-time>

Fecha de última actualización (ISO 8601)

has_trace
boolean

true si el documento tiene al menos una traza registrada del SII.

latest_trace_info
object | null

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).

amount_iva
number<float> | null

Monto del IVA

amount_without_iva
number<float> | null

Monto sin IVA

currency
enum<string>

Moneda del documento

Available options:
CLP,
UF,
USD,
EUR
Example:

"CLP"

sender_id
integer

ID de la entidad emisora

sender_name
string

Nombre de la entidad emisora

sender_tax_id
string

RUT de la entidad emisora

receiver_id
string | null

ID de la entidad receptora (como string, puede ser null para algunos tipos de documentos)

receiver_name
string | null

Nombre de la entidad receptora

receiver_tax_id
string | null

RUT de la entidad receptora

has_credit_note
boolean

Indica si el documento tiene una nota de crédito asociada

is_paid
boolean

Indica si el documento está marcado como pagado

json_param
object | null

Parámetros JSON almacenados del documento

traces
object[]

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.

trace_update_log
object | null

Log de actualización de trazas

document_states
object[]

Array de estados del documento (rechazado, con NC, acuse, pagado, mérito ejecutivo)

vat_withheld
boolean | null

Indica si se retuvo IVA

exchange_rate
string | null

Tipo de cambio para facturas internacionales

original_amount
string | null

Monto original en moneda extranjera para facturas internacionales

state
string | null

Estado del documento (draft, issued, etc.)

dte_type_description
string

Descripción del tipo de DTE

pdf
string<uri> | null

URL presignada al PDF del documento (válida por tiempo limitado, generalmente 1 hora)

xml
string | null

Contenido completo del XML del documento tributario electrónico

xml_error
string | null

Mensaje de error si no se pudo obtener el XML (null si está disponible)

references
object[]

Array de documentos referenciados (para notas de crédito, etc.)

details
object[] | null

Array de productos/líneas del documento

header
object | null

Información del encabezado del documento (transacción, pago, etc.)

document_issuer
object | null

Información completa del emisor del documento

document_receiver
object | null

Información completa del receptor del documento