Listar cesiones
Obtiene las cesiones de facturas (AEC) de una entidad. Las cesiones son las transferencias de derechos de crédito de facturas a un cesionario (por ejemplo una empresa de factoring). Por defecto devuelve las cesiones EMITIDAS por la entidad (document_type=issued); con document_type=received devuelve las cesiones RECIBIDAS — facturas de sus proveedores que ellos cedieron a un tercero, útil para saber a quién pagarle en vez del proveedor original.
¿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 yreceiver_*al receptor, sin importar qué lado fijaste condocument_type— condocument_type=received,receiver_*será la propia entidad consultada ysupplier_*el proveedor.
Ejemplos de uso
- Mostrar en un panel todas las cesiones de una empresa (emitidas y recibidas).
- Consultar
document_type=receivedpara 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
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
ID de la entidad maestra. Su rol en las facturas cedidas (emisora o receptora) depende de document_type. Obligatorio.
123
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).
issued, received Fecha desde (YYYY-MM-DD) para filtrar por fecha de creación de la cesión.
Fecha hasta (YYYY-MM-DD) para filtrar por fecha de creación de la cesión.
Estado en el SII: processing, rejected o success.
processing, rejected, success Búsqueda en folio del documento, nombre o RUT del emisor, o razón social/RUT del cesionario.
Número de página (paginación).
Cantidad de resultados por página.
