Saltar al final de los metadatos
Ir al inicio de los metadatos
Descripción

Permite consultar el estado de una carga.  

Estructura de la URL
Petición

Esta petición se debe enviar utilizando el método HTTP GET.

Este método no tiene ningún documento JSON asociado en el cuerpo, sino que el identificador de la carga se debe incluir en la URI de la petición.

Ejemplo Petición

https://api.cnmc.gob.es/carga/v1/consultar_estado_carga/550e8400-e29b-41d4-a716-446655440000

Respuesta

El cuerpo de la respuesta contendrá un documento JSON que contendrá un estado descrito en: Estados de una carga y la información adicional necesaria, en caso de haber sido rechazada: 

  • estado: estado de la carga, valores posibles: Estados de una carga
  • registrosProcesados: parámetro opcional, con el número de entradas recibidas por el procesador de la carga

  • registrosErrores: parámetro opcional, informa del número de entradas erróneas detectadas

  • numeroRegistroGeneral: parámetro opcional, informa del identificador del registro de entrada de la carga en el registro general de la CNMC
  • posicionEnColaCargas: en caso de que la carga esté en estado CONFIRMADA se rellena con la posición ordinal en dicha cola

  • justificante: fichero de justificante de presentación de los ficheros remitidos en la carga

  •      uuidUpload. Identificación del fichero del justificante.
  •      url. URL de descarga del fichero del justificante
  •      longitudBytes. Con el tamaño del fichero en bytes
  • mensajeError: En caso de que exista un error general en el tratamiento del fichero se incluirá en este atributo
  • errores: parámetro opcional. Lista de información de los errores asociados a los ficheros correspondientes a una  carga:
    • uuidUpload. Identificación del fichero subido, sobre el que se listan los errores.
    • url. URL de descarga del fichero de descripción de los errores
    • longitudBytes. Con el tamaño del fichero de errores en bytes

Ejemplo documento JSON Respuesta

{
  "estado" : "RECHAZADA",
  "registrosProcesados": 10,
  "registrosErrores": 10,
  "numeroRegistroGeneral": "20150300000000013076",
  "justificante": { ... }
  "errores" : [ {
    "uuidUpload": "650832f3-d5f1-48d7-8817-a39aafafffcf",
    "url" : "https://api.cnmc.gob.es/ficheros/v1/descarga/a02755a531544864a4443dd536eef1df",
    "longitudBytes": 121923
  } ]
}
  • Sin etiquetas