# Nonconformties List

Este método se conecta a la plataforma del Coordinador Eléctrico Nacional (CEN) y obtiene la lista de disconformidades correspondientes a los filtros utilizados como parámetros. Retorna los datos resultantes de las disconformidades en formato JSON.

El uso del campo CallbackUrl desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir  con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Endpoint: POST /v1/cl/services/cenhub.cl/hub/nonconformities-list
Version: v1.0
Security: JWT, Api-Key

## Request fields (application/json):

  - `RequestData` (object, required)
    Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

  - `RequestData.FechaCreacionDelCasoDesde` (string, required)
    Fecha inicial para filtrar los casos (MM/DD/YYYY).
    Example: "11/14/2019"

  - `RequestData.FechaCreacionDelCasoHasta` (string, required)
    Fecha final para filtrar los casos (MM/DD/YYYY).
    Example: "11/05/2025"

  - `RequestData.RutDeudor` (string, required)
    RUT del deudor sin puntos ni guion.
    Example: "76999999"

  - `RequestData.Filas` (string, required)
    Cantidad de resultados que se mostrarán por página.
    Example: "200"

  - `RequestData.Paginas` (string, required)
    Define qué grupo de resultados se mostrará. Por ejemplo, si cada página muestra 200 resultados ('filas' = 200), la página 0 mostrará los primeros 200, la página 1 los siguientes 200, y así sucesivamente.
    Example: "0"

  - `RequestData.AccountCredential` (any)
    Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

  - `CallbackUrl` (string)
    URL para enviar el mensaje de respuesta utilizando un método POST.
    Example: "https://my-api.my-business.com/api/open-data-response"

