Uso de parámetros GET

La API fue implementada para que las URIs puedan ser utilizadas mediante parámetros GET, con el objetivo de indicar las características de la petición que se ejecuta. El orden en que se indiquen estos parámetros no es relevante.

En la versión 3.0 de la API, las URIs deben incluir los siguientes parámetros para ser consideradas válidas:

  • apikey: permite incluir el valor de la clave se haya entregado al usuario.
  • formato: permite indicar si el archivo de salida será en formato JSON o XML; si no se utiliza este parámetro, la salida será en XML. Los parámetros se pueden indicar en mayúsculas (JSON|XML) o en minúsculas (json|xml).
  • callback: este parámetro es opcional y sólo se emplea cuando se pide un archivo de salida del tipo JSON (para obtener la respuesta usando JSONP). En caso de solicitarse una salida JSON y no especificarse una función de callback, se retorna JSON normal.

En cada uno de los recursos que se detallan en esta documentación se explica de manera más específica la forma de incluirlos.

Uso de parámetros generales en las URIs

Las URIS deben incluir la fecha en su contenido, por lo que se debe escribir el año, el mes y el día, si corresponde, para obtener la información. En cada caso, la inclusión se hace de la siguiente manera:

  • Raíz: Todas las peticiones deben comenzar con la siguiente línea: http://api.sbif.cl/api-sbifv3/recursos_api/
  • Year: se deben incluir cuatro números del año en el formato AAAA
  • Month: se deben incluir dos números del mes en el formato MM
  • Day: se deben incluir dos números del día en el formato DD
  • Institución: El código SBIF en formato NNN correspondiente a la institución de la que desea obtener datos (ver listado aquí). Si desea datos para el Sistema Financiero en su conjunto, utilice el código 999.

Los parámetros de año, mes e institución son opcionales. En caso de omitirse el año, el resultado de la petición mostrará todos los datos solicitados hasta donde estén disponibles. No se puede usar la variable del mes sin que sea precedida por la del año.

Códigos de Error

Cualquier llamado a los recursos que no cumpla con la entrega de la API Key o que tenga parámetros errados, generá un código de error con información general con la numeración usada en el protocolo HTTP y con información particular, de acuerdo a la nomenclatura utlizada en la API SBIF. En cualquier caso, un error generá un archivo XML con la información correspondiente.

Recursos disponibles

Los recursos disponibles para la Fichas Bancarias son los siguientes:

Perfil de una institución financiera:

Descripción: Entrega el código SWIFT, nombre, RUT, dirección, teléfono, datos de contacto, número de sucursales y empleados de la institución requerida.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: http://api.sbif.cl/api-sbifv3/recursos_api/perfil/instituciones/<Institución>/<Year>/<Month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/perfil/instituciones/001/2013/08?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega la información de ficha del Banco de Chile (Código 001) al mes de agosto de 2013 en formato XML.

  • Ejemplo de Código de Resultado
    • <reportePerfil SchemaVersion="1.0" xsi:schemaLocation="http://api.sbif.cl http://api.sbif.cl/ReporteGrafico-v1.0.xsd">
      <Perfiles>
      <Perfil>
      <codigoSWIFT>BCHI CL RM</codigoSWIFT>
      <nombre>BANCO DE CHILE</nombre>
      <rut>97.004.000-5</rut>
      <direccionPrincipal>Ahumada 251, Santiago</direccionPrincipal>
      <telefono>(56-2) 653 11 11</telefono>
      <direccionWeb>www.bancochile.cl</direccionWeb>
      <contactoPublico>Pamela Valdivia</contactoPublico>
      <direccionPublico>Huérfanos 980, 8º Piso, Santiago</direccionPublico>
      <telefonoPublico>(56-2) 653 06 73</telefonoPublico>
      <sucursales>420</sucursales>
      <empleados>10515</empleados>
      <fechaPublicacion>2011-11-29 00:00:00.0</fechaPublicacion>
      </Perfil>
      <Institucion>
      <CodigoInstitucion>001</CodigoInstitucion>
      <NombreInstitucion>BANCO DE CHILE</NombreInstitucion>
      </Institucion>
      </Perfiles>
      </reportePerfil>
      </IndicadoresFinancieros>
