Bienvenido a la documentación de la API de Datamart. Esta API le dará la posibilidad de conectar sus aplicaciones informáticas a diferentes servicios de Datamart para la sincronización de documentos tributarios, cesiones electrónicas, deuda en la tesorería general de la república, carpetas tributarias, entre otros.
La API se encuentra desarrollada tomando en consideración principios y recomendaciones para implementación de APIs REST y documentada siguiendo la especificación OpenAPI.

Para habilitar el modelo de notificación que permite sincronizar la información de un titular de información se requerirá establecer una subscripción de servicio. La subscripción de servicio es la entidad bajo la cual se identifica a las partes involucradas y la información que se comunicará. Esta entidad está conformada por:

• Id de subscriptor: variable bajo la cual se identifica al Titular (que acepta compartir su información)
• Id de cliente: variable que identifica al Destinatario que recibe la información
• Servicio: variable que define la información y las condiciones bajo las cuales se notificará la misma

Peticiones
La interacción con la API se realiza sobre conexiones seguras utilizando el protocolo HTTPS. Las solicitudes sobre HTTP no serán aceptadas y la respuesta indicará que se debe volver a realizar la misma solicitud sobre HTTPS. Las peticiones y respuestas se envían con formato JSON de acuerdo a los parámetros de cada método.

Ejemplo de petición POST

POST /cte/v1/subscriptions/1-9/1-8
Host: https://homo.datamart.cl
x-api-key: c40e7d1e28b94bdeb2dd16a736f09b16
Content-Type: application/json
{
  "atributo": "valor"
}

Ejemplo de petición GET

GET /subscriptions/v1/check-subscription/1-9/1-8/cte
Host: https://homo.datamart.cl
x-api-key: c40e7d1e28b94bdeb2dd16a736f09b16

Respuestas
Las respuestas utilizan códigos de estado HTTP para devolver el resultado de una petición realizada. De forma general, 200 indica que la solicitud fue satisfactoria, 4XX errores controlados y 500 cuando ocurre algún error no controlado. El cuerpo de respuesta JSON puede contener un código de nivel superior y un mensaje con una descripción detallada de la respuesta.
Cada API describe los posibles códigos de estado HTTP, el formato JSON de la respuesta, así como los diferentes códigos de nivel superior que puede responder.

Códigos comunes
La siguiente lista describe códigos de nivel superior comunes que pueden responder todas las APIs.

•   1 - El cuerpo de la solicitud o alguno de sus parámetros están incorrectos
• 13 - Certificado para autenticación requerido
• 15 - El usuario proporcionado no está autorizado para realizar la acción solicitada
• 60 - El cliente no está subscrito al servicio solicitado
• 61 - El cliente ya está subscrito al servicio solicitado
• 65 - Las credenciales proporcionadas no son correctas
• 66 - La autenticación con certificado digital no está habilitada
• 90 - Error no controlado (Internal Server Error)
• 91 - Tiempo de ejecución superado

Las respuestas relacionadas con errores de validación incluirán códigos de nivel superior para facilitar la corrección del problema y un mensaje descriptivo de los problemas detectados.

Ejemplo error de validación (HTTP 400)

{ 
"Codigo":"1"
"Mensaje": "El email de contacto no es válido"
}

Ejemplo error ApiKey incorrecta (HTTP 403)

{
"message": "Forbidden"
}

Errores comunes
Los siguientes códigos de respuesta HTTP son comunes a todas las APIs.

En base a la envergadura y limitaciones de los Clientes, Datamart podrá en ocasiones excepcionales generar desarrollos que puedan afectar el comportamiento de sus API’s, en este sentido, la documentación publicada hará referencia al comportamiento estándar de los servicios. La información relativa al comportamiento específico introducida por estas modificaciones será documentada y compartida con el Cliente en base al procedimiento de Datamart número DTM-PRC-CSTM-03.

Datamart ha mantenido oficialmente paquetes de software (SDKs) para facilitar a los desarrolladores comenzar a realizar solicitudes a las APIs de los diferentes servicios, así como también procesar la información que se notifica vía Webhooks.
En esta sección se proporcionan instrucciones básicas sobre cómo instalar y comenzar a utilizar estos paquetes de software.
Los SDKs mantenidos oficialmente están disponibles solamente para Microsoft .NET Framework v4.5 o superior. Los paquetes son de acceso público y se pueden encontrar en Nuget.org: https://www.nuget.org/profiles/Datamart.

