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|Tabela de Preço - Política - Desconto Volume]] (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#Desconto-Campanha-Política-de-Descontos|Desconto Campanha - 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#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#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#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|Pedidos por Referência]] (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#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)

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

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 | | |
| descricaoProd | String | | |
| vlrUnitarioAnterior | String | | |
| seqTamanho | String | | |
| 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) |

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 |

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

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. 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 representante 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 | Integer | 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 |
|_.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 &#124;&#124;. |
|_.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 | | Cust. Específica Deliz https://stackoverflowteams.com/c/geovendas/questions/697 |
|_.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 | dataBloqueioFaturamento | String | 255 | Data de bloqueio do faturamento |
|_.77 | dataBloqueioPedido | String | 255 | Data de bloqueio 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 |
| 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 |
| codCliente | #CLIENTES | | | Filtro de código de 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. 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 |

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) |
| codGenero | #GENERO | | | Qualificar no WHERE como IN (#GENERO) |
| codEtiqueta | #ETIQUETAS | | | Qualificar no WHERE como IN (#ETIQUETAS) |
| codTipoModelo | #MODELOS | | | Qualificar no WHERE como IN (#MODELOS) |
| codTipoPeca | #TIPOS | | | Qualificar no WHERE como IN (#TIPOS) |
| codMarca | #MARCAS | | | Qualificar no WHERE como IN (#MARCAS) |
| codCatalogo | #CATALOGOS | | | Qualificar no WHERE como IN (#CATALOGOS) |
| codGrade | #GRADES | | | Qualificar no WHERE como IN (#GRADES) |

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

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) |
| 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) |
| codFamilia | String | 255 | Código da família do sortimento |
| nomeFamilia | String | 255 | Descrição da família 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 |
| 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) |

h2. Produtos - Etiquetas

Retornar a listagem das etiquetas ATIVAS dos produtos

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEtiqueta | String/Integer | 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 | Código da etiqueta |

h2. Produtos - Linhas

Retornar a listagem das linhas ATIVAS dos produtos

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codLinha | String/Integer | 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/Integer | 255 | Código da linha |

h2. Produtos - Tipos

Retornar a listagem dos tipos ATIVOS dos produtos

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codTipoPeca | String/Integer | 255 | Código do tipo peça |
| nome | String | 255 | Nome do tipo peça |

h2. Produtos - Modelos

Retornar a listagem dos modelos ATIVOS dos produtos

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codTipoModelo | String/Integer | 255 | Código do tipo modelo |
| nome | String | 255 | Nome do tipo modelo |

h2. Produtos - Gênero

Retornar a listagem dos gêneros ATIVOS dos produtos

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codGenero | String/Integer | 255 | Código gênero |
| nome | String | 255 | Nome do Gênero |

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 |
| divisorPedido | String | 255 | Propriedade específica utilizada em alguns clientes para divisão de pedidos. |

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 |
| codEmpresa * | String/Integer | 255 | Código da empresa no ERP |
| codReferencia * | String/Integer | 255 | Código da referência no ERP|
| descricao | String | 255 | Descrição da referência |
| seqTamanho * | String/Integer | 255 | Código do tamanho na grade no ERP |
| seqSortimento * | String/Integer | 255 | Código da sortimento no ERP |
| flagBloqueado | Integer | | Indicador do bloqueio da referência (1 - Sim, 0 - Não) |
| codTabPreco (opcional) | String | 255 | Código 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 |
|codColecao | #COLECOES| | | Qualificar no WHERE como IN |

h2. Pedido - Capa

Retornar a situação do pedido no ERP.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codPedido * | String/Integer | 255 | Código do pedido no ERP |
| situacao | Integer | | Situação do pedido no ERP.
Pedido FATURADO: 99
Pedido CANCELADO: 98
Demais situações: retornar código do ERP |
| descSituacao | String | 255 | Descrição da situação |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codPedido | #PEDIDOS | | | Qualificar no WHERE como IN |

h2. Pedidos por Referência

Retorna a quantidade vendida de uma ou de várias referência, tamanho e cor.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 255 | Código da empresa no ERP |
| codReferencia * | String | 255 | Código da Referência |
| codTamanho * | String | 255 | Código do Tamanho |
| codSortimento * | String | 255 | Código do Sortimento |
| quantidade* | Integer | | Quantidade vendida |
| dataEmissaoPedido* | Date | | Data Emissã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 |
| codReferencia | #REFERENCIAS | | | Qualificar no WHERE como IN |
| DataVenda | :p2 | Date | | Data da venda |

