risp carburantes - manual del integrador risp api rest

RISP Carburantes

Manual del integrador RISP Api REST

1 Versión 1.0

RISP Carburantes


RISP Carburantes


2 Versión 1.0

Control de versiones del documento

Versión Fecha Descripción

1.0 30/03/2021 Versión inicial. Se detallan los recursos expuestos en la API, así como el detalle de la solicitud y respuesta de cada uno de ellos.

RISP Carburantes


3 Versión 1.0

Índice

1. Introducción .......................................................................................................................... 4

2. Autenticación ........................................................................................................................ 4

3. Login ...................................................................................................................................... 5

3.1. Header parameters request .............................................................................................. 5

3.2. Body request ..................................................................................................................... 6

3.3. Header parameters response ............................................................................................ 6

3.4. Body response ................................................................................................................... 6

3.5. HTTP status code ............................................................................................................... 6

4. Envío ITGFS ............................................................................................................................ 7

4.1. Header parameters request .............................................................................................. 7

4.2. Body request ..................................................................................................................... 7

4.3. Header parameters response .......................................................................................... 11

4.4. Body response ................................................................................................................. 11

4.5. HTTP status code ............................................................................................................. 12

5. Envío ITGFA ......................................................................................................................... 12

5.1. Header parameters request ............................................................................................ 12

5.2. Body request ................................................................................................................... 13


5.4. Body response ................................................................................................................. 18

5.5. HTTP status code ............................................................................................................. 18

6. Consulta envíos ................................................................................................................... 18

6.1. Header parameters request ............................................................................................ 19


6.3. Body response ................................................................................................................. 19

6.4. HTTP status code ............................................................................................................. 20

RISP Carburantes


4 Versión 1.0

1. Introducción

La API permitirá la remisión de información sobre productos petrolíferos a los siguientes sujetos

obligados:

Los operadores al por mayor de productos petrolíferos de todas las instalaciones de su

red de distribución.

Los titulares de instalaciones de suministro a vehículos terrestres, o de derechos de

explotación de estas instalaciones, o sus representantes, que envíen conjuntamente

datos de al menos cinco instalaciones.

Los tipos de envío permitidos serán los siguientes:

ITGFS. Envío semanal de precios.

ITGFA. Envío anual de cantidades vendidas.

El protocolo utilizado será HTTPS.

2. Autenticación

Esta API está protegida con el esquema de autenticación Bearer. Por tanto, para hacer una

llamada a cualquier recurso es necesario obtener un TOKEN de acceso y, posteriormente, hacer

la llamada a cualquiera de los endpoints disponibles con el TOKEN de acceso obtenido. Para ello

será necesario enviar el TOKEN obtenido en el encabezado Authorization con el esquema de

autenticación de Bearer.

RISP Carburantes


5 Versión 1.0

El TOKEN obtenido tendrá una validez por un tiempo determinado. Cuando éste caduque, será

necesario solicitar uno nuevo para poder seguir utilizando los servicios proporcionados por la

API.

3. Login

Este recurso permitirá la autenticación en el sistema para la obtención del TOKEN de acceso y

poder realizar la remisión de información.

https://energia.serviciosmin.gob.es/RispApi/v1/usuario/login

POST

3.1. Header parameters request

A continuación, se detallan los parámetros a incluir en la cabecera de la petición http:

Header parameters

Content-Type application/json Indicamos que enviamos los datos de la

petición en un objeto con formato JSON.

Accept application/json Indicamos que los datos recibidos en la respuesta vendrán en un objeto con formato JSON.

RISP Carburantes


6 Versión 1.0

3.2. Body request

A continuación, se detallan las características que deberá tener el Body de la petición:

Body

{

"usuario": "usu",

"password": "pass"

}

Campo Descripción

Usuario Usuario de acceso. Coincide con el utilizado para acceder al sistema de envíos desde la web de remisión de información. Es un campo obligatorio.

Password Contraseña de acceso. Coincide con la utilizada para acceder al sistema de envíos desde la web de remisión de información. Es un campo obligatorio.

3.3. Header parameters response

