Objetivos

Este manual tem por objetivo fornecer orientações para integração de sistemas externos com o Eagle Gestão para integrar pedidos e clientes. Esta integração inicialmente foi desenvolvida para o força de vendas DEMANDER e poderá ser extendida a outros sistemas.

Requisitos

Para que esta integração seja possível o parceiro deverá seguir as seguintes recomendações:

1. Possuir um profissional com conhecimento em integração de sistemas;
2. Desenvolver interface de configuração de acesso ao banco de dados.
3. Desenvolver mecanismos de controle para evitar que os mesmos dados sejam sincronizados sem que houvesse mudança de estado.

Layout de Pedidos

Para integração de pedidos o utilitário de integração desenvolvido pelo parceiro deverá gravar dados na tabela DM_PEDIDOS do banco de dados do Eagle Gestão informado na configuração. A seguir será apresentado quais campos deverão ser integrados.

Campo Demander	Observações
ID	Código do pedido gerado na plataforma externa.
CODFORMAPAGAMENTO	Código da forma de pagamento que irá constar nas parcelas do orçamento. Caso a plataforma mande o nome deverá ser pesquisado o código na tabela MEIOSPAGAMENTOS.
CODCONDICAOPAGAMENTO	Código do plano de pagamento cadastrado que definirá quantas parcelas e prazos terá o orçamento. Importante: Não é o campo plano do orçamento.
IDCLIENTE	Código do cliente gerado na plataforma externa.
CODLISTAPRECO	Código da tabela de preço que foi utilizada para gerar o orçamento. Mander sempre a GERAL.
CODVENDEDOR	Código do vendedor que será vinculado ao orçamento. Caso a plataforma mande o nome deverá ser pesquisado o código na tabela PESSOAS.
DATAEMISSAO	Data e Hora do orçamento.
VALORPRODUTOSSEMDESCACRES	Subtotal que se refere a soma dos produtos do orçamento.
OBSERVACAO	Observações do orçamento.
CODTIPOPEDIDO	Operação que será vinculada ao orçamento. Deverá existir uma operação 32.
VALORTOTALPEDIDO	Total Líquido do orçamento.
OBSERVACAOCLIENTE	Vai concatenada com o campo Observações do orçamento.
VALORIPI	Valor de IPI do Orçamento. Pode mandar zerado.
VALORICMS_ST	Valor de ICMS ST do Orçamento. Pode mandar zerado.
VALORDESCONTODOPEDIDO	Total Descontos do orçamento em valor.
PERCENTUALDESCONTODOPEDIDO	Total Descontos do orçamento em porcentagem.
PESOBRUTO	Peso Bruto do orçamento.
PESOLIQUIDO	Peso Líquido do orçamento.
CONSOLIDADO	Enviar sempre 0.
CANCELADO	Enviar sempre 0.

INSERT INTO DM_PEDIDOS (
   ID,
   CODFORMAPAGAMENTO,
   CODCONDICAOPAGAMENTO,
   IDCLIENTE,
   CODLISTAPRECO,
   CODVENDEDOR,
   DATAEMISSAO,
   VALORPRODUTOSSEMDESCACRES,
   OBSERVACAO,
   CODTIPOPEDIDO,
   VALORTOTALPEDIDO,
   OBSERVACAOCLIENTE,
   VALORIPI,
   VALORICMS_ST,
   VALORDESCONTODOPEDIDO,
   PERCENTUALDESCONTODOPEDIDO,
   PESOBRUTO,
   PESOLIQUIDO,
   CONSOLIDADO,
   CANCELADO)
VALUES (
   1,
   1,
   1,
   1,
   1,
   25,
   '25.09.2021 08:03:16',
   '37.10',
   'OBSERVACAO DE TESTE',
   '32',
   '37.10',
   'TESTE DE OBSERVACAO CLIENTE',
   '0.00',
   '0.00',
   '0.00',
   '0.00',
   '0.00',
   '0.00',
   0,
   0);

Layout de Itens de Pedidos

Para integração de itens de pedidos o utilitário de integração desenvolvido pelo parceiro deverá gravar dados na tabela DM_PEDIDO_ITEM do banco de dados do Eagle Gestão informado na configuração. A seguir será apresentado quais campos deverão ser integrados.

Campo Demander	Observações
IDPEDIDO	Código do pedido na plataforma externa.
CODPRODUTO	Código do produto no orçamento. Importante: Código da Eagle na plataforma integradora (External Code).
VALORUNITARIOCOMDESCONTO	Preço do item do orçamento.
VALORUNITARIOSEMDESCONTO	Preço do item do orçamento quando VALORDESCONTODOPEDIDO for maior que zero.
QTDE	Quantidade do produto do orçamento.
VALORTOTALPRODUTOSCOMDESCONTO	Total do item orçamento.
VALORTOTALPRODSEMPERCCONDPAG	Total do item orçamento quando VALORDESCONTODOPEDIDO for maior que zero.
OBSERVACAO	Observação do item.

INSERT INTO DM_PEDIDO_ITEM (
   CODIGO,
   IDPEDIDO,
   CODPRODUTO,
   VALORUNITARIOCOMDESCONTO,
   VALORUNITARIOSEMDESCONTO,
   QTDE,
   VALORTOTALPRODUTOSCOMDESCONTO,
   VALORTOTALPRODSEMPERCCONDPAG,
   OBSERVACAO
   )
VALUES (
   1,
   1,
   37,
   '37.10',
   '37.10',
   '1',
   '37.10',
   '37.10',
   NULL);

Layout de Clientes

