Integração Analytics

h1. Digitação de Pedidos

*Índice* 

# [[Digitação de Pedidos#Introdução|Introdução]] 

# [[Digitação de Pedidos#Acesso-via-JDBC|Acesso via JDBC]] 

# [[Digitação de Pedidos#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]]

## [[Digitação de Pedidos#Tabelas-de-Integração|Tabelas de Integração]]

## [[Digitação de Pedidos#Parâmetros|Parâmetros]]

## [[Digitação de Pedidos#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]

# [[Digitação de Pedidos#Layouts-de-Integração|Layouts de Integração]]

## [[Digitação de Pedidos#Tabela-de-Preço|Tabela de Preço]]

## [[Digitação de Pedidos#Tabela-de-Preço-por-Representante|Tabela de Preço por Representante]] (opcional - somente se ERP possui esse controle)

## [[Digitação de Pedidos#Tabela-de-Preço-Cliente-DePara|Tabela de Preço Cliente De/Para]] (opcional - somente se ERP possui esse controle)

## [[Digitação de Pedidos#Tabela-de-Preço-Representante-DePara|Tabela de Preço - Representante De/Para]] (opcional - somente se ERP possui esse controle)

## [[Digitação de Pedidos#Tabela-de-Preço-Produto|Tabela de Preço - Produto]]

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Comercial|Tabela de Preço - Política - Desconto Comercial]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Financeiro|Tabela de Preço - Política - Desconto Financeiro]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Antecipação|Tabela de Preço - Política - Desconto Antecipação]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Prazo-Adicional|Tabela de Preço - Política - Prazo Adicional]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Volume-pack|Tabela de Preço - Política - Desconto Volume (Pack)]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Preços-por-volume|Tabela de Preço - Política - Preços por volume]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-13-SegmentoCond-Pagamento|Tabela de Preço - Política - Desconto 13 (Segmento/Cond. Pagamento)]] (opcional)

## [[Digitação_de_Pedidos#Tabela-de-Preço-Política-Depósitos-por-fornecedor|Tabela de Preço - Política - Depósitos por fornecedor]]

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Adicional-de-Lote|Tabela de Preço - Política - Desconto Adicional de Lote]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Compra-Acumulada|Tabela de Preço Política Desconto Compra Acumulada]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-por-Linha-de-Produto|Tabela de Preço - Política - Desconto por Linha de Produto]] (opcional)

## [[Digitação de Pedidos#Desconto-Campanha-Política-de-Descontos|Desconto Campanha - Política de Descontos]] (opcional)

## [[Digitação de Pedidos#Desconto-linha-de-produto-Política-de-Descontos|Desconto linha de produto - Política de Descontos]] (opcional)

## [[Digitação de Pedidos#Títulos-Em-Aberto|Títulos Em Aberto]] (opcional)

## [[Digitação de Pedidos#Condição-de-Venda|Condição de Venda]]

## [[Digitação de Pedidos#Cota-de-estoque-Por-representante|Cota de estoque - Por representante]] (opcional)

## [[Digitação de Pedidos#Tipo-de-Nota|Tipo de Nota]](opcional)

## [[Digitação de Pedidos#Tipo-de-Cobrança|Tipo de Cobrança]](opcional)

## [[Digitação de Pedidos#Comissões|Comissões]] (opcional)

## [[Digitação de Pedidos#Comissões-Extrato-Resumo|Comissões - Extrato Resumo]] (opcional)

## [[Digitação de Pedidos#Comissões-Extrato-Detalhado|Comissões - Extrato Detalhado]] (opcional)

## [[Digitação de Pedidos#Clientes|Clientes]]

## [[Digitação de Pedidos#Clientes-Campos-Customizados|Clientes - Campos Customizados]] (opcional)

## [[Digitação de Pedidos#Clientes-Locais-de-Entrega|Clientes - Locais de Entrega]](opcional)

## [[Digitação de Pedidos#Clientes-Ramos-de-Atividade|Clientes - Ramos de Atividade]](opcional)

## [[Digitação de Pedidos#Clientes-Grupos-de-Cliente|Clientes - Grupos de Cliente]](opcional)

## [[Digitação de Pedidos#Clientes-Condições-de-venda|Clientes - Condições de venda]](opcional)

## [[Digitação de Pedidos#Clientes-Grupos-de-Cliente|Clientes - Marcas]](opcional)

## [[Digitação de Pedidos#Clientes-Grupos-de-Cliente|Clientes - Marcas Concorrentes]](opcional)

## [[Digitação de Pedidos#Marcas-por-Cidade|Marcas por Cidade]](opcional)

## [[Digitação de Pedidos#Clientes-Contatos-Departamento|Clientes - Contatos - Departamento]](opcional)

## [[Digitação de Pedidos#Produtos|Produtos]]

## [[Digitação de Pedidos#Produtos-Grades|Produtos - Grades]]

## [[Digitação de Pedidos#Produtos-Sortimentos|Produtos - Sortimentos]]

## [[Digitação de Pedidos#Produtos-Etiquetas|Produtos - Etiquetas]]

## [[Digitação de Pedidos#Produtos-Linhas|Produtos - Linhas]]

## [[Digitação de Pedidos#Produtos-Tipos|Produtos - Tipos]]

## [[Digitação de Pedidos#Produtos-Modelos|Produtos - Modelos]]

## [[Digitação de Pedidos#Produtos-Gênero|Produtos - Gênero]]

## [[Digitação de Pedidos#Produtos-Skus|Produtos Skus]] (opcional)

## [[Digitação de Pedidos#Produtos-Gold-Be|Produtos - Gold Be]] (Exclusiva)

## [[Digitação de Pedidos#Produtos-Prioridade-de-linha-para-distribuição|Produtos - Prioridade de linha para distribuição]] (opcional)

## [[Digitação de Pedidos#Produto-Código-Reduzido|Produto - Código Reduzido]] (opcional - somente se ERP precisa do código reduzido)

## [[Digitação de Pedidos#Produto-EAN13|Produto - EAN13]] (opcional)

## [[Digitação de Pedidos#Produtos-Parte-Cima-Parte-Baixo|Produtos Parte Cima Parte Baixo]] (opcional)

## [[Digitação de Pedidos#Bloqueio-de-Referências|Bloqueio de Referências]](opcional)

## [[Digitação de Pedidos#Pedido-Capa|Pedido - Capa]]

## [[Digitação de Pedidos#Pedidos-por-Referência(Cota)|Pedidos por Referência(Cota)]] (opcional)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Capa|Listagem de Pedidos - Capa]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Detalhado|Listagem de Pedidos - Detalhado]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Itens|Listagem de Pedidos - Itens]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Notas|Listagem de Pedidos - Notas]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Observções|Listagem de Pedidos - Observações]] (opcional)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Histórico|Listagem de Pedidos - Histórico]] (opcional)

## [[Digitação de Pedidos#Listagem-de-Notas-Fiscais-Capa|Listagem de Notas Fiscais - Capa]] (opcional)