Accionistas de una institución financiera:

Descripción: Permite obtener un listado en xml o json con la nómina de accionistas de la institución requerida, junto con su número de acciones y porcentaje de participación.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: http://api.sbif.cl/api-sbifv3/recursos_api/accionistas/instituciones/<Institución>/anhos/<Year>/meses/<Month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/accionistas/instituciones/504/anhos/2013/meses/01/?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Obtiene un listado en xml o json con la nómina de accionistas del Banco BBVA (Código 504), con sus correspondientes participaciones, al mes de enero de 2013 en formato XML.

  • Ejemplo de Código de Resultado
    • <ReportesBancarios SchemaVersion="1.0" xsi:schemaLocation="http://api.sbif.cl http://api.sbif.cl/ReportesBancarios-v1.0.xsd">
      <CodigosBalances/>
      <CodigosEstadosDeResultado/>
      <DescripcionesCodigosContables/>
      <DescripcionesCodigosDeInstituciones/>
      <AdecuacionDeCapital/>
      <AcreenciasBancarias/>
      <Accionistas>
      <ReporteAccionista>
      <Institucion>
      <CodigoInstitucion>504</CodigoInstitucion>
      <NombreInstitucion>Banco Bilbao Vizcaya Argentaria Chile</NombreInstitucion>
      </Institucion>
      <Periodo>
      <Anho>2013</Anho>
      <Mes>1</Mes>
      </Periodo>
      <DescripcionAccionista>
      <Nombre>UGAS CANELO LUIS RUDECINDO</Nombre>
      <Participacion>0</Participacion>
      <NumeroAcciones>3</NumeroAcciones>
      <FechaAsuncion>2012-12-31</FechaAsuncion>
      <FechaExpiracion>2013-03-31</FechaExpiracion>
      <HechoEsencial/>
      </DescripcionAccionista>
      .
      .
      .
      </DescripcionAccionista>
      </ReporteAccionista>
      </Accionistas>
      <Directores/>
      <Integrantes/>
      <Documentos/>
      <Periodo/>
      </ReportesBancarios>
Ejecutivos principales de una institución financiera:

Descripción: Permite obtener un listado en xml o json con la nómina de ejecutivos principales de la institución requerida.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: http://api.sbif.cl/api-sbifv3/recursos_api/integrantes/instituciones/<Institución>/anhos/<Year>/meses/<Month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/integrantes/instituciones/012/anhos/2013/meses/05/?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Obtiene la nómina de integrantes del Banco del Estado (Código 012) al mes de mayo de 2013 en formato XML.

  • Ejemplo de Código de Resultado
    • <ReportesBancarios SchemaVersion="1.0" xsi:schemaLocation="http://api.sbif.cl http://api.sbif.cl/ReportesBancarios-v1.0.xsd">
      <CodigosBalances/>
      <CodigosEstadosDeResultado/>
      <DescripcionesCodigosContables/>
      <DescripcionesCodigosDeInstituciones/>
      <AdecuacionDeCapital/>
      <AcreenciasBancarias/>
      <Accionistas/>
      <Directores/>
      <Integrantes>
      <ReporteIntegrante>
      <Institucion>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>Banco del Estado de Chile</NombreInstitucion>
      </Institucion>
      <Periodo>
      <Anho>2013</Anho>
      <Mes>5</Mes>
      </Periodo>
      <DescripcionIntegrante>
      <Nombre>DE LAS HERAS VAL EDUARDO JAVIER</Nombre>
      <Apellidos/>
      <Cargo>Ejecutivo principal</Cargo>
      <FechaAsuncion>2006-08-22</FechaAsuncion>
      <FechaExpiracion/>
      <HechoEsencial/>
      <Tipo>1</Tipo>
      </DescripcionIntegrante>
      </ReporteIntegrante>
      <ReporteIntegrante>
      <Institucion>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>Banco del Estado de Chile</NombreInstitucion>
      </Institucion>
      .
      .
      .
      </DescripcionIntegrante>
      </ReporteIntegrante>
      </Integrantes>
      <Documentos/>
      <Periodo/>
      </ReportesBancarios>

Actualizado: 26/07/2017