> ## 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 facturas

> Lista las facturas electrónicas (DTE) registradas en Pruff a las que tiene acceso tu empresa, de forma paginada y ordenada por fecha de emisión descendente (las más recientes primero) y, si dos facturas tienen la misma fecha, por `id` descendente. El orden es estable: al recorrer todas las páginas ninguna factura se repite ni se pierde.

Todos los filtros son opcionales y se combinan entre sí: una factura debe cumplir todos los que envíes. Los filtros de texto (`businessName`, `folio`) buscan coincidencia exacta.

Cada factura incluye su estado, el monto de sus notas de crédito y de débito, el detalle de las notas de crédito y el historial de cesiones. Una nota de crédito recién emitida puede tardar en aparecer hasta que Pruff la asocia a su factura.

El valor de `status` se calcula así, en este orden: si la factura tiene cesiones, es `Transable` cuando la última cesión la devolvió al emisor y `Cedida` en cualquier otro caso; si no tiene cesiones, es `Reclamada` si fue reclamada, `Nota de crédito` si la suma de sus notas de crédito, descontadas las notas de débito que las anulan, es exactamente igual al monto, `Pago al contado` si se pagó al contado y `Transable` en cualquier otro caso.



## OpenAPI

````yaml openapi/clients.yaml GET /invoices
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:
  /invoices:
    get:
      tags:
        - Facturas
      summary: Obtener facturas
      description: >-
        Lista las facturas electrónicas (DTE) registradas en Pruff a las que
        tiene acceso tu empresa, de forma paginada y ordenada por fecha de
        emisión descendente (las más recientes primero) y, si dos facturas
        tienen la misma fecha, por `id` descendente. El orden es estable: al
        recorrer todas las páginas ninguna factura se repite ni se pierde.


        Todos los filtros son opcionales y se combinan entre sí: una factura
        debe cumplir todos los que envíes. Los filtros de texto (`businessName`,
        `folio`) buscan coincidencia exacta.


        Cada factura incluye su estado, el monto de sus notas de crédito y de
        débito, el detalle de las notas de crédito y el historial de cesiones.
        Una nota de crédito recién emitida puede tardar en aparecer hasta que
        Pruff la asocia a su factura.


        El valor de `status` se calcula así, en este orden: si la factura tiene
        cesiones, es `Transable` cuando la última cesión la devolvió al emisor y
        `Cedida` en cualquier otro caso; si no tiene cesiones, es `Reclamada` si
        fue reclamada, `Nota de crédito` si la suma de sus notas de crédito,
        descontadas las notas de débito que las anulan, es exactamente igual al
        monto, `Pago al contado` si se pagó al contado y `Transable` en
        cualquier otro caso.
      operationId: getInvoices
      parameters:
        - name: page
          in: query
          required: false
          description: Número de página, desde 1.
          schema:
            type: integer
            minimum: 1
            default: 1
          example: 1
        - name: pageSize
          in: query
          required: false
          description: Cantidad de facturas por página. Máximo 500.
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 10
          example: 50
        - name: businessIdentifier
          in: query
          required: false
          description: >-
            RUT del emisor de la factura, sin puntos y con guion. Solo trae las
            facturas que ese RUT emitió, no las que recibió. Para las que
            recibió, usa `stakeholderIdentifier`. Si el RUT no tiene facturas
            registradas, la respuesta es una página vacía.
          schema:
            type: string
          example: 76111111-6
        - name: stakeholderIdentifier
          in: query
          required: false
          description: RUT del receptor de la factura (el deudor), sin puntos y con guion.
          schema:
            type: string
          example: 96111111-0
        - name: startDate
          in: query
          required: false
          description: >-
            Fecha de emisión desde la cual quieres facturas (inclusive). Fecha
            ISO 8601; si envías solo la fecha se interpreta a las 00:00 UTC.
          schema:
            type: string
          example: '2025-01-01'
        - name: endDate
          in: query
          required: false
          description: >-
            Fecha de emisión hasta la cual quieres facturas (inclusive). Fecha
            ISO 8601; si envías solo la fecha, se compara contra las 00:00 UTC
            de ese día.
          schema:
            type: string
          example: '2025-01-31'
        - name: businessName
          in: query
          required: false
          description: Nombre exacto del emisor de la factura, tal como figura en Pruff.
          schema:
            type: string
          example: Cliente Ejemplo SpA
        - name: folio
          in: query
          required: false
          description: Folio exacto de la factura.
          schema:
            type: string
          example: '1333'
        - name: code
          in: query
          required: false
          description: >-
            Tipo de DTE de la factura. `33` es factura afecta, `34` es factura
            exenta y `46` es factura de compra.
          schema:
            type: string
            enum:
              - '33'
              - '34'
              - '46'
          example: '33'
      responses:
        '200':
          description: Página de facturas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvoiceListResponse'
              example:
                data:
                  - id: 3f2b8a3e-5d1c-4c7e-9a52-0d6f1c2b7a10
                    businessIdentifier: 76111111-6
                    stakeholderIdentifier: 96111111-0
                    businessName: Cliente Ejemplo SpA
                    stakeholderName: Pagador Ejemplo SpA
                    paymentType: null
                    issuedDate: '2024-11-15T00:00:00.000Z'
                    receiptDate: '2024-11-16T00:00:00.000Z'
                    amount: 4123123
                    status: Transable
                    issuer: true
                    code: '33'
                    folio: '1333'
                    creditNoteAmount: 250000
                    debitNoteAmount: 0
                    creditNotes:
                      - folio: '1201'
                        code: '61'
                        issuedDate: '2024-11-20'
                        amount: 250000
                    cessionary: '--'
                    cessionaries: []
                    lastCessionDate: null
                    confirmDate: '2024-11-18T00:00:00.000Z'
                    cancelDate: null
                    enforceableTitle: true
                    currency: CLP
                  - id: 9c1d7e42-6b0a-4f3d-8e15-2a4b9d6c3f21
                    businessIdentifier: 76111111-6
                    stakeholderIdentifier: 96111111-0
                    businessName: Cliente Ejemplo SpA
                    stakeholderName: Pagador Ejemplo SpA
                    paymentType: null
                    issuedDate: '2024-11-10T00:00:00.000Z'
                    receiptDate: '2024-11-11T00:00:00.000Z'
                    amount: 3748500
                    status: Cedida
                    issuer: true
                    code: '33'
                    folio: '3213'
                    creditNoteAmount: 0
                    debitNoteAmount: 0
                    creditNotes: []
                    cessionary: Factoring Ejemplo SpA
                    cessionaries:
                      - giver: Cliente Ejemplo SpA
                        giverIdentifier: 76111111-6
                        cessionary: Factoring Ejemplo SpA
                        cessionaryIdentifier: 77222222-K
                        cessionDate: '2024-11-12T15:36:00.000Z'
                    lastCessionDate: '2024-11-12T15:36:00.000Z'
                    confirmDate: null
                    cancelDate: null
                    enforceableTitle: true
                    currency: CLP
                pagination:
                  total: 24
                  page: 1
                  pageSize: 2
                  totalPages: 12
        '400':
          description: >-
            Algún query param no cumple el formato esperado. `displayMessage`
            describe el primer error y `data.errors` los lista todos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
              examples:
                invalidCode:
                  summary: Tipo de DTE no permitido
                  value:
                    message: invalid_value
                    displayMessage: code must be one of 33, 34, 46
                    data:
                      errors:
                        - path: code
                          message: code must be one of 33, 34, 46
                          code: invalid_value
                pageSizeTooBig:
                  summary: pageSize sobre el máximo
                  value:
                    message: too_big
                    displayMessage: pageSize must be less or equal to 500
                    data:
                      errors:
                        - path: pageSize
                          message: pageSize must be less or equal to 500
                          code: too_big
                invalidDate:
                  summary: Fecha no válida
                  value:
                    message: custom
                    displayMessage: Invalid date string
                    data:
                      errors:
                        - path: startDate
                          message: Invalid date string
                          code: custom
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalError'
        '504':
          $ref: '#/components/responses/Timeout'
