Clientes, Contactos, Sitios y Servicios

Tenemos un modelo simple de un Cliente bajo el cual puede haber múltiples Contactos y múltiples Sitios, Servicios, etc.

Un Cliente es una empresa o individuo que tiene una relación con nosotros, a quien enviamos una factura.

Un Contacto es una persona que trabaja con el cliente; para un individuo, probablemente sea lo mismo que el cliente, una sola persona, pero podemos tener miembros de la familia u otros contactos, y cada contacto tiene un tipo, por ejemplo, un contacto de facturación, un contacto técnico, etc., lo que influye en cómo manejamos el contacto.

Un Sitio es una ubicación física donde entregamos servicios; podría ser un hogar, oficina u otra ubicación. Esto nos permite tener múltiples sitios para un solo cliente, por ejemplo, un cliente con múltiples oficinas, y saber qué servicios están asociados con qué sitio.

Un Servicio es algo por lo que facturamos a un cliente; podría ser un servicio de internet en casa, servicio móvil, o incluso servicios abstractos como arrendar una subred o proporcionar electricidad medida a un rack. Cada servicio está vinculado a un cliente y un sitio, y puede tener múltiples cargos asociados.

Los clientes también tienen un Registro de Actividad, que es un registro de todos los cambios realizados, Etiquetas, Atributos para almacenar metadatos personalizados, Artículos de Inventario e información financiera como Transacciones, Facturas y Métodos de Pago.

Una vez que hemos creado un cliente, podemos agregar un servicio a ese cliente, que es la cosa por la que les facturamos.

Para obtener información sobre cómo crear un cliente, consulte Crear un Cliente.

Lista de Clientes

La lista de clientes proporciona una tabla buscable y filtrable de todos los clientes en el sistema.

{.align-center width="800px"}

Características:

• Buscar - Filtrar clientes por nombre o ID
• Acciones Masivas - Seleccionar múltiples clientes para operaciones por lotes
• Paginación - Navegar a través de grandes listas de clientes
• Acciones Rápidas - Ver o eliminar clientes directamente desde la lista

Cliente - Detalle

El objeto cliente en sí no contiene mucha información, solo es un nombre y una referencia a los contactos y sitios.

Su implementación específica puede incluir campos adicionales o personalizaciones, pero el objeto cliente básico es muy simple.

En la página de resumen también hay un gráfico que muestra el Ingreso Promedio por Usuario (ARPU) para el cliente, que es el ingreso total dividido por el número de servicios, y una comparación de cómo este cliente se compara con el ARPU promedio para todos los clientes en el sistema.

Las opciones de Estado del Cliente están adaptadas según las necesidades específicas de su negocio, pero típicamente incluyen opciones como Activo, Inactivo, Pendiente, etc., con diferentes reglas en cada una que controlan el comportamiento del cliente en el sistema en ese estado.

Eliminar un cliente solo se puede hacer si el cliente no tiene servicios activos, facturas impagas o transacciones no facturadas. Si el cliente tiene alguno de estos, deberá cerrar los servicios activos y asegurarse de que se realicen los pagos antes de poder eliminar al cliente, lo que a su vez archivará al cliente y todos los datos asociados, que pueden ser restaurados más tarde si es necesario.

Sitio - Detalle

Los sitios son ubicaciones físicas donde se entregan servicios y pueden tener múltiples servicios asociados con ellos.

Se utilizan predominantemente para clientes empresariales, donde un solo cliente podría tener múltiples sitios, por ejemplo, un cliente con múltiples oficinas.

Tener múltiples sitios nos permite rastrear qué servicios están asociados con qué sitio; por ejemplo, si un cliente solicita un nuevo servicio para una nueva oficina, necesitamos asegurarnos de que entregamos el servicio correcto a la ubicación correcta. Esto nos permite rastrear servicios por sitio y facturarlos por separado si es necesario.

Integración de Google Maps y Geocodificación

Cada sitio está integrado con Google Maps para garantizar datos de dirección precisos y geolocalización. La interfaz de usuario geocodifica automáticamente las direcciones y genera datos de ubicación.

Cómo Funciona la Geocodificación de Direcciones:

Al agregar o editar un sitio, la interfaz proporciona dos métodos para establecer la ubicación:

1. Búsqueda de Dirección (Recomendado)
   • Use la barra de búsqueda en la parte superior del formulario
   • Escriba una dirección y Google Maps Autocomplete sugiere coincidencias
   • Seleccione la dirección correcta del menú desplegable
   • El sistema completa automáticamente:
     • Nombre del Sitio - Nombre del lugar de Google Maps
     • Línea de Dirección 1 - Número y nombre de la calle
     • Línea de Dirección 2 - Subpremisa (número de unidad/suite)
     • Ciudad - Localidad
     • Estado/Región - Área administrativa
     • Código Postal - Código postal
     • País - Nombre del país
     • Latitud y Longitud - Coordenadas precisas
     • Código Plus - Código de Ubicación Abierta de 11 caracteres (p. ej., 8C3MFJV8+2F)
     • ID de Lugar de Google Maps - Identificador único del lugar
2. Marcador de Mapa Arrastrable (Manual)
   • Arrastre el pin en el mapa a la ubicación exacta
   • El sistema realiza geocodificación inversa para obtener la dirección a partir de las coordenadas
   • Los mismos campos se completan automáticamente según la ubicación del pin
   • Útil para áreas rurales o cuando la dirección es imprecisa

