Emisario

Menú Principal de Emisario

Emisario-logo.png Menú principal

Configuración:

Mantenimientos:

Otros

Servicios

Configuración

Configuración

EOS-Emisario-Configuracion-Opciones-(Emisario)

Menú => Emisario => Sistema => Configuración => Opciones 

Screenshot_899.png

Se abren 3 pestañas, presiona donde dice SMTP preciosa el botón de "Agregar".

Screenshot_900.png

Hay 4 tipos: Global, Interna, Requisitos técnicos, cumpleaños. 

Screenshot_901.png

Wikis relacionados:

Configuración

EOS-Emisario-Sistema-Alertas

Notas importantes del proceso: 

Para acceder a dicha pantalla, debemos ingresar a Emisario = > Configuración = > Alertas: 

Screenshot_1.png

 

Una vez acá desplegamos el combo de las opciones que tenemos para configurar y elegir el código que necesitamos: 

Screenshot_2.png

Por último, solamente marcamos el o los usuarios que deseamos que les llegue el aviso de dicha alerta y aceptar para validar los cambios: 

Screenshot_3.png

Mantenimientos

Mantenimientos

EOS-Emisario-Mantenimientos-Mensajes

El proceso envía cualquiera de los siguientes documentos :

Derechos:

A continuación explicaremos, algunos de los mensajes que se pueden configurar automáticamente en el sistema. Esto a modo de ejemplo, pero en realidad el sistema maneja varios mensajes cómo los mencionados arriba y muchos más. 

Notas importantes:

Para configurar las plantillas se debe ingresar al sistema WEB, en el módulo de Seguridad=>Plantillas: 

Screenshot_902.png

En esta configuramos las que requerimos, solamente debemos presionar agregar y ahí llenar la información que deseamos para nuestra plantilla podemos usar los comodines que nos muestra el sistema también. 

Screenshot_904.png


Una vez cargados los datos, presionamos aceptar para guardar los cambios y ahora si poder ir a configurar el mensaje que deseamos ya con la plantilla creada. 

COMPROBANTES DE PAGO: 

Lo primero que debemos realizar es ingresar al sitio WEB, una vez dentro nos dirigimos al menú de Emisario, ahí ingresamos al menú de Emisario seleccionaremos la opción de Mensajes, como muestra la siguiente imagen:

Screenshot_905.png

Ya dentro de la pantalla de mensajes presionaremos el botón de agregar, enseguida nos mostrará la siguiente pantalla:

 Screenshot_906.png

En donde deberemos de seleccionar en el asunto "Recibos nulos de días anteriores", ( por ejemplo )  además de eso podemos elegir el día para que se envíen los reportes o bien un día fijo del mes en el cual se envíen dichos avisos. Una vez ingresados todos los valores, presionaremos el botón de aceptar y con esto ya quedaría configurado nuestro proceso para el envío automático.

MENSAJE DE CUMPLEAÑOS: 

Proceso:

El contenido del mensaje es personalizable con una plantilla.

Este mensaje, se encarga de enviar un correo electrónico a los clientes de Cronus que tienen el campo Email Mercadeo configurado y fecha de nacimiento definida desde el mantenimiento de clientes en CRONUS.

 

Únicamente en esta pantalla elegimos el de cumpleaños, presionamos modificar o agregar ( si es nuevo ) y debemos configurar el horario en que deseamos se envíe el correo y que plantilla usar. 

Screenshot_907.png


GARANTÍAS Y REQUISITOS TÉCNICOS: 

Proceso:

  1. Este mensaje, se encarga de enviar un correo electrónico a los clientes de CRONUS que tienen el campo Email notificar configurado. ( Esto se debe alimentar desde el mantenimiento de clientes en CRONUS ) 
  2. El sistema enviará un email por cada factura que se emita el cliente y que contenga al menos un producto que esté marcado como "Con Garantía". 
  3. Sólo se enviará el mensaje 1 vez por cada factura.   
  4. El contenido del mensaje es personalizable con una plantilla lo cual permite adjuntar documentos o links referentes a temas de garantías, requisitos técnicos de instalación, etc. 

