Digitação de Pedidos¶

Índice

1. Introdução
2. Acesso via JDBC
3. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
   1. Tabelas de Integração
   2. Parâmetros
   3. Exemplo de SQL de Integração
4. Layouts de Integração
   1. Tabela de Preço
   2. Tabela de Preço por Representante (opcional - somente se ERP possui esse controle)
   3. Tabela de Preço Cliente De/Para (opcional - somente se ERP possui esse controle)
   4. Tabela de Preço - Representante De/Para (opcional - somente se ERP possui esse controle)
   5. Tabela de Preço - Produto
   6. Tabela de Preço - Política - Capa (opcional)
   7. Tabela de Preço - Política - Desconto Comercial (opcional)
   8. Tabela de Preço - Política - Desconto Financeiro (opcional)
   9. Tabela de Preço - Política - Desconto Antecipação (opcional)
   10. Tabela de Preço - Política - Prazo Adicional (opcional)
   11. Tabela de Preço - Política - Desconto Volume (Pack) (opcional)
   12. Tabela de Preço - Política - Preços por volume (opcional)
   13. Tabela de Preço - Política - Desconto 13 (Segmento/Cond. Pagamento) (opcional)
   14. Tabela de Preço - Política - Depósitos por fornecedor
   15. Tabela de Preço - Política - Desconto Adicional de Lote (opcional)
   16. Tabela de Preço - Política - Valor Mínimo por Regiao (opcional)
   17. Tabela de Preço Política Desconto Compra Acumulada (opcional)
   18. Tabela de Preço - Política - Desconto por Linha de Produto (opcional)
   19. Desconto Campanha - Política de Descontos (opcional)
   20. Desconto linha de produto - Política de Descontos (opcional)
   21. Títulos Em Aberto (opcional)
   22. Condição de Venda
   23. Cota de estoque - Por representante (opcional)
   24. Tipo de Nota(opcional)
   25. Tipo de Cobrança(opcional)
   26. Comissões (opcional)
   27. Comissões - Extrato Resumo (opcional)
   28. Comissões - Extrato Detalhado (opcional)
   29. Clientes
   30. Clientes - Campos Customizados (opcional)
   31. Clientes - Locais de Entrega(opcional)
   32. Clientes - Ramos de Atividade(opcional)
   33. Clientes - Grupos de Cliente(opcional)
   34. Clientes - Condições de venda(opcional)
   35. Clientes - Marcas(opcional)
   36. Clientes - Marcas Concorrentes(opcional)
   37. Marcas por Cidade(opcional)
   38. Clientes - Contatos(opcional)
   39. Clientes - Contatos - Departamento(opcional)
   40. Produtos
   41. Produtos - Grades
   42. Produtos - Sortimentos
   43. Produtos - Etiquetas
   44. Produtos - Linhas
   45. Produtos - Tipos
   46. Produtos - Modelos
   47. Produtos - Gênero
   48. Produtos Skus (opcional)
   49. Produtos - Gold Be (Exclusiva)
   50. Produtos - Prioridade de linha para distribuição (opcional)
   51. Produto - Código Reduzido (opcional - somente se ERP precisa do código reduzido)
   52. Produto - EAN13 (opcional)
   53. Produtos Parte Cima Parte Baixo (opcional)
   54. Bloqueio de Referências(opcional)
   55. Pedido - UUID
   56. Pedido - UUID - (Massa)
   57. Pedido - Capa
   58. Pedidos por Referência(Cota) (opcional)
   59. Listagem de Pedidos - Capa
   60. Listagem de Pedidos - Detalhado
   61. Listagem de Pedidos - Itens
   62. Listagem de Pedidos - Notas
   63. Listagem de Pedidos - Observações (opcional)
   64. Listagem de Pedidos - Histórico (opcional)
   65. Listagem de Notas Fiscais - Capa (opcional)
   66. Estoque (Depreciada) - Alterada para Estoque Centralizado
   67. Lote Entrega (opcional)
   68. Lotes de Faturamento (opcional)
   69. Cálculo substituição tributária (opcional)
   70. Grupos substituição tributária (opcional)
   71. Integração Valor de Frete por UF (opcional)
   72. Tabela de Preço SKU (opcional)
   73. Listagem de Pedidos em Aberto - Capa (opcional)
   74. Listagem de Pedidos em Aberto - Detalhado (mesma estrutura Listagem de Pedidos - Detalhado) (opcional)
   75. Listagem de Pedidos em Aberto - Itens (mesma estrutura Listagem de Pedidos - Itens) (opcional)
   76. SKUs Pronta Entrega e Programado (opcional)
   77. Clientes Reposição (opcional)
   78. Produtos - Data de Entrega (opcional)
   79. Produtos - Política Data Limite (opcional)
   80. Conta corrente - Saldo flex por representante (opcional)
   81. Pedidos por data de Lote Fatur (opcional)
   82. Pedidos por data de Lote Fatur (opcional)

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.

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.

Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração¶

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.

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.

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

SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmpresa = :p1
  AND codTabela = :p2

Layouts de Integração¶

Segue os layouts que devem servir de base para construção dos SQLs de integração.

Tabela de Preço¶

Consulta informações de tabela de preço do ERP.

Campo	Tipo	Precisão	Descrição
codEmpresa *	String/Integer	10	Código da Empresa origem dos dados
codTabela *	String/Integer	255	Código da tabela de preços no ERP
descricao	String	255	Descrição da tabela de preços
dataMinimaFaturamento	Date		Data mínima de faturamento
dataMaximaFaturamento	Date		Data máxima de faturamento
percDescontoShowRoom	Double		Percentual de desconto para show room
dataVigenciaInicial	Date		Data de vigência inicial
dataVigenciaFinal	Date		Data de vigência final
codColecao	String		Código da coleção (opcional)
codSegmento	String		Código do segmento (opcional)
codTabelaPrecoPrincipal	String		Código da tabela de preços (opcional) - Se preenchido esse campo, irá pegar esse código como tabela nos SQL´s de produto
desconsiderarDescAcr	Integer		Desconsiderar Desconto Acrescimo (opcional)
codEmpresaDestino	String		Código de empresa destino (opcional)
currency	String		Tipo de moeda (opcional)
codTipoPedido	String		Código do tipo de pedido (opcional)
codTabPrecoIntegracao	String		Código da tabela de preços para integração (opcional)
prazoMedio	Double		Prazo Médio
depositos	String		Depositos nas configurações adicionais da tabela de preço. Enviar depositos separados por , caso seja usado mais de um para leitura do estoque
cnpjPacote	String		CNPJ da empresa destino da integração, usado apenas para integração por PACOTE
codOperacao	String		Código de operação na configuração adicional da tabela de preço
nrPrioridade	String		Código da Prioridade na configuração adicional da tabela de preço
inFatura	String		Código da tag inFatura na configuração adicional da tabela de preço
depositoERP	String		Código do deposito ERP na configuração adicional da tabela de preço
codMarca	String	255	Código da marca do produto na configuração adicional da tabela de preço

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codTabela	:p2	String/Integer	255	Código da tabela de preços no ERP

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

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

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

Tabela de Preço - Produto¶

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

Campo	Tipo	Precisão	Descrição
codEmpresa *	String/Integer	10	Código da Empresa origem dos dados
codTabela *	String/Integer	255	Código da tabela de preços no ERP
codProduto *	String/Integer	255	Código do produto no ERP
codGrade *	String/Integer	255	Código da grade de produto no ERP
preco	Double		Preço do produto
seqSortimento	String/Integer	255	Código da sortimento no ERP (opcional, somente para quem utiliza venda agrupada/look)
itemAtivo	Integer	1	Situação do item no ERP (0 - Inativo, 1 - Ativo)
seqTamanho	String		Código do tamanho na grade no ERP
descricaoProd	String
vlrUnitarioAnterior	String
seqTamanho	String		Utilizar apenas se trabalha com preço por SKU, caso contrario mandar NULL. Verificar com a GEOVendas antes.
permiteBonificacao	String
flagOferta	String
codigoCaixaGoldBe	String		Código agrupador de caixas Gold Be
dataVencimento	Date		Data de vencimento do valor do produto (Apenas para Alimentício)
aliquotaIpi	Double		Percentual da alíquota a ser aplicado ao preços do produto

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codTabela	:p2	String/Integer	255	Código da tabela de preços no ERP
produtoAtivo	:p4	Integer	-	Filtro para buscar produto ativo/inativo
codReferencia	:p5	String/Integer	255	Utilizada para filtrar um produto para digitação online
codColecao	#COLECOES			Qualificar no WHERE como IN
codRepres	:p6	String	255	Utilizada para filtrar um representante nos produtos para digitação online, obrigatório ":p6 or :p6 is null"

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

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

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

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

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

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

Desconto de Volume

Campo	Tipo	Precisão	Descrição
codSegmento	String	255	Fixo null quando por Cliente e Tabela de Preços
codColecao	String		Fixo null quando por Cliente e Tabela de Preços
clienteUf	String	255	Fixo null quando por Cliente e Tabela de Preços
valorInicial	Double		Valor Inicial
valorFinal	Double		Valor Final
tipoValor	Integer		Fixo null quando por Cliente e Tabela de Preços
desconto	Double		Valor do desconto
codTabelaPreco	String		Obrigatório quando por Cliente e Tabela de Preços
codCliente	String		Obrigatório quando por Cliente e Tabela de Preços
descontoComercialMinimo	Double
codReferencia	String		Obrigatório quando por "40 - Desc. Hist Compra por referência."
codigoAgrupador	String		Opcional - Para ligar a quantidade de outros produtos com o mesmo código

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codRepresentante	:p1	String	10	Apenas usado quando por cliente e tabela de preço
codCliente	:p2	String	255	Apenas usado quando por cliente e tabela de preço
codTabelaPreco	:p3	String	255	Apenas usado quando por cliente e tabela de preço

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

