Os clientes do PlugSales precisam ter as seguintes informações:

• ID
  • Campo numérico do tipo inteiro. Esse campo será retornado no pedido.
• RAZAO
  • Campo de texto com a razão social do cliente.
• FANTASIA
  • Campo de texto com o nome fantasia do cliente.
• CNPJ
  • Campo de texto com o CNPJ/CPF do cliente.
• ENDERECO
  • Campo de texto com o endereço do cliente.
• TELEFONE
  • Campo de texto com o telefone do cliente.
• EMAIL
  • Campo de texto com o e-mail do cliente.
• CIDADE
  • Campo de texto com a cidade do cliente.
• UF
  • Campo de texto com o estado do cliente.
• SITUACAO
  • Campo de texto com a situação do cliente.
• USUARIO
  • Campo numérico do tipo inteiro com o código do usuário atrelado ao cliente

Para se adequar ao formato do PlugSales não é necessário que você crie uma nova tabela de clientes com essas colunas e comece a cadastrar do zero. 

Basta criar uma view no seu banco de dados, a qual retornará registros com as colunas necessárias para o PlugSales.

O que é uma view?

Na prática, uma view é uma tabela virtual em que, seus registros são resultados de um SELECT definido no momento de sua criação.

Por exemplo, para criar uma view que simula uma tabela que exibe somente os clientes VIP:

CREATE VIEW ClientesVIP
AS
SELECT Nome1, Sobrenome1
FROM Clientes
WHERE VIP = 'S';

E a consulta de clientes VIP sobre essa view seria simplesmente:

SELECT *
FROM ClientesVIP;

Criando uma view de Clientes para o PlugSales

Exemplo: MySQL

Para criar a view de clientes que o PlugSales necessita, imagine que você possui a seguinte estrutura de tabelas em seu banco de dados:

O PlugSales precisa de informações que estão, nesse cenário, em tabelas diferentes.

Para resolver isso e dar ao PlugSales as informações que ele precisa sobre os clientes, você pode escrever uma query SQL com diversos inner joins, que será executada toda vez que o PlugBot precisar ler informações dos seus clientes.

Ou você pode criar uma view que trará os dados no formato correto de uma vez para o PlugSales.

Para criar a view que atenda ao PlugSales nessa estrutura de tabelas, o SQL seria o seguinte:

CREATE OR REPLACE VIEW VwClientesPlugSales AS
    SELECT 
        c.id,
        c.razao,
        c.fantasia,
        c.cnpj,
        CONCAT(e.logradouro, ', N. ', e.numero) endereco,
        co.telefone,
        co.email,
        e.cidade,
        e.uf,
        c.situacao
    FROM
        TbClientes c
            INNER JOIN
        TbEnderecos e ON c.id = e.id_cliente
            INNER JOIN
        TbContatos co ON c.id = co.id_cliente;

Depois que a view VwClientesPlugSales estiver criada, você pode selecionar essa view no painel e o PlugBot pode simplesmente executar um simples SELECT * FROM VwClientesPlugSales para obter os dados necessários.

E ao carregar os dados dessa view, seja diretamente da tabela, ou usando uma query SQL, os dados já virão formatados corretamente nas colunas que o PlugSales as espera!