Usted está en: Portada > Documentación > Uso de la API Key

Códigos de Error de la API

Con el objetivo de ofrecer información a los desarrolladores que utilizan la API CMF Bancos, la aplicación entrega códigos de error como respuesta en formato XML. En este documento se detallan sus números y significados.

Numeración existente

Los códigos de error posibles son los relativos a las siguientes situaciones:

  • 60-69: Errores relacionados con la conexión a la base de datos del sitio web SBIF
  • 70-79: Errores relacionados al ingreso de parámetros por parte del usuario de la API
  • 80-89: Errores relacionados a los datos en las bases de datos de la SBIF
  • 90-99: Errores relacionados al acceso a la API SBIF

A continuación se entrega la descripción de todos los existentes a la fecha de este documento:

RANGO DE ERRORES DEL 60 - 69

Errores relacionados al ingreso de parámetros por parte del usuario de la API.

Código de error API.SBIF: 60
  • Código de respuesta http: 503 (Service Unavailable)
  • Mensaje: "Momentaneamente no es posible acceder a el o los recursos solicitados, por favor intente nuevamente."
  • Detalle: Nuestro servidor presenta problemas técnicos que dificultan o imposibilitan la entrega de resultados. Estos errorres pueden ser de acceso a la base de datos, servidores caidos, etc.

RANGO DE ERRORES DEL 70 - 79

Errores relacionados al ingreso de parámetros por parte del usuario de la API.

Código de error API.SBIF: 70
  • Código de respuesta http: 404 (not found)
  • Mensaje: "Alguno de los campos de la fecha presenta errores tipográficos"
  • Detalle: Alguno de los valores ingresados como fecha de consulta presentan errores tipográficos que los dejan sin sentido semántico.
  • Ejemplo: http://api.sbif.cl/api-sbif/recursos/euro/200a9/02 => año 200a9 no es un año que exista
Código de error API.SBIF: 71
  • Código de respuesta http: 404 (not found)
  • Mensaje: "Fecha especificada no es válida"
  • Detalle: Si bien los valores ingresados como fecha no presentan errores tipográficos, son valores que no tienen sentido en la realidad.
  • Ejemplo: http://api.sbif.cl/api-sbif/recursos/euro/2010/02/30 => no existe el 30 de febrero del 2010 en el calendario
Código de error API.SBIF: 72
  • Código de respuesta http: 404 (not found)
  • Mensaje: "Fecha especificada es posterior a la fecha actual"
  • Detalle: Los valores ingresados como fecha representan una fecha posterior al dia actual.
  • Ejemplo: http://api.sbif.cl/api-sbif/recursos/euro/2020/12/30
Código de error API.SBIF: 73
  • Código de respuesta http: 404 (not found)
  • Mensaje: "Tipo de retorno especificado no es provisto por el API o posee errores tipográficos"
  • Detalle: El tipo de retorno pedido al API actualmente no está soportado o es un tipo de retorno erróneo.
  • Ejemplo: http://api.sbif.cl/api-sbif/recursos/euro/2012/12/30 => actualmente el API solo entrega XML y JSON
Código de error API.SBIF: 74
  • Código de respuesta http: 404 (not found)
  • Mensaje: "Cuenta especificada no es válida"
  • Detalle: El valor ingresado como Código de Cuenta es erróneo.
  • Ejemplo: http://api.sbif.cl/api-sbif/recursos/balances/2009/12/cuentas/10000 => El código de cuenta indicado no existe.
Código de error API.SBIF: 75
  • Código de respuesta http: 404 (not found)
  • Mensaje: "Institucion especificada no es valida"
  • Detalle: El valor ingresado como Código de cuenta es erroneo.
  • Ejemplo: http://api.sbif.cl/api-sbif/recursos/balances/2009/11/cuentas/1000000 => El código de banco indicado no existe.

RANGO DE ERRORES DEL 80 - 89

Errores relacionados a los datos en las bases de datos de la SBIF.

Código de error API.SBIF: 80
  • Código de respuesta http: 404 (not found)
  • Mensaje: "No hay datos para los parámetros ingresados de fecha o periodo"
  • Detalle: La consulta no retorna datos.
  • Ejemplo: http://api.sbif.cl/api-sbif/recursos/euro/2010/10/02 => fecha corresponde a un día sábado, cuando el EURO no es publicado.
Código de error API.SBIF: 81
  • Código de respuesta http: 404 (not found)
  • Mensaje: "El recurso correspondiente al dia actual aun no ha sido cargado"
  • Detalle: La consulta realizada sobre la fecha actual no retorna valores.
  • Ejemplo: http://api.sbif.cl/api-sbif/recursos/euro?

RANGO DE ERRORES DEL 90 - 99

Errores relacionados a los datos en las bases de datos de la SBIF.

Código de error API.SBIF: 90
  • Código de respuesta http: 420
  • Mensaje: "Su cuota de acceso al servicio ha sido superada"
  • Detalle: Retornado cuando un usuario intenta acceder a un servicio usando un API KEY que ha superado su cuota de acceso.
Código de error API.SBIF: 91
  • Código de respuesta http: 421
  • Mensaje: "API key no valida"
  • Detalle: Retornado cuando un usuario intenta acceder a un servicio usando un API KEY que no existe dentro de los registros de la SBIF.
Código de error API.SBIF: 92
  • Código de respuesta http: 422
  • Mensaje: "API key no ha sido suministrada"
  • Detalle: Retornado cuando un usuario intenta acceder a un recurso sin suministrar un API KEY.

Actualizado: 01/06/2019