Saltar al contenido principal
POST
/
products
/
{productId}
/
variants
Crear
curl --request POST \
  --url https://sandbox.api.riqra.com/products/{productId}/variants \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "sku": "<string>",
  "price": 123,
  "stock": 123,
  "erpCode": "<string>",
  "priceIsTaxExempt": false,
  "salesUnitFactor": 1,
  "jumpFactor": 1,
  "images": [
    {
      "url": "<string>",
      "order": 123
    }
  ],
  "order": 123,
  "attributes": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "weight": 123,
  "length": 123,
  "width": 123,
  "height": 123
}
'
{
  "errors": [
    {
      "message": "<string>",
      "code": 123
    }
  ]
}

Authorizations

api-key
string
header
required

Todas las llamadas al API tienen que contener este header junto a la clave para poder autenticar y autorizar al cliente.

Path Parameters

productId
integer<int64>
required

ID del producto.

Body

application/json
sku
string
required

SKU(Stock Keeping Unit) de la variante del producto.

price
number<float>
required

El precio se adjuntará a la lista de precios por defecto.

stock
integer
required

El stock se adjuntará al almacén por defecto.

erpCode
string

ErpCode es el código utilizado internamente por su ERP para identificar la variante del producto.

priceIsTaxExempt
boolean
default:false

Indica si el precio de la variante está o no exento del cálculo de impuestos.

salesUnitFactor
number<float>
default:1

La cantidad de ventas de este producto es un múltiplo de este valor.

El valor debe tener como máximo 2 valores decimales.

jumpFactor
integer<int64>
default:1

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.

Rango requerido: x >= 1
images
ProductImages · object[]
Maximum array length: 5
order
integer

Orden de la variante entre todas las demás variantes, si existe más de una.

attributes
object[]

Atributos con sus valores que siguen los nombres dictados por el producto padre (principal).

weight
number

Peso de la variante.

length
number

Largura de la variante.

width
number

Anchura de la variante.

height
number

Altura de la variante.

Response

No Content