Lo primero será marcar los productos que apliquen para garantía desde el mantenimiento de productos en CRONUS: 

 

 



Mantenimientos

EOS-Emisario-Mantenimientos-Casos-Tipos

Para ingresar a dicha pantalla, ingresamos a Emisario = > Mantenimientos = > Casos = > Tipos : 

Screenshot_913.png

Una vez acá presionamos agregar,completamos la información de los campos requeridos y aceptar para validar los cambios: 

Screenshot_914.png

 Con esto listo, podremos visualizar en la pantalla principal los tipos creados: 

Screenshot_915.png

 

Mantenimientos

EOS-Emisario-Mantenimientos-Casos-Email para los casos

Ingresamos a menú => Emisario => Mantenimiento => Casos => Email para los casos 

 

Al ingresa aparece esta pantalla 

 

Mantenimientos

EOS-Emisario Mantenimientos Casos Lista

Emisario => Mantenimientos => Casos => Lista

 

 

 

Ingresamos a esta pantalla 

 

Otros

Otros

EOS-Emisario-Otros-Bitacora-Envios

Menú => Emisario => Otros => Bitácora  envíos 

 

Ingresamos 

 

Otros

Solicitud Cambio de Contenido

Menú => Emisario => Otros => Solicitudes de cambio de contenido 

 

Seguridad: No requiere de ningún derecho especial.

Puntos importantes a tomar en cuenta en el proceso: 

Proceso:

En este proceso podremos configurar las Solicitudes Cambio de Contenido que requerimos, en este caso tenemos 3 tipos de solicitudes:

Por el momento solamente tendremos disponible la opción de Proveedores:

Para realizar la configuración presionamos el botón de "agregar" en la pantalla de Solicitud cambio de contenido:

Una vez dentro de la pantalla de configuración tendremos las siguientes pestañas:

 

 

 

 

Una vez ingresado los datos, bastará con presionar el botón de "Procesar" y con esto nuestra solicitud será creada. 

Nota: el botón de "Procesar" solamente es visible cuando ingresemos algún proveedor o correo, en caso de no ingresar algún dato, el botón no será visible.

 

 

 

 

Otros

Revisión solicitud cambio de contenido

Seguridad: No requiere de ningún derecho especial.

Puntos importantes a tomar en cuenta en el proceso: 

Para ingresar a la pantalla, nos dirigimos a Emisario => Otros => Solicitud Cambio de Contenido: 

solicitud.png

 

Proceso:

En este proceso se puede verificar las solicitudes enviadas así como la aplicación o anulación de las mismas:

Servicios

Servicios

EOS-Emisario-Servicios-Woocommerce

Derecho: 

¿Cómo funciona WooCommerce en Web?
Cuando agregamos la información necesaria un servicio sincronizará Cliente, Proforma (Creará proforma), y pedidos de manera automática. Podrá enviar avisos cuando se ingresa una proforma, dependiendo si así lo deseamos.

Para acceder a dicho proceso, seguimos los siguientes pasos: 

Menú => Emisario => Servicios => WooCommerce: 

Screenshot_909.png

En la pantalla principal podemos ver la información general de nuestro servidor WooCommerce, el cuál podemos editar e inactivar si así lo deseamos.

Screenshot_910.png


Agregar un servidor WooCommerce

Los campos en negrita son obligatorios y no pueden ir en blanco, para una posible conexión al servidor de WooCommerce. 

  1. Login 
  2. Password
  3. Servidor
  4. BD
  5. Sucursal

Screenshot_911.png


Funcionamiento de la pantalla

Cliente: Al momento que el WooCommerce crea un proforma por un pedido, el servicio reconocerá a cuál cliente deberá ingresar la proforma.

Checks:

Precio: Hace que el servicio sincronice el precio elegido.