A continuación, se detallan los parámetros incluidos en la cabecera de la respuesta http:

Header parameters



3.4. Body response

A continuación, se detallan las características que tendrá el Body de la respuesta:

Body

{

"token":

"eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJuYW1laWQiOiIxOCIsIm5iZiI6MTY

wMTI3MjUzNywiZXhwIjoxNjAxMzU4OTM3LCJpYXQiOjE2MDEyNzI1Mzd9.CWFiqXgMahJ

TH2fOcJnGz-

RU7N5I7C_cYwZdXSMkmSoKAs0kJYPE79crqRXqYjPx5Wswp_3407UkLLcyT2vZmA",

"expira": "29-09-2020 13:09:56"

}

Campo Descripción

token Token de acceso para realizar el envío y consulta de información.

expira Fecha de expiración del Token.

3.5. HTTP status code

A continuación, se detallan los posibles códigos de estado devueltos en la respuesta:

RISP Carburantes


7 Versión 1.0

HTTP status code

200 OK

400 Bad request. Los datos enviados en la petición no son correctos.

401 Unauthorized. Usuario no autorizado. Usuario/contraseña no válida

500 Error interno de servidor

4. Envío ITGFS

Este recurso permitirá el envío de información relativo a precios semanales para las estaciones

de servicio. Será necesario autenticarse enviando en la cabecera el TOKEN obtenido.

https://energia.serviciosmin.gob.es/RispApi/v1/envio/itgfs

POST



Header parameters




Authorization Bearer TOKEN Se debe incluir la palabra Bearer seguida del token obtenido en método Login

4.2. Body request


Body

{

"tipo": "ITGFS",

"envio": "ITGFSZZZAAAAMMDD",

"precios": [

{

"firma": "XXX",

"num_reg": "NREG1",

"margen": "D",

"fechaiper": "DD/MM/YYYY",

"horaiper": "HH:MM",

RISP Carburantes


8 Versión 1.0

"pvpg95e5": "9,999",

"pvpg95e10": "9,999",

"pvpg95e5plus": "9,999",

"pvpbioe": "9,999",

"porc_bioet": "999,9",

"pvpg98e5": "9,999",

"pvpg98e10": "9,999",

"pvpgoa": "9,999",

"pvpgoaplus": "9,999",

"pvpgob": "9,999",

"pvpgoc": "9,999",

"pvpbiod": "9,999",

"porc_est_met_biod": "999,9",

"tventa_coop": "P",

"xtos_vta_rgda_coop": "XXX/YYY",

"pvpglp": "9,999",

"pvpgnc": "9,999",

"pvpgnl": "9,999",

"pvph2": "99,999"

},

{

"firma": "XXX",

"num_reg": "NREG2",

"margen": "D",

"fechaiper": "DD/MM/YYYY",

"horaiper": "HH:MM",

"pvpg95e5": "9,999",

"pvpg95e10": "9,999",

"pvpg95e5plus": "9,999",

"pvpbioe": "9,999",

"porc_bioet": "999,9",

"pvpg98e5": "9,999",

"pvpg98e10": "9,999",

"pvpgoa": "9,999",

"pvpgoaplus": "9,999",

"pvpgob": "9,999",

"pvpgoc": "9,999",

"pvpbiod": "9,999",

"porc_est_met_biod": "999,9",

"tventa_coop": "P",

"xtos_vta_rgda_coop": "XXX/YYY",

"pvpglp": "9,999",

"pvpgnc": "9,999",

"pvpgnl": "9,999",

"pvph2": "99,999"

},

…

]

}

Campo Descripción

tipo Tipo de información remitida. En este caso ITGFS (Instalaciones terrestres generales frecuencia semanal)

RISP Carburantes


9 Versión 1.0

envio Descripción del envío según la siguiente estructura: ITGFSZZZAAAAMMDD donde:

Las tres primeras letras identifican que se trata de Instalaciones Terrestres Generales (ITG).

Las dos siguientes letras hacen referencia al carácter de frecuencia semanal. (FS).

