Skip to main content
GET
/
documents
/
{document_id}
/
states
Consultar historial de estados de un documento
curl --request GET \
  --url https://api.tupana.ai/v1/documents/{document_id}/states \
  --header 'Authorization: <api-key>'
{
  "success": true,
  "document_id": 12345,
  "folio": "123",
  "states": [
    {
      "event_code": "ERM",
      "event_description": "Acuse de Recibo",
      "event_date": "2024-01-16T10:30:00Z",
      "responsable_rut": 12345678,
      "responsable_dv": "9",
      "rejected_by_user": "[email protected]",
      "accepted_by_user": "[email protected]"
    }
  ],
  "document": {
    "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"
  }
}

​
Qué hace

  • Devuelve todos los estados registrados para el documento
  • Permite entender qué eventos han ocurrido sobre ese documento
  • Muestra la secuencia cronológica de los estados
  • No modifica ninguna información

​
Ejemplos de uso

  • Revisar si un documento fue pagado
  • Ver si tuvo rechazos o acuses
  • Auditar cambios o eventos automáticos del SII
  • Mostrar el historial completo en el backoffice

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 (integer)

Response

Historial de estados obtenido exitosamente

​
success
boolean

Indica si la operación fue exitosa

Example:

true

​
document_id
integer

ID del documento

Example:

12345

​
folio
string

Folio del documento

Example:

"123"

​
states
object[]

Lista de estados registrados para el documento, ordenados cronológicamente (más reciente primero)

​
document
object