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": [
    {}
  ],
  "certificate_pdf_url": "<string>"
}

​
Para que se usa?

Sirve para consultar el detalle de una cesion por ID, incluyendo la URL del certificado de cesion (PDF) del SII.

​
Que hace

Devuelve el detalle completo en JSON: documento, cesionario, monto, estado, eventos de trazabilidad, errores y certificate_pdf_url.

​
Campo certificate_pdf_url

La respuesta JSON incluye el campo certificate_pdf_url con la URL presignada del certificado de cesion (PDF) en S3/CDN. Tupana descarga automaticamente los certificados al scrapear las cesiones del SII.

​
Ejemplos de uso

  • Ver en tu sistema el detalle y la trazabilidad de una cesion.
  • Ofrecer un boton “Descargar certificado” que abra directamente certificate_pdf_url.

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

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[]
​
certificate_pdf_url
string<uri> | null

URL presignada del certificado de cesión (PDF) en S3/CDN. Tupana descarga automáticamente los certificados al scrapear cesiones.