Los caracteres ZZZ indican el código del operador o código asignado al remitente de datos de al menos 5 estaciones de servicio. Este código habrá sido comunicado por la Subdirección General de Hidrocarburos.

Los 8 caracteres restantes se corresponderán con la fecha de envío del fichero en formato AAAAMMDD.

Campos relativos a precios

firma Código de tres caracteres de identificación del operador mayorista que abandere la instalación, o bien el código de tres caracteres IND que utilizarán los representantes para sus estaciones no abanderadas. Validaciones realizadas sobre este campo:

Campo obligatorio.

Se verifica que el valor introducido se corresponde con el valor correspondiente al operador que realiza el envío.

num_reg Número de registro de la instalación. Validaciones realizadas sobre este campo:

Campo obligatorio.

Se verifica que el número de registro introducido y el margen indicado en el siguiente campo MARGEN identifican a una estación de servicio que pertenezca a la red del operador indicado en el campo FIRMA.

Se verifica que la estación de servicio identificada con el NUM_REG + MARGEN no esté de baja en el momento de realizar el envío.

Se verifica que la estación de servicio identificada con el NUM_REG + MARGEN haya sido verificada por los gestores del sistema en el Ministerio.

En caso de que la instalación la gestione directamente el operador que realiza el envío de datos, se verifica que para la estación de servicio identificada con el NUM_REG + MARGEN se haya enviado horario de apertura de la instalación.

En caso de que la instalación la gestione directamente el operador que realiza el envío de datos, se verifica que para la estación de servicio identificada con el NUM_REG + MARGEN se hayan comunicado correctamente las coordenadas geográficas que colocan a la instalación en el mapa.

margen Margen de la carretera en el que se encuentra situada la estación de servicio. Junto con el campo NUM_REG identifica la estación de servicio. Las validaciones realizadas sobre este campo son las siguientes:

Campo obligatorio.

Se verifica que el valor introducido se corresponde con un código de margen válido. Los códigos de margen se pueden consultar en el anexo I de este mismo documento.

fechaiper Fecha del periodo de inicio de vigencia de los precios. Validaciones realizadas en este campo:

Campo obligatorio.

Se comprueba que el formato sea DD/MM/YYYY.

RISP Carburantes


10 Versión 1.0

horaiper Hora del periodo de inicio de vigencia de los precios. Validaciones realizadas en este campo:

Campo obligatorio.

Se comprueba que el formato sea HH:MM.

Se comprueba que la fecha de inicio del periodo de vigencia sea superior en al menos una hora a la hora actual.

Se comprueba que la fecha de inicio del periodo de vigencia no es superior en tres días a la actual.

En caso de que existan uno o varios envíos de precios que todavía no haya entrado en vigor, se podrá enviar otro con fecha y hora de inicio de vigencia posterior a la del último envío.

En caso de que exista un envío de precios que todavía no haya entrado en vigor, se podrá enviar otro con fecha y hora de inicio de vigencia anterior, pero los precios del nuevo envío sustituirán los enviados anteriormente.

En caso de que existan varios envíos de precios que todavía no hayan entrado en vigor, se podrá enviar otro con fecha y hora de inicio de vigencia anterior a la del último y posterior a la del penúltimo, pero los precios del nuevo envío sustituirán a los del último envío.

En caso de que existan varios envíos de precios que todavía no hayan entrado en vigor no se podrá enviar otro con fecha y hora de inicio de vigencia anterior a la del penúltimo envío.

pvp[prod] Precio de venta al público del producto [prod]. Las validaciones realizadas en este campo son las siguientes:

El formato será de 1 entero y 3 decimales excepto para el hidrógeno (H2), que será de 2 enteros y tres decimales.

Se verifica que el valor enviado esté dentro del rango de valores permitidos para el producto en el día en que se realiza el envío.

porc_bioet Porcentaje volumétrico de bioetanol en el producto anterior. Las validaciones que se realizan sobre este campo serán las siguientes:

El formato será de 3 enteros y 1 decimal.

Se comprobará que no se ha introducido valor si no se ha enviado precio para las mezclas de gasolina con bioetanol que requieran etiquetado específico o precio del bioetanol puro.