Verificar factibilidad de cesión de un DTE
Instalar paquete DMSDK.SII

PM> Install-Package DMSDK.SII

/*
 using DMSDK.Core;
 using DMSDK.Core.Model;
 using DMSDK.SII;
 using DMSDK.SII.Model;
*/
  
//Identificación del DTE a verificar
VerificarFactCesionReq factibilidadRequest = new VerificarFactCesionReq()
{
  RUTEmisor = "1-9",
  TipoDocumento = TipoDocumento.FacturaElectronica,
  FolioDocumento = "1234"
};

//Parámetros para consultar la API
var apiConfig = new ApiConfig()
{
  IdCliente = "id-cliente",
  ApiKey = "api-key-cliente",
  Ambiente = Ambiente.HOMO
};

var respuesta = ServicioDTE.VerificarFactibilidadCesion(factibilidadRequest, apiConfig);

if (respuesta.Codigo == CodigoRespuesta.OK)
{
  string mensaje = (respuesta.DocumentoCedible == DTECedible.SI || respuesta.DocumentoCedible == DTECedible.OBS) 
      ? "El documento puede ser cedido" 
      : "El documento no puede ser cedido";
  Console.WriteLine($"{mensaje}: {respuesta.Mensaje}");
}
else
{
  Console.WriteLine($"No se pudo consultar si el DTE puede ser cedido: {respuesta.Mensaje}");
}

Obtener notificación recibida vía Webhook

/*
 using DMSDK.Core.Excepciones;
 using DMSDK.Perfiles.CL.Model;
 using DMSDK.SII.Model;
 using System.IO;
 using System.Net;
 using System.Web.Mvc;
*/
  
//Verificar autenticidad del POST recibido
var authToken = Request.Headers.Get("auth-token");
if (authToken != "mi_token_auth")
  return new HttpStatusCodeResult(HttpStatusCode.Unauthorized);
  
EventoDTENotificado dteEvent;
try
{
  using (StreamReader reader = new StreamReader(Request.InputStream))
  {
      var payload = reader.ReadToEnd();
      dteEvent = new EventoDTENotificado(payload);
  }
  //TODO: procesar el evento DTE recibido
}
catch (NotificacionInvalidaException ex)
{
  return new HttpStatusCodeResult(HttpStatusCode.BadRequest, ex.Message);
}

//Retornar OK como indicador de que se recibió la notificación de manera satisfactoria
return new HttpStatusCodeResult(HttpStatusCode.OK);

En Datamart se disponen de dos ambientes de trabajo, un ambiente de homologación sobre el que se pueden probar todas las integraciones a los diferentes servicios, y un ambiente de producción que una vez terminado el desarrollo se puede comenzar a consumir análogo al ambiente de homologación. De esta forma el desarrollo de nuevas funcionalidades o integraciones no afecta el ambiente de producción.

Todos los servicios están disponibles en el ambiente de homologación y con las mismas funcionalidades. Para realizar solicitudes a las diferentes APIs solo se debe modificar el Host y ApiKey según el ambiente en que se desee operar.

Homologación: https://homo.datamart.cl.

Producción: https://api.datamart.cl.

Para identificar y autorizar el acceso a las APIs se utiliza autorización por ApiKey e ID del Cliente, cada API especifica explícitamente el método de autenticación que se debe utilizar para realizar solicitudes. Las ApiKeys de acceso pueden ser recuperadas y configuradas desde el Portal de Clientes. Cada ApiKey es configurada para ser utilizada en el ambiente de homologación o producción, para cada ambiente se obtendrá una ApiKey privada para autorizar todas las solicitudes. Debe asegurarse de proteger y nunca compartir los ApiKeys ya que tienen acceso a todos los datos de su cuenta.

La mayoría de los servicios envían notificaciones a los clientes sobre los datos que procesan. Estas notificaciones pueden ocurrir vía correo electrónico o webhook, a través del Portal de Clientes los clientes pueden seleccionar las configuraciones sobre cómo desea que ello ocurra y los métodos de seguridad que emplean.

