1. ¿Cómo mapear a los clientes? (PlugSales)

Agregar nuevos clientes:

Para agregar nuevos clientes a través de la aplicación, debes utilizar el siguiente campo:

Esta consulta SQL siempre se ejecutará cuando se registre un nuevo cliente en la aplicación PlugSales.

*En este campo puedes usar cualquier comando SQL que inserte datos en tu base de datos.

Para que la inserción del nuevo cliente se realice correctamente, SQL debe recibir los parámetros enviados desde la aplicación. El comando SQL debe describirse de la misma manera que se hace en su base de datos. Para utilizar los parámetros, siempre debes usarlos entre familiares (Ej: [NOMBRE]). Ver los parámetros:

Parámetros enviados por la aplicación:

*Atención, PlugBot considera que su tabla de clientes es AUTOINCREMENTO para el campo de identificación (ID/NÚMERO/CÓDIGO). Si tu tabla no tiene incremento, tu consulta debe contener un incremento automático del identificador, o debes utilizar un PROCEDIMIENTO que realice el incremento y la inserción.

• TIPO DE PERSONAS*(texto)*
  • Este parámetro devuelve el tipo de cliente “Individual” o “Entidad Jurídica” dependiendo de la selección del vendedor.
• NOMBRE (texto)
  • Este parámetro devuelve el nombre de la empresa o nombre del cliente que quedó registrado en la aplicación.
• CPFCNPJ (texto)
  • Este parámetro devuelve el CPF o CNPJ del cliente registrado en la aplicación.
• CORREO ELECTRÓNICO (texto)
  • Este parámetro devuelve el correo electrónico del cliente registrado en la aplicación.
• TELÉFONO (texto)
  • Este parámetro devuelve el número de teléfono del cliente registrado en la aplicación.
• CEP (texto)
  • Este parámetro devuelve el código postal del cliente registrado en la aplicación.
• CIUDAD (texto)
  • Este parámetro devuelve el correo electrónico del cliente registrado en la aplicación.
• UF (texto)
  • Este parámetro devuelve la UF del cliente registrado en la aplicación.
• DIRECCIÓN (texto)
  • Este parámetro devuelve la dirección del cliente registrada en la aplicación.
• NÚMERO (texto)
  • Este parámetro devuelve el número de domicilio del cliente registrado en la aplicación.
• VECINDARIO (texto)
  • Este parámetro devuelve el barrio del cliente registrado en la aplicación.
• COMPLEMENTO (texto)
  • Este parámetro devuelve el complemento de clientes registrado en la aplicación.
• IDUSUARIO (número entero)
  • Este parámetro devuelve el ID del usuario que registró al cliente en la aplicación.
• REGISTRO ESTATAL (texto)
  • Este parámetro devuelve el nombre o apellido del cliente registrado en la aplicación.
• TABLA DE PRECIOS (número entero) (OPCIONAL)
  • Si se utiliza TABLA DE PRECIOS, este campo devuelve el ID de la tabla de precios relacionada con el cliente, seleccionada cuando el cliente se registró.

Vea a continuación un ejemplo de SQL para insertar un nuevo CLIENTE:

Ejemplo en una base de datos MySQLINSERT INTO CLIENTE (tipo_persona, nombre, CNPJ, correo electrónico, teléfono, código postal, ciudad, UF, dirección, usuario, complemento, número, barrio, insc_est) VALOR (‘[TYPEPESSOA]’, ‘[NOMBRE]’, ‘[CPFCNPJ]’, ‘[CORREO ELECTRÓNICO]’, ‘[TELÉFONO]’, ‘[CEP]’, ‘[CIUDAD]’, ‘[UF]’, ‘[DIRECCIÓN]’, ‘[IDUSUARIO]’, ‘[COMPLEMENTO]’, ‘[NÚMERO]’, ‘[VECINDARIO]’, ‘[ESTADO DE REGISTRO]’)

