Skip to navigation

Crear producto y SKUs

Crea un producto con uno o más SKUs. Si hay errores de validación, recibes el detalle para corregirlos.

Prepara los datos con las consultas de Datos maestros.

Body – producto

CampoTipoRequeridoDescripción
namestringSíNombre del producto.
descriptionstring (HTML)SíDescripción. Admite HTML básico (<br />, <b>).
brand.id / brand.name / brand.isActivestring / string / booleanSíDe Buscar marcas.
category.id / category.name / category.namePathstringSíDe Buscar categorías (categoría del último nivel, sin subcategorías).
productSpecifications[]arraySí, si la categoría tiene obligatoriasDe Especificaciones de producto por categoría, completando specificationFieldValues.
marketplaces[]arraySíid, name, accountName de Ecommerces de una categoría.
skus[]arraySíVariantes (ver tabla siguiente).

Body – cada SKU (skus[])

CampoTipoRequeridoDescripción
skuNamestringSíNombre de la variante.
upcstringSíCódigo del producto propio del seller (EAN/UPC o código interno).
images[].imageUrlstring (URL pública)SíImágenes del SKU.
inventory.totalQuantityenteroSíStock inicial.
price.listPricenúmeroSíPrecio regular.
price.pricenúmeroNoPrecio de oferta (menor que listPrice). Si no lo envías, queda igual a listPrice.
price.priceValidFrom / price.priceValidUntilYYYY-MM-DDSí, si envías priceVigencia de la oferta.
dimension.height / width / lengthnúmero (cm)SíMedidas del paquete.
dimension.weightnúmero (g)SíPeso en gramos.
dimension.cubicWeightnúmeroSíPeso volumétrico (para cálculo de envío).
skuSpecifications[]arraySí, si la categoría tiene obligatoriasDe Especificaciones de SKU por categoría.

Si la categoría tiene especificaciones con isRequired: true y no las envías, el producto no podrá publicarse en los ecommerces.

Respuesta 200

data.id es el id del producto y data.skus[].id los ids de SKU. Guárdalos: los necesitarás para precio, stock y órdenes. El producto y sus SKUs quedan en estado PENDING_APPROVAL hasta su aprobación; consulta el avance con Detalle de producto o SKUs de un producto.

Errores 400

El detalle viene en data.errors, junto con un trackingId que debes indicar si reportas el caso:

{ "message": "Intento fallido al crear el producto. Corregir por favor.",
"data": { "errors": ["El Marketplace oechsle, no existe. "], "trackingId": "a97d5ed0-..." },
"status": false }

Usa siempre los marketplaces que devuelve Ecommerces de una categoría (con su id, name y accountName).

Authentication

AuthorizationBearer

accessToken obtenido en Login. Dura 24 horas.

apiKeystring

apiKey de tu ambiente (QA o PRD). La recibes por correo con tus credenciales.

Request

This endpoint expects an object.
brandobjectOptional
categoryobjectOptional
namestringOptional
descriptionstringOptional
productSpecificationslist of objectsOptional
skuslist of objectsOptional
marketplaceslist of objectsOptional

Response

Producto creado
messagestringOptional
dataobjectOptional
statusbooleanOptional

Errors

400
Bad Request Error