> ## Documentation Index > Fetch the complete documentation index at: https://docs.pruff.com/llms.txt > Use this file to discover all available pages before exploring further. # Obtener resumen de cesiones > Devuelve un resumen de las cesiones de facturas que el cliente ha realizado como cedente en los últimos 24 meses (desde el primer día del mes de hace 23 meses, hora de Chile), según la información tributaria que Pruff tiene del cliente. Agrupa los montos por deudor (`dataPayers`), por empresa de factoring que recibió la cesión (`dataFactorings`), y entrega la asignación por factoring con desglose por deudor (`dataAssigned`, un elemento `payers` por RUT de deudor) y los totales por período. Los meses y `Last12Months` se agrupan por fecha de cesión, así que `Last12Months` coincide con la suma de los últimos 12 meses. Puedes filtrar por deudor y por empresa de factoring con los query params. Todos los montos están en pesos chilenos (CLP) y las proporciones van entre 0 y 1. Si el RUT no existe en Pruff, la respuesta es `200` con los períodos sin datos y `lastScrapedDate` en `null`. Si existe pero no tiene cesiones, los períodos vienen sin datos y `lastScrapedDate` indica la última actualización de su información tributaria. El ejemplo se recortó a unos pocos períodos. ## OpenAPI ````yaml openapi/clients.yaml GET /datahub/{identifier}/cessions/summary openapi: 3.1.0 info: title: API de clientes de Pruff version: '1' description: >- Endpoints que tus sistemas llaman para leer y operar los datos de tu empresa en Pruff. Todas las solicitudes van por HTTPS y se autentican con el header `x-api-key`. Las convenciones de formato, paginación y errores se describen en https://docs.pruff.com/api/introduccion. servers: - url: https://api.pruff.com/api/clients security: - ApiKeyAuth: [] tags: - name: Facturas description: Consulta de facturas electrónicas, facturas transables y cesiones. - name: Documentos description: Consulta y creación de documentos asociados a tus clientes. - name: Archivos description: Carga de archivos a operaciones y a los requerimientos de tus documentos. - name: Financiamiento description: >- Simula créditos, crea solicitudes de factoring y consulta las prórrogas de tu empresa. - name: Comité description: >- Consulta las aprobaciones de una solicitud en los comités de riesgo y de operaciones, y registra nuevas firmas. - name: Chat description: Exporta y envía mensajes del chat de una solicitud. - name: Reportes description: >- Reportes de operaciones, cartera, recaudaciones, cuentas pendientes y flujos de tu empresa. - name: Datahub description: >- Consulta de la información tributaria, financiera y de riesgo que Pruff tiene de tus clientes y deudores. - name: Mercado Público description: >- Licitaciones y órdenes de compra de Mercado Público (ChileCompra) cargadas en Pruff. - name: CRM description: >- Datos comerciales de tu CRM en Pruff: empresas con su ficha, pipeline, prospectos, gestiones y simulaciones. - name: SGR description: Operaciones SGR (garantías) de tu empresa. - name: Sincronizador description: >- Pide sincronizar a un cliente con el SII o la TGR para obtener su información más actualizada, y consulta el estado de esas sincronizaciones. - name: Usuarios description: >- Administra los usuarios de tu empresa en Pruff (crear, editar, eliminar, consultar su perfil y asignar subordinados) y consulta las cuentas (empresas conectadas) a las que cada usuario tiene acceso. - name: Contactos description: Crea contactos asociados a las empresas de tu cartera. paths: /datahub/{identifier}/cessions/summary: get: tags: - Datahub summary: Obtener resumen de cesiones description: >- Devuelve un resumen de las cesiones de facturas que el cliente ha realizado como cedente en los últimos 24 meses (desde el primer día del mes de hace 23 meses, hora de Chile), según la información tributaria que Pruff tiene del cliente. Agrupa los montos por deudor (`dataPayers`), por empresa de factoring que recibió la cesión (`dataFactorings`), y entrega la asignación por factoring con desglose por deudor (`dataAssigned`, un elemento `payers` por RUT de deudor) y los totales por período. Los meses y `Last12Months` se agrupan por fecha de cesión, así que `Last12Months` coincide con la suma de los últimos 12 meses. Puedes filtrar por deudor y por empresa de factoring con los query params. Todos los montos están en pesos chilenos (CLP) y las proporciones van entre 0 y 1. Si el RUT no existe en Pruff, la respuesta es `200` con los períodos sin datos y `lastScrapedDate` en `null`. Si existe pero no tiene cesiones, los períodos vienen sin datos y `lastScrapedDate` indica la última actualización de su información tributaria. El ejemplo se recortó a unos pocos períodos. operationId: getDatahubCessionsSummary parameters: - name: identifier in: path required: true description: >- RUT del cliente, sin puntos, con guion y con la K del dígito verificador en mayúscula. schema: type: string example: 76111111-6 example: 76111111-6 - name: payerIdentifier in: query required: false description: >- RUT del deudor por el que quieres filtrar. Si lo omites o lo envías vacío, no se filtra por deudor. schema: type: string example: 76222222-1 - name: cessionaryIdentifier in: query required: false description: >- RUT de la empresa de factoring (cesionario) por la que quieres filtrar. Si lo omites o lo envías vacío, no se filtra. schema: type: string example: 77222222-K responses: '200': description: Resumen de cesiones del cliente. content: application/json: schema: $ref: '#/components/schemas/DatahubCessionsSummaryResponse' example: dataPayers: Last24Months: - identifier: 76222222-1 name: Deudor Ejemplo SpA amount: 45000000 cancelPercentage: 0 cancelAmount: 0 creditNotePercentage: 0.04 creditNoteAmount: 1800000 Last12Months: - identifier: 76222222-1 name: Deudor Ejemplo SpA amount: 30000000 cancelPercentage: 0 cancelAmount: 0 creditNotePercentage: 0.06 creditNoteAmount: 1800000 September-2026: - identifier: 76222222-1 name: Deudor Ejemplo SpA amount: 12000000 cancelPercentage: 0 cancelAmount: 0 creditNotePercentage: 0 creditNoteAmount: 0 August-2026: [] dataFactorings: Last24Months: - identifier: 77222222-K name: Factoring Ejemplo SpA amount: 45000000 cancelPercentage: 0 cancelAmount: 0 creditNotePercentage: 0.04 creditNoteAmount: 1800000 payersData: - identifier: 76222222-1 amount: 45000000 cancelAmount: 0 creditNoteAmount: 1800000 Last12Months: - identifier: 77222222-K name: Factoring Ejemplo SpA amount: 30000000 cancelPercentage: 0 cancelAmount: 0 creditNotePercentage: 0.06 creditNoteAmount: 1800000 payersData: - identifier: 76222222-1 amount: 30000000 cancelAmount: 0 creditNoteAmount: 1800000 September-2026: - identifier: 77222222-K name: Factoring Ejemplo SpA amount: 12000000 cancelPercentage: 0 cancelAmount: 0 creditNotePercentage: 0 creditNoteAmount: 0 payersData: - identifier: 76222222-1 amount: 12000000 cancelAmount: 0 creditNoteAmount: 0 August-2026: [] dataAssigned: - factoring: Factoring Ejemplo SpA factoringIdentifier: 77222222-K total: 45000000 payers: - identifier: 76222222-1 name: Deudor Ejemplo SpA amount: 45000000 totalsCedded: Last24Months: 45000000 Last12Months: 30000000 September-2026: 12000000 August-2026: 0 totalsCancelAmount: Last24Months: 0 Last12Months: 0 September-2026: 0 August-2026: 0 totalsCreditNoteAmount: Last24Months: 1800000 Last12Months: 1800000 September-2026: 0 August-2026: 0 lastScrapedDate: '2026-11-03T18:58:53.284Z' '400': description: >- Un query param tiene un formato inválido, por ejemplo repetido más de una vez. content: application/json: schema: $ref: '#/components/schemas/ValidationError' example: message: invalid_type displayMessage: 'Invalid input: expected string, received array' data: errors: - path: payerIdentifier message: 'Invalid input: expected string, received array' code: invalid_type '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' '504': $ref: '#/components/responses/Timeout' components: schemas: DatahubCessionsSummaryResponse: type: object required: - dataPayers - dataFactorings - dataAssigned - totalsCedded - totalsCancelAmount - totalsCreditNoteAmount - lastScrapedDate properties: dataPayers: type: object description: >- Monto cedido agrupado por deudor y período. Las claves son períodos: `Last24Months`, `Last12Months` y un mes calendario por cada uno de los últimos 24 meses, incluido el actual, con el formato `Mes-Año` en inglés (por ejemplo `October-2026`). Los períodos sin datos vienen con un arreglo vacío. En `Last12Months` pueden venir deudores con montos en `0`. El ejemplo omite la mayoría de los meses. additionalProperties: type: array items: $ref: '#/components/schemas/DatahubCessionsPayerEntry' dataFactorings: type: object description: >- Monto cedido agrupado por empresa de factoring (cesionario) y período, con desglose por deudor. Las claves son períodos: `Last24Months`, `Last12Months` y un mes calendario por cada uno de los últimos 24 meses, incluido el actual, con el formato `Mes-Año` en inglés (por ejemplo `October-2026`). Los períodos sin datos vienen con un arreglo vacío. En `Last12Months` pueden venir cesionarios con montos en `0`. El ejemplo omite la mayoría de los meses. additionalProperties: type: array items: $ref: '#/components/schemas/DatahubCessionsFactoringEntry' dataAssigned: type: array description: >- Asignación por empresa de factoring con desglose por deudor (`payers`), para los últimos 24 meses. items: $ref: '#/components/schemas/DatahubCessionsAssignedItem' totalsCedded: allOf: - $ref: '#/components/schemas/DatahubCessionsTotals' description: >- Monto total cedido por período, en CLP. Las claves son períodos: `Last24Months`, `Last12Months` y un mes calendario por cada uno de los últimos 24 meses, incluido el actual, con el formato `Mes-Año` en inglés (por ejemplo `October-2026`). Los períodos sin datos vienen con `0`. El ejemplo omite la mayoría de los meses. totalsCancelAmount: allOf: - $ref: '#/components/schemas/DatahubCessionsTotals' description: >- Monto total de facturas cedidas anuladas o rechazadas por período, en CLP. Las claves son períodos: `Last24Months`, `Last12Months` y un mes calendario por cada uno de los últimos 24 meses, incluido el actual, con el formato `Mes-Año` en inglés (por ejemplo `October-2026`). Los períodos sin datos vienen con `0`. El ejemplo omite la mayoría de los meses. totalsCreditNoteAmount: allOf: - $ref: '#/components/schemas/DatahubCessionsTotals' description: >- Monto total de notas de crédito asociadas a facturas cedidas por período, en CLP. Las claves son períodos: `Last24Months`, `Last12Months` y un mes calendario por cada uno de los últimos 24 meses, incluido el actual, con el formato `Mes-Año` en inglés (por ejemplo `October-2026`). Los períodos sin datos vienen con `0`. El ejemplo omite la mayoría de los meses. lastScrapedDate: type: - string - 'null' format: date-time description: >- Fecha y hora de la última vez que Pruff actualizó la información tributaria del cliente, en ISO 8601. `null` si nunca se ha actualizado o el RUT no existe. ValidationError: type: object required: - message - displayMessage - data description: Error de validación del body, de los query params o de los path params. properties: message: type: string description: >- Código del primer error de validación (por ejemplo `custom`, `invalid_type`, `invalid_format`, `invalid_value`, `invalid_union`). displayMessage: type: string description: >- Mensaje del primer error de validación, pensado para mostrarlo a una persona. Normalmente en español; algunos mensajes de validación vienen en inglés. data: type: object required: - errors properties: errors: type: array description: Todos los errores de validación encontrados. items: type: object required: - path - message - code properties: path: type: string description: >- Campo con el error. Para listas incluye la posición, por ejemplo `types.0`. `(root)` si el error es del body completo. message: type: string description: Descripción del error en español. code: type: string description: Código del tipo de error. DatahubCessionsPayerEntry: type: object required: - identifier - name - amount - cancelPercentage - cancelAmount - creditNotePercentage - creditNoteAmount properties: identifier: type: string description: RUT del deudor. example: 76222222-1 name: type: string description: Razón social del deudor. Texto vacío si Pruff no la conoce. example: Deudor Ejemplo SpA amount: type: number description: Monto total cedido de facturas de este deudor en el período, en CLP. cancelPercentage: type: number description: >- Proporción (entre 0 y 1, no porcentaje) del monto cedido que corresponde a facturas anuladas o rechazadas. cancelAmount: type: number description: >- Monto de las facturas cedidas que están anuladas o rechazadas, en CLP. creditNotePercentage: type: number description: >- Proporción (entre 0 y 1) del monto cedido que corresponde a notas de crédito asociadas. creditNoteAmount: type: number description: Monto de notas de crédito asociadas a las facturas cedidas, en CLP. DatahubCessionsFactoringEntry: type: object required: - identifier - name - amount - cancelPercentage - cancelAmount - creditNotePercentage - creditNoteAmount - payersData properties: identifier: type: string description: RUT de la empresa de factoring que recibió la cesión (cesionario). example: 77222222-K name: type: string description: Razón social del cesionario. Texto vacío si Pruff no la conoce. example: Factoring Ejemplo SpA amount: type: number description: Monto total cedido a esta empresa en el período, en CLP. cancelPercentage: type: number description: >- Proporción (entre 0 y 1) del monto cedido que corresponde a facturas anuladas o rechazadas. cancelAmount: type: number description: Monto de facturas anuladas o rechazadas, en CLP. creditNotePercentage: type: number description: >- Proporción (entre 0 y 1) del monto cedido que corresponde a notas de crédito asociadas. creditNoteAmount: type: number description: Monto de notas de crédito asociadas, en CLP. payersData: type: array description: Desglose del monto por deudor. items: $ref: '#/components/schemas/DatahubCessionsFactoringPayerEntry' DatahubCessionsAssignedItem: type: object required: - factoring - factoringIdentifier - total - payers description: >- Monto cedido a una empresa de factoring en los últimos 24 meses, desglosado por deudor en `payers`. Cada deudor se identifica por su RUT, así que dos deudores con la misma razón social llegan como elementos distintos. properties: factoring: type: string description: Razón social de la empresa de factoring. example: Factoring Ejemplo SpA factoringIdentifier: type: string description: RUT de la empresa de factoring. example: 77222222-K total: type: number description: >- Monto total cedido a esa empresa, en CLP. Es la suma de los montos de `payers`. payers: type: array description: >- Monto cedido a esa empresa por cada deudor, en CLP, ordenado de mayor a menor `amount`. items: $ref: '#/components/schemas/DatahubCessionsAssignedPayer' DatahubCessionsTotals: type: object description: >- Total por período, en CLP. Las claves son períodos: `Last24Months`, `Last12Months` y un mes calendario por cada uno de los últimos 24 meses, incluido el actual, con el formato `Mes-Año` en inglés (por ejemplo `October-2026`). Los períodos sin datos vienen con `0`. El ejemplo omite la mayoría de los meses. additionalProperties: type: number description: Total del período, en CLP. Error: type: object required: - message properties: message: type: string description: >- Identifica el error. En algunos casos es un texto en inglés con valores variables. Para tu lógica, usa el código HTTP y, cuando exista, `data.code`. displayMessage: type: string description: >- Mensaje pensado para mostrarlo a una persona. Normalmente en español; algunos mensajes de validación vienen en inglés. data: description: Detalle adicional del error, cuando existe. DatahubCessionsFactoringPayerEntry: type: object required: - identifier - amount - cancelAmount - creditNoteAmount properties: identifier: type: string description: RUT del deudor. example: 76222222-1 amount: type: number description: >- Monto cedido a esta empresa de factoring, de facturas de este deudor, en CLP. cancelAmount: type: number description: Monto de facturas anuladas o rechazadas, en CLP. creditNoteAmount: type: number description: Monto de notas de crédito asociadas, en CLP. DatahubCessionsAssignedPayer: type: object required: - identifier - name - amount properties: identifier: type: string description: RUT del deudor. example: 76222222-1 name: type: string description: Razón social del deudor. Texto vacío si Pruff no la conoce. example: Deudor Ejemplo SpA amount: type: number description: Monto cedido por este deudor a la empresa de factoring, en CLP. example: 45000000 responses: Unauthorized: description: >- Falta el header `x-api-key`, su valor no es válido o la cuenta de API de tu empresa no está habilitada. content: application/json: schema: type: object required: - message properties: message: type: string example: message: 'Unauthorized: Invalid API Key' TooManyRequests: description: >- Tu empresa superó el límite de solicitudes. Todas las API keys de tu empresa comparten el mismo límite. Espera los segundos que indica el header `Retry-After` (o `data.retryAfterSeconds`) antes de reintentar. headers: Retry-After: description: Segundos que debes esperar antes de reintentar. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: message: >- Rate limit exceeded: 501 requests in the current 60s window, limit is 500. Retry in 12s. displayMessage: >- Superaste el límite de 500 solicitudes cada 60 segundos. Vuelve a intentarlo en 12 segundos. data: code: RATE_LIMIT_EXCEEDED scope: All API keys of your company share this budget. limit: 500 used: 501 windowSeconds: 60 retryAfterSeconds: 12 resetAt: '2026-11-04T15:00:12.000Z' hint: >- Wait until resetAt (or honor the Retry-After header) before retrying. Avoid repeating identical requests: reuse responses you already fetched, use filters and larger pageSize values instead of one request per item, and cap your client concurrency. InternalError: description: >- Error inesperado en Pruff. El texto de `message` puede variar (por ejemplo en mayúsculas); no dependas de él. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Internal server error Timeout: description: >- La solicitud superó el tiempo máximo de 55 segundos. La operación puede haberse completado igual: antes de reintentar una solicitud que crea o modifica datos, verifica su estado. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: request_timeout displayMessage: La solicitud excedió el tiempo máximo permitido securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key que Pruff entrega a tu empresa. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.