Características Generales

Para la puesta en marcha y uso de este recurso, se recomienda tener en cuenta lo siguiente:

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.

Los parámetros utilizados en el API CMF Bancos son los siguientes:

  • 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:

  • 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

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 CMF Bancos. En cualquier caso, un error generá un archivo XML con la información correspondiente.

Recursos disponibles

Los recursos disponibles para el Balance Mensual de Bancos son los siguientes:

Lista de instituciones existentes en el Balance durante el mes del año especificado:

Descripción: Permite obtener un listado en xml o json con el código y el nombre de cada institución para la que exista información en una fecha dada.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<year>/<month>/instituciones?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/2009/12/instituciones?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el listado de instituciones vigentes a diciembre de 2009.

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <DescripcionesCodigosDeInstituciones>
      <descripcionIFI>
      <CodigoInstitucion>001</CodigoInstitucion>
      <NombreInstitucion>BANCO DE CHILE</NombreInstitucion>
      </descripcionIFI>
      .
      .
      .
      </DescripcionesCodigosDeInstituciones>
      </ReportesBancarios>
Balance de una institución con resultados para todos los meses del año especificado:

Descripción: Obtener un archivo en xml o json que contiene el balance completo de la institución que se haya especificado, para cada mes del año que se haya indicado.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<year>/instituciones/<codigoInstitucion>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/2009/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el balance del año 2009 para el Banco del Estado (Código 012).

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <CodigosBalances>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>1</Mes>
      <MonedaChilenaNoReajustable>6410679,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>6763382,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>26579,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>1865378,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>15066018,00</MonedaTotal>
      </CodigoBalanceIFI>
      .
      .
      .
      </CodigosBalances>
      </ReportesBancarios>
Balance de una institución para un solo mes del año especificado:

Descripción: Obtener un archivo en xml o json que contiene el balance completo de la institución que se haya especificado, para el mes y año que se haya indicado.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<year>/<month>/instituciones/<codigoInstitucion>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/2009/01/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el balance del mes de enero del año 2009 para el Banco del Estado (Código 012).

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <CodigosBalances>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>1</Mes>
      <MonedaChilenaNoReajustable>6410679,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>6763382,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>26579,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>1865378,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>15066018,00</MonedaTotal>
      </CodigoBalanceIFI>
      .
      .
      .
      </CodigosBalances>
      </ReportesBancarios>
Balance de una institución para el mes especificado durante un periodo determinado de años

Descripción: Obtener el Balance de una institución para el mes especificado durante un periodo predeterminado de años (periodo1 = [Años 1995-2007], periodo2 = [2008], periodo3 = [2009-hoy]). Dichos períodos corresponden a los años en que los códigos contables fueron comparables.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<periodo1|periodo2|periodo3>/<month>/instituciones/<codigoInstitucion>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/periodo3/06/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el balance del mes de junio de 2009 y 2010 (ambos comprendidos dentro del periodo3) para el Banco del Estado (Código 012).

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <CodigosBalances>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>6</Mes>
      <MonedaChilenaNoReajustable>6944071,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>6640698,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>21870,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>1806646,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>15413285,00</MonedaTotal>
      </CodigoBalanceIFI>
      .
      .
      .
      </CodigosBalances>
      </ReportesBancarios>
Lista de cuentas existentes en el Balance durante el mes del año especificado

Descripción: Obtener el lista de las cuentas existentes con su Código y Descripción durante el mes del año especificado.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<year>/<month>/cuentas?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/2009/12/cuentas?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el listado de las Cuentas con su Código y Descripción para el balance del mes de diciembre de 2009.

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <DescripcionesCodigosContables>
      <descripcionCodigoIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      </descripcionCodigoIFI>
      .
      .
      .
      </DescripcionesCodigosContables>
      </ReportesBancarios>
Detalle de cuenta del Balance durante el mes del año especificado para todas las instituciones

Descripción: Entrega el detalle la cuenta del Balance que se indique para el mes del año que se haya especificado, respecto a todas las instituciones.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<year>/<month>/cuentas/<codigoCuentas>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/2009/12/cuentas/1000000?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta ACTIVOS (Código 1000000) para todas las instituciones, respecto del balance del mes de diciembre de 2009.

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <CodigosBalances>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>001</CodigoInstitucion>
      <NombreInstitucion>BANCO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>12</Mes>
      <MonedaChilenaNoReajustable>8562959,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>6438946,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>83174,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>2376741,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>17461820,00</MonedaTotal>
      </CodigoBalanceIFI>
      .
      .
      .
      </CodigosBalances>
      </ReportesBancarios>
