Skip to main content
GET
/
documents
/
{document_id}
Obtener documento específico
curl --request GET \
  --url https://api.tupana.ai/v1/documents/{document_id} \
  --header 'Authorization: <api-key>'
{
  "id": 123,
  "folio": "<string>",
  "date_issued": "2023-12-25",
  "amount_with_iva": 123,
  "dte_type_code": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "has_trace": true,
  "latest_trace_info": {
    "has_acknowledgments": true,
    "has_claims": true,
    "is_more_than_eight_days": true,
    "is_rejected": true,
    "date_reception": "2023-11-07T05:31:56Z",
    "events_count": 123
  },
  "amount_iva": 123,
  "amount_without_iva": 123,
  "currency": "CLP",
  "sender_id": 123,
  "sender_name": "<string>",
  "sender_tax_id": "<string>",
  "receiver_id": "<string>",
  "receiver_name": "<string>",
  "receiver_tax_id": "<string>",
  "has_credit_note": true,
  "is_paid": true,
  "json_param": {},
  "traces": [
    {
      "date_reception": "2023-11-07T05:31:56Z",
      "has_receiver_access": true,
      "has_issuer_access": true,
      "has_holder_access": true,
      "is_paid_cash": true,
      "has_claims": true,
      "is_more_than_eight_days": true,
      "has_acknowledgments": true,
      "has_guide_reference": true,
      "is_rejected": true,
      "days_until_executive_merit": 123,
      "events": [
        {
          "event_code": "ACD",
          "event_description": "Acepta Contenido del Documento",
          "event_date": "2023-11-07T05:31:56Z",
          "responsable_rut": 123,
          "responsable_dv": "<string>"
        }
      ]
    }
  ],
  "trace_update_log": {},
  "document_states": [
    {
      "label": "<string>",
      "description": "<string>",
      "state_type": "<string>"
    }
  ],
  "vat_withheld": true,
  "exchange_rate": "<string>",
  "original_amount": "<string>",
  "state": "<string>",
  "dte_type_description": "<string>",
  "pdf": "<string>",
  "xml": "<string>",
  "xml_error": "<string>",
  "references": [
    {
      "reference_folio": 123,
      "reference_date": "2023-12-25",
      "dte_type_code": "<string>",
      "reference_reason": "ANULA DOCUMENTO DE LA REFERENCIA"
    }
  ],
  "details": [
    {
      "item_name": "<string>",
      "quantity": 123,
      "unit_price": 1,
      "item_description": "<string>",
      "discount_percent": 123,
      "item_code": "<string>",
      "unit": "<string>",
      "other_tax": 123,
      "item_type_code": 123
    }
  ],
  "header": {
    "purchase_transaction_type": "<string>",
    "sale_transaction_type": "<string>",
    "due_date": "2023-12-25",
    "vat_withheld": false,
    "retention_type": "RETRECEPTOR",
    "purchase_type": "1"
  },
  "document_issuer": {
    "rut": "<string>",
    "business_name": "<string>",
    "phone_number": "<string>",
    "email": "<string>",
    "business_activity": "<string>",
    "activity_code": 123,
    "sii_branch_code": "<string>",
    "address": "<string>",
    "district": "<string>",
    "city": "<string>"
  },
  "document_receiver": {
    "rut": "<string>",
    "business_name": "<string>",
    "contact": "<string>",
    "business_activity": "<string>",
    "address": "<string>",
    "district": "<string>",
    "city": "<string>"
  }
}

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 array traces 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

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

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

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

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

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

document_issuer
object

Información completa del emisor del documento

document_receiver
object

Información completa del receptor del documento