Desconto linha de produto - Política de Descontos¶

Campo	Tipo	Precisão	Descrição
codigoCliente	String	255	Código do cliente que receberá descoto
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

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

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

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

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

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

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

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

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

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

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)

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)

Clientes¶

Retornar a listagem de clientes de um representante.

	Campo	Tipo	Precisão	Descrição
1	codEmpresa *	String/Integer	10	Código da Empresa origem dos dados
2	codCliente *	String	255	Código do cliente no ERP
3	cnpj *	String	255	CNPJ ou CPF do cliente (somente números)
4	nomeFantasia	String	255	Nome fantasia do cliente
5	razaoSocial	String	255	Razão social do cliente
6	situacao	Integer		Situação conforme codificação: 2- Inativo, 1 - Ativo, 999 - Limbo(Bloqueado)
7	telefone	String	255	Telefone do cliente
8	email	String	255	Endereço de e-mail padrão do cliente
9	emailNFE	String	255	Endereço de e-mail para Nota Fiscal Eletrônica do do cliente
10	codIBGE	String	255	Código IBGE da cidade do cliente
11	endereco	String	255	Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a GEOvendas para discutir uma solução.
12	enderecoNumero	String	255	Número do endereço do cliente do cliente
13	bairro	String	255	Bairro do cliente
14	cep	String	255	CEP do cliente (somente números)
15	dataCadastro	Date		Data de cadastro do cliente
16	inscricaoEstadual	String	255	Inscrição estadual do cliente
17	inscricaoSUFRAMA	String	255	Inscrição SUFRAMA do cliente se houver
18	flagConsumidorFinal *	Integer		Consumidor final: 0 - Não, 1 - Sim (não pode ser nulo)
19	cobrancaEmail	String	255	Endereço de e-mail de cobrança do cliente
20	cobrancaContato	String	255	Nome da pessoal de contato de cobrança do cliente
21	cobrancaTelefone	String	255	Telefone da pessoal de contato de cobrança do cliente
22	comprasEmail	String	255	Endereço de e-mail de compras do cliente
23	comprasContato	String	255	Nome da pessoal de contato de compras do cliente
24	comprasTelefone	String	255	Telefone da pessoal de contato de compras do cliente
25	avaliacaoRepres	Text		(opcional) Observação de avaliação do representante sobre o cliente (somente informação digitada pelo representante)
26	celular	String	255	Telefone Celular de contato do cliente
27	fax	String	255	Celular de contato do cliente
28	flagClienteFiel	Integer		Cliente Fiel/Especial: 0 - Não, 1 - Sim
29	endComplemento	String	255	Complemento do Endereço
30	dataUltimaCompra	Date		Data da ultima compra do cliente
31	codTransportadora	String	255	Código da transportadora do cliente
32	codCondPagto	String	255	Código da condição de pagamento do cliente
33	flagSimplesNacional	Integer		Cliente faz parte do Simples Nacional: 0 - Não, 1 - Sim
34	codTabPreco	String	255	Código da tabela de preço do cliente
35	percDesconto	Double		% Desconto curva ABC (Obrigatoriamente colocar o filtro de codCliente no WHERE)
36	codGerente	String	255	Código do Gerente/Supervisor do representante do cliente.
37	inscricaoMunicipal	String	255	Inscrição municipal do cliente
38	codRamoAtividade	String	255	Código do ramo de atividade do cliente.
39	codGrupoCliente	String	255	Código do grupo de cliente.
40	dataFundacao	String	255	Data de fundação do cliente.
41	limiteCredito	Double		Limite de crédito do cliente.
42	limiteCreditoDisponivel	Double		Limite de crédito disponível.
43	percDescontoGrupo	Double		Percentual de desconto do grupo comercial.
44	classificacaoCurva	String		Classificação da Curva.
45	obs	String		Observação do Cliente (Para recuperar facebook,instagram TI Empresarial).
46	listCodRepres (Passar sempre null)	String		Lista de representantes do cliente. (Opcional)
47	midiasSociais	String		Midias sociais (facebook, instagram) da Sisplan separadas por ||.
48	msgDashboard	String		Mensagem dashboard.
49	latitude	Double		latitude.
50	longitude	Double		longitude.
51	latitudeISF	Double		latitudeISF.
52	longitudeISF	Double		longitudeISF.
53	atualizadoCoordPor	String		atualizadoCoordPor.
54	cfop	Double		CFOP Cliente.
55	codTranspRedespacho	String		Código de transportadora de redespacho.
56	codPortador	String	255	Código do portador.
57	codTipoCob	String	255	Código do tipo de cobrança.
58	valorPedidosEmAberto	Double		Valor do pedido em aberto.
59	valorTitulosEmAberto	Double		Valor dos títulos em aberto.
60	codGrupoCliente	String	255	Código do grupo do cliente.
61	codTipoFatur	String	255	Código do tipo de faturamento.
62	instagram	String	255	Instagram.
63	facebook	String	255	Facebook.
64	validarCamposCustomizados	Integer		Flag para validar campos customizados.
65	lembreteAprovacaoPedido	String	255	Lembrete de aprovação do pedido.
66	grupoClienteCalculoST	String	255	Código do grupo de substituição tributária do cliente.
67	somenteTriangulacao	String	255	Cliente somente triangulação
68	possuiGrupoFiscal	String	255	Cliente possui grupo fiscal
69	origemCliente	String	255	Origem do cliente
70	marcas	String	255	Marcas do cliente (em conjunto com SQL Marcas)
71	concorrentes	String	255	Concorrentes das marcas do cliente (em conjunto com SQL Marcas Concorrentes)
72	logradouro	String	255	Terreno ou espaço em anexo da habitação (ex: rua, avenida)
73	tipoCliente	String	255	Tipo de cliente, utilizado para o cadastro de brindes (Obj)
74	mediaDiasAtrasoPagamento	Integer		Quantidade média de dias de atraso de pagamento
75	pedidoParcial	Integer		Priorizar informação do pedido do cliente como pedido parcial
76	antecipacaoPedido	Integer		Priorizar informação do pedido do cliente como antecipação de pedido
77	dataFaturamento	String	255	Data de faturamento
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)

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

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

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

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

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

