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

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 atendimento@geovendas.com 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¶

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

Produto vinculo Acessórios¶

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