> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Listado paginado de documentos con filtros

> Filtros en el body (snake_case) en vez de query params; la respuesta es camelCase con items, total y lastPage.



## OpenAPI

````yaml /generated/specs/finance.json post /api/v1/dte/documents/query
openapi: 3.0.0
info:
  title: Raul API - Finanzas
  description: >-
    Facturas, boletas, ejecuciones de billing, cuentas por pagar y medios de
    pago.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.raul.ugps.io
    description: Production
security: []
tags: []
paths:
  /api/v1/dte/documents/query:
    post:
      tags:
        - DTE
      summary: Listado paginado de documentos con filtros
      description: >-
        Filtros en el body (snake_case) en vez de query params; la respuesta es
        camelCase con items, total y lastPage.
      operationId: DteStatusController_query
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueryDteDocumentsDto'
      responses:
        '200':
          description: ''
components:
  schemas:
    QueryDteDocumentsDto:
      type: object
      properties:
        status:
          type: string
          description: Estado local exacto del documento.
          enum:
            - DRAFT
            - LOCAL_VALIDATED
            - ODOO_DRAFT_CREATED
            - ODOO_POSTED
            - ODOO_ERROR
            - SII_PENDING
            - SII_UPLOAD_UNCERTAIN
            - SII_ACCEPTED
            - SII_REJECTED
        sii_status:
          type: string
          description: >-
            Dimensión SII. Filtra por el estado de la fila, no por el DTE
            canónico de la factura.
          enum:
            - not_emitted
            - pending
            - uncertain
            - accepted
            - rejected
        document_type:
          type: string
          description: Tipo de documento tributario.
          enum:
            - FACTURA_33
            - FACTURA_EXENTA_34
            - BOLETA_39
            - BOLETA_EXENTA_41
            - GUIA_DESPACHO_52
            - NOTA_DEBITO_56
            - NOTA_CREDITO_61
        folio:
          type: number
          description: Folio exacto.
          example: 8694
        receiver_rut:
          type: string
          description: RUT del receptor.
          example: 96990050-5
          maxLength: 20
        shipment_order_id:
          type: string
          description: Orden de envío que originó el documento.
        from_issue_date:
          type: string
          description: Fecha de emisión desde (inclusive), formato YYYY-MM-DD.
          example: '2026-08-01'
        to_issue_date:
          type: string
          description: Fecha de emisión hasta (inclusive), formato YYYY-MM-DD.
          example: '2026-08-31'
        payment_status:
          type: string
          description: Estado de pago exacto del documento.
          enum:
            - NOT_PAID
            - PARTIALLY_PAID
            - PAID
            - REFUNDED
            - CANCELLED
        has_mp:
          type: boolean
          description: >-
            true = solo documentos con preferencia MercadoPago; false = sin
            ella.
        search:
          type: string
          description: >-
            Texto libre sobre el nombre del receptor (y folio si el texto es
            numérico).
          maxLength: 200
        page:
          type: number
          description: Página (base 1).
          default: 1
        per_page:
          type: number
          description: Documentos por página.
          default: 10
          maximum: 250

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.