Bonificaciones — Importar CSV/ZIP

Frecuencia de actualización recomendada: 1 hora

Define los posibles descuentos para aplicar a los artículos. Se envía como archivo CSV o ZIP en el campo Bonificaciones de un multipart/form-data.

POST/v1/files/bonificacionesCSV · ZIP

Jerarquía de bonificaciones (según importancia y existencia): 1. Canasta · 2. Orden manual · 3. Código artículo · 4. Línea artículo · 5. Rubro artículo · 6. Grupo artículo · 7. Marca artículo · 8. Proveedor artículo. El valor más bajo de Orden Manual es el de mayor jerarquía en caso de haber múltiples bonificaciones aplicables con orden manual.

Campos genéricos · Request body

Campo	Tipo	Descripción
codigo	String(20)Required	Código identificador del registro.
bonifId	String(15)Required	Código identificador de la bonificación asociado al campo "BonifId" en la tabla Clientes.
codArt	String(20)	Código de artículo.
cantSuperior	IntRequired	Cantidad mínima para que se efectúe la bonificación.
desc	Decimal	Descuento que se aplica en la bonificación.
sinCargo	String(20)	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".
listaP	Int(4)	Lista de precios sobre la que se aplica el descuento si la aplicación dispone la libre elección de lista de precio, sino se utiliza como condición de aplicación la lista de precio del cliente.
grupoArticulo	String(255)	Grupo de artículos al que aplica la bonificación, se relaciona con el grupo de los artículos.
codigoGrupoArticulo	String(255)	Código del grupo de artículos.
rubroArticulo	String(255)	Rubro de artículos al que aplica la bonificación, se relaciona con el campo rubro de Artículos.
codigoRubroArticulo	String(255)	Código del rubro de artículos.
lineaArticulo	String(255)	Línea de artículos al que aplica la bonificación, se relaciona con el campo línea de Artículos.
precio	Decimal	Precio que será aplicado.
marca	String(255)	Marca de artículos al que aplica la bonificación, se relaciona con el campo marca de Articulos.
canasta	String(255)	Bonificaciones por canasta. Bonificación con mayor prioridad.
canastaDescripcion	String(255)	Breve descripción de la canasta a la que corresponde el artículo.
topeDesc	Decimal	Tope descuento, expresado en porcentaje, por defecto no invalida el campo "TopeDesc" de la tabla de artículos.
codigoProveedor	String(255)	Bonificaciones por código de proveedor.
empresa	String(255)	Bonificaciones por código de empresa.
porBulto	String(1)Required	Indica si la política es por bulto cerrado. La cantidad tiene que ser exacta o múltiplo del PACK (bulto). Si se abre un bulto, esta política ya no se aplica. S: Si \| N: No.
ordenManual	String(20)	Bonificaciones por orden manual. Numérico y ascendente. Prioridad sobre cualquier bonificación exceptuando canasta.
sucursal	String(15)	Código de la sucursal asociada a la bonificación.
esCantidadEnBultos	String(1)Required	Indica si la cantidad expresada en cantSuperior es unidad o bulto. S: Si \| N: No.
vendedor	String(15)	Código del vendedor.

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

RESPONSE · 200 OK

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

RESPONSE · ERROR

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