h2. Listagem de Pedidos - Capa

Retornar dados referentes a capa do pedido.

|_.Num|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|1| codEmpresa | String/Integer | 10 | Código da empresa no ERP |
|2| codCliente | String | 255 | Código do Cliente |
|3| nomeCliente | String | 255 | Nome do Cliente |
|4| codRepres | String | 255 | Código do Representante |
|5| pedAutomacao | String | 255 | Número do Lote de Gravação |
|6| codPedido | String | 255 | Código do Pedido no ERP |
|7| dataEmissao | Date | | Data de Emissão do Pedido |
|8| dataPrevFat | Date | | Data de Previsão de Faturamento do Pedido |
|9| situacao | Integer | 10 | Código da Situação no ERP |
|10| situacaoEdt | String | 255 | Descrição da Situação do Pedido |
|11| valorBruto | Double | | Valor Bruto do Pedido |
|12| valorLiquido | Double | | Valor Liquido do Pedido |
|13| valorSaldo | Double | | Valor Saldo do Pedido |
|14| qtdePedLiquida | Integer | | Quantidade Pedida Liquida |
|15| motivo | String | 255 | Motivo do pedido |
|16| pedidoCliente | String | 255 | Codigo do Pedido de controle do cliente |
|17| pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |
|18| percComissao | Double | | Percentual de comissão do pedido |
|19| usuarioDigitacao | String | 255 | Usuário digitação do pedido |
|20| valorComissao | Double | | Valor da comissão do pedido |
|21| percDescGeral | Double | | Percentual de desconto geral do pedido |
|22| valorDesconto | Double | | Valor total de desconto do pedido |
|23| nomeColecao | String | 255 | Coleção do Pedido p/ Histórico de Pedidos |
|24| codTipoNota | String | 255 | Código do Tipo de nota p/ Histórico de Pedidos |
|25| currency | String | 255 | Config de moeda para o ISF, fixo 'R$' |
|26| tipoNota | String | 255 | Tipo da Nota |
|27| motivoQuarentenaPedidos | String | 255 | Motivo Da Quarentena dos pedidos |
|28| atendente | String | 255 | Atendente do pedido |
|29| tabPrecoPedido | String | 255 | Tabela de Preço do Pedido |
|30| situacaoWorkFlow | String | 255 | Situação do Ppedido no WorkFlow |
|31| nomeRepres | String | 255 | Nome Representante |
|32| valorFaturado | Double | | Valor Faturado |
|33| qtdeEntregue | Double | | Quantidade Entregue |
|34| percEntrega | Double | | Percentual de Entrega |
|35| nomeFantasia | String | 255 | Nome Fantasia |

Lista de Parâmetros:

