Saltar al contenido
docs
EN
CatálogoVariantes

Actualizar variante de producto

Actualiza únicamente los campos de la variante incluidos en la solicitud.

PATCH/v1/catalog/variants/{variantId}
Requiere un token de acceso con el permiso catalog:update.

Parámetros de ruta

variantId*string

Identificador de la variante.

Parámetros de cabecera

x-Store-Id?string

Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.

Authorization*string

Token bearer OAuth 2.0.

Cuerpo de la solicitud

application/json

Definiciones TypeScript

Usa esta definición en TypeScript.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PATCH "https://api.ecomiq.pe/api/v1/catalog/variants/7204558912004323197" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>" \  -H "Content-Type: application/json" \  -d '{    "name": "Polo de algodón Azul / M",    "sku": "POL-001-AZ-M",    "packageId": "7204558912004325646",    "price": 89,    "compareAtPrice": 99,    "costPrice": 40,    "lowStockThreshold": 24,    "allowBackorders": false  }'
{  "id": "7204558912004323197",  "storeId": "7204558912004327977",  "productId": "7204558912004322039",  "sellerId": "7204558912004323447",  "packageId": "7204558912004325646",  "shippingProfileId": "7204558912004329819",  "productName": "Polo de algodón Azul / M",  "productDescription": "Polo de algodón pima para uso diario.",  "productSlug": "polo-de-algodon",  "productType": "product",  "productIsDigital": false,  "productStatus": "draft",  "productImage": "Polo de algodón Azul / M",  "thumbnail": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp",  "brandId": "7204558912004322959",  "brandName": "Polo de algodón Azul / M",  "categoryId": "7204558912004327982",  "categoryName": "Polo de algodón Azul / M",  "tags": [    "algodón"  ],  "name": "Polo de algodón Azul / M",  "sku": "POL-001-AZ-M",  "barcode": "7751234567892",  "status": "outOfStock",  "isDigital": false,  "allowBackorders": false,  "onHand": 24,  "committed": 1,  "available": 24,  "order": 1,  "isDefault": true,  "countryOfOrigin": "Polo de algodón Azul / M",  "hsCode": "POL-001",  "price": 89,  "compareAtPrice": 99,  "costPrice": 40,  "currency": "PEN",  "lowStockThreshold": 24,  "weight": 0.3,  "width": 30,  "height": 30,  "length": 30,  "unitOfMeasure": "kilogram",  "requiresShipping": false,  "trackInventory": true,  "images": [    {      "imageId": "7204558912004329435",      "order": 1,      "isPrimary": true    }  ],  "options": [    {      "name": "Polo de algodón Azul / M",      "key": "color",      "value": "Polo de algodón Azul / M"    }  ],  "inventories": [    {      "id": "7204558912004323197",      "locationId": "7204558912004328277",      "onHand": 24,      "committed": 1,      "available": 24,      "incoming": 1,      "unavailable": 24,      "version": 3,      "createdOn": "2026-09-28T15:30:00Z"    }  ],  "optionValues": {    "key": "Polo de algodón Azul / M"  },  "createdOn": "2026-09-28T15:30:00Z",  "updatedOn": "2026-09-28T15:30:00Z"}