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",
  "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": [
    {}
  ],
  "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>",
  "has_trace": true,
  "latest_trace_info": {
    "status": "accepted",
    "timestamp": "2024-01-15T10:35:00Z",
    "description": "Documento aceptado por el SII"
  },
  "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": 123,
      "item_description": "<string>",
      "discount_percent": 123,
      "item_total": 123,
      "item_code": "<string>",
      "unit": "<string>",
      "other_tax": 123,
      "item_type_code": 123
    }
  ],
  "header": {
    "purchase_transaction_type": "<string>",
    "sale_transaction_type": "<string>",
    "payment_method": "1",
    "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

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)

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 de envío al SII

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)

has_trace
boolean

true si el documento tiene trazas de envío al SII, false en caso contrario

latest_trace_info
object

Información de la última traza disponible (estado de envío, fecha, etc.)

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