Detalle de cuenta del Balance durante el año especificado para todas las instituciones

Descripción: Entrega el detalle de la cuenta que se indique para cada uno de los meses del año que se haya especificado, respecto a todas las instituciones.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<year>/cuentas/<codigoCuentas>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/2009/cuentas/1000000?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta ACTIVOS (Código 1000000) para todas las instituciones, respecto de todos los balances mensuales del año 2009.

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <CodigosBalances>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>001</CodigoInstitucion>
      <NombreInstitucion>BANCO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>12</Mes>
      <MonedaChilenaNoReajustable>8562959,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>6438946,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>83174,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>2376741,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>17461820,00</MonedaTotal>
      </CodigoBalanceIFI>
      .
      .
      .
      </CodigosBalances>
      </ReportesBancarios>
Detalle de cuenta del Balance durante el año especificado para la institución indicada

Descripción: Entrega el detalle de la cuenta que se indique para todos los meses del año que se haya especificado, respecto la institución que se haya indicado.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<year>/cuentas/<codigoCuentas>/instituciones/<codigoInstitucion>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/2009/cuentas/1000000/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta ACTIVOS (Código 1000000) para el Banco del Estado (Código 012) para cada mes del año 2009.

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <CodigosBalances>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>1</Mes>
      <MonedaChilenaNoReajustable>6410679,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>6763382,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>26579,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>1865378,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>15066018,00</MonedaTotal>
      </CodigoBalanceIFI>
      .
      .
      .
      </CodigosBalances>
      </ReportesBancarios>
Detalle de cuenta del Balance durante el mes del año especificado para la institución especificada

Descripción: Entrega el detalle de la cuenta que se indique para el mes del año que se haya especificado, respecto la institución que se haya indicado.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<year>/<month>/cuentas/<codigoCuentas>/instituciones/<codigoInstitucion>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/2009/12/cuentas/1000000/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta ACTIVOS (Código 1000000) para el Banco del Estado (Código 012) para el mes de diciembre del año 2009.

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <CodigosBalances>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>12</Mes>
      <MonedaChilenaNoReajustable>7976294,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>7092272,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>16557,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>1808405,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>16893528,00</MonedaTotal>
      </CodigoBalanceIFI>
      </CodigosBalances>
      </ReportesBancarios>
Detalle de cuenta del Balance durante el mes especificado durante un periodo predeterminado de años

Descripción: Detalle de cuenta durante el mes especificado durante un periodo predeterminado de años (periodo1 = [Años 1995-2007], periodo2 = [2008], periodo3 = [2009-hoy]) para la institución especificada. Dichos períodos corresponden a los años en que los códigos contables fueron comparables.

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

Input: https://api.sbif.cl/api-sbifv3/recursos_api/balances/<periodo1|periodo2|periodo3>/<month>/cuentas/<codigoCuentas>/instituciones/<codigoInstitucion>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/balances/periodo3/06/cuentas/1000000/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta ACTIVOS (Código 1000000) para el Banco del Estado (Código 012) para el mes de junio de los años 2009 y 2010 (ambos incluidos en el periodo3).

  • Ejemplo de Código de Resultado
    • <ReportesBancarios xsi:schemaLocation="https://api.sbif.cl/XMLSchema ReportesBancarios-v1.0.xsd" SchemaVersion="1.0">
      <CodigosBalances>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>6</Mes>
      <MonedaChilenaNoReajustable>6944071,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>6640698,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>21870,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>1806646,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>15413285,00</MonedaTotal>
      </CodigoBalanceIFI>
      <CodigoBalanceIFI>
      <CodigoCuenta>1000000</CodigoCuenta>
      <DescripcionCuenta>ACTIVOS</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2010</Anho>
      <Mes>6</Mes>
      <MonedaChilenaNoReajustable>7496930,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>7386168,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>15870,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>2444909,00</MonedaExtranjera>
      <MonedaReajustable/>
      <MonedaTotal>17343877,00</MonedaTotal>
      </CodigoBalanceIFI>
      </CodigosBalances>
      </ReportesBancarios>

Actualizado: 01/06/2019