Skip to main content
GET
/
cessions
/
{id}
Obtener una cesión
curl --request GET \
  --url https://api.tupana.ai/v1/cessions/{id} \
  --header 'Authorization: <api-key>'
{
  "id": 123,
  "document_id": 123,
  "document_folio": "<string>",
  "status": "<string>",
  "source": "<string>",
  "assignee_business_name": "<string>",
  "assignment_amount": 123,
  "events": [
    {
      "id": 123,
      "event_code": "<string>",
      "event_description": "<string>",
      "event_date": "2023-11-07T05:31:56Z"
    }
  ],
  "errors": [
    {}
  ]
}

​
¿Para qué se usa?

Sirve para consultar el detalle de una cesión por ID y, opcionalmente, obtener el certificado de cesión (PDF) del SII mediante una URL presignada en S3.

​
Qué hace

  • Sin parámetros (GET /cessions/{id}): devuelve el detalle completo en JSON (documento, cesionario, monto, estado, eventos de trazabilidad y errores si existen).
  • Con ?pdf=document-cession (GET /cessions/{id}?pdf=document-cession): responde con una redirección (302) a la URL presignada del PDF del certificado de cesión almacenado en S3. El certificado es el que emite el SII para esa cesión.
El certificado se obtiene o se genera (scraping) la primera vez que se solicita y se guarda en S3; las siguientes veces se sirve la URL presignada del archivo ya almacenado.

​
Ejemplos de uso

  • Ver en tu sistema el detalle y la trazabilidad de una cesión.
  • Ofrecer un botón “Descargar certificado” que abra o descargue el PDF usando la URL a la que redirige el endpoint con pdf=document-cession.

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

​
id
integer
required

ID de la cesión

Query Parameters

​
pdf
enum<string>

Si se envía el valor document-cession, la API redirige a la URL presignada de S3 del certificado de cesión (PDF). Útil para descargar o mostrar el certificado.

Available options:
document-cession

Response

Detalle de la cesión (JSON). Incluye eventos de trazabilidad y errores si existen.

Objeto cesión con todos los campos del listado más events y errors

​
id
integer
​
document_id
integer
​
document_folio
string
​
status
string
​
source
string
​
assignee_business_name
string
​
assignment_amount
number
​
events
object[]
​
errors
object[]