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

# Crear

> Crea una variante de un producto.



## OpenAPI

````yaml /api/openapi.json post /products/{productId}/variants
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}/variants:
    parameters:
      - schema:
          type: integer
          format: int64
        name: productId
        in: path
        required: true
        description: ID del producto.
    post:
      tags:
        - Variantes
      summary: Crear
      description: Crea una variante de un producto.
      operationId: post-products-productId-variants
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductVariantRequestCreate'
        description: ''
      responses:
        '204':
          description: No Content
          headers: {}
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
        '404':
          description: Not Found
components:
  schemas:
    ProductVariantRequestCreate:
      title: ProductVariantRequestCreate
      type: object
      properties:
        sku:
          $ref: '#/components/schemas/ProductVariantSku'
        erpCode:
          $ref: '#/components/schemas/ProductVariantErpCode'
        price:
          type: number
          format: float
          description: El precio se adjuntará a la lista de precios por defecto.
        priceIsTaxExempt:
          type: boolean
          description: >-
            Indica si el precio de la variante está o no exento del cálculo de
            impuestos.
          default: false
        stock:
          type: integer
          description: El stock se adjuntará 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.
        attributes:
          type: array
          description: >-
            Atributos con sus valores que siguen los nombres dictados por el
            producto padre (principal).
          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.
      required:
        - sku
        - price
        - stock
    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: ''
    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
    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.

````