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

# Listar órdenes de compra o guías

> Lista documentos del local, con su estado y contenido, para aprobación, corrección o facturación. Requiere autorización admin y un usuario conectado; un token de integración sin usuario responde userRequired. Se aplican los mismos permisos y validaciones del formulario de inventario.



## OpenAPI

````yaml get /admin/inventory/stores/{storeId}/purchase-documents
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:
  /admin/inventory/stores/{storeId}/purchase-documents:
    get:
      summary: Listar órdenes de compra o guías
      description: >-
        Lista documentos del local, con su estado y contenido, para aprobación,
        corrección o facturación. Requiere autorización admin y un usuario
        conectado; un token de integración sin usuario responde userRequired. Se
        aplican los mismos permisos y validaciones del formulario de inventario.
      parameters:
        - in: path
          name: storeId
          required: true
          schema:
            type: string
          description: ID del local autorizado, obtenido de GET /ecommerce/stores.
        - in: query
          name: documentType
          required: true
          schema:
            type: string
            enum:
              - purchaseOrder
              - deliveryNote
          description: Tipo de documento que se consulta.
        - in: query
          name: statuses
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - created
                - accepted
                - sentToProvider
                - finished
                - voided
          description: >-
            Estados a incluir. Una orden created está en borrador; accepted
            indica aprobada.
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                          description: ID del registro creado, consultado o actualizado.
                        websiteId:
                          type: string
                          description: Marca propietaria del registro.
                        storeId:
                          type: string
                          description: Local propietario, para operaciones por local.
                      description: >-
                        Registro de inventario con los campos de su operación,
                        como estado, ingredientes, cantidades y costos. Las
                        fechas se devuelven en el formato del servicio Tabs.
        '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

````

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