Stock — Importar CSV/ZIP

Frecuencia de actualización recomendada: 15/30 minutos

Actualiza las existencias disponibles por artículo y depósito. Se envía como archivo CSV o ZIP en el campo Stock de un multipart/form-data.

POST/v1/files/stockCSV · ZIP

Campos genéricos · Request body

Campo	Tipo	Descripción
codArt	String(20)Required	Código de artículo asociado al stock.
stockIni	String(10)Required	Stock inicial del artículo. Los números antes del punto son la cantidad de bultos del artículo, los que están después del punto son la cantidad de unidades del artículo. Ej: "30.10", "30", "-20.0".
stockMin	String(10)	Stock mínimo a partir del cual da aviso al dispositivo móvil que no hay stock. Mismo formato bultos.unidades.
codigoDeposito	String(255)Required	Nombre identificador del depósito.

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

REQUEST · CSV DE EJEMPLO

"codart","stockini","stockmin","codigodeposito"
"291","155.8","25.0","01"
"119","233.5","10","02"

RESPONSE · 200 OK

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

RESPONSE · ERROR

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