SIPS Formato y lista de errores

Todos los errores producidos en el procesamiento de los ficheros del procedimiento SIPS corresponden al siguiente formato JSON

Formato

[{

"nombreFichero" : "sips2_gas_ps.zip#2016-04-06_gas_ps_0001.csv",

"uuidFichero" : "687a3dd5-3972-49b2-8798-6ee11a5bd577",

"errores" : [ {

"linea" : 2,

"codigo" : "120",

"campo" : "codigoResultadoInspeccion#22",

"mensaje" : "'1' is not included in the allowed set of values"

}, {

"linea" : 3,

"codigo" : "100",

"campo" : "tipoContador#26",

"mensaje" : "null value encountered"

}]

}]

Este formato tiene dos partes, la identificación del fichero procesado y una lista de errores. Se incluirá un bloque completo (fichero y errores) por cada fichero de la carga, incluyendo cada fichero dentro del archivo zip.

• nombreFichero: Indica el nombre proporcionado del fichero y si es un fichero dentro de un zip se añade el nombre de la entrada en dicho zip
• uuidFichero: Es el UUID identificador del fichero (uuidUpload) dentro de una carga, se puede consultar utilizando listar_cargas
• errores: Lista de los errores, contienen la siguiente información:
  • linea: Línea del fichero en la que se ha producido el error
  • codigo: Valor tabulado del tipo de error producido, como se ve en el listado a continuación
  • campo: Nombre del campo donde se ha producido el error, también se indica su ordinal de posición dentro de la línea
  • mensaje: Texto descriptivo con el error concreto

Tabla de errores

Gestión de errores en las cargas

Si se realiza más de una entrega de una misma empresa en un mismo periodo y con un mismo tipo de fichero sólo se mantiene la última carga presentada, se marcarán como CANCELADA las cargas anteriores.

Ejemplo

La empresa ACME entrega PS_ELECTRICIDAD para el periodo 2020-01 (no importando el resultado de la misma) detecta un error en la entrega y realiza una nueva carga con un fichero corregido, los datos anteriores se eliminarán y la carga anterior quedará CANCELADA, sin tener en cuenta el resultado de la siguiente

Tablas maestras

Para la verificación de las listas de valores en los campos a presentar en cada fichero CSV se ha creado un servicio REST que devuelve dicha lista.

Se dispone también de un servicio que obtiene la lista de las tablas asociadas con un procedimiento concreto.

• Tablas de un procedimiento
• Valores de una tabla

Recomendamos la lectura de los servicios de Catalogo para obtener los identificadores de procedimiento y otros valores de interés para las llamadas al API.

Estas son las llamadas:

Tablas de un procedimiento

https://api.cnmc.gob.es/maestras/v1/tablas/procedimiento/<idProcedimiento>

idProcedimiento: Identificador numérico del procedimiento del que se desean consultar las tablas

La respuesta es como esta:

[

{"nombre":"108 Periodicidad Facturación","nombreCorto":"108_PERIODO_FACTURACION","descripcion":"Tabla 108 Periodicidad Facturación","versionActiva":"v1"},

{"nombre":"111 Tipo de Telegestion","nombreCorto":"111_TIPO_TELEGESTION","descripcion":"Tabla 111 Tipo de Telegestion","versionActiva":"v1"},

...

]

Valores de una tabla

https://api.cnmc.gob.es/maestras/v1/tabla/<nombre_tabla>

nombre_tabla: Corresponde con el nombre corto de la anterior lista

La respuesta es como esta:

Donde los campos del JSON de respuesta indican:

• version: Versión de la tabla
• clave: Valor a introducir en el fichero, la clave de la entrada
• valor: Nombre del valor asociado a dicha clave
• descripcion: Descripción larga, sobre el valor

Ej. con la tabla PROVINCIAS (sin versión ni descripción)

{"clave":"01","valor":"Araba/Álava"}