Skip to main content
GET
/
cessions
Listar cesiones emitidas
curl --request GET \
  --url https://api.tupana.ai/v1/cessions \
  --header 'Authorization: <api-key>'
{
  "count": 123,
  "total_pages": 123,
  "results": [
    {
      "id": 123,
      "document_id": 123,
      "document_folio": "<string>",
      "document_date_issued": "2023-12-25",
      "document_amount": 123,
      "supplier_id": 123,
      "supplier_name": "<string>",
      "supplier_rut": "<string>",
      "receiver_id": 123,
      "receiver_name": "<string>",
      "receiver_rut": "<string>",
      "assignee_rut": "<string>",
      "assignee_business_name": "<string>",
      "assignee_entity_id": 123,
      "assignee_entity_name": "<string>",
      "assignee_entity_tax_id": "<string>",
      "assignment_amount": 123,
      "status": "processing",
      "status_message": "<string>",
      "source": "internal",
      "sii_date_sent": "2023-11-07T05:31:56Z",
      "aec_url": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

¿Para qué se usa?

Permite obtener todas las cesiones de facturas (AEC) emitidas por una entidad. Cada ítem representa una cesión registrada (en Tu Pana o por fuera en el SII) e incluye datos del documento cedido, del cesionario y del estado en el SII.

Qué hace

  • Devuelve una lista paginada de cesiones donde la entidad indicada es la emisora de las facturas cedidas.
  • Puedes filtrar por rango de fechas (date_from, date_to), estado (processing, rejected, success) y búsqueda en folio, emisor o cesionario.
  • El campo source indica si la cesión fue creada en Tu Pana (internal) o registrada por fuera (external).
  • Incluye assignee_entity_name cuando el cesionario está dado de alta como entidad en Tu Pana.

Ejemplos de uso

  • Mostrar en un panel todas las cesiones de una empresa.
  • Filtrar cesiones por estado para ver pendientes o rechazadas.
  • Integrar con sistemas de factoring que necesitan listar las facturas cedidas.

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)

Query Parameters

master_entity_id
integer
required

ID de la entidad maestra (emisora de las facturas cedidas). Obligatorio.

Example:

123

date_from
string<date>

Fecha desde (YYYY-MM-DD) para filtrar por fecha de creación de la cesión.

date_to
string<date>

Fecha hasta (YYYY-MM-DD) para filtrar por fecha de creación de la cesión.

status
enum<string>

Estado en el SII: processing, rejected o success.

Available options:
processing,
rejected,
success

Búsqueda en folio del documento, nombre o RUT del emisor, o razón social/RUT del cesionario.

page
integer
default:1

Número de página (paginación).

page_size
integer
default:25

Cantidad de resultados por página.

Response

Lista paginada de cesiones

count
integer

Total de resultados

total_pages
integer
results
object[]