Percepciones — Importar CSV/ZIP

Frecuencia de actualización recomendada: 1 día

Percepciones impositivas aplicables por cliente o artículo. Se envía como archivo CSV o ZIP en el campo Percepciones de un multipart/form-data.

POST/v1/files/percepcionesCSV · ZIP

Campos genéricos · Request body

Campo	Tipo	Descripción
codigo	String(15)Required	Código de percepción. Es la relación con la tabla Clientes en el campo percepid.
minIB	DecimalRequired	Es el mínimo valor desde el cual se comienza a percibir, expresado en pesos.
percepIB	DecimalRequired	Valor de percepción a aplicar dividido 100. Ej: 2.5% en el campo se coloca 0.025.
des	String(255)	Descripción. Ej: Impuesto provincial, ARBA, etc.
codigoArticulo	String(20)	Código del artículo asociado a la percepción.
linea	String(255)	Línea de los artículos asociados a la percepción.
rubro	String(255)	Rubro de los artículos asociados a la percepción.

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

RESPONSE · 200 OK

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

RESPONSE · ERROR

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