## [[Digitação de Pedidos#Estoque|Estoque]] (Depreciada) - Alterada para [[Manual de Integração#Estoque Centralizado|Estoque Centralizado]]

## [[Digitação de Pedidos#Lotes-de-Entrega|Lote Entrega]] (opcional)

## [[Digitação de Pedidos#Lotes-de-Faturamento|Lotes de Faturamento]] (opcional)

## [[Digitação de Pedidos#Cálculo-substituição-tributária|Cálculo substituição tributária]] (opcional)

## [[Digitação de Pedidos#Grupos-substituição-tributária|Grupos substituição tributária]] (opcional)

## [[Digitação de Pedidos#Integração-Valor-de-Frete-por-UF|Integração Valor de Frete por UF]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-SKU|Tabela de Preço SKU]] (opcional)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Em-Aberto-Capa|Listagem de Pedidos em Aberto - Capa]] (opcional)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Detalhado|Listagem de Pedidos em Aberto - Detalhado]] (mesma estrutura Listagem de Pedidos - Detalhado) (opcional)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Itens|Listagem de Pedidos em Aberto - Itens]] (mesma estrutura Listagem de Pedidos - Itens) (opcional)

## [[Digitação de Pedidos#SKUs Pronta Entrega e Programado|SKUs Pronta Entrega e Programado]] (opcional)

## [[Digitação de Pedidos#Clientes Reposição|Clientes Reposição]] (opcional)

## [[Digitação de Pedidos#Produtos - Data de Entrega|Produtos - Data de Entrega]] (opcional)

## [[Conta corrente - Saldo flex por representante]] (opcional)

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.inf.br 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. Tabela de Preço

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 |

| dataMinimaFaturamento | Date | | Data mínima de faturamento |

| dataMaximaFaturamento | Date | | Data máxima de faturamento |

| percDescontoShowRoom | Double | | Percentual de desconto para show room |

| dataVigenciaInicial | Date | | Data de vigência inicial |

| dataVigenciaFinal | Date | | Data de vigência final |

| codColecao | String | | Código da coleção (opcional) |

| codSegmento | String | | Código do segmento (opcional) |

| codTabelaPrecoPrincipal | String | | Código da tabela de preços (opcional) - Se preenchido esse campo, irá pegar esse código como tabela nos SQL´s de produto |

| desconsiderarDescAcr | Integer | | Desconsiderar Desconto Acrescimo (opcional) |

| codEmpresaDestino | String | | Código de empresa destino (opcional) |

| currency | String | | Tipo de moeda (opcional) |

| codTipoPedido | String | | Código do tipo de pedido (opcional) |

| codTabPrecoIntegracao | String | | Código da tabela de preços para integração (opcional) |

| prazoMedio | Double| | Prazo Médio |

| depositos| String | | Depositos nas configurações adicionais da tabela de preço. Enviar depositos separados por , caso seja usado mais de um para leitura do estoque |

| cnpjPacote| String | | CNPJ da empresa destino da integração, usado apenas para integração por PACOTE |

| codOperacao | String | | Código de operação na configuração adicional da tabela de preço |

| nrPrioridade | String | | Código da Prioridade na configuração adicional da tabela de preço|

| inFatura| String | | Código da tag inFatura na configuração adicional da tabela de preço|

| depositoERP| String | | Código do deposito ERP na configuração adicional da tabela de preço|

| codMarca| String | 255 | Código da marca do produto na configuração adicional 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ços no ERP |

h2. Tabela de Preço por Representante

Carrega as tabelas de preço de acordo com a ligação delas com o representante. Retornar somente as ativas.

Nesta integração deve sempre vir todas as tabelas de preço que o representante pode vender, seja qual for o contexto.

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

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

| codRepres | :p2     | String/Integer   | 255         | Código do representante |

h2. Tabela de Preço - Representante De/Para

Carrega as tabelas de preço de acordo com a ligação delas com o representante. Retornar somente as ativas.

Nesta integração devem vir todas tabelas que o representante pode vender para qualquer cliente e situação, sem que exista um regra ou situação especial para permitir a venda

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

| codTabela *  | String/Integer   | 255        | Código da tabela de preços no ERP |

| codRepres    | String   | 255        | Código do representante |

Lista de Parâmetros:

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

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

| codRepres | :p2     | String/Integer   | 255         | Código do representante |

h2. Tabela de Preço Cliente De/Para

Carrega as tabelas de preço de acordo com a ligação delas com o o cliente.

Nesta integração devem vir todas as tabelas de preço que possuem alguma regra especifica por cliente.

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

| codTabela *  | String/Integer   | 255        | Código da tabela de preços no ERP |

| codCliente   | String   | 255        | CodCliente |

Lista de Parâmetros:

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

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

| codRepres | :p2     | String/Integer   | 255         | Código do representante |

h2. Tabela de Preço - Produto

Retornar a listagem dos produtos da 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 |

| codProduto *  | String/Integer   | 255        | Código do produto no ERP |

| codGrade *  | String/Integer   | 255        | Código da grade de produto no ERP |

| preco    | Double   |            | Preço do produto |

| seqSortimento  | String/Integer   | 255        | Código da sortimento no ERP (opcional, somente para quem utiliza venda agrupada/look) |

| itemAtivo  | Integer   | 1        | Situação do item no ERP (0 - Inativo, 1 - Ativo) |

| seqTamanho | String | | Código do tamanho na grade no ERP|

| descricaoProd | String | | |

| vlrUnitarioAnterior | String | | |

| seqTamanho | String | | Utilizar apenas se trabalha com preço por SKU, caso contrario mandar NULL. Verificar com a GEOVendas antes.|

| permiteBonificacao | String | | |

| flagOferta | String | | |

| codigoCaixaGoldBe | String | | Código agrupador de caixas Gold Be |

| dataVencimento | Date | | Data de vencimento do valor do produto (Apenas para Alimentício) |

| aliquotaIpi | Double | | Percentual da alíquota a ser aplicado ao preços 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 |

| codTabela | :p2    | String/Integer   | 255         | Código da tabela de preços no ERP |

| produtoAtivo | :p4    | Integer   | -         | Filtro para buscar produto ativo/inativo |

| codReferencia | :p5    | String/Integer   | 255         | Utilizada para filtrar um produto para digitação online |

| codColecao | #COLECOES  | | | Qualificar no WHERE como IN |

| codRepres | :p6    | String   | 255         | Utilizada para filtrar um representante nos produtos para digitação online, obrigatório ":p6 or :p6 is null" |

h2. Tabela de Preço - Política - Desconto Comercial

Retornar a política de desconto comercial da tabela de preço do ERP.

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

| valorInicio | Double   |            | |

| valorFim | Double   |            | |

| qtdePecasIni | Integer | | |

| qtdePecasFim | Integer | | |

| percDesconto | Double | | |

| perccomissao | Double | | |

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 |

