Saltar al contenido
docs
Guías
EN
CatálogoVariantes
catalog:create

Crear variante de producto

Crea una variante del producto indicado y devuelve su representación completa.

POST/v1/catalog/products/{productId}/variants

Crea una variante del producto indicado y devuelve su representación completa.

Autorización

bearerAuth
AutorizaciónBearer <token>

Token de acceso OAuth 2.0 emitido por Ecomiq Auth.

Ubicación: header

Parámetros de ruta

productId*string

Identificador del producto.

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 POST "https://example.com/v1/catalog/products/7204558912004325301/variants" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>" \  -H "Content-Type: application/json" \  -d '{    "name": "Azul / M",    "sku": "POL-001-AZ-M",    "price": 89,    "compareAtPrice": 99,    "lowStockThreshold": 5,    "allowBackorders": false,    "trackInventory": true,    "weight": 0.25,    "unitOfMeasure": "kilogram",    "barcode": "7751234567890",    "isDefault": false,    "isDigital": false,    "options": {      "Color": "Azul",      "Talla": "M"    }  }'
{  "id": "7204558912004325377",  "storeId": "7204558912004325301",  "productId": "7204558912004325302",  "sellerId": null,  "packageId": null,  "shippingProfileId": null,  "productName": "Polo de algodón",  "productDescription": "Polo de algodón pima para uso diario.",  "productSlug": "polo-de-algodon",  "productType": "product",  "productIsDigital": false,  "productTaxIncluded": true,  "productStatus": "active",  "productImage": "https://cdn.example.com/products/pol-001.jpg",  "thumbnail": "https://cdn.example.com/products/pol-001-thumb.jpg",  "brandId": null,  "brandName": null,  "categoryId": null,  "categoryName": null,  "tags": [    "ropa",    "algodón"  ],  "name": "Azul / M",  "sku": "POL-001-AZ-M",  "barcode": "7751234567890",  "status": "active",  "isDigital": false,  "allowBackorders": false,  "onHand": 12,  "committed": 2,  "available": 10,  "order": 1,  "isDefault": false,  "upc": null,  "mpn": null,  "countryOfOrigin": null,  "hsCode": null,  "price": 89,  "compareAtPrice": 99,  "costPrice": null,  "currency": "PEN",  "lowStockThreshold": 5,  "weight": 0.25,  "width": 30,  "height": 2,  "length": 40,  "unitOfMeasure": "kilogram",  "requiresShipping": true,  "trackInventory": true,  "images": [],  "options": [],  "inventories": [],  "optionValues": {    "Color": "Azul",    "Talla": "M"  },  "modifierGroups": [],  "createdOn": "2026-07-15T15:30:00Z",  "updatedOn": "2026-07-20T18:10:00Z"}