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

# Actualizar

> Actualiza un producto por su ID.



## OpenAPI

````yaml /api/openapi.json patch /products/{productId}
openapi: 3.1.0
info:
  title: Riqra API
  version: '1.0'
  contact:
    email: soporte@riqra.com
    url: https://www.riqra.com/
    name: Riqra Support
  description: >-
    Usando nuestra API puedes integrar tu ERP o tu sistema actual de
    administración con [Riqra](https://www.riqra.com/).
servers:
  - url: https://sandbox.api.riqra.com
    description: Sandbox
  - description: Producción
    url: https://api.riqra.com
security:
  - API Key: []
tags:
  - name: Almacenes
  - name: Banners
  - name: Categorías
  - name: Clientes
  - name: Clientes - Direcciones
  - name: Cobertura
  - name: Comercio
  - name: Cupones
  - name: Inventario
  - name: Líneas de Crédito
  - name: Lista de Precios
  - name: Lista de Precios - Precios
  - name: Marcas
  - name: Pedidos
  - name: Productos
  - name: Productos Sugeridos
  - name: Promociones
  - name: Stock
  - name: Subcategorías
  - name: Variantes
paths:
  /products/{productId}:
    parameters:
      - schema:
          type: string
        name: productId
        in: path
        required: true
        description: ID del producto.
    patch:
      tags:
        - Productos
      summary: Actualizar
      description: Actualiza un producto por su ID.
      operationId: patch-products-productId
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductRequestPatch'
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
        '404':
          description: Not Found
components:
  schemas:
    ProductRequestPatch:
      title: ProductRequestPatch
      type: object
      properties:
        name:
          $ref: '#/components/schemas/ProductName'
        description:
          $ref: '#/components/schemas/ProductDescription'
        shortDescription:
          type: string
          description: Breve descripción del producto.
        seo:
          $ref: '#/components/schemas/ProductSeo'
        isPublished:
          $ref: '#/components/schemas/ProductIsPublished'
        isFeatured:
          $ref: '#/components/schemas/ProductIsFeatured'
        order:
          $ref: '#/components/schemas/ProductOrder'
        extraFields:
          $ref: '#/components/schemas/ProductExtraFields'
        mainVariant:
          type: object
          properties:
            sku:
              $ref: '#/components/schemas/ProductVariantSku'
            erpCode:
              $ref: '#/components/schemas/ProductVariantErpCode'
            price:
              type: number
              format: float
              description: Precio que se añadirá a la lista de precios por defecto.
            priceIsTaxExempt:
              description: >-
                Indica si el precio de la variante está extento o no del cálculo
                de impuestos.
              type: boolean
            stock:
              type: integer
              description: Stock que se añadirá al almacén por defecto.
            salesUnitFactor:
              $ref: '#/components/schemas/ProductVariantSalesUnitFactor'
            jumpFactor:
              $ref: '#/components/schemas/ProductVariantJumpFactor'
            images:
              $ref: '#/components/schemas/ProductImages'
            order:
              type: integer
              description: >-
                Orden de la variante entre todas las demás variantes, si existe
                más de una.
              minimum: 1
            attributes:
              type: array
              description: >-
                Atributos con sus valores que siguen los nombres dictados por el
                producto padre (principal).
              uniqueItems: true
              items:
                type: object
                properties:
                  name:
                    type: string
                  value:
                    type: string
            weight:
              type: number
              description: Peso de la variante.
            length:
              type: number
              description: Largura de la variante.
            width:
              type: number
              description: Anchura de la variante.
            height:
              type: number
              description: Altura de la variante.
        subcategories:
          type: array
          description: Lista de IDs de subcategorías a las que pertenece el producto.
          minItems: 1
          items:
            $ref: '#/components/schemas/SubcategoryId'
        attributes:
          type: array
          description: >-
            Atributos que rigen las definiciones de los atributos de las
            variantes, incluida la principal.
          items:
            type: string
    BadRequest:
      title: BadRequest
      type: object
      x-examples: {}
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type:
                  - integer
                  - string
                deprecated: true
                description: Código referencial del error. No usar.
      description: ''
    ProductName:
      title: ProductName
      description: Nombre del producto.
      type: string
    ProductDescription:
      title: ProductDescription
      type: string
      description: Detalles sobre el producto, puede ser contenido HTML.
    ProductSeo:
      title: ProductSeo
      type: object
      description: Atributos para el SEO.
      properties:
        title:
          type: string
          description: Título del producto para el SEO.
        description:
          type: string
          description: Descripción de la categoría para el SEO.
    ProductIsPublished:
      title: ProductIsPublic
      description: Indica si el producto debe mostrarse o no.
      type: boolean
    ProductIsFeatured:
      title: ProductIsFeatured
      type: boolean
      description: Indica si el producto será destacado.
    ProductOrder:
      type: integer
      title: ProductOrder
      description: Orden del producto entre a todos los demás productos.
      format: int64
    ProductExtraFields:
      title: ProductExtraFields
      description: Objeto JSON válido de campos adicionales.
      type: object
    ProductVariantSku:
      title: ProductVariantSku
      description: SKU(Stock Keeping Unit) de la variante del producto.
      type: string
    ProductVariantErpCode:
      title: ProductVariantErpCode
      description: >-
        ErpCode es el código utilizado internamente por su ERP para identificar
        la variante del producto.
      type: string
    ProductVariantSalesUnitFactor:
      type: number
      title: ProductVariantSalesUnitFactor
      x-examples: {}
      description: |-
        La cantidad de ventas de este producto es un múltiplo de este valor.

        El valor debe tener como máximo 2 valores decimales.
      default: 1
      format: float
      exclusiveMinimum: 0
      examples:
        - 3.14
    ProductVariantJumpFactor:
      type: integer
      title: ProductVariantJumpFactor
      x-examples: {}
      description: >-
        JumpFactor de un producto: es un múltiplo en el que saltará el contador.
        Ejemplo: si jumpFactor es 4, la cantidad mínima a comprar será 4,
        entonces el contador pasará de 4 a 8, de 8 a 12 y así sucesivamente.


        El valor debe ser un número entero positivo.
      default: 1
      format: int64
      minimum: 1
      examples:
        - 4
    ProductImages:
      title: ProductImages
      type: array
      maxItems: 5
      items:
        type: object
        properties:
          url:
            $ref: '#/components/schemas/ImageUrl'
          order:
            type: integer
            description: Orden de la imagen respecto a las otras imágenes.
        required:
          - url
    SubcategoryId:
      type: integer
      title: SubcategoryId
      description: El ID de la subcategoría.
      format: int64
    ImageUrl:
      type: string
      title: ImageUrl
      format: uri
      description: URL válida de la imagen.
  securitySchemes:
    API Key:
      name: api-key
      type: apiKey
      in: header
      description: >-
        Todas las llamadas al API tienen que contener este header junto a la
        clave para poder autenticar y autorizar al cliente.

````