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-Capa|Tabela de Preço - Capa]]

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

## [[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#Listagem-de-Pedidos-Capa|Listagem de Pedidos - Capa]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Detalhado|Listagem de Pedidos - Detalhado]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Itens|Listagem de Pedidos - Itens]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Notas|Listagem de Pedidos - Notas]]

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 |

h2. Listagem de Pedidos - Capa

Retornar dados referentes a capa do pedido.

|_.Num|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

|1| codEmpresa | String/Integer | 10 | Código da empresa no ERP |

|2| codCliente | String | 255 | Código do Cliente |

|3| nomeCliente | String | 255 | Nome do Cliente |

|4| codRepres | String | 255 | Código do Representante |

|5| pedAutomacao | String | 255 | Número do Lote de Gravação |

|6| codPedido | String | 255 | Código do Pedido no ERP |

|7| dataEmissao | Date | | Data de Emissão do Pedido |

|8| dataPrevFat | Date | | Data de Previsão de Faturamento do Pedido |

|9| situacao | Integer | 10 | Código da Situação no ERP |

|10| situacaoEdt | String | 255 | Descrição da Situação do Pedido |

|11| valorBruto | Double | | Valor Bruto do Pedido |

|12| valorLiquido | Double | | Valor Liquido do Pedido |

|13| valorSaldo | Double | | Valor Saldo do Pedido |

|14| qtdePedLiquida | Integer | | Quantidade Pedida Liquida |

|15| motivo | String | 255 | Motivo do pedido |

|16| pedidoCliente | String | 255 | Codigo do Pedido de controle do cliente |

|17| pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |

|18| percComissao | Double | | Percentual de comissão do pedido |

|19| usuarioDigitacao | String | 255 | Usuário digitação do pedido |

|20| valorComissao | Double | | Valor da comissão do pedido |

|21| percDescGeral | Double | | Percentual de desconto geral do pedido |

|22| valorDesconto | Double | | Valor total de desconto do pedido |

|23| nomeColecao | String | 255 | Coleção do Pedido p/ Histórico de Pedidos |

|24| codTipoNota | String | 255 | Código do Tipo de nota p/ Histórico de Pedidos |

|25| currency | String | 255 | Config de moeda para o ISF, fixo 'R$' |

|26| tipoNota | String | 255 | Tipo da Nota |

|27| motivoQuarentenaPedidos | String | 255 | Motivo Da Quarentena dos pedidos |

|28| atendente | String | 255 | Atendente do pedido |

|29| tabPrecoPedido | String | 255 | Tabela de Preço do Pedido |

|30| situacaoWorkFlow | String | 255 | Situação do Ppedido no WorkFlow |

|31| nomeRepres | String | 255 | Nome Representante |

|32| valorFaturado | Double | | Valor Faturado |

|33| qtdeEntregue | Double | | Quantidade Entregue |

|34| percEntrega | Double | | Percentual de Entrega |

|35| nomeFantasia | String | 255 | Nome Fantasia |

|36| nomeMarca | String | 255 | Marca do Pedido p/ Histórico de Pedidos |

Lista de Parâmetros:

_Formato sugerido de data: yyyy-mm-dd (2023-12-13)_

|_. Parâmetro               |_. Tipo  |_. Precisão |_. Descrição                    |

| :pDataEmissao          | Date     |             | Data de Emissão do Pedido |

| :p3   | String   | 10         | Código do Representante |

| :p4          | String   | 10         | (opcional) Código do Cliente |

| #COLECOES (#COLECAONULL)             | string   |            |(opcional) para ser utilizado na consulta de pedidos Online|

| #MARCAS (#MARCANULL) | String | 255 | Marcas do pedido |

| #CODPEDIDOCLIENTE | String | 255 | Código de pedido do cliente |

| #CODPEDIDOREPRESENTANTE | String | 255 | Código de pedido do representante |

| #SITUACAODISPLAY (#SITUACAODISPNULL) | String | 255 | Situação do pedido no ERP |

| #TABPRECOS (#TABPRECONULL) | String | 255 | Tabelas de Preço Liberadas |

| #CORINGAS1 (#CORINGA1NULL) | String | 255 | Coringa 1 (campo dinâmico opcional) |

