Skip to navigation

Datos maestros

Consultas de los datos que necesitas para crear productos: marcas, categorías, especificaciones y ecommerces.

  • Todas usan la URL del gateway y requieren el header apiKey.
  • Límite: 300 solicitudes por minuto.

Orden recomendado

  1. Buscar marcas → brand.id, brand.name.
  2. Buscar categorías → category.id, category.name, category.namePath. Usa una categoría del último nivel, es decir, que no tenga subcategorías (children vacío). Por ejemplo, Zapatillas de Fútbol y no Calzado.
  3. Ecommerces de una categoría → marketplaces[] donde puedes publicar.
  4. Especificaciones de producto (isStockKeepingUnit=false) → productSpecifications[].
  5. Especificaciones de SKU (isStockKeepingUnit=true) → skus[].skuSpecifications[].

Con esos datos arma el body de Crear producto y SKUs.

Tipos de especificación (specificationFieldType.fieldTypeName)

TipoCómo completarla
Texto / NúmerospecificationFieldValues: [{ "fieldValueId": null, "value": "<valor libre>", "isActive": null }]
Radio / Combo / CheckboxCopia uno de los valores de specificationFieldValues que devuelve la consulta (con su fieldValueId, value e isActive).

Las especificaciones con isRequired: true son obligatorias. Si no las envías, el producto no podrá publicarse.

Paginación

  • Marcas y especificaciones: from (desde qué registro) y size (cuántos).
  • Categorías: page (desde 0) y rows.
  • Las respuestas paginadas traen data.page, data.sizePage, data.totalPage y data.totalElements.