Integração com sistemas externos

| 4 minutos

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.

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.

Descrição do Campo 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.

A seguir você verá um exemplo de SQL de pedidos na tabela DM_PEDIDO.

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.

Descrição do Campo 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.

A seguir você verá um exemplo de SQL de inserção de itens de pedido na tabela DM_PEDIDO_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.

Descrição do 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.

A seguir você verá um exemplo de SQL de inserção de clientes na tabela DM_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.

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.

Este artigo ajudou você?
 0
 0

Seja uma Revenda de Software da Eagle Tecnologia

Temos a melhor Parceria de Software para sua revenda crescer e se destacar na sua região com os nossos sistemas, oferecendo mais qualidade na Gestão Empresarial dos seus clientes.
Conheça nossa Revenda de Software