POST
/api/mod/productos/{espacio}/catalog/imports/{importacion}/activateActiva 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
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Productos. |
| importacion | string | SÍ | El id de la importación: el import_id que devolvió subir el archivo (32 caracteres hexadecimales). |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| import_id | string | La importación. |
| estado | "validada" | Ya aplicada. |
| productos_creados | integer | Productos que entraron. |
| variantes_creadas | integer | Variantes 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": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Productos | módulo no habilitado para este espacio. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 400 | No hay una importación con ese id | import no encontrado |
| 400 | La 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.