Clientes - Condições de venda¶

Retornar a listagem de grupos de cliente.

Campo	Tipo	Precisão	Descrição
codCondPagto *	String	255	Código da condição de pagamento
codCliente	String	255	Código do cliente
libEmpresa	Integer	10	Situação da condição de pagamento (0 - inativo / 1 - ativo)

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
Código do cliente	:p2			Filtro de código do cliente

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

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

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

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

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

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

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

Produtos¶

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

col	Campo	Tipo	Precisão	Descrição
1	codReferencia *	String/Integer	255	Código da Referência no ERP
2	descricao	String	255	Descrição da referência
3	codEtiqueta	String	255	Código da Etiqueta (ou Marca) da referência. Consultar a GEOvendas sobre o que trazer neste campo.
4	nomeEtiqueta	String	255	Nome da Etiqueta (ou Marca) da referência. Consultar a GEOvendas sobre o que trazer neste campo.
5	codLinha	String	255	Código da Linha de Produto da referência.
6	nomeLinha	String	255	Nome da Linha de Produto da referência.
7	codTipoPeca	String	255	Código do Tipo de Peça da referência. Consultar a GEOvendas sobre o que trazer neste campo.
8	nomeTpoPeca	String	255	Nome do Tipo de Peça da referência. Consultar a GEOvendas sobre o que trazer neste campo.
9	codTipoModelo	String	255	Código do Tipo Modelo da referência. Consultar a GEOvendas sobre o que trazer neste campo.
10	nomeTipoModelo	String	255	Nome do Tipo Modelo da referência. Consultar a GEOvendas sobre o que trazer neste campo.
11	opcoesVenda	String	255	(opcional) Opções de venda separadas por virgula, depende de como a empresa trabalha. ex: '6,12'
12	codReferProvisoria	String	255	Código da referencia provisória, caso não exista, retornar a própria codReferencia
13	flagSortimentoCor	Integer		Referencia permite sortimento por cor. 0 - Não, 1 - Sim
14	flagEstoqueLimitado	Integer		Referencia é vendida apenas sob disponibilidade, é sobreescrito pela integração de estoque. 0 - Não, 1 - Sim
15	flagSortimentoCorTamanho	Integer		Referencia permite sortimento por cor/tamanho (grade aberta). 0 - Não, 1 - Sim
16	flagSortimentoAutomatico	Integer		Referencia permite sortimento automático. 0 - Não, 1 - Sim
17	aliquotaIpi	Double		Percentual de IPI que deve ser aplicado a referencia. ex: 10
18	flagNaoAplicaDesconto	Integer		Indicar se o desconto NÃO deve ser aplicado a referencia. 0 - Não, 1 - Sim
19	codColecao	String	255	Codigo da coleção do produto
20	qtdeQuilosPadrao	Double		Utilizado quando Malharia, qtde. de kilos por quantidade, determina quantos quilos tem uma unidade da peça
21	cubagem	Double
22	nomeColecao	String	255	Nome da coleção do produto, utilizado inicialmente no filtro por coleção para clientes com seleção agrupada (La Playa)
23	estacaoColecao	String	255	Estação do ano do produto
24	codFamilia	String	255	Código da família do produto
25	nomeFamilia	String	255	Nome da família do produto
26	divisorLote	String	255	(Opcional) Consultar a GEOvendas sobre o que trazer neste campo.
27	divisorBrinde	String	255	(Opcional) Consultar a GEOvendas sobre o que trazer neste campo.
28	codReferImagem	String	255	Codigo do produto para chave das imagens
29	agrupadorEstoqueData	String	255	(Opcional) Consultar a GEOvendas sobre o que trazer neste campo.
30	codMarca	String	255	Codigo da marca do produto
31	nomeMarca	String	255	Nome da marca do produto
32	peso	Double	255	Peso do produto
33	codArtigoPai	String	255	Código do Artigo Pai
34	flagGradeFechada	Integer	1	Flag para dizer se a grade é fechada ou não
35	codReferenciaCorTamanho	String	255	(DESCONTINUADO) Consultar a GEOvendas sobre o que trazer neste campo.
36	dataLimiteFatur	Date		(Opcional) Consultar a GEOvendas sobre o que trazer neste campo.
37	qtdDiasMinFaturamento	Integer		(Opcional) Consultar a GEOvendas sobre o que trazer neste campo.
38	dataVencimentoProduto	Date		(Opcional) Data de vencimento do produto (apenas para mostrar na listagem).
39	especificacoesTecnicas	String	255	(Opcional) Dados/Especificações/Descrição do produto
40	codGenero	String	255	(Opcional) Informação de gênero do produto p/ ser utilizado como filtro
41	nomeGenero	String	255	(Opcional) Informação de gênero do produto p/ ser utilizado como filtro
42	composicaoProduto	String	255	(Opcional) Consultar a GEOvendas sobre o que trazer neste campo.
43	descricaoPesquisa	String	255	(Opcional) Consultar a GEOvendas sobre o que trazer neste campo.
44	flagReferenciaCalcadista	Integer		(Opcional) Campo específico para empresas que trabalham no modelo confecção e calçadista. 0 - Não, 1 - Sim
45	dataEntrega	Date		(Opcional) Data de entrega do produto, usado com funcionalidade especifica
46	grupoProdutoCalculoST	String		Código do grupo de substituição tributária do produto
47	flagMultiplicadorUnico	Integer		Define se o produto deve utilizar a mesma quantidade de multiplicação na grade fechada
48	qtdeMinimaPorGrade	Integer		Opera apenas quando grade fechada distribuição baseado no percentual da SKU
49	modeloGradeFechada	Integer		O modelo que o produto irá seguir para a grade fechada (Customização especifica).
50	origemProduto	Integer		Determina se o produto tem origem nacional ou internacional
51	flagProdutoCombo	Integer		Indica se o produto na verdade é um combo ou não (Alimentício)
52	nomeDivisorLote	String	255	(Opcional) Consultar a GEOvendas sobre o que trazer neste campo.
53	descricaoTipoEstoque	String	255	Descrição do tipo de estoque.
54	multiploPorCor	Integer	255	Quantidade múltipla por cor que deve ser respeitada pelo Força de Vendas.
55	codTipoEstoque	String	255	Código do tipo de estoque.
56	codTecido	String	255	Código do tecido.
57	nomeTecido	String	255	Nome do tecido.
58	codAgrupador	String	255	Código do agrupador do produto (funcionalidade especifica).
59	codSegmento	String	255	Código do segmento do produto.
60	descSegmento	String	255	Descrição do segmento do produto.
61	ncm	String	255	NCM do produto.
62	apenasFreteTerrestre	Integer		Utilizado na politica de frete para identificar se só pode ser enviado por via terrestre. 0 - Não, 1 - Sim
63	agrupadorCalcadista	String		Utilizado para clientes calçadistas grade fechada
64	qtdeEmbalagemCalcadista	String		Utilizado para clientes calçadistas grade fechada

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codReferencia	:p2	String	255	Código da referência no ERP
codColecao	#COLECOES			Qualificar no WHERE como IN (#COLECOES) OR (#COLECOESNULL IS NULL)
codTabelaPreco	#TABPRECOS			Qualificar no WHERE como IN (#TABPRECOS) OR (#TABPRECOSNULL IS NULL)
codReferencia	#REFERENCIAS			Qualificar no WHERE como IN (#REFERENCIAS) OR (#REFERSNULL IS NULL)
codLinha	#LINHAS			Qualificar no WHERE como IN (#LINHAS) OR (#LINHASNULL IS NULL)
codGenero	#GENERO			Qualificar no WHERE como IN (#GENERO) OR (#GENERONULL IS NULL)
codEtiqueta	#ETIQUETAS			Qualificar no WHERE como IN (#ETIQUETAS) OR (#ETIQUETASNULL IS NULL)
codTipoModelo	#MODELOS			Qualificar no WHERE como IN (#MODELOS) OR (#MODELOSNULL IS NULL)
codTipoPeca	#TIPOS			Qualificar no WHERE como IN (#TIPOS) OR (#TIPOSNULL IS NULL)
codMarca	#MARCAS			Qualificar no WHERE como IN (#MARCAS) OR (#MARCASNULL IS NULL)
codCatalogo	#CATALOGOS			Qualificar no WHERE como IN (#CATALOGOS) OR (#CATALOGOSNULL IS NULL)
codGrade	#GRADES			Qualificar no WHERE como IN (#GRADES) OR (#GRADESNULL IS NULL)
codRepres	:p5	String	255	Utilizada para filtrar um representante nos produtos para digitação online, obrigatório ":p5 or :p5 is null"
descricao	:p6	String	255	Filtro opcional like do produto para editdisplays"
descricao	:p7	String	255	Filtro opcional selecionado do produto para editdisplays"

