Artículos — Importar CSV/ZIP
Frecuencia de actualización recomendada: 3 horas
Importa el catálogo de productos. Se envía como archivo CSV o ZIP en el campo Articulos de un multipart/form-data.
POST
/v1/files/articulosCSV · ZIPCampos genéricos · Request body
| Campo | Tipo | Descripción |
|---|---|---|
| codigo | String(20)Required | Código del artículo. |
| descripcion | String(255)Required | Descripción del artículo. |
| linea | String(255)Required | Nombre de la línea del producto. |
| rubro | String(255)Required | Nombre del rubro del producto. Tiene mayor jerarquía que línea. Ejemplo: Rubro (Gaseosas) → Línea (Pepsi) → Artículo (Pepsi 1.5l). |
| capacidad | Decimal | Volumen del bulto expresado en hectolitros, si es aplicable. |
| pack | IntRequired | Unidades por bulto que conforman un pack. Si pack es 1, los pedidos se expresan en unidades. Si pack es mayor a 1, los pedidos se expresan en bultos. |
| impuestoInt | Decimal | Impuesto interno expresado en pesos [$]. Este impuesto no debe estar incluido en el precio. |
| topeDesc | Decimal | Tope de descuento aplicable al artículo, expresado en porcentaje. |
| costo | Decimal | Costo real, expresado en pesos [$] luego de realizar todos los descuentos correspondientes. Ej: acuerdo, financiero, etc. |
| codigoIva | Int | Código de Iva del archivo Iva. Por defecto en "1" (se aplicará 21%) si no hay archivo de Iva. |
| codBarra | String(13) | Código de barra en formato EAN 13. |
| codBarraPack | String(14) | Código de barra en formato DUN14 de la caja, si es aplicable. |
| marca | String(255) | Nombre de la marca del producto. |
| fabrica | String(255) | Nombre de la fábrica del producto. |
| peso | Decimal | Peso del bulto expresado en kg. |
| codigoGrupo | String(20) | Código del grupo al que pertenece el artículo. |
| grupo | String(20) | Grupo al que pertenece el artículo. |
| codigoProveedor | String(20) | Código del proveedor. |
| proveedor | String(255) | Nombre de la empresa proveedora del producto. |
| lista1 … lista20 | String(255) | Listas de precios 1 a 20. Formato: "1000.00". |
| combo | Int | Indica si el código del artículo hace referencia a un combo (no hace diferencia entre combo estático y combo dinámico). 1: True | 0: False. |
| esPesable | String(1) | Indica si el artículo se vende por peso (el precio es por kg). 1: True | 0: False. |
| canasta | String(255) | Canasta a la cual pertenece el artículo. |
Response body
| Campo | Tipo | Descripción |
|---|---|---|
| success | BooleanRequired | Indica si la operación se procesó con éxito. |
| message | String | Mensaje con el resultado. Si success es false, detalla el motivo del error. |
Respuestas
| Código | Significado |
|---|---|
| 200 | Importación procesada. El campo success indica el resultado; si es false, message detalla el motivo. |
| 403 | La API key enviada en X-API-KEY no es válida. |
| 404 | Falta el header X-API-KEY o la URL es incorrecta. |
| 429 | Se superó el límite de 30 requests por minuto. |
| 500 | Error interno del servidor. Reintentar más tarde. |
cURL
curl --location 'https://gateway.axum.com.ar/{tenant}/api/v1/files/articulos' \ --header 'X-API-KEY: {tenant-apikey}' \ --form 'Articulos=@"articulos.csv"'
REQUEST · CSV DE EJEMPLO
"codigo","descripcion","lista1","lista2","linea","rubro","capacidad","pack","topeDesc" "10550","PEPSI 1 L X6","23.5","25","PEPSI","GASEOSAS","0.09","6","70" "10551","PEPSI 1 L X12","46.5","50","PEPSI","GASEOSAS","0.18","12","75"
RESPONSE · 200 OK
{
"success": true,
"message": "Archivo Articulos subido OK"
}RESPONSE · ERROR
{
"success": false,
"message": "Error subiendo archivo articulos.csv -> Ha ocurrido un error inesperado al intentar actualizar la tabla."
}