# Death Certificate

Este método retorna un "Certificado de defunción" desde el sitio web del , dado un Rol Único Nacional (RUN).

El uso del campo  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  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/registrocivil.cl/death-certificate
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.RolUnicoNacionalCertificate` (string, required)
    Rol único nacional (RUN) del que deseas el certificado de defunción. No utilice los puntos.
    Example: "11222333-k"

  - `RequestData.RolUnicoNacionalApplicant` (string, required)
    Rol único nacional (RUN) de la persona solicitante del certificado. No utilice los puntos.
    Example: "11222333-k"

  - `RequestData.DocumentNumberApplicant` (string, required)
    Número de serie del documento de identidad de la persona que solicita el certificado.
    Example: "555666777"

  - `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.  significa que el servicio se ha ejecutado correctamente aunque no devuelva datos.  indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.
    Enum: "OK", "ERROR"

  - `Data` (object,null, required)
    Contenedor para certificado de defunción.

  - `Data.CertificadoDefuncion` (object, required)
    Contenedor para certificado de defunción.

  - `Data.CertificadoDefuncion.CodigoVerificacion` (string, required)
    Código para verificar la validez del documento en el sitio web del Registro Civil.
    Example: "c846470891ff"

  - `Data.CertificadoDefuncion.DatosRegistro` (object, required)
    Contenedor para los detalles del certificado.

  - `Data.CertificadoDefuncion.DatosRegistro.Anio` (string, required)
    Año.
    Example: "1997"

  - `Data.CertificadoDefuncion.DatosRegistro.Circunscripcion` (string, required)
    Circunscripción.
    Example: "SAN JOSÉ DE MAIPO"

  - `Data.CertificadoDefuncion.DatosRegistro.FechaNacimiento` (string, required)
    Fecha de nacimiento.
    Example: "1980-04-25"

  - `Data.CertificadoDefuncion.DatosRegistro.NombreInscrito` (string, required)
    Nombre inscrito.
    Example: "NOMBRE1 NOMBRE2 APELLIDO1 APELLIDO2"

  - `Data.CertificadoDefuncion.DatosRegistro.FechaDefuncion` (string, required)
    Fecha de defunción.
    Example: "2023-09-28T16:32:00"

  - `Data.CertificadoDefuncion.DatosRegistro.NumeroInscripcion` (string, required)
    Nro. inscripción.
    Example: "9.821"

  - `Data.CertificadoDefuncion.DatosRegistro.Registro` (string, required)
    Registro.
    Example: "E"

  - `Data.CertificadoDefuncion.DatosRegistro.Run` (string, required)
    R.U.N.
    Example: "11.222.333-7"

  - `Data.CertificadoDefuncion.DatosRegistro.LugarDefuncion` (string, required)
    Lugar de defunción.
    Example: "Santiago"

  - `Data.CertificadoDefuncion.DatosRegistro.Sexo` (string, required)
    Sexo.
    Example: "Masculino"

  - `Data.CertificadoDefuncion.Documento` (string, required)
    Representación Base64 del documento en formato PDF.
    Example: "<document>"

  - `Data.CertificadoDefuncion.FechaEmision` (string, required)
    Fecha en la que se emitió el certificado.
    Example: "2023-09-28T16:32:00"

  - `Data.CertificadoDefuncion.Folio` (string, required)
    Número de folio del certificado.
    Example: "500515253001"

  - `Data.CertificadoDefuncion.NombreArchivo` (string, required)
    Nombre de archivo, según lo indicado por el Registro Civil.
    Example: "MAT_500515253001_11222333.pdf"

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

  - `Error` (object,null, required)
    Objeto con los detalles del error, utilizado cuando . Si  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)
    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á .
    Example: "OK"

  - `Data` (object, required)
    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)
    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"