components:
  schemas:
    InvoiceListResponse:
      type: object
      required:
        - data
        - pagination
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/InvoiceListItem'
        pagination:
          $ref: '#/components/schemas/Pagination'
    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.
    InvoiceListItem:
      type: object
      description: Factura electrónica con su estado, notas de crédito y cesiones.
      required:
        - id
        - folio
        - code
        - businessIdentifier
        - businessName
        - stakeholderIdentifier
        - stakeholderName
        - issuedDate
        - receiptDate
        - amount
        - status
        - issuer
        - creditNoteAmount
        - debitNoteAmount
        - creditNotes
        - cessionary
        - cessionaries
        - lastCessionDate
        - confirmDate
        - cancelDate
        - enforceableTitle
        - currency
      properties:
        id:
          type: string
          format: uuid
          description: Identificador único de la factura.
          example: 3f2b8a3e-5d1c-4c7e-9a52-0d6f1c2b7a10
        businessIdentifier:
          type: string
          description: RUT del emisor de la factura.
          example: 76111111-6
        businessName:
          type: string
          description: Nombre del emisor de la factura.
          example: Cliente Ejemplo SpA
        stakeholderIdentifier:
          type: string
          description: RUT del receptor de la factura (el deudor).
          example: 96111111-0
        stakeholderName:
          type: string
          description: Nombre del receptor de la factura.
          example: Pagador Ejemplo SpA
        paymentType:
          type:
            - string
            - 'null'
          description: >-
            Forma de pago informada en la factura. Los valores conocidos son `P`
            (pago al contado), `C` y `A`. Es null si la factura no la informa.
          example: null
        issuedDate:
          type: string
          format: date-time
          description: Fecha de emisión de la factura, en formato ISO 8601 (UTC).
          example: '2024-11-15T00:00:00.000Z'
        receiptDate:
          type: string
          format: date-time
          description: >-
            Fecha de recepción de la factura. Si Pruff no la conoce, es igual a
            `issuedDate`.
          example: '2024-11-16T00:00:00.000Z'
        amount:
          type: integer
          description: Monto total de la factura, en CLP.
          example: 4123123
        status:
          type: string
          enum:
            - Transable
            - Cedida
            - Reclamada
            - Nota de crédito
            - Pago al contado
          description: >-
            Estado de la factura. Las reglas para calcularlo están en la
            descripción del endpoint. No tiene el mismo significado que
            `invoiceStatus` en **Obtener cesiones**.
          example: Transable
        issuer:
          type: boolean
          description: >-
            Indica de qué registro del SII obtuvo Pruff la factura, `true` si
            vino del registro de ventas del emisor y `false` si vino del
            registro de compras del receptor. No indica quién la emitió. El
            emisor siempre es `businessIdentifier` y el receptor siempre es
            `stakeholderIdentifier`.
          example: true
        code:
          type: string
          description: >-
            Tipo de DTE de la factura, por ejemplo `33` (afecta), `34` (exenta)
            o `46` (de compra).
          example: '33'
        folio:
          type: string
          description: Folio de la factura.
          example: '1333'
        creditNoteAmount:
          type: integer
          description: >-
            Suma de los montos de todas las notas de crédito de la factura, en
            CLP. Es 0 si no tiene.
          example: 250000
        debitNoteAmount:
          type: integer
          description: >-
            Suma de los montos de las notas de débito que anulan notas de
            crédito de esta factura, en CLP. Es 0 si no tiene.
          example: 0
        creditNotes:
          type: array
          description: >-
            Detalle de las notas de crédito de la factura, ordenadas por fecha
            de emisión ascendente. Arreglo vacío si no tiene. La suma de sus
            `amount` es `creditNoteAmount`.
          items:
            $ref: '#/components/schemas/InvoiceCreditNote'
        cessionary:
          type: string
          description: >-
            Nombre del cesionario de la última cesión. Es `--` si la factura
            nunca se cedió.
          example: '--'
        cessionaries:
          type: array
          description: >-
            Historial de cesiones de la factura, de la más antigua a la más
            reciente. Arreglo vacío si nunca se cedió.
          items:
            $ref: '#/components/schemas/InvoiceCessionary'
        lastCessionDate:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Fecha y hora de la última cesión. Es null si la factura nunca se
            cedió.
          example: null
        confirmDate:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Fecha del acuse de recibo de la factura. Es null si no se ha
            confirmado.
          example: '2024-11-18T00:00:00.000Z'
        cancelDate:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Fecha en que la factura fue reclamada o anulada. Es null si no lo
            fue.
          example: null
        enforceableTitle:
          type: boolean
          description: >-
            Indica si la factura tiene mérito ejecutivo. Es `false` si fue
            reclamada; es `true` si tiene acuse de recibo o si pasaron al menos
            9 días desde su fecha de recepción; en cualquier otro caso es
            `false`.
          example: true
        currency:
          type: string
          description: Moneda de los montos de la factura. Siempre `CLP`.
          example: CLP
    Pagination:
      type: object
      required:
        - total
        - page
        - pageSize
        - totalPages
      properties:
        total:
          type: integer
          description: Cantidad total de elementos que cumplen los filtros.
        page:
          type: integer
          description: Página devuelta, desde 1.
        pageSize:
          type: integer
          description: Cantidad de elementos por página.
        totalPages:
          type: integer
          description: Cantidad total de páginas.
    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.
    InvoiceCreditNote:
      type: object
      description: Nota de crédito asociada a una factura.
      required:
        - folio
        - code
        - issuedDate
        - amount
      properties:
        folio:
          type: string
          description: Folio de la nota de crédito.
          example: '1201'
        code:
          type: string
          description: Tipo de DTE de la nota de crédito. Siempre `61`.
          example: '61'
        issuedDate:
          type:
            - string
            - 'null'
          format: date
          description: Fecha de emisión de la nota, en formato `YYYY-MM-DD`.
          example: '2024-11-20'
        amount:
          type: integer
          description: Monto total de la nota de crédito, en CLP.
          example: 250000
    InvoiceCessionary:
      type: object
      description: Una cesión de la factura.
      required:
        - giver
        - giverIdentifier
        - cessionary
        - cessionaryIdentifier
        - cessionDate
      properties:
        giver:
          type: string
          description: >-
            Nombre de quien cede en esta cesión. En una recesión, es el
            cesionario anterior.
          example: Cliente Ejemplo SpA
        giverIdentifier:
          type: string
          description: RUT de quien cede.
          example: 76111111-6
        cessionary:
          type: string
          description: Nombre del cesionario.
          example: Factoring Ejemplo SpA
        cessionaryIdentifier:
          type: string
          description: RUT del cesionario.
          example: 77222222-K
        cessionDate:
          type: string
          format: date-time
          description: Fecha y hora de la cesión, en formato ISO 8601 (UTC).
          example: '2024-11-12T15:36:00.000Z'
  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.