Integração Analytics

h1. Força de Vendas - Malharia

*Índice* 

# [[Força_de_Vendas_-_Malharia#Introdução|Introdução]] 

# [[Força_de_Vendas_-_Malharia#Acesso-via-JDBC|Acesso via JDBC]] 

# [[Força_de_Vendas_-_Malharia#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]]

## [[Força_de_Vendas_-_Malharia#Tabelas-de-Integração|Tabelas de Integração]]

## [[Força_de_Vendas_-_Malharia#Parâmetros|Parâmetros]]

## [[Força_de_Vendas_-_Malharia#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]

# [[Força_de_Vendas_-_Malharia#Layouts-de-Integração|Layouts de Integração]]

## [[Força_de_Vendas_-_Malharia#Produtos|Produtos]]

## [[Força_de_Vendas_-_Malharia#Tabela-de-preço|Tabela de Preço]]

## [[Força_de_Vendas_-_Malharia#Catalogos|Catalogos]]

## [[Força_de_Vendas_-_Malharia#Produto-vinculo-Acessórios|Produto vinculo Acessórios]]

## [[Força_de_Vendas_-_Malharia#Lotes-de-Faturamento|Lotes de Faturamento]]

## [[Força_de_Vendas_-_Malharia#Condição-de-Venda|Condição de Venda]]

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 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.

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>

h1. Layouts de Integração

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

h2. 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. |

|22| codClassificacaoFiscal * | String | 255 | Código da classificação fiscal do produto. |

|23| descClassificacaoFiscal * | String | 255 | Descrição da classificação fiscal do produto. |

|24| codCategoria * | String | 255 | Código da Categoria do produto. |

|25| descCategoria * | String | 255 | Descrição da Categoria do produto. |

|26| codOrigem * | String | 255 | Código da Origem do produto. |

|27| descOrigem * | String | 255 | Descrição da Origem 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') ) |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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     | String   		  |            | 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 |