Datamart Connect es la solución que permite integrar de manera sencilla la interacción que posibilita que un titular de los datos comparta la información solicitada de manera rápida y segura. La aplicación expone un pequeño workflow donde el usuario final navega por las etapas de Identificación, Consentimiento y Obtención de Datos Distintivos.

Para incorporar el botón de Connect a su sitio web en modalidad Button deberá seguir los pasos siguientes:

Etiqueta para agregar el botón: agregue este texto donde desee que se renderice el botón.

<datamart-button>

Código para insertar en su sitio: agregue este código después de la etiqueta body de su sitio.

<script src="https://homo.connect.datamart.co/js/datamart-button.js"></script>

Código para insertar en tu HTML: agregue este código donde desee mostrar el botón

<datamart-button connectid="0*******c"></datamart-button>

Tener en cuenta que connectid="0*******c" deberá corresponderse con el identificador asignado al botón creado para su uso.

El formato de renderización del botón se encuentra asociado al connectid, siendo estos los formatos disponibles.

Nota
Los scripts de código asociados al botón se generarán automáticamente al finalizar el wizard de configuración.

• connectid: es el identificador de la conexión.
• subscribername: es el nombre del suscriptor.
• subscriberid: es el identificador del suscriptor.
• authorizername: es el nombre de contacto.
• authorizeremail: es el correo de contacto.
• authorizermobile: es el número de móvil de contacto.
• nodocument: es el número de documento.
• validatesubscription: es para validar la suscripción.
• uibuttonstyle: es el estilo del botón.
• uibuttonshape: es la forma del botón.
• uibuttoncolor: es el color del botón.
• uibuttondirection: es la dirección del botón.
• uibuttoncustomlogo: es el logotipo personalizado del botón.
• uibuttontext: es el texto del botón.
• uibuttonshowexplanation: indica si se debe mostrar explicación del botón.
• uibuttonshowtagline: indica si se debe mostrar el eslogan del botón.
• uibuttonbgbox: es el cuadro de fondo del botón.
• uibuttonColorText: es el color y texto del botón.
• uiboxtheme: indica si se le agrega sombra a la caja o se le agrega borde.
• uisamewindow: indica si se debe abrir el widget en la misma ventana.

Atributos generales para configurar el botón

1. El atributo connectid es utilizado para identificar de manera única cada conexión asociada al botón de Connect.

   

2. El atributo subscribername se utiliza para identificar a la empresa o la persona que se va a suscribir a la conexión.

   
   

3. El atributo subscriberid es utilizado para identificar al suscriptor (RUT en Chile/RUC en Perú).

   
   

4. El atributo authorizername se refiere al nombre del contacto que va a suscribirse a los servicios para los que fue configurada la conexión.

   
   

5. El atributo authorizeremail es el correo asociado a la persona de contacto.

   
   

6. El atributo authorizermobile es el número de teléfono asociado a la persona de contacto.

   
   

7. El atributo nodocument es el identificador personal de un susbcriptor, digase número de DNI o de cédula.

   
   

8. El atributo validatesubscription se utiliza para verificar el estado del suscriptor. Puede tomar los valores "true" o "false", en caso de que el valor sea "true", verificará el estado de la suscripción y las posibles respuestas son: "suscrito", "no suscrito", "actualizar credenciales" o "aceptar términos".

   
   

Los datos relativos al authorizername, authorizeremail y authorizermobile, son requeridos para identificar a la persona que acepta los términos y condiciones.

Atributos opcionales para personalizar el estilo del botón

El botón tomará por defecto el diseño que le haya sido definido al momento de su configuración; sin embargo, admitirá que le sean pasados los siguientes parámetros que cambiarán su forma de renderización.

