Integração Analytics

h1. Força de Vendas - Malharia

*Índice* 

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

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

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') ) |