Produtos - Grades¶

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

Campo	Tipo	Precisão	Descrição
codReferencia *	String/Integer	255	Código da Referência no ERP
codGrade *	String/Integer	255	Código da Grade no ERP
seqTamanho *	String	255	Código do tamanho na grade no ERP
seqOrdenacao *	Integer		Sequencia de ordenação do tamanho na grade
codTamanho *	String	255	Descrição do tamanho no ERP (Ex: "P")
qtdPalito	Integer		Quantidade de peças para grade palito, por padrão é 1. NÃO PODE SER NULO.
itemAtivoLido	Integer		Indicador se item ativo, caso não informado, por padrão 1 (ativo)
descricao	String	255	Descrição da grade no ERP
percPalito	Double		Percentual de distribuição por tamanho
flagLiberadoDivisorGradeFechada	String	255	Indica se produto pode ou não ser editado quando distribuição por percentual de tamanho

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codReferencia	:p2	String	255	Código da referência no ERP
codColecao	#COLECOES			Qualificar no WHERE como IN (#COLECOES) OR (#COLECOESNULL IS NULL)
codTabelaPreco	#TABPRECOS			Qualificar no WHERE como IN (#TABPRECOS) OR (#TABPRECOSNULL IS NULL)
codRepres	:p5	String	255	Utilizada para filtrar um representante nos produtos para digitação online, obrigatório ":p5 or :p5 is null"
seqTamanho	:p6	String	255	Filtro opcional do seqTamanho
descricaoTamanho	:p7	String	255	Filtro opcional da descrição do tamanho