h2. Tabela de Preço - Política - Desconto Financeiro

Retornar a política de desconto financeiro da tabela de preço do ERP.

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

| prazoMedioMinimo | Double   |            | |

| prazoMedioMaximo | Double   |            | |

| percDesconto | Double | | |

| perccomissaoAdicional | Double | | |

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 |

h2. Tabela de Preço - Política - Desconto Antecipação

Retornar a política de desconto antecipação da tabela de preço do ERP.

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

| dataInicio | Date |            | |

| dataFim | Date |            | |

| percDesconto | Double | | |

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 |

h2. Tabela de Preço - Política - Prazo Adicional

Retornar a política de prazo adicional da tabela de preço do ERP.

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

| descricao | String | 255  | |

| qtdeDias | Integer | | |

| ufs | String | 255  | |

| dataFaturamentoInicio | Date |            | |

| dataFaturamentoFim | Date |            | |

| dataEmissaoInicio | Date | | |

| dataEmissaoFim | Date | | |

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 |

h2. Tabela de Preço - Política - Desconto Volume (pack)

Desconto de Volume

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

| codSegmento | String | 255  | Fixo *null* quando por Cliente e Tabela de Preços |

| codColecao | String | | Fixo *null* quando por Cliente e Tabela de Preços |

| clienteUf | String | 255  | Fixo *null* quando por Cliente e Tabela de Preços |

| valorInicial | Double |            | Valor Inicial|

| valorFinal | Double |            | Valor Final |

| tipoValor | Integer | | Fixo *null* quando por Cliente e Tabela de Preços |

| desconto | Double | | Valor do desconto |

| codTabelaPreco | String | | *Obrigatório* quando por Cliente e Tabela de Preços |

| codCliente | String | | *Obrigatório* quando por Cliente e Tabela de Preços |

| descontoComercialMinimo | Double | |  |

| codReferencia | String | | *Obrigatório* quando por "40 - Desc. Hist Compra por referência." |

| codigoAgrupador | String | | Opcional - Para ligar a quantidade de outros produtos com o mesmo código |

Lista de Parâmetros:

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

| codRepresentante | :p1     | String   | 10         | Apenas usado quando por cliente e tabela de preço |

| codCliente | :p2     | String   | 255         | Apenas usado quando por cliente e tabela de preço |

| codTabelaPreco | :p3     | String   | 255         | Apenas usado quando por cliente e tabela de preço |

h2. Desconto Campanha - Política de Descontos

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

| codigoColecao | String | 255  | Código da coleção |

| segmento | String | 255  | Segmento |

| codigoRepresentante  | String | 255  | Código do representante |

| codigoRegional | String | 255  | Código da região |

| desconto | Double | 255  | Desconto |

| nivelDesconto | Integer | 255  | Nível do desconto |

Lista de Parâmetros:

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

| codigoRepresentante | :p1     | String   | 255         | Usado para trazer os dados relacionados ao representante que está escrevendo o pedido |

| codigoRegional | :p2     | String   | 255         | Usado para trazer os dados relacionados ao representante que está escrevendo o pedido |

h2. Desconto linha de produto - Política de Descontos

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

| codigoCliente | String | 255  | Código do cliente que receberá descoto |

| codigoLinhaProduto | String | 255  | Código da linha de produto |

| codigoColecao | String | 255  | Código da coleção da tabela de preços do pedido |

| codigoSegmento | String | 255  | Código do segmento da tabela de preços do pedido |

| quantidadeInicial  | String | 255  | Quantidade incial de peças |

| quantidadeFinal | String | 255  | Quantidade final de peças |

| valorDesconto | Double | 255  | Valor a ser descontado do produto |

| flagFaixaPadrao | Integer | 255  | Indicador se a faixa é padrão. 0 - Não / 1 - Sim |

Lista de Parâmetros:

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

| codigoRepresentante | :p1     | String   | 255         | Código do representante que será filtrado |

h2. Tabela de Preço - Política - Preços por volume

Retornar a listagem dos produtos da tabela de preço do ERP.

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

| codTabela * | String/Integer   | 10         | Código da tabela de preços |

| codProduto *  | String/Integer   | 255        | Código do produto |

| codGrade *  | String/Integer   | 255        | Código da grade do produto |

| qtdMaxima *  | String/Integer   | 255        | Quantidade limite para aquela faixa de preço |

| preco *    | Double   |            | Preço |

| seqSortimento  | String/Integer   | 255        | SeqSortimento do produto, apenas usado quando utiliza configuração por sortimento |

| agrupador  | String | 255        | Agrupador para quando for usar preços por volume com grupo |

Lista de Parâmetros:

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

| codTabela | #TABATIVAS  | | | Filtro de código da Tabela de Preços |

h2. Tabela de Preço - Política - Desconto 13 (Segmento/Cond. Pagamento)

Desconto conforme Segmento do cliente ou conforme a condição de pagamento do pedido.

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

| codSegmento | String | 255  | *Obrigatório* quando por Segmento |

| codColecao | String | 255  | *Obrigatório* quando por Segmento |

| desconto | Double | | Valor do desconto |

h2. Tabela de Preço - Política - Depósitos por fornecedor

Relatório do depósito por Fornecedor.

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

| Fornecedor   | String   | 255        | *Obrigatório* Codigo do Fornecedor |

| Empresa      | String   | 255        | Código da Empresa                  |

| Site         | String   | 255        | Código do Site                     |

| Depósito     | String   | 255        | Código da Depósito                 |

| Localização  | String   | 255        | Código da Localizaçã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ços no ERP |

h2. Títulos Em Aberto

Retornar a listagem de títulos (duplicatas) que estão em aberto para os cliente do representante.

*Atenção! Para que o cliente seja impedido de fazer pedidos por possuir títulos vencidos, independente do representante, deve-se retornar o título para todos os representantes da carteira do cliente e não o representante do título.*

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

| titulo * | String/Integer   | 255         | Chave única do título no ERP |

| notaFiscal  | String/Integer   | 255        | Número da nota fiscal ou documento |

| dataEmissao  | Date   |         | Data de Emissão do título |

| dataVecto  | Date   |         | Data de Vencimento do título |

| valor    | Double   |            | Valor do título em aberto |

| nomePortador  | String/Integer   | 255        | Nome/Descrição do portador |

| codCliente  | String/Integer   | 255        | Código do cliente |

| nomeCliente  | String/Integer   | 255        | Nome do cliente |

| codgrupocliente   | String/Integer   | 255        | Código do grupo do cliente |

| moeda | String/Integer   | 255        | Moeda (O padrão é R$, deixar null) |

| nomeFantasiaCliente | String | 255        | Nome fantasia do cliente |

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 do cliente no ERP (Trazer o representante da carteira e não do título) |

| codCliente (opcional) | :p3    | String/Integer   | 255         | Código do cliente no ERP |

| dataReferencia (opcional) | :p4     | Date   |         | Data de referência para títulos |

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| Integer   |         | Condição de Parcelamento EX:30/60/90 |

