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

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

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

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 |