Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/productos/{espacio}/catalog/imports/{importacion}/activate

Activa una importación

Pasa las filas al catálogo: cada una crea un producto activo con su variante. La importación queda en validada.

  • PERMISOescribe
  • CRÉDITOSno gasta
  • AUTENTICACIÓNBearer bth_…

PARÁMETROS

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Productos.
importacionstringSÍEl id de la importación: el import_id que devolvió subir el archivo (32 caracteres hexadecimales).

RESPUESTA 200

CAMPOTIPOQUÉ ES
import_idstringLa importación.
estado"validada"Ya aplicada.
productos_creadosintegerProductos que entraron.
variantes_creadasintegerVariantes que entraron.
errores[]{ row_id, error }Las filas que no entraron y por qué. Una fila mala no para las demás.
advertencias[]{ tipo, productos }nombre_duplicado con los dos nombres de productos activos que se parecen demasiado. Solo avisa: no cambia nada.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Productosmódulo no habilitado para este espacio.
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.
400No hay una importación con ese idimport no encontrado
400La importación ya se activósolo se puede activar un import en draft (estado actual: validada)

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.

CONVIENE SABER

  • Cada fila crea un producto nuevo: activar dos veces el mismo catálogo lo duplica. Si un SKU ya existe, la variante nueva recibe uno sacado del nombre.
  • La columna de precio no fija ningún precio: se guarda en metadata.precio_sugerido. Los precios se fijan con Fija un precio.
  • La columna de tipo usa el tipo de producto con ese nombre, o lo crea.