1. uibuttonstyle: admite dos estilos: "custom" y "classic". El estilo "custom" permite personalizar completamente el diseño del botón según las preferencias, mientras que el estilo "classic" permite elegir un diseño predefinido y no permite personalizaciones adicionales. El botón se mostrará con un estilo clásico y no se aplicarán otros atributos opcionales. Es posible elegir el estilo que mejor se adapte a sus necesidades y preferencias de diseño.
   
   
   
   
2. uibuttonshape: el atributo uibuttonshape permite definir el contorno del botón. El atributo uibuttonshape admite tres opciones: “rectangle” (rectángulo), “semi-round” (semirredondo) y “round” (redondo). Es posible utilizar el atributo uibuttonshape para personalizar la forma del botón según sus preferencias.
   
   
   
   
   
   
3. uibuttoncolor: el atributo uibuttoncolor permite definir el color del botón utilizando diferentes formatos, como valores hexadecimales, referencias a colores CSS (por ejemplo, "red", "rgb", etc.). Es posible utilizar este atributo para personalizar el color del botón según sus preferencias.
   
   
   
   
4. uibuttondirection: admite dos opciones: "left" (izquierda) y "right" (derecha). Este atributo solo se aplica cuando el valor del atributo uibuttonstyle es "custom". Es posible utilizar el atributo uibuttondirection para definir la dirección en la que se muestra el color base del botón. Por ejemplo, si establece uibuttondirection como "left", el color base se mostrará en el lado izquierdo del botón. Si establece uibuttondirection como "right", el color base se mostrará en el lado derecho del botón.
   
   
   
   
5. uibuttoncustomlogo: este atributo permite personalizar el logotipo del botón. Es posible agregar cualquier dato aceptado por la etiqueta , como una dirección URL o un archivo svg. Puede utilizar este atributo para agregar su propio logotipo al botón y personalizar aún más su apariencia. Simplemente proporciona la dirección o el archivo svg que desea utilizar como logotipo.
   
   
   
   
6. uibuttontext: este atributo se utiliza para definir el texto que aparecerá en el botón. Sin embargo, es importante tener en cuenta que si el texto es demasiado extenso, puede afectar la estética.
   
   
   
   
7. uibuttonshowexplanation: este atributo se utiliza para definir si se muestra o no el texto de ayuda en el botón. Si establece este atributo como "true", se mostrará el texto de ayuda; si lo establece como "false", se ocultará. Esto puede ser útil para proporcionar información adicional al usuario sobre el funcionamiento del botón o para mantener un diseño más limpio y minimalista.
   
   
   
   
8. uibuttonshowtagline: este atributo se utiliza para definir si se muestra el eslogan o no. Si establece este atributo como "true", se mostrará el eslogan; si lo establece como "false", se ocultará. Esto puede ser útil para proporcionar información adicional o una llamada a la acción junto con el botón.
   
   
   
   
9. uibuttonbgbox: este atributo se utiliza para definir el color de fondo de la caja que contiene el botón. Admite cualquier formato CSS válido para especificar colores, como valores hexadecimales, nombres de colores CSS (por ejemplo, "red", "blue", etc.) o valores rgb.
   
   
   
   
10. uibuttonColorText: este atributo se utiliza para definir el color del texto del botón. Admite cualquier formato CSS válido para especificar colores, como valores hexadecimales, nombres de colores CSS (por ejemplo, "red", "blue", etc.) o valores rgb.
    
    
    
    
11. uiboxtheme: este atributo admite las propiedades uiboxshadow y uiboxborde. La propiedad uiboxshadow, se utiliza para mostrar una sombra alrededor de la caja del botón. La propiedad uiboxborde se utiliza para mostrar un borde definido alrededor de la caja.
    
    
    
    
12. uisamewindow: este atributo se utiliza para controlar la carga del widget en la misma ventana o en una nueva. Por defecto, está establecido como false, lo que significa que el widget se abrirá en una ventana auxiliar. Si desea que el widget se abra en la misma ventana, puede establecer uisamewindow como true.
    
    
    
    

Al abrir, la app de suscripción se desplegará en una nueva pestaña manteniendo la comunicación con el sitio que lo invocó a través de un socket; mediante el cual ambas aplicaciones podrán comprender la condición en la que se encuentran.

onstatuschange: este evento se ejecuta cuando ocurre alguna acción dentro del widget. Cuando este evento se dispara, se envía un mensaje con el nombre del evento que ha ocurrido.

Aquí tienes una lista de los posibles eventos que pueden ocurrir dentro del widget:

