GET
/api/mod/productos/{espacio}/catalog/imports/{importacion}Una importación y sus filas
La importación y, con with_rows=true, cada fila tal como la leyó: es lo que revisas antes de activar.
- PERMISOlee (vale cualquier clave)
- 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). |
| with_rows | bool, query | no | Trae también las filas. Por defecto false. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | La importación. |
| estado | "draft" | "validada" | draft: esperando revisión. validada: ya se aplicó al catálogo. |
| origen | "csv" | "xlsx" | "pdf" | El formato del archivo. |
| doc_source | string | El nombre del archivo que subiste. |
| sha256 | string | La huella del archivo. |
| n_rows | integer | Las filas que quedan en la importación. |
| created_at | number | Segundos desde 1970, con decimales. |
| activated_at | number | null | Cuándo se activó. null mientras está en draft. |
| rows[].id | string | La fila: para descartarla. |
| rows[].payload | { nombre, sku, tipo, descripcion, precio, atributos } | Lo que leyó. precio, en texto decimal o null; atributos, las columnas que no reconoció. |
| rows[].warnings | string[] | Avisos de esa fila, p. ej. «precio ilegible: …». |
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. |
| 404 | No hay una importación con ese id | import no encontrado. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.