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

# List invoices

Lista los documentos tributarios generados desde el PDV para un local autorizado.

Usa este endpoint para revisar boletas, facturas y anulaciones asociadas a cuentas o ventas de inventario. La respuesta incluye identificadores externos, estado de generación, montos netos, impuestos y total. La data siempre queda limitada al website autorizado por el token de API.


## OpenAPI

````yaml get /tabs/{storeId}/invoices
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /tabs/{storeId}/invoices:
    get:
      summary: List invoices
      parameters:
        - in: path
          name: storeId
          required: true
          schema:
            type: string
        - in: query
          name: fromDate
          required: false
          schema:
            type: string
            example: '2020-01-01T00:00:00.000Z'
            format: date-time
            description: Fecha de inicio de la búsqueda.
        - in: query
          name: toDate
          required: false
          schema:
            type: string
            example: '2020-01-01T00:00:00.000Z'
            format: date-time
            description: Fecha de fin de la búsqueda.
        - in: query
          name: page
          required: false
          schema:
            type: number
            example: 1
            description: Número de página.
        - in: query
          name: limit
          required: false
          schema:
            type: number
            example: 10
            description: 'Número de items por página. Max 100. Por defecto: 10.'
        - in: query
          name: sortBy
          required: false
          schema:
            type: string
            enum:
              - createdAt
            example: createdAt
            description: 'Campo por el cual se ordenará la lista. Por defecto: "createdAt".'
        - in: query
          name: sortType
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
            example: desc
            description: Tipo de ordenamiento.
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/tabsTabInvoice'
                        description: Items de la lista.
                      hasNextPage:
                        type: boolean
                        description: Indica si hay una página siguiente.
                      hasPreviousPage:
                        type: boolean
                        description: Indica si hay una página anterior.
                      totalPages:
                        type: number
                        description: Total de páginas.
                      totalCount:
                        type: number
                        description: Total de items.
        '400':
          description: Errors
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: 'false'
                  error:
                    type: object
                    properties:
                      error:
                        type: string
                        example: error
                      message:
                        type: string
                        example: The request has an error
components:
  schemas:
    tabsTabInvoice:
      type: object
      properties:
        _id:
          type: string
          example: tab-4c48bf33-1411-4c3f-adac-db39b4631cb8
          description: El ID de la factura.
        providerId:
          type: string
          example: openFactura
          description: El ID del proveedor al que pertenece la factura.
        storeId:
          type: string
          example: sto-4c48bf33-1411-4c3f-adac-db39b4631cb8
          description: El ID del local asociado al documento tributario.
        tabId:
          type: string
          example: tab-4c48bf33-1411-4c3f-adac-db39b4631cb8
          description: El ID de la cuenta PDV asociada al documento, si existe.
        inventorySaleId:
          type: string
          example: isale-4c48bf33-1411-4c3f-adac-db39b4631cb8
          description: El ID de la venta de inventario asociada al documento, si existe.
        createdAt:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha de creación de la factura.
        generatedAt:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha de generación de la factura.
        status:
          type: string
          enum:
            - pending
            - generated
            - error
            - voided
            - generating
          description: >-
            El estado de la factura. Valores posibles: 'pending', 'generated',
            'error', 'voided', 'generating'.
        externalInvoiceId:
          type: string
          example: '123456'
          description: El ID de la factura en el sistema externo.
        externalVoidInvoiceId:
          type: string
          example: '654321'
          description: El ID de la anulación en el sistema externo, si existe.
        errorMessage:
          type: string
          example: Error al generar la factura.
          description: Mensaje de error al generar la factura.
        voidedAt:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha de anulación de la factura.
        statusLabel:
          type: string
          example: Pendiente
          description: Etiqueta del estado de la factura.
        invoiceURL:
          type: string
          example: https://getjusto.com/invoice/123456
          description: URL de la factura.
        totalAmount:
          type: number
          example: 100
          description: El monto total de la factura.
        taxAmount:
          type: number
          example: 10
          description: El monto de los impuestos de la factura.
        netAmount:
          type: number
          example: 90
          description: El monto total neto de la factura.

````