| #CORINGAS2 (#CORINGA2NULL) | String | 255 | Coringa 2 (campo dinâmico opcional) |

| #CORINGAS3 (#CORINGA3NULL) | String | 255 | Coringa 3 (campo dinâmico opcional) |

| #CORINGAS4 (#CORINGA4NULL) | String | 255 | Coringa 4 (campo dinâmico opcional) |

| #CORINGAS5 (#CORINGA5NULL) | String | 255 | Coringa 5 (campo dinâmico opcional) |

| #CORINGAS6 (#CORINGA6NULL) | String | 255 | Coringa 6 (campo dinâmico opcional) |

h2. Listagem de Pedidos - Detalhado

Retornar dados detalhados do pedido.

|_.n|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

|1| dataEmissao | Date | | Data de Emissão do Pedido |

|2| dataPrevFat | Date | | Data de Previsão do Faturamento |

|3| situacaoEdt | String | 255 | Descrição da Situação do Pedido |

|4| codCliente | String | 255 | Código do Cliente |

|5| nomeCliente | String | 255 | Nome do Cliente |

|6| cidadeCliente | String | 255 | Nome da Cidade do Cliente (cidade da venda) |

|7| ufCliente | String | 255 | Sigla do Estado do Cliente (estado da venda). |

|8| inscEstadual | String | 255 | Inscrição Estadual do Cliente | 

|9| cnpjCliente | String | 255 | Cnpj do Cliente |

|10| codRepres | String | 255 | Código do Representante |

|11| percComissao | Double | | Percentual de Comissão do Pedido |

|12| codTabPreco | String | 255 | Código da Tabela de Preço |

|13| nomeTabPreco | String | 255 | Nome da Tabela de Preço |

|14| codCondVenda | String | 255 | Código da Condição de Venda |

|15| nomeCondVenda | String | 255 | Nome da Condição de Venda |

|16| codTranspDespacho | String | 255 | Código da Transportadora de Despacho | 

|17| nomeTranspDespacho | String | 255 | Nome da Transportadora de Despacho | 

|18| tipoFreteTranspDespacho | String | 255 | Tipo de Frete do Transporte de Despacho |

|19| codTranspRedespacho | String | 255 | Código da Transportadora de Redespacho |

|20| nomeTranspRedespacho | String | 255 | Nome da Transportadora de Redespacho | 

|21| tipoFreteTranspRedespacho | String | 255 | Tipo de Frete do Transporte de Redespacho |

|22| codTipoNota | String | 255 | Código do Tipo de Nota |

|23| nomeTipoNota | String | 255 | Nome do Tipo de Nota |

|24| observacao | String | 255 | Observação do Pedido |

|25| valorBruto | Double | | Valor Bruto do Pedido |

|26| valorLiquido | Double | | Valor Liquido do Pedido |

|27| valorSaldo | Double | | Valor Saldo do Pedido |

|28| percDesconto1 | Double | | Percentual de Desconto 1 |

|29| percDesconto2 | Double | | Percentual de Desconto 2 |

|30| percDesconto3 | Double | | Percentual de Desconto 3 |

|31| percDesconto4 | Double | | Percentual de Desconto 4 |

|32| percDesconto5 | Double | | Percentual de Desconto 5 |

|33| nomeFantasia | String | 255 | Nome Fantasia |

|34| emailCliente | String | 255 | E-mail do Cliente |

|35| pedidoCliente | String | 255 | Codigo do Pedido de controle do cliente |

|36| pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |

|37| flagAntecipacaoPedido | Integer | | Flag de antecipação |

|38| flagPedidoParcial | Integer | | Flag pedido parcial |

|39| flagFaturamentoTriangular | Integer | | Flag faturamento triangular |

|40| endereco | String | 255 | Endereço |

|41| endNumero | String | 255 | Número do endereço |

|42| bairro | String | 255 | Bairro |

|43| emailCliente | String | 255 | Complemento |

|44| currency | String | 255 | Tipo de moeda |

|45| negociacao | Integer | | Tipo de negociação |

Lista de Parâmetros:

|_. Parâmetro  |_. Tipo  |_. Precisão |_. Descrição         |

