2. Crear una vista para mapear clientes (PlugSales)
Este artículo tiene como objetivo explicar qué información del cliente es obligatoria en PlugSales y cómo utilizar una vista para adaptar los datos de tu banco al formato necesario.
En este artículo verás:
- Campos de cliente obligatorios en PlugSales
- Cómo adaptar tu base sin crear una nueva tabla
- Qué es una vista
- Ejemplo de creación de vista
- Cómo crear una vista de cliente para PlugSales
Información obligatoria del cliente
Los clientes de PlugSales deben tener la siguiente información para que la integración funcione correctamente:
-
identificación Campo numérico entero. Este campo se devolverá en el pedido y se utilizará para identificar al cliente.
-
RAZÓN Campo de texto con el nombre comercial del cliente.
-
FANTASÍA Campo de texto con el nombre comercial del cliente.
-
CNPJ Campo de texto con el CNPJ o CPF del cliente.
-
DIRECCIÓN Campo de texto con la dirección del cliente.
-
TELÉFONO Campo de texto con el número de teléfono del cliente.
-
CORREO ELECTRÓNICO Campo de texto con el correo electrónico del cliente.
-
CIUDAD Campo de texto con la ciudad del cliente.
-
UF Campo de texto con el estado del cliente.
-
SITUACIÓN Campo de texto con la situación del cliente.
-
USUARIO Campo numérico entero con el código de usuario vinculado al cliente.
¿Necesito crear una nueva tabla de clientes?
No.
Para adaptarse al formato requerido por PlugSales no es necesario crear una nueva tabla de clientes ni rehacer los registros.
Simplemente cree una vista en la base de datos que devuelva registros en el formato esperado por el sistema. PlugBot utilizará esta vista para leer la información.
¿Qué es una vista?
Una vista es una tabla virtual creada a partir de un comando SELECT.
No almacena datos físicamente. En cambio, cada vez que se consulta, devuelve los resultados definidos en su creación.
Ejemplo práctico
Sección titulada «Ejemplo práctico»Imagine una vista que devuelva solo clientes VIP:
CREAR VER ClientesVIP COMO SELECCIONAR Nombre1, Apellido1 DESDE Clientes DONDE VIP = ‘S’;
Para consultar esta vista:
SELECCIONAR * DE ClientesVIP;
Crear una vista de cliente para PlugSales
Ejemplo en MySQL
Sección titulada «Ejemplo en MySQL»Considere un escenario en el que la información requerida se encuentra en diferentes tablas de bases de datos.
PlugSales necesita recibir estos datos en un único resultado. Para ello, puedes crear una vista que reúna toda la información necesaria.
Ejemplo de creación de vistas
Sección titulada «Ejemplo de creación de vistas»CREAR O REEMPLAZAR VER VwClientesPlugSales COMO SELECCIONAR c.id, c.razao, c.fantasia, c.cnpj, CONCAT(e.logradouro, ’, N. ’, e.numero) dirección, co.telefone, co.email, e.cidade, e.uf, c.situacao FROM TbClientes c INNER JOIN TbAddresses e ON c.id = e.client_id UNIÓN INTERNA TbContacts co ON c.id = client_co.id;
En este ejemplo:
- Los datos del cliente están en tablas diferentes.
- La vista reúne toda la información necesaria.
- Los campos se devuelven en el formato esperado por PlugSales
Usando la vista en PlugBot
Después de crear la vista, simplemente selecciónela en el panel de integración.
Entonces PlugBot ejecutará una consulta simple, como:
SELECCIONAR * DE VwClientesPlugSales
De esta manera:
- Los datos ahora se devolverán en el formato correcto.
- El mapeo será más fácil
- La integración se producirá de forma más segura y organizada
Al cargar los datos de la vista, ya sea directamente desde la tabla o mediante consulta SQL, la información ya estará correctamente estructurada en las columnas esperadas por PlugSales.