Generación de Código Plus:

Los Códigos Plus se generan automáticamente a partir de latitud/longitud utilizando la biblioteca de Código de Ubicación Abierta. Un Código Plus es un código corto (11 caracteres) que representa una ubicación precisa en cualquier parte del mundo.

Ejemplo:

Campos autocompletados: ✓ Nombre del Sitio: "123 Main Street" ✓ Línea de Dirección 1: "123 Main Street" ✓ Ciudad: "Londres" ✓ Estado: "Gran Londres" ✓ País: "Reino Unido" ✓ Código Postal: "SW1A 1AA" ✓ Latitud: 51.5074 ✓ Longitud: -0.1278 ✓ Código Plus: "9C3XGPHC+3Q" ✓ ID de Lugar de Google: "ChIJdd4hrwug2EcRmSrV3Vo6llI"

Requisitos de Validación:

Antes de guardar un sitio, el sistema valida:

• Latitud y Longitud deben estar configuradas (ya sea a través de búsqueda o arrastrando el marcador)
• País debe estar poblado (se establece de forma predeterminada en REACT_APP_DEFAULT_COUNTRY si no se establece)
• Código Plus debe tener 12 caracteres (11 + 1 para relleno)

Si la validación falla, verá un error:

Retroalimentación Visual:

La interfaz muestra retroalimentación en tiempo real:

o

Cómo se Utilizan los Datos de Ubicación

Los datos de ubicación geocodificados (latitud, longitud, Código Plus) se utilizan en todo OmniCRM para:

1. Entrega e Instalación de Servicios

• Técnicos de Campo - Acceder al Código Plus para navegar a la ubicación exacta del sitio
• Programación de Instalaciones - Asignar técnicos según la proximidad geográfica
• Despliegue de Equipos - Asegurar que el equipo correcto se entregue al sitio correcto

2. Notificaciones de Interrupciones

• Alertas Geocercadas - Si hay una interrupción de red en un área específica, consultar sitios por radio de lat/long
• Comunicaciones Dirigidas - Enviar notificaciones de interrupción solo a los clientes afectados a través de Mailjet
• Páginas de Estado - Mostrar un mapa de interrupciones con los sitios afectados

Ejemplo:

Consulta: SELECT * FROM Customer_Site

: WHERE distance(latitude, longitude, 51.5074, -0.1278) < 5

Resultado: 47 sitios afectados Acción: Enviar notificación de interrupción a 47 clientes

3. Informes y Análisis

• Ingreso Geográfico - Ingreso por ciudad, estado, región
• Mapas de Densidad de Servicios - Mapa de calor de ubicaciones de servicios
• Planificación de Expansión - Identificar áreas desatendidas

4. Clientes Empresariales de Múltiples Sitios

• Gestión de Sitios - Rastrear qué servicios en qué ubicaciones
• Facturación Separada - Facturar por sitio si es necesario
• Asignación de Servicios - Vincular servicios a sitios específicos durante la provisión

Sitios Rurales y Remotos

Para clientes en áreas rurales donde las direcciones pueden no existir o ser imprecisas:

1. Usar Arrastre en el Mapa
   • Acérquese al área aproximada
   • Arrastre el pin a la propiedad/edificio exacto
   • El sistema genera el Código Plus para esa ubicación precisa
2. Compartir Código Plus
   • Compartir el Código Plus con el cliente (p. ej., 8C3MFJV8+2F)
   • El cliente puede ingresar esto en Google Maps para ver la ubicación exacta
   • Los técnicos de campo utilizan el Código Plus para la navegación
3. Notas de Dirección
   • Usar el campo "Nota de Dirección" para direcciones adicionales
   • Ejemplo: "Gire a la izquierda en el granero rojo, 500 m después de la rejilla de ganado"
   • Notas visibles para los equipos de instalación

::: tip ::: title Consejo :::

Puede arrastrar el pin en el mapa a la ubicación correcta si la dirección no es precisa. El sistema geocodificará inversamente la ubicación y completará automáticamente todos los campos de dirección. :::

Contacto - Detalle

Los Contactos son personas asociadas con el cliente. Pueden ser contactos de facturación, contactos técnicos u otros tipos, y cada contacto tiene un tipo que influye en cómo manejamos el contacto.

Podemos tener múltiples contactos para un solo cliente, por ejemplo, un cliente con múltiples contactos de facturación, o un cliente con múltiples contactos técnicos.

Un buen ejemplo sería una empresa con un proveedor de servicios gestionados, que maneja el lado técnico de las cosas, y un contacto de facturación separado que maneja el lado financiero, o una familia donde cada miembro tiene su propio contacto pero no todos están autorizados a hacer cambios.

De igual manera, solo podemos querer enviar notificaciones de interrupción al contacto técnico, o solo enviar facturas al contacto de facturación, y el tipo de contacto nos permite controlar esto.

La lógica exacta de cómo se utilizan los tipos de contacto depende de su negocio, pero la idea básica es que cada contacto tiene un tipo que influye en cómo los manejamos, y que cada persona asociada con el cliente es un contacto.

Los contactos se sincronizan con la integración de Mailjet, lo que nos permite enviar campañas de correo electrónico dirigidas según el tipo de contacto, ubicación, gasto mensual o servicios adquiridos, y gestionar todas las plantillas de correo electrónico utilizadas para comunicaciones transaccionales.