| :p1 | String   |  255          | Código do Pedido (É comparado com o "código do pedido no Erp" do "Listagem de Pedidos - Capa" e com o valor do "Pedido ERP" no botão azul de pedidos finalizados do FV)|

h2. Listagem de Pedidos - Itens

Retornar dados dos Itens do pedido.

|_.n|_. Campo  |_. Tipo   |_. Precisão |_. Descrição |

|1| codItem | String | 255 | Código do Item para Ordenação |

|2| codProduto | String | 255 | Código do Produto |

|3| nomeProduto | String | 255 | Nome do Produto |

|4| qtdePedida | Double | | Quantidade Pedida do Produto |

|5| qtdeSaldoBruto | Double | | Quantidade Saldo Bruto do Produto |

|6| qtdeSaldoLiquido | Double | | Quantidade Saldo Liquido do Produto |

|7| qtdeFaturado | Double | | Quantidade Faturada do Produto |

|8| qtdeCancelada | Double | | Quantidade Cancelada do Produto |

|9| valorUnitarioBruto | Double | | Valor Unitário Bruto do Produto |

|10| valorUnitarioLiquido | Double | | Valor Unitário Liquido do Produto |

|11| valorTotal | Double | | Valor Total do Produto |

|12| codReferencia        | String  | 255            | Código da Referência do Item.           |

|13| seqTamanho        | String  | 255            | Tamanho do Item.           |

|14| variante        | String  | 255            | Cor do Item.           |

|15| codColecao | String | 255 | Código da coleção |

|16| nomeColecao | String | 255 | Nome da coleção |

|17| codEtiqueta | String | 255 | Código da etiqueta |

|18| nomeEtiqueta | String | 255 | Nome da etiqueta |

|19| codLinha | String | 255 | Código da linha |

|20| nomeLinha | String | 255 | Nome da linha | 

|21| codFamilia | String | 255 | Código da família |

|22| nomeFamilia | String | 255 | Nome da família |

|23| codTipoPeca | String | 255 | Código do tipo de peça |

|24| nomeTipoPeca | String | 255 | Nome do tipo de peça |

|25| qtdePendente | Double | | Quantidade pendente |

|26| codGrade | String | 255 | Código da grade |

|27| dataEntrega        | String  | 255            | Data de Entrega do Item.           |

|27| acessorio        | Boolean  | | Se o item é acessório.           |

|28| seqItemPai        | Integer  | | Referência do item pai (Se for acessório)           |

Lista de Parâmetros:

|_. Parâmetro  |_. Tipo  |_. Precisão |_. Descrição         |

| :p1 | String   |  255          | Código do Pedido (É comparado com o "código do pedido no Erp" do "Listagem de Pedidos - Capa" e com o valor do "Pedido ERP" no botão azul de pedidos finalizados do FV)|

h2. Listagem de Pedidos - Notas

Retornar dados das Notas Fiscais do pedido.

|_.n|_. Campo  |_. Tipo   |_. Precisão |_. Descrição |

|1| dataEmissao | Date | | Data de Emissão da Nota Fiscal |

|2| numeroNF | String | 255 | Número da Nota Fiscal |

|3| situacao | String | 255 | Situação da Nota Fiscal |

|4| valorLiquido | Double | | Valor Total da Nota Fiscal |

|5| codTransp | String | 255 | Código da Transportadora |

|6| nomeTransp | String | 255 | Nome da Transportadora |

|7| codRedespacho | String | 255 | Código do Redespacho |

|8| nomeRedespacho | String | 255 | Nome do Redespacho |

|9| chaveNFE | String | 255 | Chave da Nota Fiscal |

|10| qtdeFaturado | Double | | Quantidade de peças faturadas |

|11| dataEntrega | Date | | Data de entrega da Nota Fiscal |

|12| descSituacaoEntrega | String | | Descrição da situação atual da entrega |

Lista de Parâmetros:

|_. Parâmetro  |_. Tipo  |_. Precisão |_. Descrição         |

| :p1 | String   |  255          | Código do Pedido (É comparado com o "código do pedido no Erp" do "Listagem de Pedidos - Capa" e com o valor do "Pedido ERP" no botão azul de pedidos finalizados do FV)|