Projeto

Geral

Perfil

Histórico

Força de Vendas - Malharia » Histórico » Versão 19

« Anterior - Versão 19/297 (diff) - Próximo » - Versão atual
maikeu, 05/12/2023 12:53 h

Força de Vendas - Malharia

Índice
  1. Introdução
  2. Acesso via JDBC
  3. 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
  4. Layouts de Integração
    1. Produtos
    2. Tabela de Preço
    3. Catalogos
    4. Produto vinculo Acessórios
    5. Lotes de Faturamento
    6. Condição de Venda
    7. Clientes

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 a Digitação de Pedidos da 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.

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

Layouts de Integração

Segue os layouts que devem servir de base para construção dos SQLs de integração.

Produtos

Retornar a listagem de produtos.

Pos Campo Tipo Precisão Descrição
1 codProduto * String 255 Código do Produto no ERP. É o código usado para gravar o produto no ERP.
2 nomeProduto * String 255 Descrição do Produto.
3 codVariante * String 255 Código da da variante no ERP.
4 nomeVariante * String 255 Nome da Variante.
5 skuReduzido * String 255 SKU reduzido do produto.
6 codCatalogo * String 255 Código do catalogo.
7 codLinha * String 255 Código da Linha.
8 nomeLinha * String 255 Nome da Linha.
9 codGrupoCliente * String 255 Código do grupo cor.
10 nomeGrupoCor * String 255 Nome do grupo da cor.
11 rgb * String RGB referente a variante do produto.
12 codTipoPeca * String Código do tipo da peça.
13 nomeTipoPeca * String Nome do tipo de peça.
14 larguraTxt * String 255 Descrição da largura para exibição.
15 largura * Double Largura.
16 gramaturaTxt * String 255 Informação de gramatura para exibição.
17 gramatura * Double gramatura do produto.
18 rendimento * Double rendimento do produto.
19 keyword * String 255 keywords do produto.
20 especial * Integer 1 se o produto for especial. 0 para os demais casos.
21 composicao * String 255 Descrição da composição do produto.

Lista de Parâmetros:

Campo Parâmetro Tipo Precisão Descrição
codEmpresa :p1 String/Integer 10 Código da empresa no ERP
codCatalogo :p2 String 255 Código do catalogo no ERP
codProduto #PRODUTOS String text Lista de Referências Ex: and (codProduto in (#PRODUTOS) or #PRODUTOS_TODOS = '') Para ORACLE and (codProduto in (#PRODUTOS) or nvl(#PRODUTOS_TODOS,'0') = nvl('','0') )

Tabela de preço - Capa

Retornar a capa da tabela de preço.

Pos Campo Tipo Precisão Descrição
1 codTabela * String 255 Código da Tabela de preço no ERP.
2 nomeTabela * String 255 Descrição da Tabela de preço.

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ço no ERP

Tabela de preço - Itens

Retornar a listagem de tabela de preços.

Pos Campo Tipo Precisão Descrição
1 codTabela * String 255 Código da Tabela de preço no ERP.
2 codProduto * String 255 Código do produto no ERP.
3 codGrupoCor * String 255 Código Grupo Cor.
4 nomeGrupoCor * String 255 Descrição do Grupo Cor.
5 prazoMedio * Integer Identificar do prazo medio.
6 padrao * Integer 1 se for preço padrão. 0 caso não seja.
7 rendimento * Double Rendimento do produto.
8 precoQuilo * Double Preço do produto por quilo.
9 precoMetro * Double Preço do produto por metro.

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ço no ERP

Catálogos

Retornar a listagem de Catálogos.

Pos Campo Tipo Precisão Descrição
1 codCatalogo * String 255 Código do Catalogo no ERP.
2 nomeCatalogo * String 255 Descrição do Catalogo no ERP.
3 status * Integer 1 quando estiver liberado. 0 quando estiver bloqueado.

Lista de Parâmetros:

Campo Parâmetro Tipo Precisão Descrição
codEmpresa :p1 String/Integer 10 Código da empresa no ERP

Acessórios de Produtos

Retornar a listagem de vinculo de produtos com acessórios.

Pos Campo Tipo Precisão Descrição
1 codProduto * String 255 Código do Produto no ERP.
2 codAcessorio (codProduto) * String 255 Código do acessório no ERP.

Lista de Parâmetros:

Campo Parâmetro Tipo Precisão Descrição
codEmpresa :p1 String/Integer 10 Código da empresa no ERP

Clientes

Retornar a listagem de clientes de um representante.