Produtos - Sortimentos¶

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

Campo	Tipo	Precisão	Descrição
codReferencia *	String/Integer	255	Código da Referência no ERP
codSortimento *	String/Integer	255	Código do Sortimento no ERP
descricao	String	255	Descrição do sortimento no ERP
codCorBase	String	255	Código da cor comercial (usada no catalogo e no cod. cor do força de vendas)
rgb	String	255	Valor hexadecial ou RGB da cor para amostra ao representante
loteEntrega	String	255	Lote de Entrega padrão do sortimento
itemAtivo	Integer	1	Situação do Item (0 - Inativo, 1 - Ativo)
percentualSortimento	Double		Percentual de sortimento
flagEstoqueLimitado	Integer	1	Estoque limitado (0 - Não, 1 - Sim)
divisorLote	String	255	Código de divisor usado para divisão de pedido (Customização especifica)
nomeDivisorLote	String	255	Nome de divisor usado para divisão de pedido (Customização especifica)
seqOrdenacao	Integer		Sequencia de ordenação das cores no produto. Caso não informado será gerado um incremental pela ordem de inserção
contaFornecedor	String	255	Conta do fornecedor do depósito (Customização especifica)

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codReferencia	:p2	String	255	Código da referência no ERP
codColecao	#COLECOES			Qualificar no WHERE como IN (#COLECOES) OR (#COLECOESNULL IS NULL)
codTabelaPreco	#TABPRECOS			Qualificar no WHERE como IN (#TABPRECOS) OR (#TABPRECOSNULL IS NULL)
codRepres	:p5	String	255	Utilizada para filtrar um representante nos produtos para digitação online, obrigatório ":p5 or :p5 is null"
seqTamanho	:p6	String	255	Filtro opcional do seqTamanho
descricaoTamanho	:p7	String	255	Filtro opcional da descrição do tamanho

Produtos - Etiquetas¶

Retornar a listagem das etiquetas ATIVAS dos produtos

Campo	Tipo	Precisão	Descrição
codEtiqueta	String	255	Código da etiqueta
nome	String	255	Nome da etiqueta

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEtiqueta	:p2	String	255	classificar no WHERE como = :p2 OR :p2 IS NULL
codEtiqueta	:p3	String	255	classificar no WHERE como LIKE :p3

Produtos - Linhas¶

Retornar a listagem das linhas ATIVAS dos produtos

Campo	Tipo	Precisão	Descrição
codLinha	String	255	Código da linha
nome	String	255	Nome da linha

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codLinha	:p2	String	255	classificar no WHERE como = :p2 OR :p2 IS NULL
codLinha	:p3	String	255	classificar no WHERE como LIKE :p3

