Skip to main content
GET
Listar cesiones (emitidas o recibidas)

¿Para qué se usa?

Permite obtener las cesiones de facturas (AEC) de una entidad, tanto las que emitió (facturas propias cedidas) como las que recibió (facturas de sus proveedores cedidas por ellos a un tercero). Cada ítem representa una cesión registrada (en Tupana 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 de la entidad indicada, filtradas según el parámetro document_type:
    • issued (default): cesiones donde la entidad es la emisora de la factura cedida.
    • received: cesiones donde la entidad es la receptora de la factura cedida — es decir, facturas de sus proveedores que ellos cedieron a un factoring. Útil para saber a quién pagarle en vez del proveedor original.
  • 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 Tupana (internal) o registrada por fuera (external).
  • Incluye assignee_entity_name cuando el cesionario está dado de alta como entidad en Tupana.
  • Los campos supplier_* siempre reflejan al emisor de la factura y receiver_* al receptor, sin importar qué lado fijaste con document_type — con document_type=received, receiver_* será la propia entidad consultada y supplier_* el proveedor.

Ejemplos de uso

  • Mostrar en un panel todas las cesiones de una empresa (emitidas y recibidas).
  • Consultar document_type=received para saber si algún proveedor cedió una factura pendiente de pago, y a quién pagarle.
  • 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. Su rol en las facturas cedidas (emisora o receptora) depende de document_type. Obligatorio.

Example:

123

document_type
enum<string>
default:issued

issued (default) = cesiones donde master_entity_id es la EMISORA de la factura cedida. received = cesiones donde master_entity_id es la RECEPTORA de la factura cedida (facturas de proveedores cedidas por ellos a un tercero).

Available options:
issued,
received
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[]