Campo Tipo Precisão Descrição
1 codEmpresa * String/Integer 10 Código da Empresa origem dos dados
2 codCliente * String 255 Código do cliente no ERP
3 cnpj * String 255 CNPJ ou CPF do cliente (somente números)
4 nomeFantasia String 255 Nome fantasia do cliente
5 razaoSocial String 255 Razão social do cliente
6 situacao Integer Situação conforme codificação: 2- Inativo, 1 - Ativo, 999 - Limbo(Bloqueado)
7 telefone String 255 Telefone do cliente
8 email String 255 Endereço de e-mail padrão do cliente
9 emailNFE String 255 Endereço de e-mail para Nota Fiscal Eletrônica do do cliente
10 codIBGE String 255 Código IBGE da cidade do cliente
11 endereco String 255 Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a GEOvendas para discutir uma solução.
12 enderecoNumero String 255 Número do endereço do cliente do cliente
13 bairro String 255 Bairro do cliente
14 cep String 255 CEP do cliente (somente números)
15 dataCadastro Date Data de cadastro do cliente
16 inscricaoEstadual String 255 Inscrição estadual do cliente
17 inscricaoSUFRAMA String 255 Inscrição SUFRAMA do cliente se houver
18 cobrancaEmail String 255 Endereço de e-mail de cobrança do cliente
19 cobrancaContato String 255 Nome da pessoal de contato de cobrança do cliente
20 cobrancaTelefone String 255 Telefone da pessoal de contato de cobrança do cliente
21 comprasEmail String 255 Endereço de e-mail de compras do cliente
22 comprasContato String 255 Nome da pessoal de contato de compras do cliente
23 comprasTelefone String 255 Telefone da pessoal de contato de compras do cliente
24 avaliacaoRepres Text (opcional) Observação de avaliação do representante sobre o cliente (somente informação digitada pelo representante)
25 celular String 255 Telefone Celular de contato do cliente
26 fax String 255 Celular de contato do cliente
27 endComplemento String 255 Complemento do Endereço
28 dataUltimaCompra Date Data da ultima compra do cliente
29 codTransportadora String 255 Código da transportadora do cliente
30 codCondPagto String 255 Código da condição de pagamento do cliente
31 flagSimplesNacional Integer Cliente faz parte do Simples Nacional: 0 - Não, 1 - Sim
32 percDesconto Double % Desconto curva ABC (Obrigatoriamente colocar o filtro de codCliente no WHERE)
33 codGerente String 255 Código do Gerente/Supervisor do representante do cliente.
34 inscricaoMunicipal String 255 Inscrição municipal do cliente
35 codRamoAtividade String 255 Código do ramo de atividade do cliente.
36 codGrupoCliente String 255 Código do grupo de cliente.
37 dataFundacao String 255 Data de fundação do cliente.
38 limiteCredito Double Limite de crédito do cliente.
39 limiteCreditoDisponivel Double Limite de crédito disponível.
40 classificacaoCurva String Classificação da Curva.
41 latitude Double latitude.
42 longitude Double longitude.
43 latitudeISF Double latitudeISF.
44 longitudeISF Double longitudeISF.
45 atualizadoCoordPor String atualizadoCoordPor.
46 cfop Double CFOP Cliente.
47 codTranspRedespacho String Código de transportadora de redespacho.
48 codPortador String 255 Código do portador.
49 codTipoCob String 255 Código do tipo de cobrança.
50 codGrupoCliente String 255 Código do grupo do cliente.
51 instagram String 255 Instagram.
52 facebook String 255 Facebook.
53 validarCamposCustomizados Integer Flag para validar campos customizados.
54 grupoClienteCalculoST String 255 Código do grupo de substituição tributária do cliente.
55 somenteTriangulacao String 255 Cliente somente triangulação
56 marcas String 255 Marcas do cliente (em conjunto com SQL Marcas)
57 logradouro String 255 Terreno ou espaço em anexo da habitação (ex: rua, avenida)

Lista de Parâmetros:

Campo Parâmetro Tipo Precisão Descrição
codEmpresa :p1 String/Integer 10 Código da empresa no ERP
codRepresentante :p2 String/Integer 255 Código do representante no ERP
codCliente :p3 String/Integer 255 Código do cliente no ERP

Lotes de Faturamento

Retornar o cadastro de lotes de faturamento

Campo Tipo Precisão Descrição
dataReferencia Date Data de referência
dataFaturamento Date Data de faturamento
descricao String Descrição do lote de faturamento
codErp String Código do lote no ERP (Necessário APENAS se for essencial para a gravação do Pedido)
Campo Parâmetro Tipo Precisão Descrição
codEmpresa :p1 String/Integer codEmpresa
dataReferencia :p2 Date Data de referência

Condição de Venda

Retorna a listagem de Condições de Venda do ERP.

Campo Tipo Precisão Descrição
codEmpresa * String/Integer 10 Código da Empresa origem dos dados
codPagamento * String/Integer 255 Código da condição de Venda no ERP
nome String 255 Nome da condição de venda
qtdeParcelas Integer Número de parcelas da condição de venda
prazoMedio Double Prazo médio das parcelas da condição de venda
situacao Integer Situação conforme codificação: 0 - Inativo, 1 - Ativo
Parcelamento Integer Condição de Parcelamento EX:30/60/90

Lista de Parâmetros:

Campo Parâmetro Tipo Precisão Descrição
codEmpresa :p1 String/Integer 10 Código da empresa no ERP