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-Grupo-de-Cliente-DePara|Tabela de Preço Grupo de 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-Capa|Tabela de Preço - Política - Capa]] (opcional)

## [[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#Volume-Compra-Política-de-Descontos|Volume Compra - Política de Descontos]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Preço-por-volume|Tabela de Preço - Política - Preço 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-Valor-Mínimo-por-Regiao|Tabela de Preço - Política - Valor Mínimo por Regiao]] (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#Tabela-de-Preço-Política-Cliente-fiel|Tabela de Preço - Política - Cliente fiel]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Limite-de-desconto-item|Tabela de Preço - Política - Limite de desconto item]] (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#Desconto-item-por-ramo-atividade-e-marca-Política-de-Descontos|Desconto item por ramo atividade e marca - 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|Clientes - Contatos]](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-Keywords|Produtos - Keywords]]

## [[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-Detalhes-Grade-Calçadista|Produtos - Detalhes Modelo Calçadista]]

## [[Digitação de Pedidos#Produtos-Conceitos-Modelo-Calçadista|Produtos - Conceitos - Modelo Calçadista]]

## [[Digitação de Pedidos#Produtos-Política-Desconto-por-sortimento|Produtos - Política - Desconto por sortimento ]]

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

## [[Digitação de Pedidos#Produtos-Mídias-compartilháveis|Produtos - Mídias compartilháveis]] (opcional)

## [[Digitação de Pedidos#Produtos-Mídias-compartilháveis-Categorias|Produtos - Mídias compartilháveis - Categorias]] (opcional)

## [[Digitação de Pedidos#Produtos-Mídias-compartilháveis-Categorias-produtos|Produtos - Mídias compartilháveis - Categorias produtos]] (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-UUID|Pedido - UUID]]

## [[Digitação de Pedidos#Pedido-UUID-(Massa)|Pedido - UUID - (Massa)]]

## [[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)

## [[Digitação de Pedidos#Produtos - Política Data Limite|Produtos - Política Data Limite]] (opcional)

## [[Digitação de Pedidos#Conta corrente - Saldo flex por representante|Conta corrente - Saldo flex por representante]] (opcional)

## [[Digitação de Pedidos#Pedidos por data de Lote Fatur|Pedidos por data de Lote Fatur]] (opcional)

## [[Digitação de Pedidos#Clientes - Ficha - Capa e Critérios|Clientes - Ficha - Capa e Critérios]] (opcional)

## [[Digitação de Pedidos#Brindes por cota - Valor a desconsiderar|Brindes por cota - Valor a desconsiderar]] (opcional)

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

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

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

## [[Digitação de Pedidos#Produtos-Política-Desconto-DUN14-por-sortimento|Produtos - Política - Desconto DUN 14 por Sortimento ]]

## [[Digitação de Pedidos#Clientes-Tipo-Nota-Suframa|Clientes - Tipo Nota - Suframa]]

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.

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

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

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

|3| descricao         | String   | 255        | Descrição da tabela de preços |

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

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

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

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

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

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

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

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

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

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

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

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

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

|17| prazoMedio | Double| | Prazo Médio |

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

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

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

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

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

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

|24| codMarca| String | 255  | Código da marca do produto na configuração adicional da tabela de preço|

|25| diasAddEntrega| Integer |  | Dias a serem adicionados na entrega, utilizado apenas para feature flagCapacidadeProdutivaPorColecao |

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 |

| flagDescontoFidelidade   | Integer   | 255        | (Funcionalidade especifica) Indica se nessa tabela de preços o cliente recebe desconto fidelidade. |

| flagDescontoClienteNovo   | Integer   | 255        | (Funcionalidade especifica) Indica se nessa tabela de preços o cliente recebe desconto cliente novo. |

| codCondicaoPagamento   | String | 255        | (Funcionalidade especifica) Indica a condição de pagamento especifica para tabela de preços e cliente. |

| aceitaPedidoParcial   | Integer | 255        | (Funcionalidade especifica) Indica se pedido vai vir marcado com aceitaPedidoParcial ao selecionar tabela de preços. |

| aceitaAnteciparPedido | Integer | 255        | (Funcionalidade especifica) Indica se pedido vai vir marcado com aceitaAnteciparPedidoao selecionar 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 Grupo de Cliente De/Para

Carrega as tabelas de preço de acordo com a ligação delas com o grupo dos clientes.

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

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

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

| codGrupoCliente | String   | 255        | Código do grupo do cliente |

Lista de Parâmetros:

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

| grupos | :p1     | IN<String>   | 255         | Códigos dos grupos de clientes que serão filtrados |

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 |

| vlrUnitarioBonificado | Double | |  |

| vlrUnitarioSugestao| Double | | Valor unitário sugerido na digitaçã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 |

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

Carrega alguns valores da política de determinada tabela de preço

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

| percDesconto11 | Double | | |

| qtdDiasLeadTime | Integer | | |

| qtdeDiasFaturamento | Integer | | |