Precio promo: Hace que el servicio sincronice el precio promo elegido.

Usuario: Dependiendo de los derechos del usuario, el sistema reconocerá a cuales bodegas tiene permitido el usuario y por ende hace posible mostrar el saldo correcto.

Sucursal: Hace posible que el servicio identifique a donde ingresar la proforma.

Campos custom: Se utiliza para la creación de clientes automáticamente en Cronus, se debe configurar el nombre de la tabla y los campos en los cuales se almacenara el tipo de cedula, la cédula, el email, el teléfono, dirección 1 y dirección 2 del cliente relacionado al pedido.

Bitácora WooCommerce

Podremos ver lo que el servicio estará haciendo de fondo, cuando sincroniza, avisos, errores, nuevos clientes, nuevos pedidos(proformas), productos sincronizados. 

Podemos filtrar en base a lo que deseemos ver.

En opciones -- Bitácora:

Screenshot_912.png

El servicio la primera vez que sincronice un servidor nuevo, va a sincronizar todos los productos que tengan SKU en WooCommerce, cuando termine la primera sincronización, este procederá a cargar los productos modificados tanto de WooCommerce(con SKU) cómo los productos recientemente modificados en nuestro sistema.

Casos a tomar en cuenta:

¿Por qué no sincroniza el precio de un producto en el WooCommerce?

Manejo de los Clientes WooCommerce

El servicio tiene varias opciones, la primera seria utilizar un solo cliente, a elección del usuario (se configura en la pantalla del servidor).
La segunda forma de trabajar es cuando el cliente ya esta registrado en Cronus, el servicio, buscara en el mantenimiento por medio de cedula o email, y utilizara ese cliente para las proformas y pedidos.
La ultima alternativa es que el servicio creara el cliente en Cronus, basada en la información digitada por el usuario al momento de procesar la compra en el WooCommerce, esto requiere de algunos campos especiales/custom en el WooCommerce.

¿Cómo sincroniza los productos el WooCommerce?

La primera vez que se sincroniza, este hace un barrido entero, porque el necesita poner todos los productos en orden con el sistema, una vez hecho esto, cada vez que sincronice el va a buscar los productos actualizados después de la última sincronización; en el WooCommerce y los productos actualizados en el sistema, esto quiere decir que hasta que un producto no sufra un cambio en el inventario o un cambio en el producto mismo no va a realizar la sincronización de dicho producto ya que no se le realizaron cambios necesarios de sincronizar.

Configuración para el IMAP con dominio de Office 365

Wiki – Configuración IMAP Office 365 con OAuth2

Objetivo