Para integração de clientes o utilitário de integração desenvolvido pelo parceiro deverá gravar dados na tabela DM_CLIENTE do banco de dados do Eagle Gestão informado na configuração. A seguir será apresentado quais campos deverão ser integrados.

Campo	Observações
IDCLIENTE	Código do pedido gerado na plataforma externa.
CPFCNPJ	CPF ou CNPJ do cadastro do cliente.
CODCIDADE	Código da localidade do cadastro do cliente.
NOMERAZAO	Razão Social do cadastro do cliente.
NOMEFANTASIA	Nome Fantasia do cadastro do cliente.
TIPOPESSOA	Pessoa Física (F) ou Jurírica (J)
RGIE	RG ou Inscrição Estadual do cadastro do cliente.
TELEFONE1	Telefone 1 do cadastro do cliente.
TELEFONE2	Telefone 2 do cadastro do cliente.
EMAILCOMPRADOR	E-mail do cadastro do cliente.
CONTATO	Contato do cadastro do cliente.
ENDERECO	Endereço do cadastro do cliente.
BAIRRO	Bairro do cadastro do cliente.
CEP	CEP do cadastro do cliente.
OBSERVACAO	Observação do cadastro do cliente.
ATIVO	Campo inativo do cadastro de cliente. Mandar 1 para ativo e 0 para inativo.
NUMERO	Número do endereço do cadastro do cliente.
COMPLEMENTO	Complemento do cadastro do cliente.
DATANASCIMENTO	Data de nascimento do cliente.

INSERT INTO DM_CLIENTE (
   IDCLIENTE,
   CPFCNPJ,
   CODCIDADE,
   NOMERAZAO,
   NOMEFANTASIA,
   TIPOPESSOA,
   RGIE,
   TELEFONE1,
   TELEFONE2,
   EMAILCOMPRADOR,
   CONTATO,
   ENDERECO,
   BAIRRO,
   CEP,
   OBSERVACAO,
   ATIVO,
   NUMERO,
   COMPLEMENTO,
   DATANASCIMENTO)
VALUES (
   '1',
   '48753436636',
   '3728',
   'CARLOS EDUARDO SILVA',
   'PEDRO PEIXOTO',
   'F',
   'MG367614091',
   '3136222608',
   '31995470335',
   'carloseduardosilva@gmail.com',
   'O MESMO',
   'RUA CAPELA',
   'JARDIM RIACHO DAS PEDRAS',
   '32241290',
   'OBSERVACAO DE TESTE',
   '1',
   '937',
   'CASA',
   '09.02.1983');

Processo de conversão de dados

Após conhecer quais informações devem ser gravadas nas tabelas de integração do Eagle Gestão iremos entender deve ser feito após inserir os dados nas tabelas de integração.

1. O utilitário de integração deverá ler as informações no sistema de externo e gravar no Eagle Gestão nas tabelas de integração.
2. Caso tenha ocorrido algum cadastro de cliente no sistema externo o utilitário de integração deverá executar a procedure DM_IMPORTA_CLIENTES.
3. Após a execução da procedure DM_IMPORTA_CLIENTES o usuário deverá ser notificado e poderá conferir os dados na tela de cadastro de clientes.
4. Caso tenha ocorrido algum registro de pedido no sistema externo o utilitário de integração deverá executar a procedure DM_IMPORTA_PEDIDOS
5. Após a execução da procedure DM_IMPORTA_PEDIDOS o usuário deverá ser notificado e poderá conferir os dados na tela de Orçamentos.

Consulta de pedidos

Caso seja necessário obter informações acerca dos pedidos gravados, os seguintes campos podem ser consultados na tabela ORCAMENTOS

Campo	Observações
ORCAMENTOS_ID	Código do pedido gerado pelo sistema.
OPERACOES_ID	Código da Operação configurada no sistema
CLIENTES_ID	Código do cliente vinculado ao pedido
VENDEDORES_ID	Código do vendedor vinculado ao pedido
MODIFICADO	Data da última alteração do pedido pelo usuário
CODIGO_EXTERNO	Amazena o código externo do aplicativo que originou o pedido

SELECT
   ORCAMENTOS_ID,
   OPERACOES_ID
FROM
   ORCAMENTOS
WHERE
   MODIFICADO > '18.04.2024 17:51:41' AND
   OPERACOES_ID IN (71, 72, 73, 74)
   AND
   VENDEDORES_ID = 2   

Consulta de empresa

Caso seja necessário obter informações acerca da empresa, os seguintes campos podem ser consultados na tabela EMPRESA

Campo	Observações
EMPRESA_CNPJ	CNPJ
EMPRESA_NOME1	Nome Fantasia
EMPRESA_NOME2	Razão Social
EMPRESA_ENDERECO	Endereço
EMPRESA_ENDERECO_NUMERO	Número do endereço
EMPRESA_ENDERECO_COMPLEMENTO	Complemento do endereço
EMPRESA_BAIRRO	Bairro do endereço
EMPRESA_CEP	CEP do endereço
DISTRITO_NOME	Cidade
ESTADO_SIGLA	UF
EMPRESA_TELEFONE	Telefone da empresa
EMPRESA_RESPONSAVEL	Nome do responsável
EMPRESA_EMAIL	E-mail da empresa

SELECT
   EMPRESA_CNPJ,
   EMPRESA_NOME2
FROM
   EMPRESA

Importante

1. Caso ocorra alguma restrição a nível de banco de dados após a inserção os dados deverá ser verificado se os dados foram inseridos conforme layout estabelecido.
2. A versão do servidor do banco de dados Firebird compatível com o sistema é a 2.5.9