Produtos - Tipos¶

Retornar a listagem dos tipos ATIVOS dos produtos

Campo	Tipo	Precisão	Descrição
codTipoPeca	String	255	Código do tipo peça
nome	String	255	Nome do tipo peça

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codTipoPeca	:p2	String	255	classificar no WHERE como = :p2 OR :p2 IS NULL
codTipoPeca	:p3	String	255	classificar no WHERE como LIKE :p3

Produtos - Modelos¶

Retornar a listagem dos modelos ATIVOS dos produtos

Campo	Tipo	Precisão	Descrição
codTipoModelo	String	255	Código do tipo modelo
nome	String	255	Nome do tipo modelo

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codTipoModelo	:p2	String	255	classificar no WHERE como = :p2 OR :p2 IS NULL
codTipoModelo	:p3	String	255	classificar no WHERE como LIKE :p3

Produtos - Gênero¶

Retornar a listagem dos gêneros ATIVOS dos produtos

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

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codGenero	:p2	String	255	classificar no WHERE como = :p2 OR :p2 IS NULL
codGenero	:p3	String	255	classificar no WHERE como LIKE :p3

Produtos Skus¶

Consulta de produtos SKUs utilizada internamente pela GEOvendas

Campo	Tipo	Precisão	Descrição
codReferencia *	String/Integer	255	Código da Referência
seqTamanho*	String/Integer	255	Sequencia do tamanho
seqSortimento	String	255	Sequência de Sortimento
codigoReduzido	String	255	Código reduzido / Codigo do sku
percPalito	Double	255	Percentual da grade palito
ean	String	255	Sequência numérica do código de barras
ncm	String	255	Nomenclatura que identifica códigos de oito dígitos para produtos diversos
divisorPedido	String	255	Propriedade específica utilizada em alguns clientes para divisão de pedidos (Ainda não commitado)

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)

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

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

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

Pedido - UUID¶

Retornar a situação do pedido no ERP.

Campo	Tipo	Precisão	Descrição
codPedidoERP *	String		Código do pedido no ERP.
FlagCodigoTemporario	Integer	255	Flag se é um código temporário
FlagCodigoRestaurado	Integer	255	Flag se é um código restaurado
MsgErro	String	255	Menasgem de erro do pedido

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codPedido	#PEDIDOS			Uuid do pedido

Pedido - UUID - (Massa)¶

Retornar a situação do pedido no ERP.

Campo	Tipo	Precisão	Descrição
Uuid *	String	255	Uuid do pedido
codPedidoERP *	String		Código do pedido no ERP.
FlagCodigoTemporario	Integer	255	Flag se é um código temporário
FlagCodigoRestaurado	Integer	255	Flag se é um código restaurado
MsgErro	String	255	Menasgem de erro do pedido

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codPedido	#PEDIDOS			Qualificar no WHERE como IN

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
codDivisoesERP	String	255	Códigos gerados na divisão do pedido pelo ERP do cliente (separados por vírgula ex: 123,321,231)

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

Pedidos por Referência(Cota)¶

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

Listagem de Pedidos - Capa¶

Retornar dados referentes a capa do pedido.

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

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
:p5	Date	-	(opcional) Data inicio de faturamento, incluir :p5 is null
:p6	Date	-	(opcional) Data Fim de faturamento, incluir :p6 is null
#COLECOES (#COLECAONULL)	string		(opcional) para ser utilizado na consulta de pedidos Online
#MARCAS (#MARCANULL)	String	255	Marcas do pedido
#CODPEDIDOCLIENTE (#CODPEDCLIENTENULL)	String	255	Código de pedido do cliente
#CODPEDIDOREPRESENTANTE (#CODPEDIDOREPRESENTANTENULL)	String	255	Código de pedido do representante
'#SITUACAODISPLAY' (#SITUACAODISPNULL)	String	255	Situação do pedido no ERP
#TABPRECOS (#TABPRECONULL)	String	255	Tabelas de Preço Liberadas
#CORINGAS1 (#CORINGA1NULL)	String	255	Coringa 1 (campo dinâmico opcional)
#CORINGAS2 (#CORINGA2NULL)	String	255	Coringa 2 (campo dinâmico opcional)
#CORINGAS3 (#CORINGA3NULL)	String	255	Coringa 3 (campo dinâmico opcional)
#CORINGAS4 (#CORINGA4NULL)	String	255	Coringa 4 (campo dinâmico opcional)
#CORINGAS5 (#CORINGA5NULL)	String	255	Coringa 5 (campo dinâmico opcional)
#CORINGAS6 (#CORINGA6NULL)	String	255	Coringa 6 (campo dinâmico opcional)

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)

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)

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)

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

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

Listagem de Notas Fiscais - Capa¶

