Iniciar Sesión

Para poder realizar una consulta de datos en la API de DataComex, es necesario obtener un token de seguridad. Este token se obtiene realizando una llamada al método con una solicitud HTTP POST:

• Iniciar sesión ➟ https://comercio.serviciosmin.gob.es/DatacomexAPI/IniciarSesion

Es necesario pasar su email y su contraseña en formato JSON en el body de la llamada. Una vez que se compruebe que está registrado, la respuesta de dicho método será un token de acceso necesario para poder obtener datos.

También puede obtener el token fácilmente (Requiere iniciar sesión previamente), haciendo clic en el siguiente botón:

Obtener Datos

Para poder realizar una llamada a este método, es necesario incluir el token de acceso obtenido anteriormente. Este token es posible incluirlo a esta llamada de dos maneras diferentes:

  • 1. Incluirlo en la url como un parámetro de Querystring con el nombre de access_token. Ejemplo: https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerDatos?access_token=eyJhbGciOiJIUz...
  • 2. Incluirlo en la cabecera de la llamada como token_bearer de Authorization Ejemplo con Excel:
Paso Descripción Ver paso
2.1 Crear nueva consulta.
2.2 Especificar los parámetros en la url y el token de acceso como cabecera.
Ejemplo: Exportación, meses de 2018 y 2019, país Francia, taric 1001 (caballos, asnos, mulos).
https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerDatos?f=E&pe=H2018.H2019&pa=001&ta=1001
2.3 Cargar resultado.
2.4 Trabajar con los datos.

Los parámetros que deben ser pasados por querystring son:

  • • f ➟ Flujo de importación/exportación. Los valores permitidos son:
    • ➣ I Indica que se desea obtener las importaciones.
    • ➣ E Indica que se desea obtener las exportaciones.
    • ➣ I/E Indica que se desean obtener importaciones y exportaciones.
  • • pe ➟ Periodo de tiempo. Los valores permitidos son:
    • ➣ «Año» Numeración del año concreto. "Ejemplo año 2021 es: 2021".
    • ➣ «Mes» Numeración del mes concreto. "Ejemplo enero 2021 es: 202101".
    • ➣ LastY Indica que se desea obtener el último año.
    • ➣ LastM Indica que se desea obtener el último mes.
    • ➣ ALL Indica que se desea obtener todos los años disponibles.
    • ➣ ALLM Indica que se desea obtener todos los meses disponibles.
    • ➣ D«Año» Indica que se desea obtener todos los años disponibles desde uno en concreto. Ejemplo: años desde 2018 es: "D2018"
    • ➣ D«Mes» Indica que se desea obtener todos los meses disponibles desde uno en concreto. Ejemplo: meses desde enero 2018 es: "D201801"
    • ➣ H«Año» Indica que se desean obtener los meses (hijos) del año. Ejemplo: con H2019 se obtendrían los datos mensuales del año 2019.
    • * Es posible introducir más de un periodo separados por el carácter «punto». Ejemplo: lista de 3 años es "2018.2019.2021"
  • • pa ➟ País de origen o destino. Los valores permitidos son:
    • ➣ «País» Código de los paises concretos. Ejemplo: código de Francia es "001"
    • ➣ ALL Todos los países.
    • ➣ TOTAL La suma total de todos los países. Es decir, Total Mundo.
    • * Es posible introducir más de un país separados por el carácter «punto». Ejemplo: lista de 3 países es "660.070.001"
  • • ta ➟ Código del arancel integrado (TARIC). Los valores permitidos son:
    • ➣ «Taric» Código de taric. Ejemplo: código de Caballos, asnos, mulos y burdéganos es "1001".
    • ➣ AT2 Códigos taric agrupados a 2 dígitos.
    • ➣ AT4 Códigos taric agrupados a 4 dígitos.
    • ➣ AT6 Códigos taric agrupados a 6 dígitos.
    • ➣ TOTAL La suma total de todos los taric.
    • ➣ H«Taric» Indica que se desean obtener el taric y sus hijos en la jerarquía de la clasificación. Ejemplo: con H1001 se obtendrían los códigos "100101, 100102, etc."
    • * Es posible introducir más de un taric separados por el carácter «punto». Ejemplo: lista con los hijos del código taric 1001 y el 0090 "H1001.0090"
  • • pr ➟ Código de la Provincia. Los valores permitidos son:
    • ➣ «Provincia» Código de la provincia. Ejemplo: código de Madrid es "28".
    • ➣ ALL La suma total de las Provincias. Es decir, Total Nacional.
    • * Es posible introducir más de una provincia separados por el carácter «punto». Ejemplo: lista de tres provincias es "28.35.16"

Una vez que se han rellenado los parámetros de la querystring con los valores deseados se pueden obtener los valores de la consulta realizando una llamada al método con una solicitud HTTP GET:

• Obtener Datos ➟ https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerDatos?access_token=valor&f=valor&pe=valor&pa=valor&ta=valor&pr=valor

Ejemplo: Exportación, último mes, TODOS los países,en la provincia de Madrid, taric 1001 (caballos, asnos, mulos)
https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerDatos?f=E&pe=LastM&pa=ALL&ta=1001&pr=28
* En este caso, el token de acceso se pasaría en una cabecera, ver imagen del paso 2.2 más arriba.

El resultado de una llamada se devuelve en formato JSON. Los datos incluyen los siguientes valores:

  • ➣ flujo: "Importación" o "Exportación".
  • ➣ periodo: Nombre del año o mes.
  • ➣ pais: Nombre de país.
  • ➣ id_pais: Código de país.
  • ➣ prov: Nombre de provincia.
  • ➣ id_prov: Código de provincia.
  • ➣ taric: Código de taric.
  • ➣ euros: Valor declarado en euros.
  • ➣ kilos: Peso en kilogramos.
  • ➣ mensaje: Reservado para informar sobre cualquier incidencia producida en el resultado. En condiciones normales, se informará si el dato es provisional o definitivo.
  • * Los datos provisionales del año corriente pasarán automáticamente a definitivo alrededor de un año después del cierre del año.

Límites de descarga (número máximo de filas):

  • ➣ Caso general: 1.000.000 de filas estimadas.
  • ➣ Casos especiales:
  • ➣ Cuando se piden todos los taric a 4 dígitos (ta=AT4) es obligatorio especificar solo 1 periodo
  • ➣ Cuando se piden todos los taric a 6 dígitos (ta=AT6) es obligatorio especificar solo 1 periodo y solo 1 país
  • * Si se superan estos límites el resultado es null.

Obtener Variables

Todas las consultas se pueden realizar por medio de una API. Para obtener el valor de las todas las variables de cruce posibles, se deben realizar las siguientes llamadas utilizando una solicitud HTTP GET:

  • • Obtener Flujos ➟ https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerFlujos
  • • Obtener Periodos ➟ https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerPeriodos
  • • Obtener Paises ➟ https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerPaises
  • • Obtener Taric ➟ https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerTarics
  • • Obtener Provincias ➟ https://comercio.serviciosmin.gob.es/DatacomexAPI/ObtenerProvincias