Projeto

Geral

Perfil

Manual de Integração » Histórico » Versão 297

« Anterior - Versão 297/298 (diff) - Próximo » - Versão atual
paulo, 16/12/2025 10:44 h


Manual de Integração

Documentações

Analytics
Força de Vendas - Digitação de Pedidos
Força de Vendas - Malharia
B2B - Loja Virtual
CRM - GEO360
Recurso Plus - Envio de Duplicatas
Recurso Plus - Gestão de Cobrança
Recurso Plus - Gestão de Crédito
Loja Virtual - B2C (depreciado)

Informações Gerais

  1. Introdução
  2. Conexões DB
  3. Acesso via JDBC
  4. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
    1. Tabelas de Integração
    2. Parâmetros
    3. Exemplo de SQL de Integração

Views/Tabelas Padrões por módulo/produto

  1. Todos os modulos/produtos
    1. Clientes e Prospects
    2. Coleções
    3. Representantes
    4. Representantes dos Clientes
  2. Analytics
    1. Clientes Inadimplentes
    2. Linhas de Produto
    3. Marcas
    4. Vendas-1
  3. Força de Vendas
    1. Condição de Venda
    2. Clientes
    3. Títulos Em Aberto
    4. Tabela de Preço
    5. Tabela de Preço - Produto
    6. Produtos
    7. Produtos - Grades
    8. Produtos - Sortimentos
    9. Estoque Centralizado
    10. Listagem de Pedidos - Capa
    11. Listagem de Pedidos - Histórico
    12. Listagem de Pedidos - Detalhado
    13. Listagem de Pedidos - Itens
    14. Listagem de Pedidos - Notas
  4. Força de Vendas - Malharia
    1. Condição de Venda
    2. Catalogos
    3. Tabela de Preço - Capa
    4. Tabela de Preço - Itens
    5. Produtos
    6. Produtos - Variantes
    7. Estoque Centralizado
    8. Listagem de Pedidos - Consulta
    9. Listagem de Pedidos - Detalhamento da Capa
    10. Listagem de Pedidos - Itens
    11. Listagem de Pedidos - Notas
    12. Listagem de Pedidos - Notas Itens
    13. Triangulação
    14. Títulos
  5. B2B - Loja Virtual
    1. Cliente
    2. Representantes - Clientes
    3. Clientes - Representantes
    4. Tabela de Preço
    5. Produtos
    6. Produtos - Grades
    7. Produtos - Sortimentos
    8. Estoque Centralizado
    9. Pedido - Capa
    10. Pedido - Histórico
    11. Pedido - Detalhe
    12. Pedido - Itens
    13. Condição de Venda
    14. Pedido - Recompra
  6. CRM - GEO360
    1. Dados Cadastrais do Cliente
    2. Pesquisa por Nome de Cliente
    3. Pesquisa Avançada
    4. Lista de Pedidos do Cliente
    5. Pedido - Detalhado
    6. Pedido - Itens
    7. Pedido - NFs
    8. Lista de Pedidos Representante
    9. Informações Financeiras

Views/Tabelas Padrões para Recursos Plus

  1. B2B - Portal Financeiro
    1. Boletos - Consulta Cliente
    2. Boletos - Listagem
    3. Boletos - Detalhado
    4. Boletos Pagos - Listagem (somente via API com ELT)
    5. DANFE- Listagem
    6. DANFE- Itens da nota
    7. DANFE- XML

Manuais

Força de Vendas - Digitação de Pedidos - Imagens dos Produtos
B2B - Loja Virtual - Imagens
B2B - Loja Virtual - Estilos (Layout Personalizado)
B2B - Loja Virtual - Login Externo
Interno - Portal de Clientes - API
Produção

Introdução

O presente documento tem por objetivo orientar as empresas de ERP na geração dos arquivos e/ou tabelas necessárias para integração com o GEOvendas.

Atenção!! Os campos que estiverem com a descrição "Campo Específico" retornar null, salvo se for combinado algo diferente com a GEOvendas durante o processo.

Atenção!! Cabe ao desenvolvedor das Views retornar nas views os campos obrigatórios e os campos não obrigatórios que forem pertinentes ao processo do Cliente, ou a informação que o cliente deseja enxergar.

Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail ou pelo telefone (47) 3370-0504. atendimento whatsapp 47 99950146

Conexões DB

JDBC pré-requisito: Suporte por parte do Banco de Dados da Empresa fornecedora do ERP a acesso JDBC.

Na integração via JDBC a fornecedora de ERP deve disponibilizar para a GEOvendas tabelas (ou visões) conforme os layouts especificados neste documento, também deverá fornecer um usuário e senha que tenha permissão de consulta nas referidas tabelas ou visões. A GEOvendas fará acesso via JDBC à base de dados do cliente para extrair as informações.

API: Para conexões via API ou outra solução que não seja JDBC favor entrar em contato com a GEOvendas pelo e-mail ou pelo telefone fixo (47) 3370-0504. atendimento whatsapp 47 99950146

Acesso via JDBC

Pré-Requisito: Suporte por parte do Banco de Dados da Empresa fornecedora do ERP a acesso JDBC.

Na integração via JDBC a fornecedora de ERP deve disponibilizar para a GEOvendas tabelas (ou visões) conforme os layouts especificados neste documento, também deverá fornecer um usuário e senha que tenha permissão de consulta nas referidas tabelas ou visões. A GEOvendas fará acesso via JDBC à base de dados do cliente para extrair as informações.

Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração

Tabelas de Integração

As tabelas/visões tem um campo chamado “codEmpresa” que separa a geração dos dados entre as possíveis várias empresas que o cliente tenha na mesma base de ERP.
Observação: Os campos com asterisco (*) compõem a “primaryKey” e podem ser enviados como String ou Integer dependendo da necessidade do cliente.

Parâmetros

Algumas tabelas de integração necessitam de parâmetros. Os parâmetros trabalham em pares: Campo e Parâmetro.
O Campo refere-se ao campo correspondente na tabela/visão, e o parâmetro é o código que será substituído na hora da execução do SQL.

Exemplo de SQL de Integração

Vamos usar abaixo um exemplo a Tabela de Preços:

Documentação do IGS:

Consulta informações de tabela de preço do ERP.

Campo Tipo Precisão Descrição
codEmpresa * String/Integer 10 Código da Empresa origem dos dados
codTabela * String/Integer 255 Código da tabela de preços no ERP
descricao String 255 Descrição da tabela de preços

Lista de Parâmetros:

Campo Parâmetro Tipo Precisão Descrição
codEmpresa :p1 String/Integer 10 Código da empresa no ERP
codTabela :p2 String/Integer 255 Código da tabela de preços no ERP

SQL de exemplo com base na documentação

SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmpresa = :p1
  AND codTabela = :p2