Combos — Importar CSV/ZIP

Frecuencia de actualización recomendada: 3 horas

Define los códigos de artículos que se utilizarán como combos interactivos en el dispositivo móvil. Un combo interactivo es un artículo compuesto por 1 o más componentes. Cada componente está definido como un conjunto de 1 o más SKU y establece una cantidad exacta necesaria de unidades y un descuento asignado. El código de combo, junto a su descripción, ramo y línea se debe cargar en la importación Artículos. Se envía como archivo CSV o ZIP en el campo Combos de un multipart/form-data.

POST/v1/files/combosCSV · ZIP

Campos genéricos · Request body

Campo	Tipo	Descripción
codigo	String(20)Required	Código del combo. Recordar que este código debe estar y ser único en la tabla Articulos.
componente_codigo	String(20)Required	Código del componente.
componente_nombre	String(255)Required	Nombre del componente.
cantidad	IntRequired	Cantidad a completar por los artículos que componen al componente.
descuento	DecimalRequired	Descuento a aplicar en este componente.
precio	String	Precio individual a aplicar sobre los componentes del combo.

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/combos' \
  --header 'X-API-KEY: {tenant-apikey}' \
  --form 'Combos=@"combos.csv"'

RESPONSE · 200 OK

{
  "success": true,
  "message": "Archivo Combos subido OK"
}

RESPONSE · ERROR

{
  "success": false,
  "message": "Error subiendo archivo combos.csv -> Ha ocurrido un error inesperado al intentar actualizar la tabla."
}