| qtdeDiasFaturamentoProntaEntrega | Integer | | |

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 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. Volume Compra - Política de Descontos

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

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

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

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

| 4 | valorInicial | Double |            | Valor Inicial|

| 5 | valorFinal | Double |            | Valor Final |

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

| 7 | desconto | Double | | Valor do desconto |

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

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

| 10 | DescontoComercialMinimo| Double | |  |

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

| 12 | codigoAgrupador | String | | |

| 13 | PercComissaoAdicional| String | | |

| 14 | DiasPrazoAdicional| Double |        | |

| 15 | DataVigenciaInicial| Double |        |  |

| 16 | DataVigenciaFinal| String | | |

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

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

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

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

| meta | Double | 255  | Valor da meta que o segmento deve atingir (desenvolvimento especifico) |

Lista de Parâmetros:

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

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

h2. Desconto item por ramo atividade e marca - Política de Descontos

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

| codMarca | String | 255  | Código de marca do produto |

| codRamoAtividade | String | 255  | Código do Ramo de Atividade do cliente |

| percDesconto | Double | 255  | % de desconto máximo permitido |

| percComissao | Double | 255  | % de comissão fixo aplicado ao item |

Lista de Parâmetros:

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

| codRamoAtividade | :p1     | String   | 255         | Código do ramo de atividade, por ser passado como null em alguns casos, então sempre fazer `ramo = :p1 OR :p1 IS NULL` |

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

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

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

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

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

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

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

| 5 | preco *    | Double   |            | Preço fixo da faixa|

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

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

| 8 | nomeGrade  | String | 255        | Nome da grade |

| 9 | flagSomenteGradeFechada  | Integer |         | Faixa pode ser aplicada somente se referência em grade fechada |

| 10 | flagNaoRecebeDescontoCapa  | Integer |        | Faixa não pode receber desconto de capa do pedido |

| 11 | percComissao | Double |  | Percentual de comissão |

| 12 | codTipoModelo | String |  | Tipo de modelo da peça |

| 13 | tipoPack | Integer |  | 10 - Quando for Pack / 20 - Quando for combo |

| 13 | seletorTabelaPreco | String |  | Tabela de preço específica para seleção de preço |

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 |

| cnpj (opcional) | :p5     | String   | 255         | CNPJ do cliente |

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 |

| flagAVista | Integer |         | Indica se a condição de pagamento é ou não `À Vista`. |

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, OBS se o cliente tem configurado quantidade de meses pra importar, pode ter apenas um p3, pois esse filtro é usado para importar as comissões pro FV |

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: 0- Inativo, 1 - Ativo, 3- Bloqueado (Mostra no FV), 999 - Limbo/Bloqueado (Não mostra no FV) |

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

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

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

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

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

|_.82 | percDescontoMaximo | Double | | (opcional - enviar null) Quando informado, o sistema barra os pedidos com percentual maior que o máximo |

|_.83 | dataValidadeSuframa | Date | | (opcional - enviar null) Data de validade do SUFRAMA do cliente. |

|_.84 | ufSigla | String | | (opcional - enviar null) UF do cliente. |

|_.85 | cadastroBloqueado | Integer | | (opcional - enviar null) Indica se o cliente tem o cadastro bloqueado ou não. |

|_.86 | nomeGrupoCliente | String | 255 | (opcional - enviar null) Quando o cliente quer apenas apresentar o grupo sem necessidade de integrar todos os grupos. |

|_.87 | flagVerbaEmMercadoria| String | 255 | (opcional - enviar null) |

|_.88 | flagVerbaEmDescontoDuplicata| String | 255 | (opcional - enviar null) |

|_.89 | flagEtiquetasPreco| String | 255 | (opcional - enviar null) |

|_.90 | flagEcommerce| String | 255 | (opcional - enviar null) |

|_.91 | dataVigenciaCredito| Date | | (opcional - enviar null) |

|_.92 | codRegiao| String| | (opcional - enviar null) |

|_.93 | flagCaixaEspecial | String | 255 | (opcional - enviar null) |

|_.94 | codConceito | String | 255 | Utilizado modelo calçadista grade fechada - Conceito do cliente para filtragem de produtos |

|_.95 | flagSemSuframa | Integer | 255 | Utilizado para informar se o cliente não tem suframa |

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

| dataAlteracao| Date| 255 | Data de alteração dos campos, caso não possua, colocar data atual para atualizar os registros na sincronização (pode ser que fique lenta a sincronização no fv)|

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 |

| codRepres | :p3     | String   | 255         | Código do representante 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                                                                      |

| przMedioPermitido | Double   | 255          | Prazo médio permitido para o grupo de cliente *(Quanto null não aplica)* *(Necessário ativar customização)* |

| percDesconto | Double | 255          | Percentual de desconto que será aplicado ao pedido *(Quanto null não aplica)* *(Necessário ativar customização)* |

| percComissao | Double | 255          | Percentual de comissão que será aplicado ao pedido *(Quanto null não aplica)* *(Necessário ativar customização)* |

