As comissões no PlugSales precisam ter as seguintes informações:

• ID
  • Campo numérico do tipo inteiro que identifica a comissão desse usuário. Esse campo não é retornado no aplicativo, pois essa informação serve apenas para consulta.
• USUARIO
  • Campo numério do tipo inteiro com o ID do usuário, esse valor deve ser o mesmo informado no mapeamento do Usuário.
• CLIENTE
  • Campo numério do tipo inteiro com o ID do cliente, esse valor deve ser o mesmo informado no mapeamento do Cliente.
• PEDIDO
  • Campo de texto contendo um valor para identificar qual é o pedido do vendedor, esse campo será exibido em uma coluna na listagem de pedidos da comissão.
• DATA_PEDIDO
  • Campo de texto com a data de vencimento da conta no formato: YYYY-MM-DD.
• VALOR_PEDIDO
  • Campo numérico do tipo real (float/decimal) com o valor do pedido que gerou essa comissão.
• VALOR_COMISSAO
  • Campo numérico do tipo real (float/decimal) com o valor da comissão.
• SITUACAO
  • Campo de texto com a situação da comissão.

Para se adequar ao formato do PlugSales não é necessário que você crie uma nova tabela de comissões 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 Comissões para o PlugSales

Exemplo: MySQL

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

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

Para resolver isso e dar ao PlugSales as informações que ele precisa sobre as comissões, você pode escrever uma query SQL passando nomes de aliases para as colunas com inner joins para agregar as tabelas, que precisará ser executada toda vez que o PlugBot precisar ler informações das comissões.

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 VwComissoesPlugSales AS
    SELECT 
        cpp.id,
        p.id_usuario AS usuario,
        p.id_cliente AS cliente,
        p.id AS pedido,
        p.data_pedido,
        p.valor_total_pedido AS valor_pedido,
        cpp.valor_comissao,
        cpp.situacao_comissao AS situacao
    FROM
        tbcomissoesporpedido cpp
            INNER JOIN
        tbpedidos p ON cpp.id_pedido = p.id;

Depois que a view VwComissoesPlugSales estiver criada, você pode selecionar essa view no painel e o PlugBot pode simplesmente executar um simples SELECT * FROM VwComissoesPlugSales 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!