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

# Actualizar producto

> Mismos campos que la creación. Un cambio de `availability` genera un ajuste de inventario.

**Permiso requerido:** `products`



## OpenAPI

````yaml /api-reference/openapi.json put /products/{id}
openapi: 3.0.3
info:
  title: FileXpress API Externa
  version: 1.0.0
  description: >-
    API para integrar sistemas de terceros con FileXpress: facturación, RRHH y
    contabilidad.
servers:
  - url: https://api.filexpress.app/api/external
    description: Producción
security:
  - ApiKey: []
tags:
  - name: General
  - name: Facturación · Ventas
  - name: Facturación · Compras
  - name: Facturación · Clientes
  - name: Facturación · Proveedores
  - name: Facturación · Productos
  - name: Catálogos
  - name: RRHH · Empleados
  - name: RRHH · Asistencia
  - name: RRHH · Permisos
  - name: RRHH · Planillas
  - name: Contabilidad
paths:
  /products/{id}:
    put:
      tags:
        - Facturación · Productos
      summary: Actualizar producto
      description: >-
        Mismos campos que la creación. Un cambio de `availability` genera un
        ajuste de inventario.


        **Permiso requerido:** `products`
      parameters:
        - name: id
          in: path
          required: true
          description: ID del producto
          schema:
            type: string
            format: uuid
          example: 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductRequest'
            example:
              name: Refresco 350ml
              sku: BEB-001
              price_before_taxes: 1.11
              cost: 0.7
              tax_method: is_taxed
              composition_type: simple
              product_type: phisical
              product_category_id: 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
              product_measurement_id: 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
              branch_id: 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
              availability: 100
              limit_availability: 10
              tax_ids:
                - 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
      responses:
        '200':
          description: Producto actualizado
          content:
            application/json:
              example:
                success: true
                data:
                  id: 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
                  name: Refresco 350ml
                  sku: BEB-001
                  price_before_taxes: 1.11
                  cost: 0.7
                  tax_method: is_taxed
                  composition_type: simple
                  product_type: phisical
                  product_category_id: 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
                  product_measurement_id: 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
                  availability: 100
                  limit_availability: 10
                  taxes:
                    - id: 9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11
                      name: IVA
                      number_code: '20'
                      tax_type: percentage
                      percent: 0.13
                message: Data retrieved successfully.
        '401':
          $ref: '#/components/responses/E401'
        '403':
          $ref: '#/components/responses/E403'
        '404':
          $ref: '#/components/responses/E404'
        '429':
          $ref: '#/components/responses/E429'
components:
  schemas:
    ProductRequest:
      type: object
      properties:
        name:
          type: string
        sku:
          type: string
        price_before_taxes:
          type: number
        cost:
          type: number
        tax_method:
          type: string
          description: Tratamiento de IVA.
          enum:
            - is_taxed
            - is_exent
            - is_not_subject
        composition_type:
          type: string
          description: Composición.
          enum:
            - simple
            - with_portions
            - with_recipe
        product_type:
          type: string
          description: Tipo.
          enum:
            - phisical
            - service
            - both
        product_category_id:
          type: string
          format: uuid
        product_measurement_id:
          type: string
          format: uuid
        branch_id:
          type: string
          format: uuid
        availability:
          type: number
          description: Existencia.
        limit_availability:
          type: number
          description: Existencia mínima.
        tax_ids:
          type: array
          items:
            type: string
            format: uuid
          description: >-
            Impuestos del producto (GET /taxes/branch/{branch_id}). En gravados
            envía al menos el IVA. En actualización: omitido = se conservan; []
            = se quitan.
        base_unit_quantity:
          type: number
          description: Requerido con porciones.
        base_unit:
          type: string
          description: Requerido con porciones.
        portions:
          type: array
          items:
            type: object
            properties:
              portion_name:
                type: string
              portion_quantity:
                type: number
              portion_unit:
                type: string
              portion_price:
                type: number
              is_active:
                type: boolean
        components:
          type: array
          items:
            type: object
            properties:
              component_product_id:
                type: string
                format: uuid
              quantity_needed:
                type: number
              unit_type:
                type: string
      required:
        - name
        - price_before_taxes
        - product_category_id
        - product_measurement_id
        - product_type
        - tax_method
        - composition_type
        - branch_id
        - availability
        - limit_availability
  responses:
    E401:
      description: API Key ausente o inválida
      content:
        application/json:
          example:
            status: false
            message: Invalid API Key.
    E403:
      description: Integración sin el permiso requerido o desactivada
      content:
        application/json:
          example:
            status: false
            message: This integration does not have the 'hr.employees' permission.
            required_scope: hr.employees
    E404:
      description: Recurso inexistente o de otro negocio
      content:
        application/json:
          example:
            status: false
            message: Not found.
    E429:
      description: Límite de peticiones excedido
      content:
        application/json:
          example:
            status: false
            message: Rate limit exceeded. Please try again later.
            rate_limit: 100
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key de la integración (Integraciones → Nueva Integración).

````

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