## Response 200 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.
    Enum: "OK", "ERROR"

  - `Data` (object,null, required)

  - `Data.NonconformitiesList` (object, required)
    Contenedor de disconformidades retornadas por el servicio del Coordinador Eléctrico Nacional (CEN) para los filtros aplicados.
    Example: {"TotalDisconformidades":4575,"Disconformidades":[]}

  - `Data.NonconformitiesList.Disconformidades` (array, required)
    Lista de disconformidades que coinciden con los filtros proporcionados.
    Example: []

  - `Data.NonconformitiesList.Disconformidades.FechaCreacionDelCasoHasta` (string, required)
    Límite superior de la fecha/hora de creación del caso (ISO 8601 con zona).
    Example: "2021-08-11T08:43:21-0400"

  - `Data.NonconformitiesList.Disconformidades.Nemotecnico` (string, required)
    Cadena nemotécnica mostrada por el portal para el caso/instrucción.
    Example: "[DISC_1888][P][SEN_[TEE_][Jun21][L][V01]][2888888]"

  - `Data.NonconformitiesList.Disconformidades.RutAcreedor` (string, required)
    RUT del acreedor sin formato.
    Example: "988888888"

  - `Data.NonconformitiesList.Disconformidades.RazonSocialAcreedor` (string, required)
    Razón social del acreedor.
    Example: "Empresa Ejemplo"

  - `Data.NonconformitiesList.Disconformidades.RutDeudor` (string, required)
    RUT del deudor sin formato.
    Example: "76999999"

  - `Data.NonconformitiesList.Disconformidades.RazonSocialDeudor` (string, required)
    Razón social del deudor.
    Example: "Empresa Ejemplo"

  - `Data.NonconformitiesList.Disconformidades.TipodeDisconformidad1` (string, required)
    Tipo de disconformidad principal.
    Example: "Pago"

  - `Data.NonconformitiesList.Disconformidades.MontoBrutoInstruccionDePago` (integer, required)
    Monto bruto de la instrucción de pago relacionada (CLP, sin formato).
    Example: 1111111

  - `Data.NonconformitiesList.Disconformidades.SaldoPendiente` (integer, required)
    Saldo pendiente de la disconformidad (CLP, sin formato).
    Example: 1111111

  - `Data.NonconformitiesList.Disconformidades.NumeroDeDisconformidad` (object, required)
    Identificadores del caso y de la disconformidad.
    Example: {"IDCaso":"3524","NumeroDeDisconformidad":"DISC_8888"}

  - `Data.NonconformitiesList.Disconformidades.NumeroDeDisconformidad.IDCaso` (string, required)
    Identificador interno del caso.
    Example: "3524"

  - `Data.NonconformitiesList.Disconformidades.NumeroDeDisconformidad.NumeroDeDisconformidad` (string, required)
    Número de disconformidad mostrado.
    Example: "DISC_8888"

  - `Data.NonconformitiesList.Disconformidades.FechaCierreCaso` (string, required)
    Fecha/hora de cierre del caso (ISO 8601 con zona) o vacío si está abierto.
    Example: "2021-08-30T12:03:59-0400"

  - `Data.NonconformitiesList.Disconformidades.FechaDeVencimientoDesde` (string, required)
    Fecha/hora de vencimiento desde la cual aplica la disconformidad (ISO 8601 con zona).
    Example: "2021-08-23T07:30:22-0400"

  - `Data.NonconformitiesList.Disconformidades.DisconformidadAbiertaPor` (string, required)
    Parte que abrió la disconformidad.
    Example: "Acreedor"

  - `Data.NonconformitiesList.Disconformidades.TipoDeDisconformidad2` (string, required)
    Tipo de disconformidad secundario.
    Example: "Pago"

  - `Data.NonconformitiesList.Disconformidades.CodigoNemotecnico` (string, required)
    Código nemotécnico asociado a la instrucción o entidad (puede venir vacío).

  - `Data.NonconformitiesList.Disconformidades.IdInstruccionDePagoPP` (string, required)
    Identificador de la instrucción de pago relacionada en el portal/proveedor.
    Example: "9999999"

  - `Data.NonconformitiesList.Disconformidades.EstadoDeFacturacion` (string, required)
    Estado de facturación mostrado por el portal.
    Example: "Facturado"

  - `Data.NonconformitiesList.Disconformidades.EstadoDePago` (string, required)
    Estado de pago mostrado por el portal.
    Example: "No Pagado"

  - `Data.NonconformitiesList.Disconformidades.EnEsperaDeEjecucion` (string, required)
    Indicador de espera de ejecución (puede venir vacío).

  - `Data.NonconformitiesList.Disconformidades.Estado` (string, required)
    Estado general del caso.
    Example: "Cerrada"

  - `Data.NonconformitiesList.Disconformidades.FechaSolicitudCierre` (string, required)
    Fecha/hora en que se solicitó el cierre (ISO 8601 con zona) o vacío.

  - `Data.NonconformitiesList.Disconformidades.DeudorSolicitaCierre` (string, required)
    Si el deudor solicitó el cierre (p. ej., Si/No) o vacío.

  - `Data.NonconformitiesList.Disconformidades.AcreedorSolicitaCierre` (string, required)
    Si el acreedor solicitó el cierre (p. ej., Si/No) o vacío.

  - `Data.NonconformitiesList.Disconformidades.CierreAprobado` (string, required)
    Si el cierre fue aprobado (p. ej., Si/No) o vacío.
    Example: "Si"

  - `Data.NonconformitiesList.Disconformidades.CierreAutomatico` (string, required)
    Si el cierre fue automático (p. ej., Si/No) o vacío.

  - `Data.NonconformitiesList.TotalDisconformidades` (integer, required)
    Número total de disconformidades retornadas para los filtros aplicados.
    Example: 4575

  - `AdditionalInformation` (string,null, required)
    Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

  - `Error` (object,null, required)
    Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando [este enlace](https://docs.khipu.com/portal/en/errors/)

  - `Error.Code` (string)
    Código interno del sistema que identifica el error.
    Example: "E201"

  - `Error.Type` (string)
    Indica cómo tratar este código de error específico, en función del tipo de error.
    Enum: "RETRY_IMMEDIATELY", "DO_NOT_RETRY", "WAIT_4_HOURS_BEFORE_RETRY", "RETRY_AFTER_NOTIFICATION"

  - `Error.Description` (string)
    Descripción asociada al código de error.
    Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

  - `LifeSpan` (string,null, required)
    null en peticiones sincrónicas.

## Response 202 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación. Al realizar solicitudes asíncronas, siempre devolverá OK.
    Example: "OK"

  - `Data` (object, required)
    null en solicitudes asíncronas.

  - `AdditionalInformation` (string, required)
    Mensaje de la operación, puede usarse para mostrar información adicional.
    Example: "Data will be sent to the callback URL."

  - `Error` (object, required)
    null en solicitudes asíncronas.

  - `LifeSpan` (string, required)
    Fecha máxima estimada de entrega para solicitudes asíncronas, en formato de fecha y hora ISO 8601, zona horaria UTC.
    Example: "2017-07-22T00:00:00-0400"


## Response 400 fields

## Response 401 fields

## Response 404 fields

## Response 500 fields