Este documento explica paso a paso cómo configurar una cuenta de correo Office 365 utilizando autenticación OAuth2 ( https://www.limilabs.com/blog/oauth2-client-credential-flow-office365-exchange-imap-pop3-smtp para conexiones IMAP dentro del sistema.

Requisitos Previos

Antes de iniciar, se debe contar con:

Información Necesaria

Durante la configuración se solicitarán los siguientes datos:

Dato

Descripción

Email

Cuenta de correo a configurar

Client ID

Identificador de la aplicación

Tenant ID

Identificador del directorio

Client Secret

Clave secreta generada en Azure

Servidor IMAP

Servidor de correo entrante

Puerto IMAP

Puerto de conexión IMAP

Antes de iniciar:

    1. Validar que el usuario tenga permisos suficientes.
    2. Confirmar acceso al portal de Azure.
    3. Verificar permisos dentro del sistema para modificar configuraciones.

Paso 1 : Ingresar al Portal Azure 

Ingresar al portal de Microsoft Azure y acceder con una cuenta con permisos administrativos.

Ingresar al portal de Microsoft Azure y acceder con una cuenta con permisos administrativos.


image.png

Paso 2 : Registro de Aplicaciones

Ingresar a Microsoft Entra ID → Registro de aplicaciones y crear una nueva aplicación.

image.png

Paso 3 : Obtener Client ID y Tenant ID

Desde la sección Información general copiar el Application ID y Directory ID.

Ruta

  1. Ingresar a:

Completar:

Campo

Valor

Nombre

Nombre descriptivo de la integración

Tipo de cuenta

Solo esta organización

Presionar:

image.png

Paso 4 : Crear Client Secret

Ingresar a Certificados y secretos, para de esta forma generar un nuevo secreto de cliente.

Después de registrar la aplicación:

  1. Ingresar a:

Importante

Este valor corresponde al:

Client ID

image.png

Paso 5 : Obtener el Tenant ID

En la misma pantalla:

  1. Copiar:

Importante

Este valor corresponde al:

Recomendación

Verificar cuidadosamente que pertenezca a la compañía correcta.

Un Tenant ID incorrecto provocará errores de autenticación.

1.   

Paso 6: Validación de Configuración mediante PowerShell

2.    Objetivo

3.    Esta validación permite confirmar que la aplicación registrada en Microsoft 365 tiene los permisos y configuraciones correctas para utilizar IMAP con OAuth2.

5.    Paso 1:Ejecutar Comandos en PowerShell

6.    Abrir PowerShell con permisos administrativos y ejecutar los siguientes comandos:

Get-ServicePrincipal

Get-MailboxPermission -Identity "correo@dominio.com"

Ejemplo 

Get-MailboxPermission -Identity "AdeleV@your-domain.onmicrosoft.com"

Asignación de Permisos al Mailbox mediante PowerShell

Objetivo

Este proceso permite otorgar permisos de acceso completo al buzón de correo para la aplicación o servicio configurado.

Comando PowerShell

Ejecutar el siguiente comando desde PowerShell:

Add-MailboxPermission `
 -Identity "usuario@dominio.com" `
 -User OBJECT_ID `
 -AccessRights FullAccess

Add-MailboxPermission `
 -Identity "usuario@dominio.com" `
 -User OBJECT_ID `
 -AccessRights FullAccess

Screenshot_1225.png

¿Qué se debe validar?

ServiceId

Validar que el:

sea exactamente igual al:

ubicado en:

⚠️ Importante:
No utilizar el Object ID del:

Debe utilizarse el valor mostrado en:

AppId

Validar que el:

sea igual al:

mostrado en:

Validaciones Importantes

Validación del ServiceId

Verificar que el:

sea exactamente igual al:

mostrado en:

⚠️ Importante:
No utilizar el valor del:

Debe utilizarse el Object ID mostrado específicamente en:

Validación del AppId

Confirmar que el:

sea igual al:

mostrado en:

Validación de Conexión IMAP

Se recomienda validar la conexión utilizando flujo interactivo OAuth2.

Herramienta de referencia:

Herramienta IMAP OAuth2 Office365 - Limilabs

Esta validación confirma:

Validación de Permisos API

Confirmar que:

⚠️ Aunque los permisos estén agregados, sin el consentimiento administrativo la autenticación puede fallar.

Errores Comunes

Client ID / Tenant ID / Secret Incorrectos

Uno de los errores más frecuentes ocurre por:

Recomendación

Validar cuidadosamente:

Tiempo de Aplicación de Cambios

⚠️ Importante:

Los cambios realizados en Azure / Entra ID pueden tardar entre:

en aplicarse completamente.

Durante este tiempo pueden aparecer:

Esto es un comportamiento normal de sincronización de Microsoft 365.

 

Nota importante sobre errores comunes: 

• Tenant ID incorrecto.

• Client Secret expirado.

• Permisos API incompletos.

• Configuración realizada desde Aplicaciones Empresariales en lugar de Registro de aplicaciones.

• Correos que no procesan por falta de permisos.

Configuración

Valor

Servidor IMAP

outlook.office365.com

Puerto IMAP

993

Seguridad

SSL/TLS

Recomendaciones:

Guardar capturas de pantalla de la configuración y documentar los valores de Client ID, Tenant ID y Client Secret en un lugar seguro.