• Atención, para parámetros de tipo TEXT(string), deben recibir un apóstrofe. Ejemplo: ‘[NOMBRE]’. No es necesario para parámetros NUMÉRICOS. Nota: **si los caracteres especiales **’ “ | **, saltos de línea o emojis se identifican en parámetros de tipo texto, se eliminarán para evitar conflictos con cualquier medio de integración.

Campos personalizados (ENTRADA)

Para poder utilizar campos personalizados en el registro de clientes, haga clic en aquí.

Mapeo de clientes

Para mapear a sus clientes en PlugSales, cada registro de cliente debe tener los siguientes campos:

*** Atención, todos los campos obligatorios deben devolver registros.**

• ID*
  • Campo numérico de tipo inteiro.
  • Se utiliza para identificar al cliente en el pedido.
  • Este campo no puede contener registros idénticos.
  • Todos los clientes deben estar registrados en este campo.
  • Este campo será devuelto en el pedido.
• RAZÓN*
  • Campo texto con el nombre de la empresa o nombre del cliente.
• FANTASÍA*- Campo texto con el nombre o apellido del cliente.
• CNPJ
  • Campo texto con el CNPJ/CPF del cliente.
  • Este campo es obligatorio y todos los clientes deben contener registros en el campo.
• DIRECCIÓN
  • Campo texto con la dirección del cliente.
• TELÉFONO
  • Campo texto con el número de teléfono del cliente.
• ** CORREO ELECTRÓNICO **
  • Campo texto con el correo electrónico del cliente.
• CIUDAD
  • Campo texto con la ciudad del cliente.
• UF
  • Campo texto con el estado del cliente.
• SITUACIÓN
  • Campo texto con la situación del cliente.
  • Este campo se puede utilizar para bloquear clientes.
• USUARIO
  • Campo numérico de tipo inteiro con el código de usuario vinculado al cliente.
  • El cliente sólo estará disponible para el usuario relacionado.
• AÑADIR CAMPO PERSONALIZADO
  • Utilizando campos personalizados podrás ingresar más información sobre tu CLIENTE.
  • En este campo es necesario determinar el tipo (Monetary o String).
  • En este campo es necesario definir si esta información debe enviarse o no al PDF del pedido.
  • Un campo de tu base de datos debe estar relacionado.
  • El registro en este campo se mostrará junto con la información del CLIENTE. Obtenga más información sobre cómo funciona ‘Agregar campo personalizado’. Nota: Para que estos campos se informen correctamente, recomendamos crear un view específico e ingresarlo en el panel de PlugBot.

Leer: Creando una vista para mapear clientes

Para comenzar a configurar los productos, defina el intervalo en el que PlugBot debe sincronizar los registros de su sistema a su PlugSales.

Nota: Recomendamos utilizar al menos 10 minutos

Después de seleccionar la Tabla de origen o ingresar la Fuente SQL, haga clic en “Cargar datos”.

Con los datos cargados, puede comenzar el proceso de mapeo de campos, siguiendo las instrucciones para cada campo.

## Bloqueo de clientes:

Es posible agregar situaciones de bloqueo para que la aplicación impida el registro de pedidos de clientes que se encuentren en estas situaciones.

Luego, según el campo SITUACIÓN** enumerado anteriormente, puede definir qué situaciones desea bloquear al cliente.

Ejemplo: Si el cliente tiene un registro INACTIVO en el campo SITUACIÓN, y esta es una situación de bloqueo, el cliente quedará bloqueado para realizar pedidos.

Vea algunos ejemplos de bloques:

-** INACTIVO** -BAJO ANÁLISIS -INACTIVO, BLOQUEADONota:en caso de más de una situación, debes separarlas con una coma. Nota:independientemente de las letras mayúsculas y minúsculas, es decir, Inactivo y INACTIVOson lo mismo.

Con todos los campos asignados y configurados, haga clic en “Guardar configuración del CLIENTE” en la parte inferior de la pantalla.