El presente documento define las consideraciones técnicas, operativas y administrativas relacionadas con el uso de la plataforma de notificaciones, la forma en que se practican las notificaciones electrónicas y los aspectos funcionales relevantes para su correcta operación, así como la aplicación de los mandatos establecidos en la Norma Técnica de Notificaciones Electrónicas.
Esta guía define el proceso de integración de las instituciones a la plataforma de notificaciones. Su objetivo es proporcionar apoyo a las OAE para solicitar su habilitación en la plataforma, configurar su institución y enviar mensajes desde la interfaz web y/o la API en un ambiente de pruebas antes de su integración en producción.
Esta es la primera versión de la plataforma de notificaciones en producción, que opera durante 2025 con instituciones que desean formar parte de esta etapa del producto. Es importante considerar que esta versión:
Las siguientes definiciones se aplican en el contexto de este documento.
Es la plataforma electrónica encargada de registrar a las personas naturales y jurídicas en el Domicilio Digital Único (DDU); y de ejecutar las notificaciones electrónicas de los Órganos de la Administración del Estado (OAE) en el marco de procedimientos administrativos.
Todos los Órganos de la Administración del Estado (OAE): ministerios, secretarías, servicios, gobernaciones, municipalidades, entre otros, deben practicar notificaciones por medios electrónicos en el marco de sus procedimientos administrativos, utilizando como base la información contenida en el registro único dependiente del Servicio de Registro Civil e Identificación, según lo establece el artículo 46 de la ley N° 19.880, en adelante también “Registro de Domicilios Digitales Únicos” o “Registro de DDU”.
Para ello, los OAE pueden integrarse a la plataforma de notificaciones, para dar cumplimiento al mandato de envío de notificaciones por medios electrónicos a los interesados y apoderados de los procedimientos administrativos.
Para utilizar cualquier plataforma o servicio compartido de Gobierno Digital, cada institución debe contar con un Coordinador de Transformación Digital oficialmente designado, quien se encarga de las comunicaciones con la SGD.
Antes de solicitar la integración a la plataforma, la institución debe:
Una vez que la institución cumple con los requisitos mencionados, puede iniciar la solicitud de integración a la Plataforma de Notificaciones, ingresando a CeroFilas. Para ello debe:
Importante: En la solicitud de integración se incluyen los términos y condiciones de uso de la plataforma para las instituciones. Es fundamental que estos sean revisados para continuar con el proceso. A continuación, se detalla el flujo de integración.
La institución debe estar preparada para integrarse a la plataforma de notificaciones, según lo indicado al inicio del punto 2, una vez lista debe solicitar la integración en el sitio web de CeroFilas de la Secretaría de Gobierno Digital.
En el formulario de la solicitud se debe indicar la siguiente información:
Antes de enviar el formulario es importante que sean leídos los términos y condiciones para las instituciones.
La Secretaría de Gobierno Digital (SGD) evalúa todas las solicitudes de integración, verificando que:
Si la solicitud presenta inconsistencias, se rechaza y se envía un correo con las observaciones de la evaluación. Para continuar con la integración, la institución debe corregir los errores y presentar una nueva solicitud.
Si la solicitud es aceptada, la SGD habilita a la institución y al administrador institucional en la plataforma, permitiéndoles avanzar en la configuración. La habilitación inicial se realiza en un ambiente de pruebas, donde la institución puede resolver dudas y efectuar un primer envío de mensajes antes de la implementación en producción.
En esta fase, la SGD ejecuta las siguientes acciones en el ambiente de pruebas:
Para cualquier integración que realice un OAE en la Plataforma de Notificaciones, es obligatorio realizar un envío de mensaje en el ambiente de pruebas. Para ello, se deben completar las configuraciones necesarias que permitan operar correctamente en la plataforma.
Configurar la institución
Este proceso, independiente del tipo de integración seleccionado, permite iniciar la operación y se lleva a cabo a través de la interfaz web.
El administrador institucional, designado en el formulario de solicitud, debe acceder a la plataforma utilizando ClaveÚnica y completar las siguientes actividades:
Crear administrador de mensajes, si la institución va a operar a través de la web o solo necesita ver los mensajes que se han enviado desde la API, entonces debe crear usuarios con el rol de administrador de mensajes. Debe ir a la opción Administración/Usuarios.
Envío de mensaje desde la plataforma web y/o API: según lo indicado en la solicitud la institución debe enviar un mensaje desde la interfaz web y/o desde la API.
Para enviar un mensaje a través de la web, el funcionario asignado con el rol de administrador de mensajes debe acceder a la plataforma y realizar el envío; debe ir a la opción Crear mensaje. Para el envío de mensajes a través de la API, se debe realizar a través del nodo de PISSE, puede revisar el punto 4 de este documento “Envío de notificación por parte del OAE desde la API”, allí encontrará detalles para realizar el envío.
Aunque estas actividades se llevan a cabo en un ambiente de pruebas, se sugiere seguir las siguientes recomendaciones para el contenido del mensaje:
Si la institución ha optado por la integración a través de la API o por ambas opciones (WEB/API), debe enviar también, un mensaje mediante la integración por API, esto se realizará a través del nodo de PISEE.
El objetivo de las actividades en ambiente de pruebas, es que pueda realizar la configuración y envío de mensajes, desde la interfaz web o API, según la integración que haya solicitado. En la interfaz web puede ver el detalle y estado de los mensajes que ha enviado su institución, y una previsualización de cómo lo verá el ciudadano. Si quiere ver directamente cómo lo recibe y visualiza el destinatario, y utilizó el usuario de prueba para este ambiente, puede ingresar a la CasillaÚnica en ambiente de pruebas, con los siguientes datos:
A continuación una vista de un mensaje visto en la bandeja de un ciudadano:
La revisión se realizará en el ambiente de pruebas, y está enfocada a validar por parte de SGD, si la institución pudo ejecutar todas las actividades del punto anterior. Se espera que la institución haya podido:
Cuando la institución haya realizado las actividades descritas en el punto “2.3 Realizar actividades en ambiente de pruebas”, debe continuar el flujo de la solicitud de integración a la plataforma de notificaciones ingresando a CeroFilas, y debe realizar una solicitud de certificación:
Ingrese la solicitud y si es necesario, agregue en los comentarios los detalles de la solicitud que el equipo de SGD debe tener en cuenta durante la evaluación
En caso de cumplir con los parámetros establecidos, la Secretaría de Gobierno Digital habilita a la institución en producción, permitiéndole comenzar a enviar notificaciones electrónicas de los procedimientos administrativos a los interesados.
El OAE realiza la revisión y corrección: si la institución no presenta evidencias o estas no cumplen con lo esperado, debe repetir la actividad hasta realizar las acciones indicadas correctamente.
La Secretaría de Gobierno Digital (SGD), evalúa la solicitud de certificación asegurándose que las actividades descritas en el punto “2.3 Realizar actividades en ambiente de pruebas” se hayan completado:
Si hay algún inconveniente, la certificación no será aprobada y se enviará un correo con las observaciones de la evaluación. Una vez corregidas, la institución debe realizar una nueva solicitud de certificación.
Si la solicitud de certificación es aprobada, se enviará un correo con la respuesta de la solicitud de certificación con los detalles e información necesarias para continuar el proceso de habilitación en producción.
Si requiere enviar notificaciones a través de la API, debe hacerlo a través del nodo de PISEE en producción. Esto permitirá integrarse al modelo de interoperabilidad, donde su nodo consumidor podrá acceder a nuestro nodo proveedor. Para realizar la solicitud del nodo en producción, debe comunicarse con la Mesa de servicios.
La SGD habilita a la institución y al administrador institucional en la plataforma para continuar con el proceso de configuración de la institución en producción. En este paso la SGD realizará las siguientes actividades en el ambiente de producción:
La institución debe:
Luego de completar los pasos de integración, la institución queda habilitada para enviar notificaciones por medios electrónicos a los interesados en los procedimientos administrativos definidos en la plataforma.
El OAE cuenta con dos mecanismos no excluyentes de practicar las notificaciones electrónicas: mediante la interfaz web y de manera automática con la integración vía API. En ambos casos, antes de enviar la primera notificación la institución debe estar configurada.
Como precondición a este proceso, todas las actividades descritas en la sección “2.6-Habilitación en producción” deben estar realizadas.
El usuario podrá optar por enviar mensajes con la opción de Mensaje Simple, esto es un solo mensaje a uno o más destinatarios, en los que todos reciben el mismo contenido y archivos adjuntos. También se pueden enviar mensajes a través de la opción de Mensaje Múltiple, esto último es enviar un mensaje para distintos grupos de destinatarios, en donde por cada grupo se podrá individualizar los destinatarios y archivos adjuntos. Esta opción en la plataforma, la puede encontrar en el menú del administrador del mensaje como “Crear mensaje”.
Luego, el usuario debe indicar el Procedimiento Administrativo para el cuál necesita practicar la notificación, el cuál el administrador institucional lo debió haber añadido a la plataforma previamente.
Si al enviar un mensaje, no encuentra en la lista el procedimiento administrativo que desea notificar, debe reportarlo al administrador institucional de la plataforma, para que verifique si ya fue añadido en la lista del notificador.
Finalmente, el usuario puede redactar la notificación agregando a los destinatarios de manera manual o por archivo .csv, agregando: asunto, cuerpo del mensaje y archivos adjuntos; de la misma forma que un correo electrónico tradicional.
Si configuró una o más firmas para su institución, puede elegir una para que se muestre en el mensaje, también puede enviar mensajes tomando como base las plantillas creadas previamente.
Para más detalles refiérase al Manual de Usuario Institucional disponible en: Manual-instituciones-Plataforma-notificador.
En un mensaje simple se pueden enviar archivos cuyo peso no sea mayor a 20 MB, en un archivo o varios que en total no superen el peso indicado. Los archivos adjuntos enviados en las notificaciones, deben tener alguna de estas extensiones: pdf, jpg, png, word (doc. docx), excel(xls, xlsx). Si el archivo tiene firma electrónica, ésta debe ser válida y el documento no debe estar adulterado para poder adjuntarlo. La plataforma acepta y valida archivos con firma electrónica en formato PDF.
Las notificaciones que se han enviado, desde la plataforma web y desde la API, se pueden ver en el listado de mensajes enviados, en la opción del menú “Mensajes enviados”. Desde allí podrá acceder al detalle de cada mensaje. La plataforma maneja 3 estados:
La API de notificaciones permite gestionar las notificaciones (envíos de mensajes y visualización de sus estados) a las instituciones que se encuentren habilitadas en la plataforma de notificaciones. Las validaciones para el envío de un mensaje que se realizan en un mensaje enviado desde la WEB son las misma que se realizan desde la API, por lo que todas las actividades descritas en la sección “2.6-Habilitación en producción” deben estar realizadas antes de realizar un mensaje desde este canal.
Para consumir esta API es necesario tener configurado un nodo de interoperabilidad PISEE 2, además de un client_id y un client_secret asociado a la institución que desea utilizar la plataforma.
Para el envío de notificaciones, se debe configurar y consumir el siguiente endpoint:
URL: /notificador/sendMessage
Tipo de llamada: POST
La solicitud debe enviarse como multipart/form-data con dos partes posibles:
data: Una cadena JSON que contiene los datos de la notificación que se desea enviar.
attachments: Archivos adjuntos opcionales (se permiten múltiples archivos)
| Campo | Tipo | Obligatorio | Descripción |
|
recipients |
Arreglo |
Sí |
Lista de destinatarios, cada destinatario se identifica por un objeto con el atributo “rol_unico” que corresponde al rol único del destinatario (ya sea RUN o RUT) sin dígito verificador. (máximo 250 destinatarios) Por ejemplo:
|
|
message_type |
Cadena. | Sí |
Corresponde al tipo de notificación. Puede ser de alguno de los siguientes valores:
CP: Comunicación Personal CI: Comunicado Institucional |
|
procedure_code |
Cadena |
Obligatorio solo si message_type = NT |
Código del procedimiento administrativo. |
|
procedure_stage |
Numérico |
Obligatorio solo si message_type = NT |
Etapa del procedimiento administrativo en formato numérico. Puede ser de alguno de los siguientes valores: 1 = Etapa de inicio 2 = Etapa de instrucción 3 = Etapa de finalización |
|
signature_uid |
Cadena (UUID) | No | Identificador único universal (UUID) de la firma institucional a utilizar. Solo si se envía un mensaje con una firma institucional. |
|
subject |
Cadena | Sí | Asunto de la notificación. |
|
content |
Cadena | Sí | Contenido de la notificación. |
|
content_type |
Cadena | Sí |
Tipo MIME del contenido de la notificación. Por ejemplo "text/html" |
|
webhook_url |
Cadena (URL) | No | URL para recibir el estado del procesamiento del mensaje. Si se especifica se gatilla una petición post a la URL indicada cuando se inicia el proceso de envío de dicho mensaje. Dentro del body se envía la información del resultado del envío: status y message_data_id. Si no se especifica se debe enviar como null o vacío, ejemplo: "webhook_url": "" ó "webhook_url": null |
Tabla 1. Descripción del objeto JSON para enviar un mensaje
Enlaces dentro del contenido del mensaje
Para colocar un enlace dentro del contenido del mensaje, se debe añadir la etiqueta html que permite añadir enlaces a otras páginas en internet, debe especificar en el atributo target que debe Carga la URL en una nueva pestaña, ejemplo:
<a href="https://digital.gob.cl" target="_blank">Enlace</a>
Resultado
Una vez ejecutada la llamada, y si todo está correcto, el endpoint retorna el código HTTP 200 y como respuesta un JSON con los siguientes valores:
message_data_id: Corresponde al ID del envío.
sent_at: Fecha de envío.
status: Corresponde al estado del envío.
{
"message_data_id": "630c7a94ee5a2dbd341d23ff7",
"sent_at": "Mon, 14 Jun 2023 15:09:03 GMT",
"status": "pending"
}
Figura 22. Ejemplo de respuesta después de enviar un mensaje
El contenido del mensaje que se envía desde la API debe tener datos válidos para la institución que está realizando el envío, se realizan validaciones y si hay algún error no se realiza el envío. Cuando un mensaje no puede ser enviado por las validaciones realizadas en los datos, se muestra la siguiente información:
errors: muestra los errores encontrados, muestra el código y una descripción del error.
message: resumen del estado del envío.
{
"errors": [
{
"code": "ERR007",
"message": "Código de procedimiento administrativo no válido"
}
],
"message": "Falló la validación de los datos de entrada"
}
Figura 23. Ejemplo de respuesta después de enviar un mensaje con error
Posibles mensajes en la validación del envío: A continuación se presentan todos los estados mensajes de validación del contenido del mensaje que se está intentando enviar.
|
Código |
Mensaje | Posibles causas y acciones |
|
ERR001 |
No se proporcionó ningún destinatario para el mensaje |
No se proporcionó un valor válido para "recipients". Este atributo espera un arreglo de destinatarios de la siguiente forma (debe contener al menos un registro): "recipients": [ { "rol_unico": 16724949 } ] |
|
ERR002 |
El/los siguiente(s) índices contienen elementos no esperados para destinatarios [i, j, k] |
Alguno de los nodos en "recipients": [ ... ] no contiene el atributo "rol_unico". El mensaje indica los índice dentro del arreglo que no cumplen este requisito, el primer elemento del arreglo corresponde al 0 |
|
ERR003 |
El/los siguiente(s) índices de destinatarios no son válidos [i, j, k], verifique el contenido o longitud del dato |
Alguno de los nodos en "recipients": [ ... ] no contiene un valor válido para "rol_unico". El mensaje indica los índices dentro del arreglo que no cumplen este requisito, el primer elemento del arreglo corresponde al 0. "rol_unico" es de tipo entero positivo y no debe exceder el valor 99.999.999 |
|
ERR004 |
Código de tipo de mensaje no ingresado | No se proporcionó un valor para "message_type", este campo es obligatorio y corresponde al código de tipo de mensaje |
|
ERR005 |
Código de tipo de mensaje no permitido |
1. El código de tipo de mensaje enviado en el campo "message_type" no es uno de los tipos válidos (NT,CP,CI) 2. Se envío un código válido, pero su institución no está habilitada para enviar ese tipo de mensajes |
|
ERR006 |
Código de procedimiento administrativo no ingresado | No se ingresó un valor válido para el campo "procedure_code". Es requerido siempre que se intente enviar un mensaje de tipo notificación ("message_type" : "NT"). En cualquier otro tipo de notificación es opcional |
|
ERR007 |
Código de procedimiento administrativo no válido | El código de procedimiento enviado en el campo "procedure_code" no existe o no ha sido habilitado para el envío de notificaciones desde su institución |
|
ERR008 |
Debe configurar el logo de su institución en la plataforma | La institución que está intentando enviar el mensaje aún no ha configurado el logotipo en la plataforma. Antes de enviar cualquier mensaje es necesario configurar el logotipo, por favor contacte con su administrador de institución. |
|
ERR013 |
El archivo [índice/posición del archivo] tiene un formato no permitido. Selecciona un formato válido | Se adjuntó un archivo al mensaje y la extensión es diferente a: pdf, jpg, png, word (doc. docx), excel(xls, xlsx) |
|
ERR014 |
El nombre del archivo [índice/posición del archivo] debe tener máximo 50 caracteres | El nombre de un archivo adjuntado en el mensaje excede a los 50 caracteres |
|
ERR015 |
El límite total para los adjuntos es de 25 MB. Elige un archivo que no exceda ese límite | La suma de los archivos que se adjuntaron al mensajes es mayor a 20 MB |
|
ERR016 |
El Archivo [índice/posición del archivo] ya fue adjuntado | En los archivos que fueron adjuntados al mensaje hay archivos duplicados o tienen el mismo nombre |
|
ERR017 |
El contenido del archivo [índice/posición del archivo] (base64) no tiene el formato correcto | En los archivos que fueron adjuntados un base64 no tiene el formato correcto (caracteres y tamaño múltiplo de 4) |
|
ERR018 |
La extensión del archivo [índice/posición del archivo] no corresponde con el tipo de documento | En los archivos que fueron adjuntados existe una extensión que no corresponde con el tipo de documento adjuntado |
|
ERR019 |
El archivo [índice/posición del archivo] excede los 20 MB permitidos. Elige un archivo que no exceda ese límite | Se adjuntó un archivo y su peso es de 20 MB o más |
|
ERR020 |
Firma no válida | Se añadió el código de una firma que pertenece a otra institución |
|
ERR021 |
El archivo [índice/posición del archivo] no se ha cargado por los siguientes motivos: El archivo está adulterado, fué modificado después de su firma y/o tiene firma(s) revocada(s)” | Se adjuntó un archivo en donde alguna de las firmas del archivo está adulterado, fue modificado después de su firma y/o tiene firma(s) revocada(s) |
|
ERR023 |
RUN no válido | El RUN ingresado, tiene caracteres que no son números, está fuera de la cantidad de dígitos permitidos o no se envió ningún valor |
|
ERR026 |
No se puede enviar el mensaje, cantidad de caracteres excede al número permitido de 150 caracteres | La cantidad de caracteres en el asunto excede a los 150 permitidos |
|
ERR027 |
No se puede enviar el mensaje, asunto del mensaje no ingresado | Asunto del mensaje no ingresado |
|
ERR028 |
No se puede enviar el mensaje, URL no válida | URL en el contenido del mensaje no es válida o no se añadió ninguna |
|
ERR030 |
No se puede enviar el mensaje, se permite hasta 250 destinatarios en un mensaje | Se colocó una lista de destinatarios mayor a 250 |
|
ERR031 |
Este es un envío duplicado, si estás seguro de que debe enviarse, debes esperar 5 minutos desde que apareció este mensaje por primera vez. | Un mensaje con el mismo contenido se ha enviado en un período dentro de 5 minutos |
|
ERR032 |
El límite total de archivos permitidos se ha superado, elige hasta 50 archivos. | Se adjuntó más de 50 archivos al mensaje |
|
ERR033 |
Debes renombrar el archivo, usando sólo letras (sin acentos ni ñ), números y como separadores usa guiones, guiones bajos o espacio (sin usarlos al inicio, al final o juntos) | se adjuntó un archivo cuyo nombre tiene caracteres diferentes a los permitidos: letras, números, guiones (-, _), espacios. |
|
ERR034 |
No se puede enviar el mensaje, el atributo webhook tiene una URL no válida | Se colocó una URL con una estructura que no corresponde con la esperada |
Tabla 2. Posibles mensajes de error al enviar un mensaje
Para ver el estado de una notificación enviada, se debe configurar y consumir el siguiente endpoint:
URL: /notificador/messageStatus/{message_data_id}
Tipo de llamada: GET
El parámetro a configurar en esta llamada es el siguiente:
message_data_id: El ID del envío generado a través del endpoint de envío de notificaciones. Corresponde al valor message_data_id que fue retornado como respuesta en el endpoint de envío de notificaciones (/notificador/sendMessage).
Una vez ejecutada la llamada, el endpoint retorna como respuesta un JSON con los siguientes valores:
message_data_id: Corresponde al ID del envío.
entity_id: ID de la institución.
recieved_at: Fecha de recepción del mensaje por parte de la plataforma.
status: Estado actual del envío.
subject: Asunto del envío.
recipents_count: Cantidad de destinatarios del envío.
recipients: Objeto que contiene roles únicos de destinatarios como llave y como contenido una estructura con los atributos:
{
"entity_id": "794a0088-cec0-11eb-b8bc-0242ac130003",
"message_data_id": "60c7a94ee5a2dbd341d23ff7",
"received_at": "Wed, 24 Aug 2022 15:59:23 GMT",
"status": "processed",
"subject": "Asunto de ejemplo",
"recipents_counts": 5,
"recipients"{
"10936746": {
"ddu_type": "not_configured",
"message_status": "delivered",
"method": "API",
"delivered_at": "Wed, 24 Aug 2022 15:59:23 GMT",
"read_at": null
},
"16409277": {
"ddu_type": "casilla",
"message_status": "delivered",
"method": "API",
"delivered_at": "Wed, 24 Aug 2022 15:59:23 GMT",
"read_at": "Mon, 14 Jun 2021 15:09:03 GMT"
},
"17353548": {
"ddu_type": "email",
"message_status": "delivered",
"method": "API",
"delivered_at": "Wed, 24 Aug 2022 15:59:23 GMT",
"read_at": null
},
"21175730": {
"ddu_type": "excepcion",
"message_status": "delivered",
"method": "API",
"delivered_at": "Wed, 24 Aug 2022 15:59:23 GMT",
"read_at": null
},
"16472149": {
"ddu_type": "email",
"message_status": "error",
"method": "API",
"delivered_at": "Wed, 24 Aug 2022 15:59:23 GMT",
"read_at": null
}
}
}
Figura 24. Ejemplo de respuesta de estado de un mensaje para diferentes destinatarios
Posibles estados de un mensaje: A continuación se presentan todos los estados posibles que puede tener un mensaje.
| Estados | Descripción |
| pending | Estado inicial, al crear el envío se crea con este estado. |
| delivered | Estado final, el envío queda con este estado al finalizar el proceso de enviar los mensajes. |
| error | Falló al momento de crear/actualizar el envío para el destinatario correspondiente. |
| error_rejected | Se ha determinado que el mensaje es sospechoso o no es válido |
| error_undetermined_undetermined | No se ha podido determinar un motivo específico de rebote. |
| error_permanent_general | Ha ocurrido un rechazo permanente general. |
| error_permanent_no_email | Ha ocurrido un rechazo permanente porque la dirección de correo electrónico de destino no existe. |
| error_permanent_supressed | Se ha descartado el envío a esta dirección dado que tiene un historial reciente de rebotes como dirección no válida. |
| error_permanent_on_account_suspension_list | Se ha descartado el envío a esta dirección porque está en la lista de correos electrónicos con rebotes previos. |
| error_transient_general | Ha ocurrido un rebote general. Es posible que pueda enviar correctamente a este destinatario en el futuro. |
| error_transient_mailbox_full | Ha ocurrido un rebote. La bandeja de mensajes del destinatario está llenared |
| error_transient_message_too_large | Ha ocurrido un rebote. Mensaje demasiado grande |
| error_transient_content_rejected | Ha ocurrido un rebote. Contenido rechazado |
| error_transient_attachment_rejected | Ha ocurrido un rebote. Archivo adjunto rechazado |
| error_send_message_mail | No se ha podido comunicar con el servidor de correo |
Tabla 3. Tabla con estados para un mensaje
Estado de configuración de DDU: Al momento que se envían los mensajes, para DDU configurados como email, temporalmente y por pocos segundos, quedan en estado “pending”; para los otros casos inicialmente quedan como delivered; esto pasa para cada destinatario de un mensaje. A continuación una tabla con valores para el estado del mensaje para un destinatario que puede mostrar de acuerdo a la configuración de DDU:
| Estado DDU destinatario | Estado mensaje inicial | Estado mensaje Final |
| DDU no configurada | delivered | delivered o error |
| DDU excepcionada | delivered | delivered o error |
| DDU configurada como casilla | delivered | delivered o error |
| DDU configurada como correo electrónico | pending | delivered o error (todos los posibles errores indicados en la tabla 3 sección 4.3) |
Tabla 4. Tabla con estados del mensaje según la configuración de DDU
Endpoint que se dispone para mostrar la cantidad de notificaciones sin leer de un ciudadano. Para ver los mensajes pendientes de lectura de un ciudadano, se debe configurar y consumir el siguiente endpoint:
URL: /notificador/citizenPending/{rol-unico}
Tipo de llamada: GET
El parámetro a configurar en esta llamada es el siguiente:
rol-unico: Rol único del ciudadano del cual se hace la consulta.
Una vez ejecutada la llamada, el endpoint retorna como respuesta un JSON con los siguientes valores:
access_url: Ruta directa a la bandeja de mensajes de ciudadanos.
current_ddu_type: estado actual del DDU del ciudadano.
result_message: Mensaje con resumen del resultado de la consulta de acuerdo a si el ciudadano tiene o no mensajes pendientes por leer.
status: estado de la consulta.
total_pending: Cantidad de mensajes que se encuentran en estado “pending” por parte del ciudadano.
{
"access_url": "https://portal.devel.casillaunica.gob.cl/ext/bandeja",
"current_ddu_type": "casilla",
"result_message": "Usuario tiene mensajes pendientes por leer en su casilla",
"status": true,
"total_pending": 11
}
Figura 25. Ejemplo de respuesta a consulta de mensajes en estado pendiente para un destinatario
Para conocer los códigos de los procedimientos administrativos asociados a la institución con la cual quiero enviar algún mensaje, es necesario consumir el siguiente endpoint:
URL: /notificador/getProcedure
Tipo de llamada: GET
Una vez ejecutada la llamada, el endpoint retorna como respuesta un JSON con los siguientes valores:
procedures: Objeto que contiene una lista de procedimientos administrativos con los atributos:
name: Nombre del procedimiento administrativo.
code: Código del procedimiento administrativo.
stage: Etapa del procedimiento administrativo como número.
stage_name: Etapa del procedimiento administrativo como string.
{
"procedures": [
{
"code": "PA-SER0000-5463",
"name": "Licitación Pública",
"stage": 1,
"stage_name": "Etapa de inicio"
},
{
"code": "PA-SER0000-5463",
"name": "Licitación Pública",
"stage": 3,
"stage_name": "Etapa de finalización"
}
]
}
Figura 25. Ejemplo de respuesta a consulta de procedimientos administrativos
Posibles salidas: A continuación se presentan los posibles mensajes que puede retornar este endPoint de acuerdo a los procedimientos administrativos asociados a la institución.
| Tiene procedimientos | Resultado |
| SI | Lista con los procedimientos administrativos y sus datos. |
| NO | Un mensaje que indique que no existen Procedimientos administrativos registrados. |
Tabla 6. Tabla con salida de procedimientos administrativos
Para conocer los UUID de las firmas institucionales con la cual quiero enviar algún mensaje, es necesario consumir el siguiente endpoint:
URL: /notificador/getSignature
Tipo de llamada: GET
Una vez ejecutada la llamada, el endpoint retorna como respuesta un JSON con los siguientes valores:
signatures: Objeto que contiene una lista de firmas institucionales con los atributos:
name: Nombre de la firma institucional.
code: Código de la firma institucional.
body: Contenido de la firma institucional.
updated_at: Fecha de la última modificación de la firma institucional.
{
"signatures": [
{
"body": "<p style="line-height: 24px; margin: 0px; padding: 0px; border: 0px; color: #373737;"><strong><span style="font-family: Roboto; font-size: 16px;">Enrique González Muñoz</span></strong><br /><em><span style="font-family: Roboto; font-size: 16px;">QA - Gobierno Digital </span><br /></em><br /><em><span style="font-family: Roboto; font-size: 16px;">Subsecretaria de Hacienda</span></em><br /><strong><em><span style="font-family: Roboto; font-size: 16px;">Ministerio de Hacienda</span></em></strong><br /><br /><br /></p>",
"name": "Firma Enrique",
"uid": "46e497de-8724-4a4d-befb-331486c70ba9",
"updated_at": "Mon, 20 Dec 2024 16:42:18 GMT"
},
{
"body": "<p style="line-height: 24px; margin: 0px; padding: 0px; border: 0px; color: #373737;"><strong><span style="font-family: Roboto; font-size: 16px;">Dirección de Arquitectura</span></strong><br /><em><span style="font-family: Roboto; font-size: 16px;">Subsecretaria de Hacienda</span></em><br /><br /><br /></p>",
"name": "Firma institución",
"uid": "483ef791-7253-46a0-997c-afd8d089cc26",
"updated_at": "Mon, 20 Dec 2024 10:42:18 GMT"
}
]
}
Posibles salidas: A continuación se presentan los posibles mensajes que puede retornar este endPoint de acuerdo a las firmas institucionales creadas.
| Tiene firmas | Resultado |
| SI | Lista con las firmas institucionales y sus datos. |
| NO | Un mensaje que indique que no existen firmas institucionales registradas. |
Para obtener un comprobante de mensajes desde la API es necesario consumir el siguiente endpoint:
URL: /notificador/getReceipt/{message_data_id}/{rol_unico}
Tipo de llamada: GET
El parámetro a configurar en esta llamada es el siguiente:
message_data_id: El ID del envío generado a través del endpoint de envío de notificaciones. Corresponde al valor message_data_id que fue retornado como respuesta en el endpoint de envíos (Sección 3.6).
rol_unico: Rol único del ciudadano del cual se quiere obtener el comprobante.
Una vez ejecutada la llamada, el endpoint retorna como respuesta un JSON con los siguientes valores:
url: Dirección desde la cual se puede descargar el comprobante de mensajes.
{
"url": "https://s3-153795248828-ms-message-devel.s3.amazonaws.com/statistics/certificate/comprobante_envio_21131064_20241226T1848.pdf?AWSAccessKeyId=AKIASHTXJIK6CTPBY5GM&Signature=NXClYleRHwuChA36GIXr0b31Wkg%3D&Expires=1735249783"
}
Ejemplo de respuesta a consulta de certificado de mensajes
Posibles salidas: A continuación se presentan los posibles mensajes que puede retornar este endPoint de acuerdo al certificado de mensajes de un ciudadano.
| Se genera comprobante | Resultado |
| SI | Una URL con el certificado de mensajes para descargar. |
| NO | Un mensaje que indique que no se puede descargar el comprobante, el mensaje no ha sido enviado. |
Posibles mensajes en la validación del comprobante: A continuación se presentan todos los mensajes de validación del comprobante de mensaje que se está intentando obtener.
|
Código |
Mensaje | Posibles causas y acciones |
|
ERR022 |
Código de mensaje no válido | El código no existe, pertenece a un mensaje de otra institución o no cumple el formato. |
|
ERR023 |
RUN no válido | El run tiene caracteres que no son números, está fuera de la cantidad de dígitos permitidos. |
|
ERR024 |
Mensaje no válido | El certificado que se puede obtener ya que no corresponde al destinatario. |
|
ERR025 |
No se puede descargar el comprobante, el mensaje no ha sido enviado | Dado que un mensaje que fue enviado por la API o la web y no se envió correctamente, se encuentra “en proceso” o con “error”, entonces no se puede generar un comprobante. |
La API y todos sus servicios estarán disponibles 24 x 7 con un máximo de 6 TPS.
En esta opción, el funcionario designado como administrador institucional podrá registrar una excepción para un ciudadano que, previa solicitud, quede exento de recibir notificaciones electrónicas, conforme a lo establecidos en el capítulo III, párrafo 1, artículo 46 de la ley 19.880 de Transformación Digital del Estado.
En el módulo de excepción de la plataforma, el funcionario debe registrar la solicitud en un formulario, indicando los datos del solicitante, los motivos de excepción y adjuntando los documentos de respaldo. Este registro viene a dar cuenta de una solicitud efectuada por parte del interesado, ante el órgano de la Administración del Estado donde está tramitando un procedimiento administrativo (Norma técnica de notificaciones, artículo 8) . El usuario debe cumplir con los casos descritos en los artículos 28 y 29 del Reglamento .
El formulario de registro de excepción se compone de lo siguiente:
La plataforma dispondrá una opción para descargar un certificado de envío de cada mensaje , que certifica que se ha realizado el envío de un mensaje a un destinatario, en la fecha y hora y con los datos mostrados en el certificado; se podrá obtener desde la plataforma web y a través de la API. Los certificados descargados podrán ser validados por cualquier persona.
La mesa de servicios para las instituciones estará a cargo de la Secretaría de Gobierno Digital (SGD). Puede dejar sus solicitudes en el siguiente formulario: https://gobdigitalcl.freshdesk.com/support/home. Ver figura 29
Para informar sobre otros inconvenientes o hacer sugerencias, puede escribir al correo del producto. Ver figura 30
curl --location '{url}/notificador/sendMessage' \
--form 'data="{
\"recipients\": [
{\"rol_unico\": 26093912},
{\"rol_unico\": 26789805}
],
\"message_type\": \"NT\",
\"procedure_code\": \"PA-SUP00604-00007\",
\"procedure_stage\": 1,
\"signature_uid\": \"92d6692d-a401-4f7f-918c-c3c74ae1b3b5\",
\"subject\": \"Mensaje de Prueba\",
\"content\": \"Recordemos que, el Nuevo Ingreso Familiar de Emergencia (IFE), promulgado el domingo 21 de junio, amplió su cobertura y aumentó los montos, para apoyar a los hogares con ingresos informales o formales insuficientes que se han visto afectados por la crisis sanitaria y económica provocada por el brote de Covid-19, como parte del conjunto de medidas que el Gobierno ha implementado en la actual contingencia. Para acceder al beneficio es necesario que la persona tenga Registro Social de Hogares (RSH) y que pertenezca al 90% más vulnerable. Pero, además se creó un nuevo indicador para contar con información más actualizada de la vulnerabilidad socioeconómica de las familias durante la emergencia: El Indicador Socioeconómico de Emergencia (ISE) y en cuyo caso se requiere que los hogares además se encuentren dentro del 80% de este indicador.\",
\"content_type\": \"text/html\",
\"webhook_url\": \"https://institucion.com/recibir-update-mensaje\"
}"' \
--form 'attachments=@"/ruta/al/archivo/archivo.png"' \
--form 'attachments=@"/ruta/al/archivo/archivo.pdf"'
curl --location '{url}/notificador/messageStatus/6789a014291e172670ae075e'
curl --location '{url}/notificador/citizenPending/26093912'
curl --location '{url}/notificador/getProcedure'
curl --location '{url}/notificador/getSignature'
curl --location '{url}/notificador/getReceipt/64f65a4d144e0d5ac4bfd25e/26093912'
Envío de un mensaje a dos destinatarios desde Postman, se puede ver la url del servicio, método y respuesta.
Consulta de estado de un mensaje enviado, se debe ingresar como parámetro el message_id del mensaje.
Consulta de mensajes pendientes que tiene un ciudadano.
Para registrar las credenciales necesarias para comunicarse con la API de Notificaciones se requiere ajustar los siguientes parámetros en el archivo config.json del nodo PISEE que le fue entregado.
Dentro del elemento “identificación”.”custom” se deben agregar o ajustar los valores de:
id: Corresponde al client_id que identifica a su Institución
secret: Corresponde al client_secret que identifica a su Institución
Para poder acceder a los servicios provistos por la API de Notificaciones a través del nodo de PISEE 2 es necesario registrar cada uno de los endpoints o servicios que se desean consumir. Esto se hace en el archivo config.json del nodo PISEE que le fue entregado.
Dentro del arreglo “consumidor” se deben listar los servicios que su Institución desea utilizar.