Antes de comenzar

La Unidad Tributaria Mensual (UTM) es calculada por el Servicio de Impuestos Internos y publicada el primer día hábil de cada mes en su sitio web.

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

Recursos disponibles

Los recursos disponibles para la Unidad Tributaria Mensual (UTM) son los siguientes:

UTM del mes actual:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM para el mes actual.

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/<UTM|utm>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la UTM para el mes actual.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2010-01-01</Fecha>
      <Valor>36.679</Valor>
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>
UTM de un año:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM para cada mes del año que se indique.

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/<UTM|utm>/<year>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm/2010?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la de la UTM para cada mes del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2010-01-01</Fecha>
      <Valor>36.679</Valor>
      </UTM>
      <UTM>
      .
      .
      .
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>
UTM de un año y mes:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM para el mes y año que se indique.

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/<UTM|utm>/<year>/<month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm/2010/01?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la UTM para el mes de enero del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2010-01-01</Fecha>
      <Valor>36.679</Valor>
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>
UTM desde un año determinado:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM de cada mes correspondiente a una fecha posterior a la que se indique.

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/<UTM|utm>/posteriores/<year>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm/posteriores/2009?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la UTM desde el mes de inicio del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2010-01-01</Fecha>
      <Valor>36.679</Valor>
      </UTM>
      <UTM>
      .
      .
      .
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>
UTM de meses posteriores al mes de un año:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM de cada mes correspondiente a una fecha posterior al mes y año que se indique en los parámetros.

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/<UTM|utm>/posteriores/<year><month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm/posteriores/2010/01?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la UTM para las fechas posteriores al mes de enero del año 2010, es decir, desde febrero de 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2010-02-01</Fecha>
      <Valor>36.569</Valor>
      </UTM>
      <UTM>
      .
      .
      .
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>
UTM de meses anteriores a un año:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM de cada mes correspondiente a las fechas anteriores al año que se indique en los parámetros.

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/<UTM|utm>/anteriores/<year>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm/anteriores/2010?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la UTM para las fechas anteriores a enero del año 2010, es decir, todos los datos existentes hasta diciembre 2009.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2006-01-01</Fecha>
      <Valor>31.508</Valor>
      </UTM>
      <UTM>
      .
      .
      .
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>
UTM de meses anteriores a un mes y año:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM de cada mes correspondiente a las fechas anteriores al mes y año que se indique en los parámetros.

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/<UTM|utm>/anteriores/<year>/<month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm/anteriores/2010/01?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la UTM para las fechas anteriores a enero del año 2010, es decir, todos los datos existentes hasta diciembre 2009.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2006-01-01</Fecha>
      <Valor>31.508</Valor>
      </UTM>
      <UTM>
      .
      .
      .
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>
UTM de un período definido por dos fechas:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM para los meses incluidos dentro de los parámetros.

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/<UTM|utm>/anteriores/<year>/<month>/<year2>/<month2>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm/periodo/2010/01/2010/03?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la UTM para los meses entre enero y marzo del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2010-01-01</Fecha>
      <Valor>36.679</Valor>
      </UTM>
      <UTM>
      <Fecha>2010-02-01</Fecha>
      <Valor>36.569</Valor>
      </UTM>
      <UTM>
      <Fecha>2010-03-01</Fecha>
      <Valor>36.752</Valor>
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>
UTM de un período definido por dos años:

Descripción: Permite obtener un listado en xml o json con el valor de la UTM para cada uno de los meses incluidos dentro de los años que se indiquen.

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/<UTM|utm>/anteriores/<year>/<year2>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: http://api.sbif.cl/api-sbifv3/recursos_api/utm/periodo/2009/2010?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor de la UTM para el período que va desde enero 2009 a diciembre del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="http://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <UTMs>
      <UTM>
      <Fecha>2009-01-01</Fecha>
      <Valor>37.614</Valor>
      </UTM>
      <UTM>
      .
      .
      .
      </UTM>
      </UTMs>
      <...>
      </IndicadoresFinancieros>

Actualizado: 08/04/2015