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 Estado de Resultados de Bancos son los siguientes:

Lista de instituciones existentes 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/resultados/<year>/<month>/instituciones?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/resultados/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>
Estado de Resultados de una institución para el año especificado:

Descripción: Obtener un archivo en xml o json que contiene el Estado de Resultados completo de la institución que se haya especificado, para todos los meses 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/resultados/<year>/instituciones/<codigoInstitucion>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

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

Resultado: Entrega un archivo en formato xml con el balance de cada mes 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">
      <CodigosEstadosDeResultado>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>1</Mes>
      <MonedaChilenaNoReajustable>50874,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>-27942,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>226,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>3266,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>26424,00</MonedaTotal>
      </CodigoEERRIFI>
      .
      .
      .
      </CodigosEstadosDeResultado>
      </ReportesBancarios>
Estado de Resultados de una institución para el mes del año especificado:

Descripción: Obtener un archivo en xml o json que contiene el Estado de Resultados 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/resultados/<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/resultados/2009/12/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el Estado de Resultados del mes de diciembre 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">
      <CodigosEstadosDeResultado>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>12</Mes>
      <MonedaChilenaNoReajustable>425214,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>184285,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>3131,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>39387,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>652017,00</MonedaTotal>
      </CodigoEERRIFI>
      .
      .
      .
      </CodigosEstadosDeResultado>
      </ReportesBancarios>
Estado de Resultados de una institución para el mes especificado durante un periodo de años

Descripción: Obtener el Estado de Resultados 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 de cuentas son 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/resultados/<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/resultados/periodo3/06/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el Estado de Resultados 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">
      <CodigosEstadosDeResultado>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>6</Mes>
      <MonedaChilenaNoReajustable>237237,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>7821,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>834,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>20656,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>266548,00</MonedaTotal>
      </CodigoEERRIFI>
      .
      .
      .
      </CodigosEstadosDeResultado>
      </ReportesBancarios>
Lista de cuentas existentes en el Estado de Resultados 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/resultados/<year>/<month>/cuentas?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/resultados/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 Estado de Resultados 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>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      </descripcionCodigoIFI>
      .
      .
      .
      </DescripcionesCodigosContables>
      </ReportesBancarios>
Detalle de una cuenta del Estado de Resultados durante el mes del año especificado para todas las instituciones

Descripción: Entrega el detalle la cuenta del Estado de Resultados 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/resultados/<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/resultados/2009/12/cuentas/4100000?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta INGRESOS POR INTERESES Y REAJUSTES (Código 4100000) para todas las instituciones, respecto del Estado de Resultados 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">
      <CodigosEstadosDeResultado>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>001</CodigoInstitucion>
      <NombreInstitucion>BANCO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>12</Mes>
      <MonedaChilenaNoReajustable>686259,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>132089,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>9476,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>65183,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>893007,00</MonedaTotal>
      </CodigoEERRIFI>
      .
      .
      .
      </CodigosEstadosDeResultado>
      </ReportesBancarios>
Detalle de cuenta del Estado de Resultados durante el año especificado para todas las instituciones

Descripción: Entrega el detalle de la cuenta del Estado de Resultados 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/resultados/<year>/cuentas/<codigoCuentas>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

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

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta INGRESOS POR INTERESES Y REAJUSTES (Código 4100000) para todas las instituciones, respecto de todos los Estados de Resultados 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">
      <CodigosEstadosDeResultado>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>001</CodigoInstitucion>
      <NombreInstitucion>BANCO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>1</Mes>
      <MonedaChilenaNoReajustable>79127,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>-30215,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>377,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>9492,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>58781,00</MonedaTotal>
      </CodigoEERRIFI>
      .
      .
      .
      </CodigosEstadosDeResultado>
      </ReportesBancarios>
Detalle de cuenta del Estado de Resultados durante el año especificado para la institución especificada

Descripción: Entrega el detalle de la cuenta del Estados de Resultados 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/resultados/<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/resultados/2009/cuentas/4100000/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta INGRESOS POR INTERESES Y REAJUSTES (Código 4100000) 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">
      <CodigosEstadosDeResultado>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>1</Mes>
      <MonedaChilenaNoReajustable>50874,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>-27942,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>226,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>3266,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>26424,00</MonedaTotal>
      </CodigoEERRIFI>
      .
      .
      .
      </CodigosEstadosDeResultado>
      </ReportesBancarios>
Detalle de cuenta del Estado de Resultados 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/resultados/<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/resultados/2009/12/cuentas/4100000/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta INGRESOS POR INTERESES Y REAJUSTES (Código 4100000) 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">
      <CodigosEstadosDeResultado>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>12</Mes>
      <MonedaChilenaNoReajustable>425214,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>184285,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>3131,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>39387,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>652017,00</MonedaTotal>
      </CodigoEERRIFI>
      </CodigosEstadosDeResultado>
      </ReportesBancarios>
Detalle de cuenta del Estado de Resultados 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/resultados/<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/resultados/periodo3/06/cuentas/4100000/instituciones/012?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con los valores correspondientes para la Cuenta INGRESOS POR INTERESES Y REAJUSTES (Código 4100000) 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">
      <CodigosEstadosDeResultado>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2009</Anho>
      <Mes>6</Mes>
      <MonedaChilenaNoReajustable>237237,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>7821,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>834,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>20656,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>266548,00</MonedaTotal>
      </CodigoEERRIFI>
      <CodigoEERRIFI>
      <CodigoCuenta>4100000</CodigoCuenta>
      <DescripcionCuenta>INGRESOS POR INTERESES Y REAJUSTES</DescripcionCuenta>
      <CodigoInstitucion>012</CodigoInstitucion>
      <NombreInstitucion>BANCO DEL ESTADO DE CHILE</NombreInstitucion>
      <Anho>2010</Anho>
      <Mes>6</Mes>
      <MonedaChilenaNoReajustable>179704,00</MonedaChilenaNoReajustable>
      <MonedaReajustablePorIPC>248872,00</MonedaReajustablePorIPC>
      <MonedaReajustablePorTipoDeCambio>370,00</MonedaReajustablePorTipoDeCambio>
      <MonedaExtranjera>16885,00</MonedaExtranjera>
      <MonedaChilena/>
      <MonedaTotal>445831,00</MonedaTotal>
      </CodigoEERRIFI>
      </CodigosEstadosDeResultado>
      </ReportesBancarios>

Actualizado: 01/06/2019