• start_process: este evento ocurre cuando el usuario ha llenado el formulario de contacto. Puede utilizarse para realizar alguna acción específica cuando el usuario ha iniciado el proceso de suscripción.
• Initialized: este evento ocurre cuando comienza el proceso de suscripción. Puede utilizarse para realizar alguna acción específica al inicio del proceso de suscripción.

Cuando se dispara alguno de estos eventos, se envía un mensaje con la siguiente estructura: { eventName: 'NOMBRE_DEL_EVENTO' }. El valor de 'NOMBRE_DEL_EVENTO' será el nombre del evento que ha ocurrido.

Puedes utilizar estos eventos y sus respectivos mensajes para realizar acciones específicas dentro de tu aplicación en respuesta a las interacciones del usuario con el widget de suscripción.

const element = document.createElement("datamart-button");

element.addEventListener('onstatuschange', (e) => {
  console.log('--------->onstatuschange', e);
});

oninitialized: este evento ocurre cuando comienza el proceso de suscripción. Puede utilizarse para realizar alguna acción específica al inicio del proceso de suscripción.

Puedes utilizar este evento para realizar acciones específicas al inicio del proceso de suscripción, como mostrar un mensaje de bienvenida, realizar alguna validación adicional o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento tiene la siguiente estructura: { eventName: 'initialized' }.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('oninitialized', (e) => {
  console.log('--------->oninitialized', e);
});

onuserclose: este evento ocurre cuando el usuario cierra el widget sin haber completado completamente el flujo de suscripción. Puede utilizarse para realizar alguna acción específica cuando esto sucede.

Puedes utilizar este evento para realizar acciones específicas cuando el usuario cierra el widget sin completar la suscripción, como mostrar un mensaje de despedida, guardar el progreso realizado hasta el momento o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onuserclose', (e) => {
  console.log('--------->onuserclose', e);
});

onsuccess: este evento se ejecuta cuando el botón verifica la suscripción del subscriberid y como resultado determina que el usuario está suscrito. Este evento puede ocurrir al principio cuando el usuario ya estaba previamente suscrito, o cuando se cierra el widget y el usuario se suscribe correctamente.

Puedes utilizar este evento para realizar acciones específicas cuando se verifica la suscripción del usuario, como mostrar un mensaje de confirmación, redirigir a una página de agradecimiento o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onsuccess', (e) => {
  console.log('--------->onsuccess', e);
});

oninactivity: este evento se ejecuta cuando el usuario se mantiene inactivo por al menos 5 minutos, con la app de suscripción abierta en el navegador.

Puedes utilizar este evento para realizar acciones específicas cuando el usuario se mantiene inactivo por un período de tiempo determinado, como mostrar un mensaje de advertencia, cerrar la app de suscripción o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('oninactivity', (e) => {
  console.log('--------->oninactivity', e);
});

onunauthorized: este evento se ejecuta cuando se integra la conexión desde un dominio no autorizado.

Puedes utilizar este evento para realizar acciones específicas cuando la conexión se integra desde un dominio no autorizado, como mostrar un mensaje de error, redirigir a una página de error o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onunauthorized', (e) => {
  console.log('--------->onunauthorized', e);
});

onbadconfiguration: este evento se ejecuta cuando existe algún error en la configuración de la conexión.

Puedes utilizar este evento para realizar acciones específicas cuando se produce un error en la configuración de la conexión, como mostrar un mensaje de error, realizar alguna acción de recuperación o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onbadconfiguration', (e) => {
  console.log('--------->onbadconfiguration', e);
});

onconectionnotready: este evento se ejecuta cuando la conexión se encuentra en proceso de creación, y aún no se encuentra lista para ser utilizada.

Puedes utilizar este evento para realizar acciones específicas cuando la conexión aún no está lista para ser utilizada, como mostrar un mensaje de espera, deshabilitar ciertas funcionalidades o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onconnectionnotready', (e) => {
  console.log('--------->onconnectionnotready', e);
});

oninvalidsuscriberid: este evento se ejecuta cuando el RUT del suscriptor no es válido.

