POST
/api/mod/productos/{espacio}/catalog/importImporta un catálogo desde un archivo
Sube tu catálogo en CSV, Excel o PDF. Queda en una importación en draft para que la revises: el catálogo no cambia hasta que la activas.
- 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. |
CUERPO · MULTIPART/FORM-DATA
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| file | archivo | SÍ | Un .csv, .xlsx o .pdf con una tabla, hasta 25 MB. Las columnas que entiende, en la guía. |
RESPUESTA 201
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| import_id | string | La importación. Guárdalo. |
| estado | "draft" | Esperando revisión. |
| n_rows | integer | Las filas que reconoció. |
| origen | "csv" | "xlsx" | "pdf" | El formato del archivo. |
| warnings | string[] | Avisos del archivo entero, p. ej. si no reconoció ninguna tabla. |
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 | El archivo no trae nada | archivo vacío. |
| 400 | La extensión no es .csv, .xlsx ni .pdf | extensión no soportada para catálogo: … |
| 413 | El archivo pasa de 25 MB | archivo demasiado grande (máximo 26214400 bytes). |
| 422 | Falta el campo file (detail es una lista) | — |
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
- Si
n_rowses 0, no encontró una columna de nombre ni de SKU: mirawarnings. - Excel, en .xlsx. Un .xls antiguo no se lee: guárdalo como .xlsx o como CSV. De un PDF solo se leen las tablas.