Manual de Integração » Histórico » Versão 287
Versão 286 (paulo, 03/07/2024 10:16 h) → Versão 287/295 (paulo, 03/07/2024 10:18 h)
h1. Manual de Integração
[[Documentações]]
[[Analytics]]
[[Digitação de Pedidos|Força de Vendas - Digitação de Pedidos]]
[[Força de Vendas - Malharia]]
[[Loja Virtual - B2B|B2B - Loja Virtual]]
[[CRM|CRM - GEO360]]
[[Envio de Duplicatas|Recurso Plus - Envio de Duplicatas]]
[[Gestão de Cobrança|Recurso Plus - Gestão de Cobrança]]
[[Gestão de Crédito|Recurso Plus - Gestão de Crédito]]
-[[Loja Virtual - B2C]]- (depreciado)
*Manuais*
[[Digitação de Pedidos - Imagens dos Produtos|Força de Vendas - Digitação de Pedidos - Imagens dos Produtos]]
[[Loja Virtual - Imagens|B2B - Loja Virtual - Imagens]]
[[Loja Virtual - Estilos (Layout Personalizado)|B2B - Loja Virtual - Estilos (Layout Personalizado)]]
[[Loja Virtual - Login Externo|B2B - Loja Virtual - Login Externo]]
[[Portal de Clientes - API|Interno - Portal de Clientes - API]]
[[Produção]]
*Índice*
# [[Manual de Integração#Introdução|Introdução]]
# [[Manual de Integração#Conexões-DB|Conexões DB]]
# [[Manual de Integração#Acesso-via-JDBC|Acesso via JDBC]]
# [[Manual de Integração#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]
## [[Manual de Integração#Tabelas-de-Integração|Tabelas de Integração]]
## [[Manual de Integração#Parâmetros|Parâmetros]]
## [[Manual de Integração#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Manual de Integração#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Views/Tabelas Padrões por módulo/produto]]
## [[Analytics#Introdução|*Todos [[Analytics#Introdução|Todos os modulos/produtos*]] modulos/produtos]]
### [[Analytics#Clientes-e-Prospects|Clientes e Prospects]]
### [[Analytics#Coleções|Coleções]]
### [[Analytics#Representantes|Representantes]]
### [[Analytics#Representantes-dos-Clientes|Representantes dos Clientes ]]
## [[Analytics#Introdução|Analytics]]
### [[Analytics#Clientes Inadimplentes|Clientes Inadimplentes]]
### [[Analytics#Linhas-de-Produto|Linhas de Produto]]
### [[Analytics#Marcas|Marcas]]
### [[Analytics#Vendas|Vendas]]
## [[Digitação de Pedidos#Introdução|Força de Vendas]]
### [[Digitação de Pedidos#Condição-de-Venda|Condição de Venda]]
### [[Digitação de Pedidos#Clientes|Clientes]]
### [[Digitação de Pedidos#Títulos-Em-Aberto|Títulos Em Aberto]]
### [[Digitação de Pedidos#Tabela-de-Preço|Tabela de Preço]]
### [[Digitação de Pedidos#Tabela-de-Preço-Produto|Tabela de Preço - Produto]]
### [[Digitação de Pedidos#Produtos|Produtos]]
### [[Digitação de Pedidos#Produtos-Grades|Produtos - Grades]]
### [[Digitação de Pedidos#Produtos-Sortimentos|Produtos - Sortimentos]]
### [[Analytics#Estoque Centralizado|Estoque Centralizado]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Capa|Listagem de Pedidos - Capa]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Histórico|Listagem de Pedidos - Histórico]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Detalhado|Listagem de Pedidos - Detalhado]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Itens|Listagem de Pedidos - Itens]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Notas|Listagem de Pedidos - Notas]]
## [[Loja_Virtual_-_B2B#Introdução|B2B - Loja Virtual]]
### [[Loja_Virtual_-_B2B#Cliente|Cliente]]
### [[Loja_Virtual_-_B2B#Representantes - Clientes|Representantes - Clientes]]
### [[Loja_Virtual_-_B2B#Clientes-Representantes|Clientes - Representantes]]
### [[Loja_Virtual_-_B2B#Tabela-de-Preço|Tabela de Preço]]
### [[Loja_Virtual_-_B2B#Produtos|Produtos]]
### [[Loja_Virtual_-_B2B#Produtos-Grades|Produtos - Grades]]
### [[Loja_Virtual_-_B2B#Produtos-Sortimentos|Produtos - Sortimentos]]
### [[Analytics#Estoque Centralizado|Estoque Centralizado]]
### [[Loja_Virtual_-_B2B#Pedido-Capa|Pedido - Capa]]
### [[Loja_Virtual_-_B2B#Pedido-Histórico|Pedido - Histórico]]
### [[Loja_Virtual_-_B2B#Pedido-Detalhe|Pedido - Detalhe]]
### [[Loja_Virtual_-_B2B#Pedido-Itens|Pedido - Itens]]
### [[Loja_Virtual_-_B2B#Condição de Venda|Condição de Venda]]
### [[Loja_Virtual_-_B2B#Pedido-Recompra|Pedido - Recompra]]
## [[CRM#Introdução|CRM - GEO360]]
### [[CRM#Dados-Cadastrais-do-Cliente|Dados Cadastrais do Cliente]]
### [[CRM#Pesquisa-por-Nome-de-Cliente|Pesquisa por Nome de Cliente]]
### [[CRM#Pesquisa-Avançada|Pesquisa Avançada]]
### [[CRM#Lista-de-Pedidos-do-Cliente|Lista de Pedidos do Cliente]]
### [[CRM#Pedido-Detalhado|Pedido - Detalhado]]
### [[CRM#Pedido-Itens|Pedido - Itens]]
### [[CRM#Pedido-NFs|Pedido - NFs]]
### [[CRM#Lista-de-Pedidos-Representante|Lista de Pedidos Representante]]
### [[CRM#Informações-Financeiras|Informações Financeiras]]
h1. 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 atendimento@geovendas.com ou pelo telefone (47) 3370-0504. atendimento whatsapp 47 99950146
h1. 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 atendimento@geovendas.com ou pelo telefone fixo (47) 3370-0504. atendimento whatsapp 47 99950146
h1. 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.
h1. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
h2. 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.
h2. 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.
h2. 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*
<pre>SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmpresa = :p1
AND codTabela = :p2</pre>
[[Documentações]]
[[Analytics]]
[[Digitação de Pedidos|Força de Vendas - Digitação de Pedidos]]
[[Força de Vendas - Malharia]]
[[Loja Virtual - B2B|B2B - Loja Virtual]]
[[CRM|CRM - GEO360]]
[[Envio de Duplicatas|Recurso Plus - Envio de Duplicatas]]
[[Gestão de Cobrança|Recurso Plus - Gestão de Cobrança]]
[[Gestão de Crédito|Recurso Plus - Gestão de Crédito]]
-[[Loja Virtual - B2C]]- (depreciado)
*Manuais*
[[Digitação de Pedidos - Imagens dos Produtos|Força de Vendas - Digitação de Pedidos - Imagens dos Produtos]]
[[Loja Virtual - Imagens|B2B - Loja Virtual - Imagens]]
[[Loja Virtual - Estilos (Layout Personalizado)|B2B - Loja Virtual - Estilos (Layout Personalizado)]]
[[Loja Virtual - Login Externo|B2B - Loja Virtual - Login Externo]]
[[Portal de Clientes - API|Interno - Portal de Clientes - API]]
[[Produção]]
*Índice*
# [[Manual de Integração#Introdução|Introdução]]
# [[Manual de Integração#Conexões-DB|Conexões DB]]
# [[Manual de Integração#Acesso-via-JDBC|Acesso via JDBC]]
# [[Manual de Integração#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]
## [[Manual de Integração#Tabelas-de-Integração|Tabelas de Integração]]
## [[Manual de Integração#Parâmetros|Parâmetros]]
## [[Manual de Integração#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Manual de Integração#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Views/Tabelas Padrões por módulo/produto]]
## [[Analytics#Introdução|*Todos [[Analytics#Introdução|Todos os modulos/produtos*]] modulos/produtos]]
### [[Analytics#Clientes-e-Prospects|Clientes e Prospects]]
### [[Analytics#Coleções|Coleções]]
### [[Analytics#Representantes|Representantes]]
### [[Analytics#Representantes-dos-Clientes|Representantes dos Clientes ]]
## [[Analytics#Introdução|Analytics]]
### [[Analytics#Clientes Inadimplentes|Clientes Inadimplentes]]
### [[Analytics#Linhas-de-Produto|Linhas de Produto]]
### [[Analytics#Marcas|Marcas]]
### [[Analytics#Vendas|Vendas]]
## [[Digitação de Pedidos#Introdução|Força de Vendas]]
### [[Digitação de Pedidos#Condição-de-Venda|Condição de Venda]]
### [[Digitação de Pedidos#Clientes|Clientes]]
### [[Digitação de Pedidos#Títulos-Em-Aberto|Títulos Em Aberto]]
### [[Digitação de Pedidos#Tabela-de-Preço|Tabela de Preço]]
### [[Digitação de Pedidos#Tabela-de-Preço-Produto|Tabela de Preço - Produto]]
### [[Digitação de Pedidos#Produtos|Produtos]]
### [[Digitação de Pedidos#Produtos-Grades|Produtos - Grades]]
### [[Digitação de Pedidos#Produtos-Sortimentos|Produtos - Sortimentos]]
### [[Analytics#Estoque Centralizado|Estoque Centralizado]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Capa|Listagem de Pedidos - Capa]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Histórico|Listagem de Pedidos - Histórico]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Detalhado|Listagem de Pedidos - Detalhado]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Itens|Listagem de Pedidos - Itens]]
### [[Digitação de Pedidos#Listagem-de-Pedidos-Notas|Listagem de Pedidos - Notas]]
## [[Loja_Virtual_-_B2B#Introdução|B2B - Loja Virtual]]
### [[Loja_Virtual_-_B2B#Cliente|Cliente]]
### [[Loja_Virtual_-_B2B#Representantes - Clientes|Representantes - Clientes]]
### [[Loja_Virtual_-_B2B#Clientes-Representantes|Clientes - Representantes]]
### [[Loja_Virtual_-_B2B#Tabela-de-Preço|Tabela de Preço]]
### [[Loja_Virtual_-_B2B#Produtos|Produtos]]
### [[Loja_Virtual_-_B2B#Produtos-Grades|Produtos - Grades]]
### [[Loja_Virtual_-_B2B#Produtos-Sortimentos|Produtos - Sortimentos]]
### [[Analytics#Estoque Centralizado|Estoque Centralizado]]
### [[Loja_Virtual_-_B2B#Pedido-Capa|Pedido - Capa]]
### [[Loja_Virtual_-_B2B#Pedido-Histórico|Pedido - Histórico]]
### [[Loja_Virtual_-_B2B#Pedido-Detalhe|Pedido - Detalhe]]
### [[Loja_Virtual_-_B2B#Pedido-Itens|Pedido - Itens]]
### [[Loja_Virtual_-_B2B#Condição de Venda|Condição de Venda]]
### [[Loja_Virtual_-_B2B#Pedido-Recompra|Pedido - Recompra]]
## [[CRM#Introdução|CRM - GEO360]]
### [[CRM#Dados-Cadastrais-do-Cliente|Dados Cadastrais do Cliente]]
### [[CRM#Pesquisa-por-Nome-de-Cliente|Pesquisa por Nome de Cliente]]
### [[CRM#Pesquisa-Avançada|Pesquisa Avançada]]
### [[CRM#Lista-de-Pedidos-do-Cliente|Lista de Pedidos do Cliente]]
### [[CRM#Pedido-Detalhado|Pedido - Detalhado]]
### [[CRM#Pedido-Itens|Pedido - Itens]]
### [[CRM#Pedido-NFs|Pedido - NFs]]
### [[CRM#Lista-de-Pedidos-Representante|Lista de Pedidos Representante]]
### [[CRM#Informações-Financeiras|Informações Financeiras]]
h1. 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 atendimento@geovendas.com ou pelo telefone (47) 3370-0504. atendimento whatsapp 47 99950146
h1. 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 atendimento@geovendas.com ou pelo telefone fixo (47) 3370-0504. atendimento whatsapp 47 99950146
h1. 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.
h1. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
h2. 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.
h2. 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.
h2. 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*
<pre>SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmpresa = :p1
AND codTabela = :p2</pre>