Se comprobará que se ha introducido valor si se ha enviado precio para las mezclas de gasolina con bioetanol que requieran etiquetado específico o precio del bioetanol puro.

porc_est_met_biod Porcentaje volumétrico de éster metílico en el producto anterior. Las validaciones que se realizan sobre este campo serán las siguientes:


Se comprobará que no se ha introducido valor si no se ha enviado precio para las mezclas de gasóleo con éster metílico que requieran etiquetado específico (biodiesel) o precio del éster metílico puro.

Se comprobará que se ha introducido valor si se ha enviado precio para las mezclas de gasóleo con éster metílico que requieran etiquetado específico (biodiesel) o precio del éster metílico puro.

tventa_coop Tipo de venta del titular de la instalación al consumidor final. Las validaciones que se realizan sobre este campo son las siguientes:

Campo obligatorio.

RISP Carburantes


11 Versión 1.0

Se verifica que el valor introducido se corresponde con un código de tipo de venta válido. Los códigos de tipo de venta se pueden consultar en el anexo I de este mismo documento.

Si una instalación suministra a sus asociados o cooperativistas un producto a un precio diferente del de venta al público en general, deberá remitir dos registros, uno con el código P (venta al público en general) y otro con R (venta restringida a asociados o cooperativistas). Si solo vende a sus asociados o cooperativistas pondrá los precios de venta a estos asociados y hará constar en este campo la letra R. El código A se pondrá en el caso en que venda productos diferentes al público en general y a sus asociados o cooperativistas, en cuyo caso se debe rellenar el campo XTOS_VTA_RGDA_COOP (Campo siguiente)

xtos_vta_rgda_coop Productos que solo se venden a asociados o cooperativistas. Las validaciones realizadas sobre este campo son las siguientes:

Campo obligatorio si en el campo anterior (TVENTA_COOP) se ha indicado el valor A (Venta de productos distinta para el público y para asociados o cooperativistas).

Se verifica que la longitud del texto introducido no sea mayor de 15 caracteres ni menor de tres.

Se deben escribir los productos que solo se venden a asociados o cooperativistas separados por “/”. Ejemplo: GOA/GOB.



Header parameters

Content-Type application/json Indicamos que

enviamos los

datos de la

petición en un

objeto con

formato JSON.

Location https://energia.serviciosmin.gob.es/RispApi/v1/Envio/getenvio/999 URL para

consulta del

estado del

envío creado

4.4. Body response


RISP Carburantes


12 Versión 1.0

Body

{

"idEnvio": 999,

"numRegistro": "202000060008107",

"claveRegistro": "B5MVLMXK5BCAKHU",

"urlComprobante": "https://... "

}

Campo Descripción

idEnvio Identificador del envío que servirá para realizar consultas sobre su estado.

numRegistro Número de entrada en el registro electrónico del Ministerio para la información remitida

claveRegistro Clave de consulta de la entrada generada en el registro electrónico del Ministerio para la información remitida

urlComprobante URL de descarga del comprobante de envío proporcionado por el registro electrónico del Ministerio.



HTTP status code

201 Created. Envío generado correctamente.


401 Unauthorized. Usuario no autorizado. Token no válido


5. Envío ITGFA

Este recurso permitirá el envío de información relativo a cantidades anuales vendidas para las

estaciones de servicio. Será necesario autenticarse enviando en la cabecera el TOKEN obtenido.

https://energia.serviciosmin.gob.es/RispApi/v1/envio/itgfa

POST



Header parameters

RISP Carburantes


13 Versión 1.0





5.2. Body request


Body