Puedes utilizar este evento para realizar acciones específicas cuando el RUT del suscriptor no es válido, como mostrar un mensaje de error, solicitar al usuario que ingrese un RUT válido o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('oninvalidsubscriberid', (e) => {
  console.log('--------->oninvalidsubscriberid', e);
});

oninvalidtoken: este evento se ejecuta cuando se envía un token inválido.

Puedes utilizar este evento para realizar acciones específicas cuando se envía un token inválido, como mostrar un mensaje de error, solicitar al usuario que ingrese un token válido o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('oninvalidtoken', (e) => {
  console.log('--------->oninvalidtoken', e);
});

onunknownerror: este evento se ejecuta cuando se desencadena un error desconocido.

Puedes utilizar este evento para realizar acciones específicas cuando se produce un error desconocido, como mostrar un mensaje de error genérico, registrar el error para su posterior análisis o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onunknownerror', (e) => {
  console.log('--------->onunknownerror', e);
});

onvalidationerror: este evento se ejecuta cuando se desencadena un error de validación.

Puedes utilizar este evento para realizar acciones específicas cuando se produce un error de validación, como mostrar un mensaje de error al usuario, resaltar los campos inválidos o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onvalidationerror', (e) => {
  console.log('--------->onvalidationerror', e);
});

onapikeyrequired: esto evento se ejecuta cuando se requiere una clave de API.

Puedes utilizar este evento para realizar acciones específicas cuando se requiere una clave de API, como mostrar un mensaje al usuario solicitando la clave, redirigir a una página de configuración de la clave de API o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onapikeyrequired', (e) => {
  console.log('--------->onapikeyrequired', e);
});

onexceededquota: este evento se ejecuta cuando se excede la cantidad de suscripciones permitidas.

Puedes utilizar este evento para realizar acciones específicas cuando se excede la cantidad de suscripciones permitidas, como mostrar un mensaje de error al usuario, limitar la funcionalidad del botón o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento es un valor booleano.

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onexceededquota', (e) => {
  console.log('--------->onexceededquota', e);
});

onsuscriberstatuschange: este evento se ejecuta cuando cambia el estado del botón de acuerdo al estado del suscriptor.

Puedes utilizar este evento para realizar acciones específicas cuando cambia el estado del botón de acuerdo al estado del suscriptor, como actualizar la interfaz de usuario para reflejar el nuevo estado, mostrar mensajes informativos al usuario o cualquier otra acción que desees realizar en ese momento.

El mensaje enviado con este evento puede tener diferentes valores, como "Verificando", "NoSuscrito", "ActualizarCredenciales", "ActualizarTerminos" o "Suscrito".

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onsubscriberstatuschange', (e) => {
  console.log('--------->onsubscriberstatuschange', e);
});

onsessionoperations: este evento se ejecuta para mostrar las operaciones que se van realizando durante una sesión.

Puedes utilizar este evento para mostrar las operaciones que se van realizando durante una sesión, como obtener el ID del suscriptor, compartir información de contacto, seleccionar documentos para suscribirse, actualizar términos, completar la sesión, entre otras operaciones.

El mensaje enviado con este evento puede tener diferentes valores, como "started_session", "get_subscriber_id", "shared_contact_info", "selected_documents_to_subscribe", "updated_terms" o "completed_session".

Aquí tienes un ejemplo de cómo puedes escuchar este evento y realizar una acción específica cuando se dispare:

element.addEventListener('onsessionoperations', (e) => {
  console.log('--------->onsessionoperations', e);
});

Botón

Con el fin de mejorar la experiencia de uso, en caso de que el botón reciba como parámetro el subscriberid, la aplicación validará el estado de la suscripción de los servicios que se encuentran configurados para ese connectid. El proceso de validación sólo se ejecutará en caso de que el botón tenga activada la propiedad de validatesubscription y al invocarlo se envíe un subscriberid válido.

El resultado de este proceso condicionará el despliegue del mensaje del botón de Datamart Connect.

Caso	Estado suscripción	Estado credencial	Aceptación de Términos de uso	Despliegue
1	Suscrito a todos los servicios	Válida	Aceptados
2	Actualizar credenciales	Inválida	Aceptados
3	Suscrito a todos los servicios	Válida	No aceptados
4	No suscrito a alguno de los servicios	-	-

Widget