Retornar dados referentes a capa da nota do pedido.

Campo	Tipo	Precisão	Descrição
dataEmissao	Date		Data de emissão
numeroNF	String	255	Número da nota Fiscal
codPedido	String	255	Número do código do pedido
situacao	String	255	Situação da nota fiscal
valorLiquido	Double		Valor Líquido
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 nota fiscal eletrônica
qtdeFaturado	Double		Quantidade de itens faturados

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:p1	Date		Data de emissão de
:p2	Date		Data de emissão até
:p3	String	255	Código do representante
#PEDIDOS (#PEDIDONULL)	String	255	Códigos dos pedidos
#CLIENTES (#CLIENTENULL)	String	255	Códigos dos clientes
#MARCAS (#MARCANULL)	String	255	Códigos das marcas
#COLECOES (#COLECAONULL)	String	255	Códigos das coleções

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

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

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

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
modalidadeBCST	double		modalidadeBCST
percentualPobreza	double		percentualPobreza
percentualReducaoMVAParaSimplesNacional	double		percentualReducaoMVAParaSimplesNacional

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
modalidadeBCST	double		modalidadeBCST
percentualPobreza	double		percentualPobreza
percentualReducaoMVAParaSimplesNacional	double		percentualReducaoMVAParaSimplesNacional

SQL de exemplo com base na documentação

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

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

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

SELECT custo_frete, 
       uf
FROM v_ibtech_uf_frete
WHERE upper(uf) = upper(:p1)

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	Sequencia do tamanho
descrProduto	String	255	Descrição de produto
vlrUnitarioAnterior	Double		Valor Unitário Anterior na tabela
seqTamanho *	String	225	Sequencia do tamanho
permiteBonificacao	Integer	1	Definição para Bonificação na tabela
flagOferta	Integer	1	Flag de Oferta na Tabela
codAgrupadorGoldBe	String	0	..
dataVencimento	Date	0	..
aliquotaIpi	Double	0	..
vlrUnitarioBonificado	Double	0	..
vlrUnitarioSugestao	Double	0	..

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:p1	String		Codigo da Empresa
:p2	String		Codigo da Tabela de Preço
:p6	String		Codigo do Representante
codColecao	#COLECOES		Qualificar no WHERE como IN
codReferencia	#REFERENCIAS		Qualificar no WHERE como IN (#REFERENCIAS) OR (#REFERSNULL IS NULL)

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

Tabela de Preço - Política - Valor Mínimo por Regiao¶

Campo	Tipo	Precisão	Descrição
tabPreco	String	255	Tabela de preço
regiao	String	255	Região do cliente
valorMinimo	Double	255	Valor mínimo da região do cliente

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
rep	:p1	String	10	Código do representante (já obtido pelo login)
tabelas	#TABELAS	String	255	Somente #TABELAS, sem #TABELASISNULL
regioes	#REGIAO	String	255	Sempre passar nesse formato AND (REGIAO IN (#REGIAO) OR (#REGIAOISNULL IS NULL))

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

Tabela de Preço - Política - Desconto por Linha de Produto¶

Campo	Tipo	Precisão	Descrição
percDescontoDe *	Double		Percentual de desconto de(Inicio)
percDescontoAte *	Double		Percentual de desconto até(Fim)
percComissao *	Double		Percentual de comissão do Representante
codLinha *	String	255	Código da Linha do produto

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

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa *	:p1	String	255	Código da empresa
codTabela *	:p2	String	255	Código da Tabela

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

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

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
codColecao	#COLECOES			Qualificar no WHERE como IN or #COLECAONULL is null
codTabela	#TABPRECOS			Qualificar no WHERE como IN or #TABPRECONULL is null

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

Produtos - Política - Data Limite¶

Campo	Parâmetro	Tipo	Precisão	Descrição
1	produto	String		Código do Produto (SKU)
2	cor	String		Cor do Produto
3	dataIni	Date		Data Início de entrega
4	dataFim	Date		Data Máxima de entrega

Conta corrente - Saldo flex por representante¶

Campo	Parâmetro	Tipo	Precisão	Descrição
1	codEmpresa	String		Código da empresa
2	codRepresentante	Date		Código do representante
3	saldoFlex	Double		Saldo Flex

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
empresas	#EMPRESAS	IN		Códigos da empresa que serão considerados baseado na configuração da tabela de preços
representante	:p1	String		Código do representante

Pedidos por data de Lote Fatur¶

Deve se trazer os pedidos feitos na data selecionada, somando quantidade e valores, lembrando de remover peças canceladas e afins.

Campo	Parâmetro	Tipo	Precisão	Descrição
1	codRepres	String		Código do representante
2	valor	Double		valor
3	qtdePecas	Double		Quantidade de Peças
3	codTabelaPreco	String		Código da tabela de preço

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
DataPrevFaturamento	:p1	Date		Data de Previsão de Faturamento Base