| qtdMinima | Double | 255          | Quantidade mínima de peças que o grupo precisa comprar para pedido não ser enviado como bloqueado *(Quanto null não aplica)* *(Necessário ativar customização)* |

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         | —            | Código do representante                |

| codigoGrupo   | :p3         | String         | —            | Filtro pelo código do grupo de cliente |

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 |

| situacao* | Integer | 10 | Situação da liberacao da condição de pagamento para o cliente (0 - bloqueado / 1 - liberado) |

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

| codClassificacaoERP | String | 255 | Código da classificação envida para o ERP. |

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

Retornar a listagem dos contatos

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

| cnpjCliente * | String | 255 | CNPJ do cliente |

| codigo * | String | 255 | Código do contato no ERP |

| nome * | String | 255 | Nome do contato |

| departamento * | String | 255 | Departamento do contato |

| email * | String | 255 | E-mail do contato |

| telefone * | String | 255 | Telefone do contato |

| celular * | String | 255 | Celular do contato |

| uuid | String | 255 | uuid (código) uníco do contato do GEOvendas |

| dataUltimaAlteracao | Date | 255 | Data de ultima alteração |

| nomeDoMeio | Date | 255 | Nome do meio do contato |

| sobrenome | Date | 255 | Sobrenome do contato |

Lista de Parâmetros:

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

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

| cnpjSemFormatacao | :p2     | String   | 10         | CNPJ do cliente sem formatação |

| codRepresentante | :p3     | String   | 10         | Código do representante |

| cnpjFormatado | :p4     | String   | 10         | CNPJ do cliente formatado |

h2. Clientes - Contatos - Departamento

Retornar a listagem de departamentos dos contatos

|_. 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 - Mídias compartilháveis

Retorna todas as mídias que podem ser compartilhadas durante a funcionalidade de compartilhamento de mídia dos pedidos!

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

| Referência    | String   | Código da referêcia.                                          |       

| Sortimento    | String   | Código (sequencia) do sortimento.                             |       

| URL           | String   | URL para acessar a mídia.                                     | 

| Mídia principal | Integer  | Sinaliza se é a mídia principal (0 - Não / 1 - Sim)           |

| Tipo          | Integer  | Sinaliza o tipo de mídia (10 - Imagem / 20 - Vídeo MP4 / 30 - GIF) |

Lista de Parâmetros:

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

| coleção | :p1  | Código da coleção que será filtrada! |

h2. Produtos - Mídias compartilháveis - Categorias

Retorna todas as categorias e suas opções.

| **Campo**               | **Tipo** | **Descrição**                     |

| ----------------------- | -------- | --------------------------------- |

| Código da classificação | String   | Código da classificação.          |

| Nome da classificação   | String   | Nome/Descrição da classificação.  |

| Código da opção         | String   | Código da opção da classificação. |

| Nome da opção           | String   | Nome/Descrição da opção.          |

h2. Produtos - Mídias compartilháveis - Categorias produtos

Retorna todas as mídias que podem ser compartilhadas durante a funcionalidade de compartilhamento de mídia dos pedidos!

| **Campo**               | **Tipo** | **Descrição**                     |

| ----------------------- | -------- | --------------------------------- |

| Código da referência    | String   | Código da referência.             |

| Código da classificação | String   | Código da classificação.          |

| Código da opção         | String   | Código da opção da classificação. |

Lista de Parâmetros:

| **Campo**             | **Parâmetro**            | **Descrição**                                                                           |

| --------------------- | ------------------------ | --------------------------------------------------------------------------------------- |

| Códigos de referência | #REFERENCIAS/#REFERSNULL | Códigos das referências que serão filtradas durante a sincronização do Força de Vendas. |

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 - Detalhes Grade Calçadista

Detalhes de produtos para modelo calçadista

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

| codigoProduto| String | | |

| descricao| String | | |

| referencia| String | | |

| qtdeEmbalagem | Integer | | |

| nomeCorUm | String | | |

| nomeCorDois | String | | |

| genero| String | | |

| marca| String | | |

| grupo| String | | |

| subgrupo| String | | |

| linha| String | | |

| grade| String | | |

Lista de Parâmetros:

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

| referencias | #REFERENCIAS  | | | Filtro de referências |

h2. Produtos - Conceitos - Modelo Calçadista

Conceitos de produto modelo calçadista

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

| codigoProduto| String | | |

| conceitoProduto | String | | |

Lista de Parâmetros:

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

| referencias | #REFERENCIAS  | | | Filtro de referências |

h2. Produtos - Política - Desconto por sortimento 

Retornar uma lista de faixas de política do desconto por sortimento!

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

| codReferencia | String | | |

| seqSortimento | String | | |

| percDescontoMaximo | DOuble | | |

Lista de Parâmetros:

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

| referencias | #REFERENCIAS  | | | Filtro de código das referências |

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 (ou Etiqueta) do produto |

|_.31 | nomeMarca  | String | 255 | Nome da Marca (ou Etiqueta) 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 |