_Formato sugerido de data: dd/mm/yyyy (31/12/2013)_

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :pDataEmissao | Date | | Data de Emissão do Pedido |
| :p3 | String | 10 | Código do Representante (Alterado de :pCodRepresentante para :p3 por Ivo em 26/10/2022 |
| :p4 | String | 10 | (opcional) Código do Cliente |
| #COLECOES | string | |(opcional) para ser utilizado na consulta de pedidos Online|
| #CODPEDIDOCLIENTE | String | 255 | Código de pedido do cliente |
| #CODPEDIDOREPRESENTANTE | String | 255 | Código de pedido do representante |
| #SITUACAODISPLAY (#SITUACAODISPNULL) | String | 255 | Situação do pedido no ERP |
| #TABPRECOS (#TABPRECONULL) | String | 255 | Tabelas de Preço Liberadas |

h2. Listagem de Pedidos - Detalhado

Retornar dados detalhados do pedido.

|_.n|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|1| dataEmissao | Date | | Data de Emissão do Pedido |
|2| dataPrevFatur | Date | | Data de Previsão do Faturamento |
|3| situacaoEdt | String | 255 | Descrição da Situação do Pedido |
|4| codCliente | String | 255 | Código do Cliente |
|5| nomeCliente | String | 255 | Nome do Cliente |
|6| cidadeCliente | String | 255 | Nome da Cidade do Cliente (cidade da venda) |
|7| ufCliente | String | 255 | Sigla do Estado do Cliente (estado da venda). |
|8| inscEstadual | String | 255 | Inscrição Estadual do Cliente |
|9| cnpjCliente | String | 255 | Cnpj do Cliente |
|10| codRepres | String | 255 | Código do Representante |
|11| percComissao | Double | | Percentual de Comissão do Pedido |
|12| codTabPreco | String | 255 | Código da Tabela de Preço |
|13| nomeTabPreco | String | 255 | Nome da Tabela de Preço |
|14| codCondVenda | String | 255 | Código da Condição de Venda |
|15| nomeCondVenda | String | 255 | Nome da Condição de Venda |
|16| codTranspDespacho | String | 255 | Código da Transportadora de Despacho |
|17| nomeTranspDespacho | String | 255 | Nome da Transportadora de Despacho |
|18| tipoFreteTranspDespacho | String | 255 | Tipo de Frete do Transporte de Despacho |
|19| codTranspRedespacho | String | 255 | Código da Transportadora de Redespacho |
|20| nomeTranspRedespacho | String | 255 | Nome da Transportadora de Redespacho |
|21| tipoFreteTranspRedespacho | String | 255 | Tipo de Frete do Transporte de Redespacho |
|22| codTipoNota | String | 255 | Código do Tipo de Nota |
|23| nomeTipoNota | String | 255 | Nome do Tipo de Nota |
|24| observacao | String | 255 | Observação do Pedido |
|25| valorBruto | Double | | Valor Bruto do Pedido |
|26| valorLiquido | Double | | Valor Liquido do Pedido |
|27| valorSaldo | Double | | Valor Saldo do Pedido |
|28| percDesconto1 | Double | | Percentual de Desconto 1 |
|29| percDesconto2 | Double | | Percentual de Desconto 2 |
|30| percDesconto3 | Double | | Percentual de Desconto 3 |
|31| percDesconto4 | Double | | Percentual de Desconto 4 |
|32| percDesconto5 | Double | | Percentual de Desconto 5 |
|33| fantasia | String | 255 | Nome Fantasia |
|34| emailCliente | String | 255 | E-mail do Cliente |
|35| pedidoCliente | String | 255 | Codigo do Pedido de controle do cliente |
|36| pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :p1 | String | 255 | Código do Pedido (É comparado com o "código do pedido no Erp" do "Listagem de Pedidos - Capa" e com o valor do "Pedido ERP" no botão azul de pedidos finalizados do FV)|

h2. Listagem de Pedidos - Itens

Retornar dados dos Itens do pedido.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codItem | String | 255 | Código do Item para Ordenação |
| codProduto | String | 255 | Código do Produto |
| nomeProduto | String | 255 | Nome do Produto |
| qtdePedida | Double | | Quantidade Pedida do Produto |
| qtdeSaldo | Double | | Quantidade Saldo do Produto |
| qtdeFaturado | Double | | Quantidade Faturada do Produto |
| qtdeCancelada | Double | | Quantidade Cancelada do Produto |
| valorUnitarioBruto | Double | | Valor Unitário Bruto do Produto |
| valorUnitarioLiquido | Double | | Valor Unitário Liquido do Produto |
| valorTotal | Double | | Valor Total do Produto |
| codReferencia | String | 255 | Código da Referência do Item. |
| seqTamanho | String | 255 | Tamanho do Item. |
| seqSortimento | String | 255 | Cor do Item. |
| qtdeReservado | Double | | Quantidade reservada |
| qtdeColetada | Double | | Quantidade coletada |
| codColecao | String | 255 | Código da coleção |
| nomeColecao | String | 255 | Nome da coleção |
| codEtiqueta | String | 255 | Código da etiqueta |
| nomeEtiqueta | String | 255 | Nome da etiqueta |
| codLinha | String | 255 | Código da linha |
| nomeLinha | String | 255 | Nome da linha |
| codFamilia | String | 255 | Código da família |
| nomeFamilia | String | 255 | Nome da família |
| codTipoPeca | String | 255 | Código do tipo de peça |
| nomeTipoPeca | String | 255 | Nome do tipo de peça |
| qtdePendente | Double | | Quantidade pendente |
| codGrade | String | 255 | Código da grade |
| dataEntrega | String | 255 | Data de Entrega do Item. |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :p1 | String | 255 | Código do Pedido (É comparado com o "código do pedido no Erp" do "Listagem de Pedidos - Capa" e com o valor do "Pedido ERP" no botão azul de pedidos finalizados do FV)|

h2. Listagem de Pedidos - Notas

Retornar dados das Notas Fiscais do pedido.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| dataEmissao | Date | | Data de Emissão da Nota Fiscal |
| numeroNF | String | 255 | Número da Nota Fiscal |
| situacao | String | 255 | Situação da Nota Fiscal |
| valorLiquido | Double | | Valor Total da Nota Fiscal |
| codTransp | String | 255 | Código da Transportadora |
| nomeTransp | String | 255 | Nome da Transportadora |
| codRedespacho | String | 255 | Código do Redespacho |
| nomeRedespacho | String | 255 | Nome do Redespacho |
| chaveNFE | String | 255 | Chave da Nota Fiscal |
| qtdeFaturado | Double | | Quantidade de peças faturadas |
| dataEntrega | Date | | Data de entrega da Nota Fiscal |
| descSituacaoEntrega | String | | Descrição da situação atual da entrega |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :p1 | String | 255 | Código do Pedido (É comparado com o "código do pedido no Erp" do "Listagem de Pedidos - Capa" e com o valor do "Pedido ERP" no botão azul de pedidos finalizados do FV)|

h2. Listagem de Pedidos - Observações

Retornar dados das observações do pedido por setor.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codSetor | String | 255 | Código do setor da observação |
| nomeSetor | String | 255 | Nome do setor da observação |
| dataObservacao | Date | | Data da observação |
| descricao | String | 255 | Texto da observação |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :pCodPedido | String | 255 | Código do Pedido |

h2. Listagem de Pedidos - Histórico

Retornar dados do histórico de movimentação do pedido no ERP.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codHistorico | String | 255 | Código do histórico |
| situacao | String | 255 | Número da situação do pedido no ERP |
| descSituacao | String | 255 | Descrição da situação do pedido no ERP |
| data | Date | | Data da movimentação |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :pCodPedido | String | 255 | Código do Pedido |

h2. Estoque

Retornar a listagem do estoque
*Só é necessário caso não esteja utilizando a view de Estoque Centralizado abaixo*
https://redmine.ibtech.inf.br/projects/integracao_igs/wiki/Manual_de_Integra%C3%A7%C3%A3o#Estoque-Centralizado

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|codEmpresa | String | 255 | Código da Empresa origem dos dados |
|codReferencia* | String | 255 | Código da Referência no ERP |
|seqTamanho* | String | 255 | Código do tamanho na grade no ERP |
|seqSortimento* | String | 255 | Código do Sortimento no ERP |
|codColecao* | String | 255 | Código da coleção da referencia no ERP |
|estoqueLimitado | Integer | | Referencia com estoque limitado/vendida por disponibilidade, geralmente produtos importados: 0 - Não, 1 - Sim |
|quantidade* | Double | | Quantidade disponivel para venda (estoque - pedidos em aberto + OPs em aberto) |
|qtdProducao | Double | | Quantidade em OPs em aberto, utilizar apenas se o ERP não tratar o % de quebra e o valor não estiver compondo o campo de quantidade acima |
|nomeReferencia* | String | 255 | (opcional) Nome da referencia |
|nomeSortimento* | String | 255 | (opcional) Descricao do Sortimento |
|codTamanho* | String | 255 | (opcional) Codigo do Tamanho. ex: P ou M ou G |
|codGrade* | String | 255 | (opcional) Codigo da grade dos tamanhos |
|codDeposito | String | 255 | Código do Deposito, utilizar apenas em casos específicos, falar com a GEOvendas antes |
|nomeDeposito | String | 255 | Nome do Deposito, utilizar apenas em casos específicos, falar com a GEOvendas antes |
|qtdProntaEntrega | Double | | Quantidade em pronta entrega, não considera as OPs em aberto, somente os produtos no estoque físico |
|nomeColecao* | String | 255 | (opcional) Nome da coleção do produto |
|seqOrdenacaoTamanho* | integer | | (opcional) Sequencia de ordenação do tamanho na grade |
|peso | Double | | (opcional) Peso da peça acabada |
|dataReferencia | Date | | (opcional) Data da disponibilidade do estoque do SKU. O valor de estoque deve ser o acumulado na data, não apenas o que sera produzido no dia em questão. |
|codMarca | String | 255 | (opcional) Codigo da marca no qual o produto pertence |
|CodCorBase | String | 255 | (opcional) Código da Cor Base do Produto |
|codReferProvisoria | String | 255 | (opcional) Código provisório |

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 | 10 | (opcional) Código da empresa no ERP |
| seqTamanho | :p3 | String/Integer | 10 | (opcional) Código do tamanho na grade no ERP |
| seqSortimento | :p4 | String/Integer | 10 | (opcional) Código do Sortimento no ERP |
| codColecao | #COLECOES | | | Qualificar no WHERE como IN |

h2. Lotes de Entrega

Retornar o cadastro de lotes de entrega

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|prazo | String | 255 | Código do lote de entrega (consequente prazo) |
|descricao | String | 255 | Descrição do lote de entrega |
|dataInicio | Date | 255 | Data de Início da vigência de entrega |
|dataFim | Date | 255 | Data Final da vigência de entrega |

h2. Lotes de Faturamento

Retornar o cadastro de lotes de faturamento

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| dataReferencia | Date | | Data de referência |
| dataFaturamento | Date | | Data de faturamento |
| descricao | String | | Descrição do lote de faturamento |
| codErp | String | | Código do lote no ERP (Necessário APENAS se for essencial para a gravação do Pedido) |
| codRepres | String | | Código do representante (opcional) |
| janelaEntregaDe | Date | | Data de Início da vigência de entrega (opcional) |
| janelaEntregaAte | Date | | Data Final da vigência de entrega (opcional) |
| codTabPreco | String | | Código de tabela de preços (opcional) |
| codTipoNota | String | | Código de tipo de nota (opcional) |
| situacao | Integer | | Situação do lote de faturamento (opcional) |
| dataMinimaEntrega | Date | | Data minima para entrega (opcional) |

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :p1 | Date | | Data de referência |

h2. Cálculo substituição tributária

A integração de ST possuiu dois modelos de leitura.
O modelo *PADRAO* que filtra a ST apenas pelo código da referência e o *MODELO_GRUPO_PRODUTO_CLIENTE* que filtra a ST de acordo com o grupo do produto e a do cliente.
O formato do SQL muda de acordo com as configurações gerais do Força de Vendas.

Abaixo SQL modelo padrão:

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|codReferencia | String | 255 | Código da referência |
|UF | String | 2 | Sigla do estado |
|aliquotaInterna | double | | aliquotaInterna |
|aliquotaICMS | double | | aliquotaICMS |
|aliquotaICMS2 | double | | aliquotaICMS2 |
|reducaoICMS | double | | reducaoICMS |
|percentualMVA | double | | percentualMVA |
|reducaoICMSBase | double | | reducaoICMSBase |
|pauta | double | | pauta |
|peso | double | | peso |

Abaixo SQL modelo por grupo de produto e de cliente:

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|codGrupoProduto | String | 255 | Grupo de ST do produto |
|codGrupoCliente | String | 255 | Grupo de ST do cliente |
|UF | String | 2 | Sigla do estado |
|aliquotaInterna | double | | aliquotaInterna |
|aliquotaICMS | double | | aliquotaICMS |
|aliquotaICMS2 | double | | aliquotaICMS2 |
|reducaoICMS | double | | reducaoICMS |
|percentualMVA | double | | percentualMVA |
|reducaoICMSBase | double | | reducaoICMSBase |
|pauta | double | | pauta |
|peso | double | | peso |

*SQL de exemplo com base na documentação*
<pre>select codEmpresa,
cgiima->cgisai->coditem,
uf,
aliquotaICMSInterna,
IBTech.CGISAI_getPercICMS(codEmpresa,cgiima->cgisai->coditem,uf) aliqOrigemICMS,
percReducaoBase percReducaoBASE,
percIVA percMVA,
percReducaoMVASimplesNac percReducaoICMS,
IBTech.FTBTAB97fx1nv6_pegarValorPautaVigencia(codEmpresa,uf,cgiima->cgisai->coditem,null) pauta,
0 peso
from IBTech.FTBTAB60fx1nv6
where codEmpresa = 20</pre>

h2. Grupos substituição tributária

Quando usar o modelo substituição tributária por grupo então é necessário utilizar esse SQL.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|codigo | String | 255 | Código do grupo ST |
|descricao | String | 255 | Descrição do grupo ST |

h2. Integração Valor de Frete por UF

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|Valor| Double | | Valor do frete |
|UF | String | 2 | Sigla do estado |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :p1 | String | 2 | UF do Cliente |

*SQL de exemplo com base na documentação*
<pre>SELECT custo_frete,
uf
FROM v_ibtech_uf_frete
WHERE upper(uf) = upper(:p1)</pre>

h1. Tabela de Preço SKU

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String | 10 | Código da Empresa de origem dos dados |
| codTabPreco * | String | 255 | Código da tabela de preço |
| codReferencia * | String | 225 | Código de referência |
| codGrade *| String | 225 | Código da grade |
| vlrUnitario * | Double | | Valor Unitário da SKU |
| seqSortimento * | String/Integer | 255 | Código do sortimento |
| itemAtivo | Integer | 1 | Flag de item ativo |
| seqTamanho * | String | 225 | Sequência do tamanho |
| descrProduto | String | 255 | Descrição de produto |
| vlrUnitarioAnterior | Double | | Valor Unitário Anterior na tabela |
| seqTamanho * | String | 225 | Sequência do tamanho |
| permiteBonificacao | Integer | 1 | Definição para Bonificação na tabela |
| flagOferta | Integer | 1 | Flag de Oferta na Tabela |

h1. Tabela de Preço - Política - Desconto Adicional de Lote

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| prazoMedioMinimo * | Double | | Prazo Médio Mínimo |
| prazoMedioMaximo * | Double | | Prazo Médio Máximo |
| percDesconto * | Double | | Prazo Inicial |

Lista de Parâmetros:

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :p2 | String | | Tabela de Preço |

h1. Tabela de Preço - Política - Desconto Compra Acumulada

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codigoTabelaPreco * | String | | Código da tebala de preços |
| codigoCliente * | String | | Código do cliente |
| valorBruto * | Double | | Valor bruto vendido para essa tabela e cliente |

Lista de Parâmetros:
Todos os parâmetros são obrigatórios!

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | :p1 | String | | Código da empresa |
| codRepresentante * | :p2 | String | | Código do representante |
| codigoTabelaPreco * | :p3 | String | | Código da tabela de preços |
| codigoCliente * | :p4 | String | | Código do cliente |

h1. Listagem de Pedidos Em Aberto - Capa

Retornar dados referentes a capa do pedido.

|_.Num|_. Campo |_. Tipo |_. Precisão |_. Descrição |
|1| codEmpresa | String/Integer | 10 | Código da empresa no ERP |
|2| codPedido | String | 255 | Código do Pedido no ERP |
|3| dataEmissao | Date | | Data de Emissão do Pedido |
|4| dataPrevFat | Date | | Data de Previsão de Faturamento do Pedido |
|5| codCliente | String | 255 | Código do Cliente |
|6| nomeCliente | String | 255 | Nome do Cliente |
|7| situacaoDescritiva | String | 255 | Situação no ERP |
|8| valorLiquido | Double | | Valor Liquido do Pedido |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| dataEmissaoDe | :p1 | Date | | Data Emissão Inicial |
| dataEmissaoAte | :p2 | Date | | Data Emissão Final |
| codRepres | :p3 | String | 255 | Código Representante |
| codCliente | :p4 | String | 255 | Código Cliente |

h1. SKUs Pronta Entrega e Programado

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
|1| codReferencia | String/Integer | 10 | Código da referência |
|2| codTabPreco | String | 255 | Código da tabela de preço |
|3| seqSortimento | String | | Sequência do Sortimento |
|4| seqTamanhos | String | | Sequência do Tamanho |
|5| tipoPedido | Int | 255 | Tipo de pedido (10 = Pronta Entrega, 20 = Programado) |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codTabPreco | #TABPRECOS | | | Qualificar no WHERE como IN |

h1. Clientes Reposição

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
|1| codEmpresa | String/Integer | | Código da Empresa |
|2| codCliente | String | 255 | Código 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 |
| codTabela | :p2 | String/Integer | 255 | Código da tabela de preços no ERP |
| codColecao | #COLECOES | | | Qualificar no WHERE como IN |

h1. Produtos - Data de Entrega

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
|1| codReferencia | String/Integer | | Código da Referência |
|2| dataEntrega| Date | 255 | Data de Entrega |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | | |
| colecoes | #COLECOES | String | | Qualificar no WHERE como IN |