| Acrescimo | Double |         | Percentual de acréscimo da condição (Apenas alimentício |

| Desconto | Double   |         | Percentual de desconto concedido pela condição ao pedido |

Lista de Parâmetros:

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

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

h2. Cota de estoque - Por representante

Retorna a listagem da Cota de Estoque por Representante

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

| codigoEmpresa | String | 255 | Código da empresa no ERP |

| codigoRepresentante| String | 255 | Código do Representante |

| codReferencia | String | 255 |  Código da Referência no ERP |

| codTamanho | String | 255 | Descrição do tamanho no ERP (Ex: "P") |

| seqTamanho | String | 255 | Código do tamanho na grade no ERP |

| codGrade | String | 255 | Código da grade de produto no ERP |

| seqSortimento | String | 255 | Sequência de Sortimento |

| nomeSortimento | String | 255 | Descrição do Sortimento |

| quantidade | Double |  | Quantidade |

h2. Tipo de Nota

Retorna a listagem de Tipos de Nota do ERP.

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

| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |

| codTipo *  | String/Integer   | 255        | Código do tipo de nota no ERP |

| nome         | String   | 255        | Nome/descrição do tipo de nota |

| classificacao | Integer | | Classificação: 1 - Venda, 2 - Bonificação, 3 - Consumo Próprio, 4 - Devolução |

Lista de Parâmetros:

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

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

h2. Tipo de Cobrança

Retorna a listagem de Tipos de Cobrança do ERP.

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

| codTipo *  | String/Integer   | 255        | Código do tipo de cobrança no ERP |

| nome         | String   | 255        | Nome/descrição do tipo de cobrança |

| situacaoPagamento | String   | 255        | Situação de pagamento a ser enviada na integração do pedido |

Lista de Parâmetros:

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

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

h2. Comissões

Retorna informações de comissão para o representante filtrado.

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

| tipo * | Integer   |          | Tipo de comissão: 1 - No Faturamento, 2 - Na Liquidação |

| dataReferencia *  | Date   |         | Data de referência da comissão |

| codTitulo *        | String   | 255        | Título de referência da comissão. Sugestão: no caso do tipo 1 trazer o número da nota fiscal, no caso do tipo 2 trazer o número do título |

| codCliente | String | 255 | Código do cliente relacionado a comissão |

| nomeCliente | String | 255 | Código do cliente relacionado a comissão |

| baseComissaoLiq | Double |  | Valor base líquido usado no cálculo da comissão |

| valorComissaoLiq | Double |  | Valor líquido da comissão |

| codNota | String | 255 | Código da Nota relacionado a comissão |

| pedidos | String | 255 | Lista de pedidos separado por virgula relacionados a comissão |

| percBaseComissao | Double |  | Percentual base |

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 |

| dataReferencia | :p3     | Date   |          | Data de Referência - utilizar sinal de (>=) maior igual |

h2. Comissões - Extrato Resumo

Retornar de forma resumida os resultados dos meses de comissões

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

| anoMes | Integer | 6| Ano/mês de referencia ex:  201708 |

| flagMesFechado | Integer | 1 | Identificador para a situação do mês (0 - Em Aberto(Box Amarelo) / 1 - Fechado (Box Verde) |

| valorIRF | Double |  | Valor de IR Total |

| valorComissao | Double | | Valor da Comissão |

| valorNotaFiscal | Double | | Valor da Nota Fiscal |

| valorLiquido | Double | | Valor Liquido Total de Comissão |

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 |

| anoMesReferencia | :p3     | Integer   | 255         | Ano Mes Referencia para retornar apenas os últimos 6 meses (ex: 201801) |

| anoMes           | :p4     | String   | 255         | Ano Mes Referencia necessário para que o total dos lançamentos seja baseado no resumo. (Incluir or is null) |

h2. Comissões - Extrato Detalhado

Retornar de extrato detalhado das comissões

Os 5 primeiros campos, são os mesmos retornados na Integração Anterior, os valores deles são referentes ao total do periodo

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

| anoMes | Integer | 6| Ano/mês de referencia ex:  201708 |

| flagMesFechado | Integer | 1 | Identificador para a situação do mês (0 - Em Aberto(Box Amarelo) / 1 - Fechado (Box Verde) |

| valorIRF | Double |  | Valor de IR Total |

| valorComissao | Double | | Valor da Comissão |

| valorNotaFiscal | Double | | Valor da Nota Fiscal |

| dataLcto | Date | | Data do registro |

| lancamento | Integer  | | Identificador do registro (usado para ordenação) |

| notaFiscal | String | 255 | Número da Nota Fiscal |

| cliente | String | 255 | Nome do Cliente |

| baseComissao | Double | | Valor base para calculo da comissão |

| percBaseComissao| Double | | Percentual Base Cálculo comissão |

| percComiss | Double | | Percentual de comissão |

| valorCredito | Double | | Valor para credito |

| valorDebito | Double | | Valor para debito |

| titulo | String | 255 | Titulo  que originou o lançamento |

| pedido | String | 255 | Pedido que originou o lançamento |

| observacao | String | 255 | Historico ou Descrição do lançamento |

| parcelas | String | 255 | Informação de parcelas do título |

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 |

| anoMes | :p3     | Integer   | 255         | Ano Mes Referencia (ex: 201801) |

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 | flagConsumidorFinal * | Integer | | Consumidor final: 0 - Não, 1 - Sim (não pode ser nulo) |

|_.19 | cobrancaEmail | String | 255 | Endereço de e-mail de cobrança do cliente |

|_.20 | cobrancaContato | String | 255 | Nome da pessoal de contato de cobrança do cliente |

|_.21 | cobrancaTelefone | String | 255 | Telefone da pessoal de contato de cobrança do cliente | 

|_.22 | comprasEmail | String | 255 | Endereço de e-mail de compras do cliente | 

|_.23 | comprasContato | String | 255 | Nome da pessoal de contato de compras do cliente |

|_.24 | comprasTelefone | String | 255 | Telefone da pessoal de contato de compras do cliente | 

|_.25 | avaliacaoRepres | Text |  | (opcional) Observação de avaliação do representante sobre o cliente (somente informação digitada pelo representante) | 

|_.26 | celular | String | 255 | Telefone Celular de contato do cliente |

|_.27 | fax | String | 255 | Celular de contato do cliente |

|_.28 | flagClienteFiel | Integer | | Cliente Fiel/Especial: 0 - Não, 1 - Sim |

|_.29 | endComplemento | String | 255 | Complemento do Endereço | 

|_.30 | dataUltimaCompra | Date | | Data da ultima compra do cliente | 

|_.31 | codTransportadora | String | 255 | Código da transportadora do cliente | 

|_.32 | codCondPagto | String | 255 | Código da condição de pagamento do cliente |

|_.33 | flagSimplesNacional | Integer| | Cliente faz parte do Simples Nacional: 0 - Não, 1 - Sim | 

|_.34 | codTabPreco | String | 255 | Código da tabela de preço do cliente |  

|_.35 | percDesconto | Double | | % Desconto curva ABC (Obrigatoriamente colocar o filtro de codCliente no WHERE)   |

|_.36 | codGerente | String | 255 | Código do Gerente/Supervisor do representante do cliente. |

|_.37 | inscricaoMunicipal | String | 255 | Inscrição municipal do cliente |

|_.38 | codRamoAtividade | String | 255 | Código do ramo de atividade do cliente. |

|_.39 | codGrupoCliente | String | 255 | Código do grupo de cliente. |

|_.40 | dataFundacao | String | 255 | Data de fundação do cliente. |

|_.41 | limiteCredito | Double | | Limite de crédito do cliente. |

|_.42 | limiteCreditoDisponivel | Double | | Limite de crédito disponível. |

|_.43 | percDescontoGrupo | Double | | Percentual de desconto do grupo comercial. |

|_.44 | classificacaoCurva | String | | Classificação da Curva. |

|_.45 | obs | String | | Observação do Cliente (Para recuperar facebook,instagram TI Empresarial). |

|_.46 | listCodRepres *(Passar sempre null)*| String | | Lista de representantes do cliente. (Opcional) |

|_.47 | midiasSociais | String | | Midias sociais (facebook, instagram) da Sisplan separadas por ||. |

|_.48 | msgDashboard | String | | Mensagem dashboard. |

|_.49 | latitude | Double | | latitude. |

|_.50 | longitude | Double | | longitude. |

|_.51 | latitudeISF | Double | | latitudeISF. |

|_.52 | longitudeISF | Double | | longitudeISF. |

|_.53 | atualizadoCoordPor | String | | atualizadoCoordPor. |

|_.54 | cfop | Double | | CFOP Cliente. |

|_.55 | codTranspRedespacho | String | | Código de transportadora de redespacho. |

|_.56 | codPortador | String | 255 | Código do portador. |

|_.57 | codTipoCob | String | 255 | Código do tipo de cobrança. |

|_.58 | valorPedidosEmAberto | Double | | Valor do pedido em aberto. |

|_.59 | valorTitulosEmAberto | Double | | Valor dos títulos em aberto. |

|_.60 | codGrupoCliente | String | 255 | Código do grupo do cliente. |

|_.61 | codTipoFatur | String | 255 | Código do tipo de faturamento. |

|_.62 | instagram | String | 255 | Instagram. |

|_.63 | facebook | String | 255 | Facebook. |

|_.64 | validarCamposCustomizados | Integer | | Flag para validar campos customizados. |

|_.65 | lembreteAprovacaoPedido | String | 255 | Lembrete de aprovação do pedido. |

|_.66 | grupoClienteCalculoST | String | 255 | Código do grupo de substituição tributária do cliente. |

|_.67 | somenteTriangulacao | String | 255 | Cliente somente triangulação |

|_.68 | possuiGrupoFiscal | String | 255 | Cliente possui grupo fiscal |

|_.69 | origemCliente | String | 255 | Origem do cliente |

|_.70 | marcas | String | 255 | Marcas do cliente (em conjunto com SQL Marcas) |

|_.71 | concorrentes | String | 255 | Concorrentes das marcas do cliente (em conjunto com SQL Marcas Concorrentes) |

|_.72 | logradouro | String | 255 | Terreno ou espaço em anexo da habitação (ex: rua, avenida) |

|_.73 | tipoCliente | String | 255 | Tipo de cliente, utilizado para o cadastro de brindes (Obj) |

|_.74 | mediaDiasAtrasoPagamento | Integer |  | Quantidade média de dias de atraso de pagamento |

|_.75 | pedidoParcial | Integer | | Priorizar informação do pedido do cliente como pedido parcial |

|_.76 | antecipacaoPedido | Integer | | Priorizar informação do pedido do cliente como antecipação de pedido |

|_.77 | dataFaturamento | String | 255 | Data de faturamento |

|_.77 | dataBloqueioPedido | String | 255 | Data de bloqueio do pedido |

|_.78 | percDescontoVisual1 | Double | | (opcional - enviar null) Percentual de desconto visual 1 |

|_.79 | percDescontoVisual2 | Double | | (opcional - enviar null) Percentual de desconto visual 2 |

|_.80 | situacaoAnaliseCredito | Integer | | (opcional - enviar null) Estatus do ultimo pedido de reanalise de credito |

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. Clientes - Campos Customizados

Retornar as informações dos Campos Customizados por Cliente

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

| codCliente * | String | 255 | Cod do Cliente |

| cnpj | String | 255 | CNPJ ou CPF do cliente (formatado) |

| idCampoCustomizado | String | 255 | Id do campo Customizado Criado no FV |

| valorCampoCustomizado | String | 255 | Valor que vai retornar no Campo. |

Lista de Parâmetros:

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

| codEmpresa | :p1     | String/Integer   | 10         | Código da Empresa |

| codRepres | :p2     | String/Integer   | 10         | Código do Representante |

| codRepres | :p3     | String/Integer   | 10         | CNPJ Formatado |

| codRepres | :p4     | String/Integer   | 10         | CNPJ Desformatado |

h2. Clientes - Locais de Entrega

Retornar a listagem de locais de entrega de um cliente.

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

| cnpj * | String | 255 | CNPJ ou CPF do cliente (formatado) |

| seqEntrega | String | 255 | Identificador único para o local de entrega |

| descricao | String | 255 | Descrição sobre o local de entrega |

| cep | String | 255 | CEP do local de entrega (somente números) |

| endereco | String | 255 | Endereço do local de entrega |

| numero | String | 255 | Número do endereço do local de entrega |

| complemento | String | 255 | Complemento do local de entrega |

| bairro | String | 255 | Bairro do local de entrega |

| codIBGE | String | 255 | Código IBGE do local de entrega |

| telefone | String | 255 | Telefone do local de entrega |

| celular | String | 255 | Telefone Celular do local de entrega |

| inscEstadual | String | 255 | Inscrição estadual do local de entrega |

Lista de Parâmetros:

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

| codEmpresa * | :p1     | String/Integer   | 10         | Código da empresa no ERP |

| cnpj * | :p2     | String   | 255         | CNPJ do cliente no ERP |

h2. Clientes - Ramos de Atividade

Retornar a listagem de ramos de atividade.

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

| codigo * | String | 255 | Código do ramo de atividade |

| descricao | String | 255 | Descrição do ramo de atividade |

| flagSituacao | Integer | | Situação do ramo de atividade no ERP (0 - Inativo, 1 - Ativo) | 

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 - Grupos de Cliente

Retornar a listagem de grupos de cliente.

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

| codigo * | String | 255 | Código do grupo |

| descricao | String | 255 | Descrição do grupo |

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 - Condições de venda

Retornar a listagem de grupos de cliente.

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

| codCondPagto * | String | 255 | Código da condição de pagamento |

| codCliente | String | 255 | Código do cliente |

| libEmpresa | Integer | 10 | Situação da condição de pagamento (0 - inativo / 1 - ativo) |

Lista de Parâmetros:

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

| Código do cliente| :p2 | | | Filtro de código do cliente |

h2. Clientes - Marcas

Retornar a listagem de marcas 

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

| codMarca * | String | 255 | Código da marca |

| descricao * | String | 255 | Descrição da marca |

h2. Clientes - Marcas Concorrentes

Retornar a listagem de marcas concorrentes

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

| codMarca * | String | 255 | Código da marca |

| codConcorrente * | String | 255 | Código da concorrente da marca |

| descricaoConcorrente * | String | 255 | Descrição da concorrente |

h2. Marcas por Cidade

Deve retornar uma lista com as faixas de política para o *Filtro de marca do produto por cidade do cliente*

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

| codEmpresa * | String | 255 | Código da empresa. Campo usado apenas para manter o padrão. |

| codIBGE * | String | 255 | Código do IBGE que a marca deve estar liberada para venda. |

| codMarca * | String | 255 | Código da marca liberada para venda no IBGE do registro. |

Lista de Parâmetros:

|_. Campo           |_. Parâmetro      |_. Obrigatório |_. Tipo   |_. Descrição |

| codEmpresa        | :p1              | *Não*         | String/Integer   | Código da empresa. Campo usado apenas para manter o padrão. *Não precisa ser informado* |

| codRepresentante  | :p2              | *Sim*         | String | Código do representante, usado para filtrar as fixas |

| codIBGE           | :p3              | *Não*         | String | Código do IBGE que sendo filtrado. Deve ser considerado que esse filtro pode ser passado como null e nesse caso deve ser tratado (c.campo = :p3 OR :p3 IS NULL). |

h2. Clientes - Contatos - Departamento

Retornar a listagem de marcas concorrentes

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

| codigo * | String | 255 | Código do departamento |

| descricao * | String | 255 | Descrição do departamento |

Lista de Parâmetros:

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

| codEmpresa | :p1     | String/Integer   | 10         | Código da Empresa |

h2. Produtos - Prioridade de linha para distribuição

Retorna uma listagem de prioridades por data e linha. *Configuração exclusiva de cliente*

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

| codigo_linha | String | | Código da linha do produto. |

| data_prioridade | Date | | Data que deve ser usada para prioridade. |

| prioridade | Int | | Prioridade que será usada para distribuição dos itens |

h2. Produtos - Gold Be

Retornar a listagem de produtos Gold Be

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

| codProduto | String | | |

| descReferencia | String | | |

| codCaixaMatriz | String | | |

| codCaixa | String | | |

| codGrade | String | | |

| codTamanho | String | | |

| seqTamanho | String | | |

| ordemTamanho | String | | |

| gradePalito | String | | |

| seqSortimento | String | | |

| codSortimento | String | | |

Lista de Parâmetros:

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

| codTabela | #TABATIVAS  | | | Filtro de código da Tabela de Preços |

h2. Produtos

Retornar a listagem de produtos ATIVOS filtrando coleção.

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

|_.1 | codReferencia * | String/Integer   | 255 | Código da Referência no ERP |

|_.2 | descricao | String | 255 | Descrição da referência |

|_.3 | codEtiqueta | String | 255 | Código da Etiqueta (ou Marca) da referência. Consultar a GEOvendas sobre o que trazer neste campo. |

|_.4 | nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a GEOvendas sobre o que trazer neste campo. |

|_.5 | codLinha | String | 255 | Código da Linha de Produto da referência. |

|_.6 | nomeLinha | String | 255 | Nome da Linha de Produto da referência. |

|_.7 | codTipoPeca | String | 255 | Código do Tipo de Peça da referência. Consultar a GEOvendas sobre o que trazer neste campo. |

|_.8 | nomeTpoPeca | String | 255 | Nome do Tipo de Peça da referência. Consultar a GEOvendas sobre o que trazer neste campo. |

|_.9 | codTipoModelo | String | 255 | Código do Tipo Modelo da referência. Consultar a GEOvendas sobre o que trazer neste campo. |

|_.10 | nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a GEOvendas sobre o que trazer neste campo. |

|_.11 | opcoesVenda | String | 255 | (opcional) Opções de venda separadas por virgula, depende de como a empresa trabalha. ex: '6,12' |

|_.12 | codReferProvisoria | String | 255 | Código da referencia provisória, caso não exista, retornar a própria codReferencia |

|_.13 | flagSortimentoCor | Integer |  | Referencia permite sortimento por cor. 0 - Não, 1 - Sim |

|_.14 | flagEstoqueLimitado | Integer |  | Referencia é vendida apenas sob disponibilidade, é sobreescrito pela integração de estoque. 0 - Não, 1 - Sim |

|_.15 | flagSortimentoCorTamanho | Integer | | Referencia permite sortimento por cor/tamanho (grade aberta). 0 - Não, 1 - Sim |

|_.16 | flagSortimentoAutomatico | Integer | | Referencia permite sortimento automático. 0 - Não, 1 - Sim |

|_.17 | aliquotaIpi | Double | | Percentual de IPI que deve ser aplicado a referencia. ex: 10 |

|_.18 | flagNaoAplicaDesconto | Integer | | Indicar se o desconto NÃO deve ser aplicado a referencia. 0 - Não, 1 - Sim |

|_.19 | codColecao | String | 255 | Codigo da coleção do produto |

|_.20 | qtdeQuilosPadrao | Double | | Utilizado quando Malharia, qtde. de kilos por quantidade, determina quantos quilos tem uma unidade da peça |

|_.21 | cubagem | Double | | |

|_.22 | nomeColecao | String | 255 | Nome da coleção do produto, utilizado inicialmente no filtro por coleção para clientes com seleção agrupada (La Playa) |

|_.23 | estacaoColecao  | String | 255 | Estação do ano do produto |

|_.24 | codFamilia  | String | 255 | Código da família do produto |

|_.25 | nomeFamilia  | String | 255 | Nome da família do produto |

|_.26 | divisorLote  | String | 255 | (Opcional) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.27 | divisorBrinde  | String | 255 | (Opcional) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.28 | codReferImagem  | String | 255 | Codigo do produto para chave das imagens |

|_.29 | agrupadorEstoqueData  | String | 255 | (Opcional) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.30 | codMarca  | String | 255 | Codigo da marca do produto |

|_.31 | nomeMarca  | String | 255 | Nome da marca do produto |

|_.32 | peso  | Double | 255 | Peso do produto |

|_.33 | codArtigoPai  | String | 255 | Código do Artigo Pai |

|_.34 | flagGradeFechada  | Integer | 1 | Flag para dizer se a grade é fechada ou não |

|_.35 | -codReferenciaCorTamanho- | String | 255 | (DESCONTINUADO) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.36 | dataLimiteFatur | Date | | (Opcional) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.37 | qtdDiasMinFaturamento | Integer | | (Opcional) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.38 | dataVencimentoProduto| Date| | (Opcional) Data de vencimento do produto (apenas para mostrar na listagem). |

|_.39 | especificacoesTecnicas| String | 255 | (Opcional) Dados/Especificações/Descrição do produto |

|_.40 | codGenero| String | 255 | (Opcional) Informação de gênero do produto p/ ser utilizado como filtro |

|_.41 | nomeGenero| String | 255 | (Opcional) Informação de gênero do produto p/ ser utilizado como filtro |

|_.42 | composicaoProduto | String | 255 | (Opcional) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.43 | descricaoPesquisa | String | 255 | (Opcional) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.44 | flagReferenciaCalcadista | Integer | | (Opcional) Campo específico para empresas que trabalham no modelo confecção e calçadista. 0 - Não, 1 - Sim |

|_.45 | dataEntrega | Date | | (Opcional) Data de entrega do produto, usado com funcionalidade especifica |

|_.46 | grupoProdutoCalculoST | String | | Código do grupo de substituição tributária do produto |

|_.47 | flagMultiplicadorUnico | Integer| | Define se o produto deve utilizar a mesma quantidade de multiplicação na grade fechada |

|_.48 | qtdeMinimaPorGrade | Integer| | Opera apenas quando grade fechada distribuição baseado no percentual da SKU |

|_.49 | modeloGradeFechada | Integer| | O modelo que o produto irá seguir para a grade fechada (Customização especifica). |

|_.50 | origemProduto | Integer| | Determina se o produto tem origem nacional ou internacional |

|_.51 | flagProdutoCombo | Integer | | Indica se o produto na verdade é um combo ou não (Alimentício) |

|_.52 | nomeDivisorLote | Sting | 255 | (Opcional) Consultar a GEOvendas sobre o que trazer neste campo. |

|_.53 | descricaoTipoEstoque | Sting | 255 | Descrição do tipo de estoque. |

|_.54 | multiploPorCor | Integer | 255 | Quantidade múltipla por cor que deve ser respeitada pelo Força de Vendas. |

|_.55 | codTipoEstoque | Sting | 255 | Código do tipo de estoque. |

|_.56 | codTecido | Sting | 255 | Código do tecido. |

|_.57 | nomeTecido | Sting | 255 | Nome do tecido. |

|_.58 | codAgrupador | Sting | 255 | Código do agrupador do produto (funcionalidade especifica). |

|_.59 | codSegmento | Sting | 255 | Código do segmento do produto. |

|_.60 | descSegmento | Sting | 255 | Descrição do segmento 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 |

| codReferencia | :p2     | String   | 255         | Código da referência no ERP |

| codColecao | #COLECOES | | | Qualificar no WHERE como IN (#COLECOES) OR (#COLECOESNULL IS NULL) |

| codTabelaPreco | #TABPRECOS | | | Qualificar no WHERE como IN (#TABPRECOS)  OR (#TABPRECOSNULL IS NULL) |

| codReferencia | #REFERENCIAS | | | Qualificar no WHERE como IN (#REFERENCIAS) OR (#REFERSNULL IS NULL) |

| codLinha | #LINHAS | | | Qualificar no WHERE como IN (#LINHAS) OR (#LINHASNULL IS NULL) |

| codGenero | #GENERO | | | Qualificar no WHERE como IN (#GENERO) OR (#GENERONULL IS NULL) |

| codEtiqueta | #ETIQUETAS | | | Qualificar no WHERE como IN (#ETIQUETAS) OR (#ETIQUETASNULL IS NULL) |

| codTipoModelo | #MODELOS | | | Qualificar no WHERE como IN (#MODELOS) OR (#MODELOSNULL IS NULL) |

| codTipoPeca | #TIPOS | | | Qualificar no WHERE como IN (#TIPOS) OR (#TIPOSNULL IS NULL) |

| codMarca | #MARCAS | | | Qualificar no WHERE como IN (#MARCAS) OR (#MARCASNULL IS NULL) |

| codCatalogo | #CATALOGOS | | | Qualificar no WHERE como IN (#CATALOGOS) OR (#CATALOGOSNULL IS NULL) |

| codGrade | #GRADES | | | Qualificar no WHERE como IN (#GRADES) OR (#GRADESNULL IS NULL) |

| codRepres | :p5    | String   | 255         | Utilizada para filtrar um representante nos produtos para digitação online, obrigatório ":p5 or :p5 is null" |

h2. Produtos - Grades

Retornar a listagem das grades ATIVAS dos produtos filtrando coleção.

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

| codReferencia * | String/Integer   | 255 | Código da Referência no ERP |

| codGrade * | String/Integer   | 255 | Código da Grade no ERP |

| seqTamanho * | String | 255  | Código do tamanho na grade no ERP |

| seqOrdenacao * | Integer |  | Sequencia de ordenação do tamanho na grade |

| codTamanho * | String | 255 | Descrição do tamanho no ERP (Ex: "P") |

| qtdPalito | Integer | | Quantidade de peças para grade palito, por padrão é 1. NÃO PODE SER NULO. |

| itemAtivoLido | Integer |  | Indicador se item ativo, caso não informado, por padrão 1 (ativo) |

| descricao | String | 255  | Descrição da grade no ERP |

| percPalito | Double |  | Percentual de distribuição por tamanho |

| flagLiberadoDivisorGradeFechada | String | 255  | Indica se produto pode ou não ser editado quando distribuição por percentual de tamanho |

Lista de Parâmetros:

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

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

| codReferencia | :p2     | String   | 255         | Código da referência no ERP |

| codColecao | #COLECOES | | | Qualificar no WHERE como IN (#COLECOES) OR (#COLECOESNULL IS NULL) |

| codTabelaPreco | #TABPRECOS | | | Qualificar no WHERE como IN (#TABPRECOS)  OR (#TABPRECOSNULL IS NULL) |

| codRepres | :p5    | String   | 255         | Utilizada para filtrar um representante nos produtos para digitação online, obrigatório ":p5 or :p5 is null" |

h2. Produtos - Sortimentos

Retornar a listagem dos sortimentos ATIVOS dos produtos filtrando coleção.

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

| codReferencia * | String/Integer   | 255 | Código da Referência no ERP |

| codSortimento * | String/Integer   | 255 | Código do Sortimento no ERP |

| descricao | String | 255 | Descrição do sortimento no ERP |

| codCorBase | String | 255 | Código da cor comercial (usada no catalogo e no cod. cor do força de vendas)  |

| rgb | String | 255 | Valor hexadecial ou RGB da cor para amostra ao representante |

| loteEntrega | String | 255 | Lote de Entrega padrão do sortimento |

| itemAtivo | Integer | 1 | Situação do Item (0 - Inativo, 1 - Ativo) |

| percentualSortimento | Double |  | Percentual de sortimento |

| flagEstoqueLimitado | Integer | 1 | Estoque limitado (0 - Não, 1 - Sim) |

| divisorLote | String | 255 | Código de divisor usado para divisão de pedido *(Customização especifica)* |

| nomeDivisorLote | String | 255 | Nome de divisor usado para divisão de pedido *(Customização especifica)* |

| seqOrdenacao| Integer | | Sequencia de ordenação das cores no produto. Caso não informado será gerado um incremental pela ordem de inserção |

| contaFornecedor | String | 255 | Conta do fornecedor do depósito *(Customização especifica)* |

Lista de Parâmetros:

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

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

| codReferencia | :p2     | String   | 255         | Código da referência no ERP |

| codColecao | #COLECOES | | | Qualificar no WHERE como IN (#COLECOES) OR (#COLECOESNULL IS NULL) |

| codTabelaPreco | #TABPRECOS | | | Qualificar no WHERE como IN (#TABPRECOS)  OR (#TABPRECOSNULL IS NULL) |

| codRepres | :p5    | String   | 255         | Utilizada para filtrar um representante nos produtos para digitação online, obrigatório ":p5 or :p5 is null" |

h2. Produtos - Etiquetas

Retornar a listagem das etiquetas ATIVAS dos produtos

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

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

| nome | String   | 255 | Nome da etiqueta |

Lista de Parâmetros:

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

| codEtiqueta | :p2     | String   | 255 | classificar no WHERE como = :p2 OR :p2 IS NULL |

| codEtiqueta | :p3     | String   | 255 | classificar no WHERE como LIKE :p3 |

h2. Produtos - Linhas

Retornar a listagem das linhas ATIVAS dos produtos

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

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

| nome | String   | 255 | Nome da linha |

Lista de Parâmetros:

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

| codLinha | :p2     | String   | 255 | classificar no WHERE como = :p2 OR :p2 IS NULL |

| codLinha | :p3     | String   | 255 | classificar no WHERE como LIKE :p3 |

h2. Produtos - Tipos

Retornar a listagem dos tipos ATIVOS dos produtos

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

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

| nome | String   | 255 | Nome do tipo peça |

Lista de Parâmetros:

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

| codTipoPeca | :p2     | String   | 255 | classificar no WHERE como = :p2 OR :p2 IS NULL |

| codTipoPeca | :p3     | String   | 255 | classificar no WHERE como LIKE :p3 |

h2. Produtos - Modelos

Retornar a listagem dos modelos ATIVOS dos produtos

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

| codTipoModelo | String   | 255 | Código do tipo modelo |

| nome | String   | 255 | Nome do tipo modelo |

Lista de Parâmetros:

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

| codTipoModelo | :p2     | String   | 255 | classificar no WHERE como = :p2 OR :p2 IS NULL |

| codTipoModelo | :p3     | String   | 255 | classificar no WHERE como LIKE :p3 |

h2. Produtos - Gênero

Retornar a listagem dos gêneros ATIVOS dos produtos

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

| codGenero | String   | 255 | Código gênero |

| nome | String   | 255 | Nome do Gênero |

Lista de Parâmetros:

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

| codGenero | :p2     | String   | 255 | classificar no WHERE como = :p2 OR :p2 IS NULL |

| codGenero | :p3     | String   | 255 | classificar no WHERE como LIKE :p3 |

h2. Produtos Skus

Consulta de produtos SKUs utilizada internamente pela GEOvendas

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

| codReferencia * | String/Integer   | 255 | Código da Referência |

| seqTamanho* | String/Integer   | 255 | Sequencia do tamanho                |

| seqSortimento | String | 255 | Sequência de Sortimento                 |

| codigoReduzido | String | 255 | Código reduzido / Codigo do sku |

| percPalito      | Double | 255 | Percentual da grade palito |

| ean      | String | 255 | Sequência numérica do código de barras |

| ncm      | String | 255 | Nomenclatura que identifica códigos de oito dígitos para produtos diversos |

| divisorPedido      | String | 255 | Propriedade específica utilizada em alguns clientes para divisão de pedidos (Ainda não commitado) |

h2. Produto - EAN13

Essa integração deve retornar os codigos de EANs dos produtos disponiveis para venda.

A informação disponibilizada sera utilizada que o usuario seja capaz digitar um pedido utilizando um leitor de codigos de barra + as etiquetas dos mostruarios que ele possui consigo, sendo assim, pode-se retornar aqui apenas os SKUs que foram enviados como mostruario. Dessa maneira, a importação dos dados da view não ficara lenta.

Exceções a esta determinação, devem ser alinhadas com a equipe da GeoVendas

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

| codReferencia * | String/Integer   | 255 | Código da Referência no ERP |

| EAN * | String/Integer   | 255 | Código de Barras (EAN)                |

| seqSortimento | String | 255 | Sequência de Sortimento                 |

| seqTamanho    | String | 255 | Sequência de Tamanho                    |

| nomeRef       | String | 255 | Nome da Referência                      |

| nomeSort      | String | 255 | Nome do Sortimento                      |

Lista de Parâmetros:

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

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

| codColecao | #COLECOES  | | | Qualificar no WHERE como IN |

| codTabPreco | #TABPRECOS | | | Qualificar no WHERE como IN |

| codReferencia | #REFERENCIAS OR  #REFERSNULL IS NULL | | | Qualificar no WHERE como IN |

| codEan | #EANS | | | Qualificar no WHERE como IN (NÃO UTILIZAR, DESCONSIDERAR ESTE FILTRO)|

h2. Produtos - Parte Cima Parte Baixo

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

| codReferencia1 * | String/Integer   | 255 | Código da Referência no ERP Parte de cima|            

| seqTamanho1    | String | 255 | Sequência de Tamanho Parte de Cima    |

| seqSortimento1 | String | 255 | Sequência de Sortimento Parte de Cima                 |

| codReferencia2 * | String/Integer   | 255 | Código da Referência no ERP Parte de Baixo |             

| seqTamanho2    | String | 255 | Sequência de Tamanho Parte de Baixo|

| seqSortimento2 | String | 255 | Sequência de Sortimento  Parte de Baixo|

h2. Produto - Código Reduzido

Retornar o código reduzido para o produto (referência, cor e tamanho)

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

| codReduzido * | String/Integer   | 255 | Código reduzido do produto no ERP |

| seqTamanho * | String/Integer   | 255         | Código do tamanho no ERP |

| seqTamOrdenacao | Integer   |          | Sequencia de ordenação do tamanho no ERP |

| seqSortimento * | String/Integer   | 255         | Código da sortimento no ERP |

| seqSortOrdenacao | Integer   |          | Sequencia de ordenação do sortimento no ERP |

| codColecao | String/Integer   | 255         | Código da coleção da referencia 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 |

| codReferencia | :p2     | String/Integer   | 255         | Código da referência no ERP |

h2. Bloqueio de Referências

Retornar as referências bloqueadas no ERP.

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