{

"tipo": "ITGFA",

"envio": "ITGFAZZZAAAAMMDD ",

"cantidades": [

{

"firma": "XXX",

"num_reg": "NREG1",

"margen": "D",

"año": "AAAA",

"vg95e5": "99999999,999",

"vg95e5_dto":"99999999,999",

"dto_g95e5": "99999999,999",

"vg95e5plus": "99999999,999",

"vg95e10": "99999999,999",

"vg98e5": "99999999,999",

"vg98e10": "99999999,999",

"vgoa": "99999999,999",

"vgoa_dto": "99999999,999",

"dto_goa": "99999999,999",

"vgoaplus": "99999999,999",

"vgob": "99999999,999",

"vgoc": "99999999,999",

"vbio": "99999999,999",

"porc_est_met_biod": "AAAA",

"vbie": "99999999,999",

"porc_bioetanol": "999,9",

"vglp": "99999999,999",

"vgnc": "99999999,999",

"poder_cal_inf_gnc": "9,999",

"vgnl": "99999999,999",

"poder_cal_inf_gnl": "9,999",

"vh2": "99999999,999"

},

{

"firma": "XXX",

"num_reg": "NREG1",

RISP Carburantes


14 Versión 1.0

"margen": "D",

"año": "AAAA",

"vg95e5": "99999999,999",

"vg95e5_dto":"99999999,999",

"dto_g95e5": "99999999,999",

"vg95e5plus": "99999999,999",

"vg95e10": "99999999,999",

"vg98e5": "99999999,999",

"vg98e10": "99999999,999",

"vgoa": "99999999,999",

"vgoa_dto": "99999999,999",

"dto_goa": "99999999,999",

"vgoaplus": "99999999,999",

"vgob": "99999999,999",

"vgoc": "99999999,999",

"vbio": "99999999,999",

"porc_est_met_biod": "AAAA",

"vbie": "99999999,999",

"porc_bioetanol": "999,9",

"vglp": "99999999,999",

"vgnc": "99999999,999",

"poder_cal_inf_gnc": "9,999",

"vgnl": "99999999,999",

"poder_cal_inf_gnl": "9,999",

"vh2": "99999999,999"

},

…

]

}

Campo Descripción

tipo Tipo de información remitida. En este caso ITGFA (Instalaciones terrestres generales frecuencia anual)

envío Descripción del envío según la siguiente estructura: ITGFAZZZAAAAMMDD donde:

Las tres primeras letras identifican que se trata de Instalaciones Terrestres Generales (ITG).

Las dos siguientes letras hacen referencia al carácter de frecuencia anual. (FS).

Los caracteres ZZZ indican el código del operador o código asignado al remitente de datos de al menos 5 estaciones de servicio. Este código habrá sido comunicado por la Subdirección General de Hidrocarburos.

Los 8 caracteres restantes se corresponderán con la fecha de envío del fichero en formato AAAAMMDD.

Campos relativos a precios

firma Código de tres caracteres de identificación del operador mayorista que abandere la instalación, o bien el código de tres caracteres IND que utilizarán los representantes para sus estaciones no abanderadas. Validaciones realizadas sobre este campo:

Campo obligatorio.

Se verifica que el valor introducido se corresponde con el valor correspondiente al operador que realiza el envío.

RISP Carburantes


15 Versión 1.0

num_reg Número de registro de la instalación. Validaciones realizadas sobre este campo:

Campo obligatorio.

Se verifica que el número de registro introducido y el margen indicado en el siguiente campo MARGEN identifican a una estación de servicio que pertenezca a la red del operador indicado en el campo FIRMA.

Se verifica que la estación de servicio identificada con el NUM_REG + MARGEN haya sido verificada por los gestores del sistema en el Ministerio.

margen Margen de la carretera en el que se encuentra situada la estación de servicio. Junto con el campo NUM_REG identifica la estación de servicio. Las validaciones realizadas sobre este campo son las siguientes:

Campo obligatorio.

Se verifica que el valor introducido se corresponde con un código de margen válido. Los códigos de margen se pueden consultar en el anexo I de este mismo documento.

año Periodo al que se refiere la información enviada. Las validaciones realizadas sobre este campo son las siguientes:

Campo obligatorio.

Se comprueba que el formato sea: AAAA (Cuatro dígitos)

Se comprueba que el año no sea menor de 2005 (Año en el que empezó a funcionar el actual sistema de remisión de información)

Se comprueba que el año no sea inferior al año en el que se realiza el envío.

