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 - Desconto Comercial (opcional)
   7. Tabela de Preço - Política - Desconto Financeiro (opcional)
   8. Tabela de Preço - Política - Desconto Antecipação (opcional)
   9. Tabela de Preço - Política - Prazo Adicional (opcional)
   10. Tabela de Preço - Política - Desconto Volume (opcional)
   11. Tabela de Preço - Política - Preços por volume (opcional)
   12. Tabela de Preço - Política - Desconto 13 (Segmento/Cond. Pagamento) (opcional)
   13. Tabela de Preço - Política - Depósitos por fornecedor
   14. Tabela de Preço - Política - Desconto Adicional de Lote (opcional)
   15. Tabela de Preço Política Desconto Compra Acumulada (opcional)
   16. Desconto Campanha - Política de Descontos (opcional)
   17. Títulos Em Aberto (opcional)
   18. Condição de Venda
   19. Cota de estoque - Por representante (opcional)
   20. Tipo de Nota(opcional)
   21. Tipo de Cobrança(opcional)
   22. Comissões (opcional)
   23. Comissões - Extrato Resumo (opcional)
   24. Comissões - Extrato Detalhado (opcional)
   25. Clientes
   26. Clientes - Campos Customizados (opcional)
   27. Clientes - Locais de Entrega(opcional)
   28. Clientes - Ramos de Atividade(opcional)
   29. Clientes - Grupos de Cliente(opcional)
   30. Clientes - Condições de venda(opcional)
   31. Clientes - Marcas(opcional)
   32. Clientes - Marcas Concorrentes(opcional)
   33. Produtos - Gold Be (Exclusiva)
   34. Produtos - Prioridade de linha para distribuição (opcional)
   35. Produtos
   36. Produtos - Grades
   37. Produtos - Sortimentos
   38. Produtos - Etiquetas
   39. Produtos - Linhas
   40. Produtos - Tipos
   41. Produtos - Modelos
   42. Produtos - Gênero
   43. Produtos Skus (opcional)
   44. Produto - Código Reduzido (opcional - somente se ERP precisa do código reduzido)
   45. Produto - EAN13 (opcional)
   46. Produtos Parte Cima Parte Baixo (opcional)
   47. Bloqueio de Referências(opcional)
   48. Pedido - Capa
   49. Pedidos por Referência (opcional)
   50. Listagem de Pedidos - Capa
   51. Listagem de Pedidos - Detalhado
   52. Listagem de Pedidos - Itens
   53. Listagem de Pedidos - Notas
   54. Listagem de Pedidos - Observações (opcional)
   55. Listagem de Pedidos - Histórico (opcional)
   56. Estoque (Depreciada) - Alterada para Estoque Centralizado
   57. Lote Entrega (opcional)
   58. Lotes de Faturamento (opcional)
   59. Cálculo substituição tributária (opcional)
   60. Grupos substituição tributária (opcional)
   61. Integração Valor de Frete por UF (opcional)
   62. Tabela de Preço SKU (opcional)
   63. Listagem de Pedidos em Aberto - Capa (opcional)
   64. Listagem de Pedidos em Aberto - Detalhado (mesma estrutura Listagem de Pedidos - Detalhado) (opcional)
   65. Listagem de Pedidos em Aberto - Itens (mesma estrutura Listagem de Pedidos - Itens) (opcional)
   66. SKUs Pronta Entrega e Programado (opcional)
   67. Clientes Reposição (opcional)
   68. Produtos - Data de Entrega (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)
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

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

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

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¶

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

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

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

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

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

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
codCliente	#CLIENTES			Filtro de código de 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

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

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)

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)

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)

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

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

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

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

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

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.

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

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

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

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

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

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

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

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

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
codTabela	:p2	String/Integer	255	Código da tabela de preços no ERP
codColecao	#COLECOES			Qualificar no WHERE como IN

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