Caso	Estado suscripción	Estado credencial	Aceptación de Términos de uso	Despliegue
1	Suscrito a todos los servicios	Válida	Aceptados
2	Fallo al obtener el Estado del Suscriptor	-	-
3	Timeout a la espera del Estado del Subscriptor	-	-

En el caso de los clientes que hayan realizado procesos de suscripción a los diferentes servicios configurados en el botón, desde otras vías previas a la implementación de Connect; deberán tener en cuenta que el botón mostrará el estado: acepte los nuevos términos y condiciones. Para estos casos, si el cliente así lo considerase, podría solicitar la generación de una versión de migración de los Términos de uso. Esta versión hará referencia a la aprobación previa de los Términos por parte del cliente a través de otras plataformas; sin necesidad de solicitarles nuevamente su aprobación.

En el caso de que se desee emplear la misma configuración de servicios y finalidades a suscribir, se recomienda que se ocupe un único botón. Cada botón constituye una aplicación, por lo que tiene definidos sus propios Términos de uso. Si se emplean varios botones, los clientes que hayan sido suscritos por un botón, deberán aceptar nuevamente los términos de uso al usar un nuevo botón.

Servicio que permite generar la proyección de Renta de una persona basado en los ingresos mensuales plasmados en su documento AFC, DJ1887, Honorarios Brutos y los anuales de su Información Tributaria.

Configuraciones
El servicio presenta una configuración por defecto para calcular la proyección de Renta del cliente. Se puede modificar la configuración para que se ajuste a los parámetros del cliente.

Notificaciones
Este servicio notifica de forma automática, vía Webhook y/o por correo electrónico, de acuerdo a la configuración realizada; al momento de la finalización de la obtención de la Renta.
El siguiente modelo representa los datos enviados en la notificación.

Servicio que permite sincronizar las declaraciones juradas (DJ) propias: 1835, 1847, 1879, 1887, 1923, 1926 y las de terceros: 0011, 0040, 0041, 0304, 1812, 1824, 1829, 1835, 1862, 1870, 1879, 1887, 1889, 1890, 1891, 1894, 1895, 1898, 1899, 1914, 1922, 1948, 1955, 2890 desde el Servicio de Impuestos Internos. Para un contribuyente subscrito al servicio, periódicamente y de forma automática se notifica vía Webhook o por correo electrónico las declaraciones juradas.
Para descargar un ejemplo de cada una de ellas puede pinchar este enlace.

Configuraciones
Es posible personalizar el comportamiento de este servicio a través de parámetros de configuración. Puede indicar si las credenciales de la subscripción, requeridas para obtener las declaraciones juradas, serán enviadas cifradas o en texto plano, en ambos casos el envío siempre se realiza sobre protocolo seguro HTTPS. Para modificar estos parámetros debe acceder al Portal de Clientes, donde va a encontrar otros parámetros disponibles como aquellos relacionados con la habilitación de las notificaciones por correo y webhooks.

Notificaciones
Este servicio notifica de forma automática, vía Webhook o por correo electrónico, las declaraciones juradas del subscriptor, actualizadas desde el Servicio de Impuestos Internos.
El siguiente modelo representa los datos enviados en la notificación.

Servicio que permite la suscripción a los servicios de datamart: Carpeta Tributaria Electrónica(CTE), Certificado Deuda Fiscal, Cartola Fiscal y Convenios(TGRSync), Documentos Tributarios Electrónicos y/o Registro de Compra-Venta(DTESync), Registro Público Electrónico de Transferencia de Crédito(AECSync), Declaraciones Juradas de Renta(DJSync), Servicio de cesion de DTE(CessionDte), Consulta Contribuyente SII(TaxPayer), Informe de deudas de la Comisión para el Mercado Financiero(CMFDebtSync), Seguro de Cesantías de la Administradora de Fondos de Cesantía(AFC), Registro Civil - Certificado nacimiento(BirthCertificate), Registro Civil - Certificado matrimonio(MarriageCertificate), Verificación de renta de persona natural CTE / DJS / AFC(IncomeCL), Relación de eRUTs registrados por Empresa (eRut); así como generar los consentimientos de Políticas de Privacidad y de Términos y Condiciones.