Se comprueba que en todas las filas del fichero el año sea el mismo. No se permite enviar años distintos en un mismo fichero de datos.

Se comprueba que la estación de servicio para la que se envía la información no esté de baja durante todo el año.

Se comprueba, siempre que la estación de servicio sea gestionada por el operador que envía la información, que se haya enviado el fichero de auditorías de información de cantidades vendidas para el año.

vg95e5 Metros cúbicos vendidos en el periodo (año) de gasolina 95 E5. Las validaciones realizadas sobre este campo son las siguientes:

El formato será de 8 enteros (máximo) y tres decimales.

Si se indica que la cantidad vendida para el producto es superior a treinta millones de litros, se comprobará en los datos censales si la capacidad indicada en los depósitos permite vender esa cantidad. En caso de que no se haya informado la capacidad de los depósitos, el sistema devolverá error.

vg95e5_dto Metros cúbicos vendidos en el periodo (año) de gasolina 95 E5 con descuento. Este dato solo será posible enviarlo en el caso de que se haya introducido una cantidad vendida para el producto G95E5.

dto_g95e5 Descuento anual medio en las ventas con descuento de gasolina 95 E5, en euros por m3. Este dato solo será posible enviarlo en el caso de que se haya introducido una cantidad vendida para el producto G95E5.

vg95e5plus Metros cúbicos vendidos en el periodo de gasolina 95 de características mejoradas. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95E5.

RISP Carburantes


16 Versión 1.0

vg95e10 Metros cúbicos vendidos en el periodo de gasolina 95 E10. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95E5.

vg98e5 Metros cúbicos vendidos en el periodo de gasolina 98 E5. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

vg98e10 Metros cúbicos vendidos en el periodo de gasolina 98 E10. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

vgoa Metros cúbicos vendidos en el periodo de gasóleo de automoción habitual. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

vgoa_dto Metros cúbicos vendidos en el periodo (año) de gasóleo de automoción habitual con descuento. Este dato solo será posible enviarlo en el caso de que se haya introducido una cantidad vendida para el producto GOA.

dto_goa Descuento anual medio en las ventas con descuento de gasóleo de automoción habitual, en euros por m3. Este dato solo será posible enviarlo en el caso de que se haya introducido una cantidad vendida para el producto GOA.

vgoaplus Metros cúbicos vendidos en el periodo de gasóleo de automoción de características mejoradas. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

vgob Metros cúbicos vendidos en el periodo de gasóleo B. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

vgoc Metros cúbicos vendidos en el periodo de gasóleo C. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

vbio Metros cúbicos vendidos en el período de mezclas de gasóleo con éster metílico que requieran etiquetado específico o metros cúbicos vendidos de éster metílico puro. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

porc_est_met_biod Porcentaje de éster metílico en el producto biodiesel. Las validaciones realizadas sobre este campo serán las siguientes:

El formato será de 3 enteros y un decimal.

Se comprobará que no se ha introducido valor si no se ha enviado cantidad para el producto biodiesel.

Se comprobará que se ha introducido valor si se ha enviado cantidad el producto biodiesel.

vbie Metros cúbicos vendidos en el período de mezclas de gasolina con bioetanol que requieran etiquetado específico o m3 vendidos de bioetanol puro. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

porc_bioetanol Porcentaje volumétrico de éster metílico en el producto anterior. Las validaciones que se realizan sobre este campo serán las siguientes:

Se comprobará que no se ha introducido valor si no se ha enviado cantidad para el producto bioetanol.

Se comprobará que se ha introducido valor si se ha enviado cantidad el producto bioetanol.


RISP Carburantes


17 Versión 1.0

vglp Metros cúbicos vendidos en el periodo de gases licuados del petróleo para automoción. Las validaciones realizadas sobre este campo serán las mismas que para el producto Gasolina 95 E5.

vgnc Kg vendidos en el período del producto gas natural comprimido para automoción. Las validaciones realizadas en este campo serán las siguientes:


Se comprobará que la cantidad enviada no es superior al millón de kilos.

poder_cal_inf_gnc Poder calorífico del producto gas natural comprimido para automoción en kWh/kg. Las validaciones realizadas sobre este campo serán las siguientes:

