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

# Editar orden de compra o guía

> Envía ingredientes e ítems completos. Una orden aprobada solo permite cambios que el flujo actual admite, como comentarios y archivos; no admite cambiar su contenido. No se puede cambiar el tipo de documento ni editar documentos anulados o facturados. 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 put /admin/inventory/stores/{storeId}/purchase-documents/{inventoryTaxDocumentId}
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/{inventoryTaxDocumentId}:
    put:
      summary: Editar orden de compra o guía
      description: >-
        Envía ingredientes e ítems completos. Una orden aprobada solo permite
        cambios que el flujo actual admite, como comentarios y archivos; no
        admite cambiar su contenido. No se puede cambiar el tipo de documento ni
        editar documentos anulados o facturados. 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: path
          name: inventoryTaxDocumentId
          required: true
          schema:
            type: string
          description: >-
            ID del registro, obtenido al crearlo o en la consulta de su
            colección.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/apiInventoryDocumentUpdateInput'
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    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
components:
  schemas:
    apiInventoryDocumentUpdateInput:
      type: object
      additionalProperties: false
      properties:
        comments:
          type:
            - string
            - 'null'
          description: Comentarios del documento.
        providerId:
          type:
            - string
            - 'null'
          description: Proveedor de GET /admin/inventory/providers.
        invoiceId:
          type:
            - string
            - 'null'
          description: Identificador de la guía de despacho.
        issueDate:
          type:
            - string
            - 'null'
          format: date-time
          description: Fecha de emisión del documento.
        documentType:
          type: string
          enum:
            - purchaseOrder
            - deliveryNote
          description: >-
            Una orden de compra nace en borrador; una guía registra entradas de
            inventario.
        ingredients:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              ingredientId:
                type:
                  - string
                  - 'null'
                description: >-
                  ID del ingrediente. Se obtiene de GET
                  /admin/inventory/ingredients o GET
                  /tabs/{websiteId}/ingredients.
              quantity:
                type:
                  - number
                  - 'null'
                description: >-
                  Cantidad en la unidad base del ingrediente, incluso si se
                  indica conversionName. Para comprar 2 sacos de 25 kg de un
                  ingrediente medido en kg, envía quantity: 50.
              ingredientName:
                type:
                  - string
                  - 'null'
                description: >-
                  Nombre del ingrediente; el servicio lo actualiza desde el
                  catálogo.
              conversionName:
                type:
                  - string
                  - 'null'
                description: Nombre exacto de una conversión configurada en el ingrediente.
              inConversionQuantity:
                type:
                  - number
                  - 'null'
                description: >-
                  Cantidad en la conversión elegida, calculada por el servicio
                  como quantity dividido por el factor. No es necesario
                  enviarla.
              stockRoomId:
                type:
                  - string
                  - 'null'
                description: >-
                  ID de bodega de la marca. Se obtiene de GET
                  /admin/inventory/stock-rooms.
              totalCost:
                type:
                  - number
                  - 'null'
                description: >-
                  Costo total de la línea, incluidos impuestos. Las compras
                  ingresan a la bodega definida por el flujo actual del local.
              discount:
                type:
                  - number
                  - 'null'
                description: Descuento de la línea, en moneda del local.
              totalNetCost:
                type:
                  - number
                  - 'null'
                description: Costo total neto de la línea.
              totalTaxCost:
                type:
                  - number
                  - 'null'
                description: Impuestos de la línea.
              netCostPerUnit:
                type:
                  - number
                  - 'null'
                description: Costo neto por unidad; el servicio lo recalcula.
              taxes:
                type: object
                additionalProperties: false
                properties:
                  cl:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - ila_20_5
                            - ila_31_5
                            - iva_0
                            - iva_5
                            - iva_8
                            - iva_10
                            - iva_10_5
                            - iva_12
                            - iva_16
                            - iva_18
                            - iva_19
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Chile.
                  co:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - icui_20
                            - inc_2
                            - inc_4
                            - inc_8
                            - inc_16
                            - iva_0
                            - iva_5
                            - iva_19
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Colombia.
                  mx:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - ieps_8
                            - iva_0
                            - iva_16
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para México.
                  pe:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - igv_10
                            - igv_10_5
                            - igv_18
                            - iva_18
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Perú.
                  ec:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - iva_0
                            - iva_15
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Ecuador.
                  cr:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - iva_0
                            - iva_13
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Costa Rica.
                description: >-
                  Impuestos de la línea. Usa el desglose del país de la marca,
                  como en el formulario de inventario.
            required:
              - ingredientId
              - quantity
              - totalCost
          description: Lista completa de ingredientes comprados y sus costos e impuestos.
        items:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              description:
                type:
                  - string
                  - 'null'
                description: Descripción del ítem adicional sin ingrediente.
              quantity:
                type:
                  - number
                  - 'null'
                description: Cantidad del ítem.
              totalCost:
                type:
                  - number
                  - 'null'
                description: Costo total del ítem.
              discount:
                type:
                  - number
                  - 'null'
                description: Descuento del ítem.
              totalNetCost:
                type:
                  - number
                  - 'null'
                description: Costo neto del ítem.
              totalTaxCost:
                type:
                  - number
                  - 'null'
                description: Impuestos del ítem.
              taxes:
                type: object
                additionalProperties: false
                properties:
                  cl:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - ila_20_5
                            - ila_31_5
                            - iva_0
                            - iva_5
                            - iva_8
                            - iva_10
                            - iva_10_5
                            - iva_12
                            - iva_16
                            - iva_18
                            - iva_19
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Chile.
                  co:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - icui_20
                            - inc_2
                            - inc_4
                            - inc_8
                            - inc_16
                            - iva_0
                            - iva_5
                            - iva_19
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Colombia.
                  mx:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - ieps_8
                            - iva_0
                            - iva_16
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para México.
                  pe:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - igv_10
                            - igv_10_5
                            - igv_18
                            - iva_18
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Perú.
                  ec:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - iva_0
                            - iva_15
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Ecuador.
                  cr:
                    type: object
                    additionalProperties: false
                    properties:
                      taxTypes:
                        type: array
                        items:
                          type: string
                          enum:
                            - iva_0
                            - iva_13
                        description: Códigos de impuesto del país aplicables a esta línea.
                      baseAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto neto de la línea, antes de impuestos.
                      amount:
                        type:
                          - number
                          - 'null'
                        description: Monto de impuestos de la línea.
                      totalAmount:
                        type:
                          - number
                          - 'null'
                        description: Monto total de la línea, incluidos impuestos.
                      netCost:
                        type:
                          - number
                          - 'null'
                        description: >-
                          Costo neto utilizado en inventario según la
                          configuración tributaria del local.
                      netCostPerUnit:
                        type:
                          - number
                          - 'null'
                        description: Costo neto por unidad.
                    description: Desglose de impuestos para Costa Rica.
                description: >-
                  Impuestos de la línea. Usa el desglose del país de la marca,
                  como en el formulario de inventario.
            required:
              - description
              - quantity
              - totalCost
          description: Lista completa de ítems adicionales sin ingrediente; [] si no hay.
        files:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              _id:
                type:
                  - string
                  - 'null'
                description: ID del archivo previamente cargado en Tabs.
              name:
                type:
                  - string
                  - 'null'
                description: Nombre del archivo.
              type:
                type:
                  - string
                  - 'null'
                description: Tipo MIME del archivo.
              size:
                type:
                  - number
                  - 'null'
                description: Tamaño en bytes.
              status:
                type:
                  - string
                  - 'null'
                description: Estado del archivo devuelto por la carga.
              key:
                type:
                  - string
                  - 'null'
                description: Clave de almacenamiento devuelta por la carga.
              bucket:
                type:
                  - string
                  - 'null'
                description: Bucket de almacenamiento devuelto por la carga.
              hash:
                type:
                  - string
                  - 'null'
                description: Huella del archivo devuelta por la carga.
              externalUrl:
                type:
                  - string
                  - 'null'
                description: URL externa del archivo, si corresponde.
              createdBy:
                type:
                  - string
                  - 'null'
                description: Usuario que cargó el archivo.
              createdAt:
                type:
                  - string
                  - 'null'
                format: date-time
                description: Fecha de carga.
              dimensions:
                type: object
                additionalProperties: false
                properties:
                  width:
                    type:
                      - number
                      - 'null'
                    description: Ancho en píxeles.
                  height:
                    type:
                      - number
                      - 'null'
                    description: Alto en píxeles.
                description: Dimensiones de una imagen cargada.
              colorsData:
                type: object
                additionalProperties: false
                properties:
                  background:
                    type:
                      - string
                      - 'null'
                    description: Color de fondo.
                  front:
                    type:
                      - string
                      - 'null'
                    description: Color de primer plano.
                  blurhash:
                    type:
                      - string
                      - 'null'
                    description: Representación desenfocada de la imagen.
                description: Colores de la imagen devueltos por la carga.
              resizedData:
                type: object
                additionalProperties: false
                properties:
                  extraLargeURL:
                    type:
                      - string
                      - 'null'
                    description: URL de la variante de imagen generada durante la carga.
                  largeURL:
                    type:
                      - string
                      - 'null'
                    description: URL de la variante de imagen generada durante la carga.
                  mediumURL:
                    type:
                      - string
                      - 'null'
                    description: URL de la variante de imagen generada durante la carga.
                  smallURL:
                    type:
                      - string
                      - 'null'
                    description: URL de la variante de imagen generada durante la carga.
                  thumbnailURL:
                    type:
                      - string
                      - 'null'
                    description: URL de la variante de imagen generada durante la carga.
                description: Variantes de imagen devueltas por la carga.
          description: Archivos previamente cargados que respaldan el documento.
      required:
        - providerId
        - documentType
        - ingredients
        - items
      example:
        providerId: ti-pro-ejemplo
        documentType: purchaseOrder
        ingredients:
          - ingredientId: ti-ing-ejemplo
            quantity: 2
            totalCost: 2380
        items: []
        comments: Entregar por la mañana

````

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