Bancos — Importar CSV/ZIP

Frecuencia de actualización recomendada: 1 día

Entidades bancarias/financieras disponibles para la cobranza. Se envía como archivo CSV o ZIP en el campo Banco de un multipart/form-data.

POST/v1/files/bancosCSV · ZIP

Campos genéricos · Request body

Campo	Tipo	Descripción
nombre	String(255)Required	Nombre de la entidad bancaria/financiera.
entidad	String(20)Required	Nómina de entidad regida por el banco central.

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

RESPONSE · 200 OK

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

RESPONSE · ERROR

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