Se comprobará que no se ha introducido valor si no se ha enviado cantidad para el producto gas natural comprimido.

Se comprobará que se ha introducido valor si se ha enviado cantidad para el producto gas natural comprimido.

El formato será de 1 entero y tres decimales.

vgnl Kg vendidos en el período del producto gas natural licuado para automoción. Las validaciones realizadas en este campo serán las siguientes:



poder_cal_inf_gnl Poder calorífico del producto gas natural licuado para automoción en kWh/kg. Las validaciones realizadas sobre este campo serán las siguientes:

Se comprobará que no se ha introducido valor si no se ha enviado cantidad para el producto gas natural comprimido.

Se comprobará que se ha introducido valor si se ha enviado cantidad para el producto gas natural comprimido.

El formato será de 1 enteros y tres.

vh2 Kg vendidos en el período del producto hidrógeno. Las validaciones realizadas en este campo serán las siguientes:





Header parameters

Content-Type application/json Indicamos que

enviamos los

datos de la

petición en un

objeto con

formato JSON.

Location https://energia.serviciosmin.gob.es/RispApi/v1/Envio/getenvio/999 URL para

consulta del

RISP Carburantes


18 Versión 1.0

estado del

envío creado

5.4. Body response


Body

{

"idEnvio": 999,

"numRegistro": "202000060008107",

"claveRegistro": "B5MVLMXK5BCAKHU",

"urlComprobante": "https://... "

}

Campo Descripción

idEnvio Identificador del envío que servirá para realizar consultas sobre su estado.

numRegistro Número de entrada en el registro electrónico del Ministerio para la información remitida

claveRegistro Clave de consulta de la entrada generada en el registro electrónico del Ministerio para la información remitida

urlComprobante URL de descarga del comprobante de envío proporcionado por el registro electrónico del Ministerio.



HTTP status code

201 Created. Envío generado correctamente.




6. Consulta envíos

Este recurso permitirá la consulta de un envío realizado mediante la API. Será necesario

autenticarse enviando en la cabecera el TOKEN obtenido.

https://energia.serviciosmin.gob.es/RispApi/v1/Envio/getenvio/{IdEnvio}

GET

RISP Carburantes


19 Versión 1.0



Header parameters





Header parameters

Content-Type application/json Indicamos que enviamos los datos de la petición

en un objeto con formato JSON.

6.3. Body response


Body

{

"idEnvio": 999999,

"procesado": false,

"correcto": false,

"numErrores": 9,

"fechaEnvio": "29-03-2021 16:03:38",

"tipo": "ITG",

"envio": "ITGXXZZZAAAAMMDD",

"cantidades|precios": [

{

"correcto": false,

…

"errores": [

{

"columna": "nombre_columna",

"error": "Descripción del error"

}

]

}

],

"errores": null

RISP Carburantes


20 Versión 1.0

}

Campo Descripción

idEnvio Identificador del envío que se está consultando

procesado Indica si el envío consultado ha sido procesado o no por el servicio de validación. Los posibles valores serán true|false

correcto En caso de que el envío haya sido procesado por el servicio de validación, aquí se indicará si es correcto o no. Los posibles valores serán true|false.

numErrores Número de errores encontrados en la información enviada.

fechaEnvio Fecha en la que se realizó el envío de información

Tipo Tipo de envío realizado. Los posibles valores serán ITGFA|ITGFS

Envío Código del envío consultado.

Cantidades Se incluirán todos los registros de cantidades o de precios (dependiendo del envío consultado). Para cada uno de los registros se indicará:

correcto: Indica si el registro es correcto o no. Los posibles valores serán true|false

errores: Se incluirán los errores encontrados en el registro. Para cada uno de los registros de error se indicará: o columna: Nombre de la columna en la que se ha producido

el error o error: descripción del error

errores Se incluirán todos los errores generales del envío. No se incluirán aquí los errores de cada registro.



HTTP status code

200 OK.


404 Not found. Envío no encontrado.


risp carburantes - manual del integrador risp api rest

Documents