v1.28 ›

Inversiones — Importar CSV/ZIP

Frecuencia de actualización recomendada: 1 día

Comodatos (heladeras, freezers, etc.) colocados en los puntos de venta. Se envía como archivo CSV o ZIP en el campo Inversiones de un multipart/form-data.

POST/v1/files/inversionesCSV · ZIP
Campos genéricos · Request body
CampoTipoDescripción
codigoComodatoString(15)RequiredCódigo del comodato.
codigoClienteString(64)RequiredCódigo del punto de venta el cual posee un comodato.
codigoProductoString(50)RequiredCódigo del producto comodatado.
descripcionProductoString(255)Descripción del producto comodatado.
codigoModeloString(15)RequiredCódigo del modelo del producto comodatado de la compañía.
descripcionModeloString(255)Descripción del modelo del producto comodatado.
numeroSerieString(50)Número de serie del producto.
consumoMensualIntVenta mensual, expresada en bultos, acorde al negocio del comodato.
fechaVencimientoDateFecha de vencimiento del comodato (yyyy-MM-dd).
tipoInversionInt0: Imagen | 1: Mantenimiento | 2: Incremento.
fechaColocacionDateFecha de colocación del comodato (yyyy-MM-dd).
negocioString(50)Rubro dedicado al contenido del comodato.
vendedorString(50)Vendedor del comodato.
comodato_idString(50)Identificador del comodato.
numerocomodatoString(50)Número del comodato.
inversionString(50)Monto de la inversión.
Response body
CampoTipoDescripción
successBooleanRequiredIndica si la operación se procesó con éxito.
messageStringMensaje con el resultado. Si success es false, detalla el motivo del error.
Respuestas
CódigoSignificado
200Importación procesada. El campo success indica el resultado; si es false, message detalla el motivo.
403La API key enviada en X-API-KEY no es válida.
404Falta el header X-API-KEY o la URL es incorrecta.
429Se superó el límite de 30 requests por minuto.
500Error interno del servidor. Reintentar más tarde.
cURL
curl --location 'https://gateway.axum.com.ar/{tenant}/api/v1/files/inversiones' \
  --header 'X-API-KEY: {tenant-apikey}' \
  --form 'Inversiones=@"inversiones.csv"'
RESPONSE · 200 OK
{
  "success": true,
  "message": "Archivo Inversiones subido OK"
}
RESPONSE · ERROR
{
  "success": false,
  "message": "Error subiendo archivo inversiones.csv -> Ha ocurrido un error inesperado al intentar actualizar la tabla."
}