Força de Vendas - Malharia¶

Í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. Produtos
   2. Produtos - Variantes
   3. Produtos - Exclusivos
   4. Tabela de Preço - Capa
   5. Tabela de Preço - Itens
   6. Tabela de Preço - Clientes
   7. Tabela de Preço - Representantes
   8. Catalogos
   9. Acessórios-de-Produtos
   10. Lotes de Faturamento
   11. Condição de Venda
   12. Listagem de Pedidos - Consulta
   13. Listagem de Pedidos - Detalhamento da Capa
   14. Listagem de Pedidos - Itens
   15. Listagem de Pedidos - Notas
   16. Listagem de Pedidos - Notas Itens
   17. Listagem de Pedidos - Situação ERP
   18. Listagem de Pedidos - Tipo Nota
   19. Listagem de pedidos para conjugar
   20. Triangulação
   21. Transportadoras
   22. Comissões - Extrato Resumo
   23. Comissões - Extrato Detalhado
   24. Títulos
   25. Tipo de Cobrança
   26. Condição de Pagamento
   27. Campos Customizados
   28. Partidas de Pedidos
   29. Lista pública de clientes
   30. Carga Máquina
   31. Politica Comercial - Proporcional Condição de Pagamento ERP - Preço Sugerido
   32. Politica Comercial - Proporcional Condição de Pagamento ERP - Comissão Sugerida
   33. Carga Máquina - Dalila
   34. Romaneios
   35. Romaneios - Itens
   36. Clientes (Infos Complementares)
   37. Consulta de pedido - ERP
   38. Minimo Grupo Produto
   39. Minimo Grupo Produto - Produtos

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

Produtos¶

Retornar a listagem de produtos.

Pos	Campo	Tipo	Precisão	Descrição
1	codProduto *	String	255	Código do Produto no ERP. É o código usado para gravar o produto no ERP.
2	nomeProduto *	String	255	Descrição do Produto.
3	larguraTxt *	String	255	Descrição da largura para exibição.
4	largura *	Double		Largura.
5	gramaturaTxt *	String	255	Informação de gramatura para exibição.
6	gramatura *	Double		gramatura do produto.
7	rendimentoMKG *	Double		rendimento do produto em M/KG.
8	keyword *	String	255	keywords do produto.
9	composicao *	String	255	Descrição da composição do produto.
10	acessorio *	Integer	0,1	Deve ser informado 1, quando a linha representar um acessório. Default: 0
11	vendaAcessorio *	Integer	0,1	Deve ser informado 1, quando é possível vender o acessório como um produto principal. Default: 0
12	unidadeMedida *	String	KG,M	Deve ser informado M para metros e KG para quilos. Default: KG
13	urlFichaTecnica	String		URL da Ficha tecnica do produto. O arquivo PDF deve estar acessível publicamente caso seja uma URL direta ao arquivo, caso seja URL de página mesma não deve ter o cabeçalho X-Frame-Options configurada

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codCatalogo	:p2	String	255	Código do catalogo no ERP
codProduto	#PRODUTOS	String	text	Lista de Referências Ex: and (codProduto in (#PRODUTOS) or #PRODUTOS_TODOS = '') Para ORACLE and (codProduto in (#PRODUTOS) or nvl(#PRODUTOS_TODOS,'0') = nvl('','0') )

Produtos - Variantes¶

Retornar a listagem de variantes dos produtos.

Pos	Campo	Tipo	Precisão	Descrição
1	codProduto *	String	255	Código do Produto no ERP. É o código usado para gravar o produto no ERP.
2	codVariante *	String	255	Código da da variante no ERP.
3	nomeVariante *	String	255	Nome da Variante.
4	skuReduzido *	String	255	SKU reduzido do produto.
5	codCatalogo *	String	255	Código do catalogo.
6	pesoPadrao *	Double		Peso padrão.
7	codLinha *	String	255	Código da Linha.
8	nomeLinha *	String	255	Nome da Linha.
9	codGrupoCor *	String	255	Código do grupo cor.
10	nomeGrupoCor *	String	255	Nome do grupo da cor.
11	rgb *	String		RGB referente a variante do produto.
12	codTipoPeca *	String		Código do tipo da peça.
13	nomeTipoPeca *	String		Nome do tipo de peça.
14	especial*	Integer		1 se o produto for exclusivo. 0 para os demais casos. Se o código for 1, desviaremos para quem não tem autorização
15	codClassificacaoFiscal *	String	255	Código da classificação fiscal do produto.
16	descClassificacaoFiscal *	String	255	Descrição da classificação fiscal do produto.
17	codCategoria *	String	255	Código da Categoria do produto.
18	descCategoria *	String	255	Descrição da Categoria do produto.
19	codOrigem *	String	255	Código da Origem do produto.
20	descOrigem *	String	255	Descrição da Origem do produto.
21	multiploPadrao *	Double		Valor do multiplo padrão da variante.

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codCatalogo	:p2	String	255	Código do catalogo no ERP
codProduto	#PRODUTOS	String	text	Lista de Referências Ex: and (codProduto in (#PRODUTOS) or #PRODUTOS_TODOS = '') Para ORACLE and (codProduto in (#PRODUTOS) or nvl(#PRODUTOS_TODOS,'0') = nvl('','0') )

Produtos - Exclusivos¶

Retornar a listagem de produtos exclusivos. Esta é a autorização do cliente para itens especiais.

Pos	Campo	Tipo	Precisão	Descrição
1	skuReduzido	String	255	SKU reduzido do produto.
2	codCliente	String	255	Código do Cliente

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
codEmpresa	String/Integer	10	Código da empresa no ERP

Tabela de preço - Capa¶

Retornar a capa da tabela de preço.

Pos	Campo	Tipo	Precisão	Descrição
1	codTabela *	String	255	Código da Tabela de preço no ERP.
2	nomeTabela *	String	255	Descrição da Tabela de preço.
3	nomeApresentacao*	String	255	Nome para apresentação no FVM
4	ordem	Integer	255	Ordem
5	status	String	255	Status(ativo/inativo)
6	dataValidadeInicial	Date		Data Validade Inicial
7	dataValidadeFinal	Date		Data Validade Final
8	liberacaoAcesso	String	255	Liberação de Acesso (Todos/Específica)

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ço no ERP

Tabela de preço - Itens¶

Retornar a listagem de tabela de preços.

Pos	Campo	Tipo	Precisão	Descrição
1	codTabela *	String	255	Código da Tabela de preço no ERP.
2	codProduto *	String	255	Código do produto no ERP.
3	codGrupoCor *	String	255	Código Grupo Cor.
4	nomeGrupoCor *	String	255	Descrição do Grupo Cor.
5	prazoMedio *	Integer		Identificar do prazo medio.
6	padrao *	Integer		1 se for preço padrão. 0 caso não seja.
7	rendimento *	Double		Rendimento do produto.
8	precoQuilo *	Double		Preço do produto por quilo.
9	precoMetro *	Double		Preço do produto por metro.

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ço no ERP

Tabela de Preço - Clientes¶

Retornar a listagem de clientes de tabelas de preços.

Pos	Campo	Tipo	Precisão	Descrição
1	codigoTabela	String	255	Código da Tabela de Preço
2	codigoCliente	String	255	Código do Cliente

Tabela de Preço - Representante¶

Retornar a listagem de representantes de tabelas de preços.

Pos	Campo	Tipo	Precisão	Descrição
1	codigoTabela	String	255	Código da Tabela de Preço
2	codigoRepresentante	String	255	Código do Representante

Catalogos¶

Retornar a listagem de Catálogos.

Pos	Campo	Tipo	Precisão	Descrição
1	codCatalogo *	String	255	Código do Catalogo no ERP.
2	nomeCatalogo *	String	255	Descrição do Catalogo no ERP.
3	status *	Integer		1 quando estiver liberado. 0 quando estiver bloqueado.

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP

Acessórios de Produtos¶

Retornar a listagem de vinculo de produtos com acessórios.

Pos	Campo	Tipo	Precisão	Descrição
1	codProduto *	String	255	Código do Produto no ERP.
2	codAcessorio (codProduto) *	String	255	Código do acessório no ERP.
3	multiplicador *	Double		Multiplicador proporcional entre a venda de um item principal e um acessório. EX: Se for inserido 18kg na quantidade principal e na integração estiver inserido que se aplica 0,250kg para cada kilo do principal, a quantidade a ser inserida automaticamente será 4,5kg.
4	codCatalogo	String	255	Código do catalogo a que o acessorio está vinculado
5	liberado	Integer	0 ou 1. Default: 1	0: Acessório não liberado para a venda direta. 1: Acessório liberado para a venda direta.

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
catalagos	:p2	Lista String		Lista de catálogos ativos a serem importados

Lotes de Faturamento¶

Retornar o cadastro de lotes de faturamento

Campo	Tipo	Precisão	Descrição
dataLimite*	Date		Data Limite -- 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)

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer		codEmpresa
dataReferencia	:p2	Date		Data de referência

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

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP

Listagem de Pedidos - Consulta¶

Retornar dados referentes a capa do pedido.

Pos	Campo	Tipo	Precisão	Descrição
1	codEmpresa *	String	255	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		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 *	String		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	nomeTipoNota *	String	255	Nome do Tipo da Nota
27	corCard *	Integer		1 - Sem cor / 2 - Vermelho / 3 - Amarelo / 4 - Verde / 5 - Azul
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	codCondVenda *	String	255	Cod da Condição de Venda
38	nomeCondVenda *	String	255	Nome da Condição de Venda
39	negociacao *	String	255	Código da negociação, salvo pela GEO
40	flagPartidasAtivas *	Integer		0 - NÃO / 1 - SIM
41	flagPedidoFVT *	Integer		0 - NÃO / 1 - SIM

Parâmetros da Consulta

Formato sugerido de data: yyyy-mm-dd (2023-12-13)

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	dataEmissaoInicial	Date		Data de Emissão do Pedido inicial	Não
:p2	dataEmissaoFinal	Date		Data de Emissão do Pedido final	Não
:p3	codCliente	String		Código do Cliente	Não
:p4	nomeCliente	String		Nome do cliente	Não
:p5	tipoNotaPedido	List<String>		Tipo da nota do pedido	Não
:p6	statusErp	List<String>		Status do ERP	Não
:p7	negociacao	String		Código da negociação	Não
:p8	codPedido	String		Código do pedido	Não
:p9	dataPrevInicial	Date		Data de previsão de faturamento inicial	Não
:p10	dataPRevFinal	Date		Data de previsão de faturamento final	Não
:p11	codRepres	String		Código do representante	Não

Listagem de Pedidos - Detalhamento da Capa¶

Retornar dados detalhados do pedido.

Pos	Campo	Tipo	Precisão	Descrição
1	dataEmissao *	Date		Data de Emissão do Pedido
2	dataPrevFat *	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 / Código do Tipo de Pedido
23	nomeTipoNota *	String	255	Nome do Tipo de Nota / Nome do Tipo de Pedido
24	valorBruto *	Double		Valor Bruto do Pedido
25	valorLiquido *	Double		Valor Liquido do Pedido
26	valorSaldo *	Double		Valor Saldo do Pedido
27	percDesconto1 *	Double		Percentual de Desconto 1
28	percDesconto2 *	Double		Percentual de Desconto 2
29	percDesconto3 *	Double		Percentual de Desconto 3
30	percDesconto4 *	Double		Percentual de Desconto 4
31	percDesconto5 *	Double		Percentual de Desconto 5
32	nomeFantasia *	String	255	Nome Fantasia
33	emailCliente *	String	255	E-mail do Cliente
34	pedidoCliente *	String	255	Codigo do Pedido de controle do cliente
35	pedidoRepresentante *	String	255	Codigo do Pedido de controle do representante
36	flagAntecipacaoPedido *	Integer		Flag de antecipação
37	flagPedidoParcial *	Integer		Flag pedido parcial
38	flagFaturamentoTriangular *	Integer		Flag faturamento triangular
39	endereco *	String	255	Endereço
40	endNumero *	String	255	Número do endereço
41	bairro *	String	255	Bairro
42	complemento *	String	255	Complemento
43	currency *	String	255	Tipo de moeda
44	negociacao *	Integer		Tipo de negociação
45	observacaoPedido *	String	255	Observação do Pedido
46	observacaoNota *	String	255	Observação da Nota
47	nomeRepres *	String	255	Nome do representante
48	codTriangulador *	String	255	Código do Triangulador
49	nomeTriangulador *	String	255	Nome do Triangulador
50	motivoBloqueio *	String	255	Motivo do bloqueio
51	subtipoPedido	String	255	Subtipo do pedido

Parâmetros da Consulta

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	codPedido	String		Código do pedido no ERP	Sim
:p2	codEmpresa	String		Código de empresa	Não

Listagem de Pedidos - Itens¶

Retornar dados dos Itens do pedido.

Pos	Campo	Tipo	Precisão	Descrição
1	codItem *	String	255	Código do Item para Ordenação
2	codProduto *	String	255	Código do Produto
3	nomeProduto *	String	255	Nome do Produto
4	qtdePedida *	Double		Quantidade Pedida do Produto
5	valorPedidoBruto *	Double		Quantidade Saldo Bruto do Produto
6	valorPedidoLiquido *	Double		Quantidade Saldo Liquido do Produto
7	qtdeSaldo *	Double		Quantidade Saldo
8	valorSaldoBruto *	Double		Quantidade Saldo Bruto do Produto
9	valorSaldoLiquido *	Double		Quantidade Saldo Liquido do Produto
10	qtdeFaturado *	Double		Quantidade Faturada do Produto
11	valorFaturadoBruto *	Double		Quantidade Saldo Bruto do Produto
12	valorFaturadoLiquido *	Double		Quantidade Saldo Liquido do Produto
13	qtdeCancelada *	Double		Quantidade Cancelada do Produto
14	valorCanceladoBruto *	Double		Quantidade Saldo Bruto do Produto
15	valorCanceladoLiquido *	Double		Quantidade Saldo Liquido do Produto
16	valorUnitarioBruto *	Double		Valor Unitário Bruto do Produto
17	valorUnitarioLiquido *	Double		Valor Unitário Liquido do Produto
18	codVariante *	String	255	Código da Variante do Item.
19	nomeVariante *	String	255	Cor do Item.
20	codSKU *	String	255	Código do SKU.
21	codColecao *	String	255	Código da coleção
22	nomeColecao *	String	255	Nome da coleção
23	codCategoria *	String	255	Código da Categoria
24	nomeCategoria *	String	255	Nome da Categoria
25	codLinha *	String	255	Código da linha
26	nomeLinha *	String	255	Nome da linha
27	codTipoPeca *	String	255	Código do tipo de peça
28	nomeTipoPeca *	String	255	Nome do tipo de peça
29	dataEntrega *	String	255	Data de Entrega do Item.
30	acessorio *	Boolean		Se o item é acessório.
31	seqItemPai *	Integer		Referência do item pai (Se for acessório)
32	percComissao *	Double		Percentual de comissão do item
33	qualidadeSintetica *	String	255	Qualidade Sintética do item
34	qualidadeAnalitica *	String	255	Qualidade Analítica do item
35	percDesconto *	Double		Percentual de desconto do item
36	status*	String		Status do item

Lista de Parâmetros:

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	codPedido	String		Código do Pedido	Sim

Listagem de Pedidos - Notas¶

Retornar dados das Notas Fiscais do pedido.

Pos	Campo	Tipo	Precisão	Descrição
1	dataEmissao	Date		Data de Emissão da Nota Fiscal (timestamp)
2	numeroNF	String	255	Número da Nota Fiscal (separar a série com /)
3	situacao	String	255	Situação da Nota Fiscal
4	valorLiquido	Double		Valor Total da Nota Fiscal
5	codTransp	String	255	Código da Transportadora
6	nomeTransp	String	255	Nome da Transportadora
7	codRedespacho	String	255	Código do Redespacho
8	nomeRedespacho	String	255	Nome do Redespacho
9	chaveNFE	String	255	Chave da Nota Fiscal
10	qtdeFaturado	Double		Quantidade de quilos faturados
11	dataEntrega	Date		Data de entrega da Nota Fiscal
12	descSituacaoEntrega	String		Descrição da situação atual da entrega
13	dataSaida	Date		Data de saida da Nota Fiscal
14	tipo	String		Tipo da Nota Fiscal
15	codPedido	String		Código do Pedido (se mais de um, separar por ponto e vírgula)
16	pesoBruto	Double		Peso bruto
17	pesoLiquido	Double		Peso líquido
18	volumes	Integer		Quantidade de volumes da Nota Fiscal
19	condPagamento	String		Condição de Pagamento da Nota Fiscal
20	codCliente	String		Código do cliente

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:p1	String		(opcional) codPedido (Utilizar comparador LIKE)
:p2	String		(opcional) codCliente
:p3	String		(opcional) numeroNf (separar a série com /)

Listagem de Pedidos - Notas Itens¶

Retornar dados dos Itens das Notas Fiscais do pedido.

Pos	Campo	Tipo	Precisão	Descrição
1	empresa	String	255	Nome da Empresa
2	numeroNF	String	255	Número da Nota Fiscal (separar a série com /)
3	sequenciaNF	String	255	Sequência do item na Nota Fiscal
4	codProduto	String	255	SKU do produto
5	descricao	String	255	Descrição do item
6	unidadeMedida	String	255	Unidade de medida do item
7	quantidade	Double	255	Quantidade do item
8	precoBruto	Double	255	Preço Bruto do item
9	precoLiquido	Double	255	Preço Líquido do item

Listagem de Pedidos - Situação ERP¶

Retorna todas as situações de pedidos do ERP.

Campo	Tipo	Precisão	Descrição
situacaoEdt	String	255	Situação de pedido

Listagem de Pedidos - Tipo Nota¶

Retorna todos os tipos de notas de pedidos do ERP.

Campo	Tipo	Precisão	Descrição
tipoNota	String	255	Tipo de nota de pedido

Listagem de pedidos para conjugar¶

Retornar os pedido que podem ser utilizados pelo representante.

Pos	Campo	Tipo	Precisão	Descrição
1	codPedido *	String	255	Código do Pedido no ERP
2	codCliente *	String	255	Código do Cliente ERP
3	codRepres *	String	255	Código do Representante
4	descricao *	String	255	Descrição utilizada para exibir para o representante

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codCliente	:p2	String	255	Código do Cliente no ERP

Triangulação¶

Retornar relação dos trianguladores (Geral, por representante ou por cliente).

Pos	Campo	Tipo	Precisão	Descrição
1	codEmpresa *	String	255	Código da Empresa
2	codClienteTriangulacao *	String	255	Código do cliente triagulador
3	nomeClienteTriangulacao *	String	255	Nome do cliente de triangulação. O nome está aqui pois podem existir clientes onde a base de clientes de triangulação não é a mesma da de clientes de venda.
4	codClienteVenda	String	255	Código do cliente da venda a ser relacionado o cliente de triangulação (é opcional, se enviar nulo entende-se que o cliente de triangulação está disponível para todos os clientes de venda)
5	codRepresentante	String	255	Código do representante a ser relacionado o cliente de triangulação (é opcional, se enviar nulo entende-se que o cliente de triangulação está disponível para todos os representantes)

Transportadoras¶

Retornar relação das transportadoras

Pos	Campo	Tipo	Precisão	Descrição
1	codEmpresa *	String	255	Código da Empresa
2	codTransportadora *	String	255	Código da transportadora
3	nomeTransportadora *	String	255	Nome da transportadora.
4	situacao	Inteiro		1 - Ativo / 0 - Inativo

Comissões - Extrato Resumo¶

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

Pos	Campo	Tipo	Precisão	Descrição
1	anoMes	Integer	6	Ano/mês de referencia ex: 201708
2	flagMesFechado	Integer	1	Identificador para a situação do mês (0 - Em Aberto(Box Amarelo) / 1 - Fechado (Box Verde)
3	valorIRF	Double		Valor de IR Total
4	valorLiquido	Double		Valor líquido
5	valorBruto	Double		Valor bruto

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:p1	List<String/Integer>		anoMes
:p2	String		Código do representante

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

Pos	Campo	Tipo	Precisão	Descrição
1	anoMes	Integer	6	Ano/mês de referencia ex: 201708
2	flagMesFechado	Integer	1	Identificador para a situação do mês (0 - Em Aberto(Box Amarelo) / 1 - Fechado (Box Verde)
3	valorIRF	Double		Valor de IR Total
4	valorLiquido	Double		Valor líquido
5	valorBruto	Double		Valor bruto
6	dataLcto	Date		Data do registro
7	lancamento	Integer		Identificador do registro (usado para ordenação)
8	cliente	String	255	Código do do Cliente
9	baseComissao	Double		Valor base para calculo da comissão
10	percBaseComissao	Double		Percentual Base Cálculo comissão
11	percComiss	Double		Percentual de comissão
12	valorCredito	Double		Valor para credito
13	valorDebito	Double		Valor para debito
14	observacao	String	255	Historico ou Descrição do lançamento
15	codPedido	String	255	Código do pedido
16	numeroNF	String	255	Número da Nota Fiscal (separar a série com /)
17	titulo	String	255	Título da comissão
18	representante	String	255	Código do representante

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:p1	String/Integer		anoMes
:p2	String		Código do representante

Títulos¶

Retornar a listagem de títulos (duplicatas) dos clientes 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.

Pos	Campo	Tipo	Precisão	Descrição
1	titulo *	String/Integer	255	Chave única do título no ERP
2	numeroNf	String/Integer	255	Número da nota fiscal ou documento (separar a série com /)
3	dataEmissao	Datetime		Data de Emissão do título
4	dataVecto	Datetime		Data de Vencimento do título
5	valor	Double		Valor do título em aberto
6	nomePortador	String/Integer	255	Nome/Descrição do portador
7	codCliente	String/Integer	255	Código do cliente
8	nomeCliente	String/Integer	255	Nome do cliente
9	codgrupocliente	String/Integer	255	Código do grupo do cliente
10	moeda	String/Integer	255	Moeda (O padrão é R$, deixar null)
11	nomeFantasiaCliente	String	255	Nome fantasia do cliente
12	dataPagamento	Datetime		Data de pagamento do título
13	condVenda	String	255	Condição de Venda
14	diasAtraso	Integer		Número de dias de atraso
15	desconto	Double		Desconto
16	baseComLiq	Double		Valor do título após aplicação do desconto
17	valorJuros	Double		Valor do Juros
18	valorPago	Double		Valor pago
19	codRepresentante	String	255	Código do representante
20	situacao	Integer		1 - VENCIDO / 2 - À VENCER / 3 - PAGO APÓS VENCIMENTO / 4 - PAGO ANTES DO VENCIMENTO
21	parcela	Integer		Número da parcela do título

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:p1	Date		(opcional) Data de emissão inicial
:p2	Date		(opcional) Data emissão final
:p3	Date		(opcional) Data vencimento inicial
:p4	Date		(opcional) Data vencimento final
:p5	String		(opcional) Código do cliente
:p6	String		(opcional) Código do representante
:p7	String		(opcional) Número da nota fiscal ou documento
:p8	String		(opcional) Chave única do título no ERP
:p9	List<String>		(opcional) Situação

Tipo de Cobrança¶

Retornar a listagem de tipos de cobranças da condição de pagamento.

Pos	Campo	Tipo	Precisão	Descrição
1	codigo	String	255	Código do Tipo de Cobrança
2	descricao	String	255	Descrição do Tipo de Cobrança
3	codEmpresa	String	255	Código da empresa

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:p1	String/Integer		(opcional) Código da empresa

Condição de Pagamento¶

Retornar a listagem de condição de pagamento.

Pos	Campo	Tipo	Precisão	Descrição
1	nome*	String	255	Nome da condição de pagamento
2	condicaoVenda*	String/Integer	255	Condição de Venda ERP
3	portador	String	255	Portador
4	tipoCobranca	String	255	Código doTipo de cobrança
5	prazoMedio*	Double	255	Prazo médio
6	qtdeParcelas	Integer	255	Quantidade de Parcelas
7	disponivelForcaVendas	Integer	255	Disponível no força de vendas
8	disponivelEcommerce	Integer	255	Disponível no E-commerce
9	valorMinimo	Double	255	Valor mínimo para apresentação
10	liberacao	String	255	TODOS / EXCLUSIVA / BLOQUEADA

Campos Customizados¶

Retornar as informações dos Campos Customizados

Pos	Campo	Tipo	Precisão	Descrição
1	codCliente *	String	255	Cod do Cliente
2	codIdentificador *	String	255	Código do identificador
3	idCampoCustomizado *	String	255	Id do campo Customizado Criado no FV Malharia
4	valorCampoCustomizado *	String	255	Valor que vai retornar no Campo.

Lista de Parâmetros:

Parâmetro	Campo	Tipo	Precisão	Descrição
:p1	codEmpresa	String/Integer	10	Código da Empresa
:p2	codRepres	String/Integer	10	Código do Representante

Partidas de Pedidos¶

Nessa consulta será possível consultar as partidas dos pedidos efetuados.

Pos	Campo	Tipo	Precisão	Descrição
1	anoPartida	String		Retorna a informação de mês e ano da partida no formato AAAAMM
2	codPartida	String		Código da partida no ERP
3	situacao	Integer		código da situação atual da partida
4	codPedido	String		Código do pedido no ERP ao qual a partida pertence
5	sequenciaItem	Integer		Sequência da partida na produção de acordo com o pedido
6	dataEmissao	Date		Data de início da produção da partida no formato AAAA-MM-DD
7	dataPrevisaoFaturamento	Date		Data de previsão de faturamento da partida no formato AAAA-MM-DD
8	codReferencia	String		Código da referência no ERP
9	codVariante	String
10	qtdeQuilos	Double	(10, 2)	Quantidade em kg da partida
11	qtdePecas	Integer		Quantidade de rolos da partida
12	nomeProcessoAtual	String		Nome do processo atual que a partida se encontra
13	nomeProcessoSeguinte	String		Nome da próxima etapa do fluxo de partidas
14	dataBaixa	Date		Data da baixa final da partida no formato AAAA-MM-DD
15	loteCliente	String		Lote do cliente
16	descProduto	String		Descrição do produto
17	codCliente	String		Código do cliente
18	nomeCliente	String		Razão social do cliente
19	codEmpresa	String		Código do empresa
20	codProduto	String		Código do SKU
21	codRepres	String		Código do representante

Parâmetros da Consulta

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	codEmpresa	String		Código da empresa dentro do ERP	Não
:p2	codCliente	String		Código do cadastro do cliente no ERP	Não
:p3	dataEmissaoInicial	Date	AAAA-MM-DD	Data inicial para consulta com base na data de emissão	Sim
:p4	dataEmissaoFinal	Date	AAAA-MM-DD	Data final para consulta com base na data de emissão	Sim
:p5	dataPrevisaoInicial	Date	AAAA-MM-DD	Data inicial para consulta com base na data de previsão	Não
:p6	dataPrevisaoFinal	Date	AAAA-MM-DD	Data final para consulta com base na data de previsão	Não
:p7	codPedido	String		Código do pedido no ERP	Não
:p8	codProduto	String		Código do produto no ERP	Não
:p9	codRepres	String		Código do representante no ERP	Não

Lista pública de clientes¶

Nessa consulta será possível consultar a lista pública de clientes.

Pos	Campo	Tipo	Precisão / Tamanho / Formato	Descrição
1	codCliente	String		Código do cliente no ERP
2	cnpj	String		CNPJ do cliente
3	razaoSocial	String		Razão social do cliente
4	telefone	String		Telefone do cliente
5	pessoaContato	String		Pessoa de contato
6	endereco	String		Endereço completo (Rua, Nº, Bairro)
7	cep	String		CEP do endereço
8	cidade	String		Cidade do cliente
9	uf	String		Estado do cliente
10	dataUltimaCompra	Date		Data da ultima compra do cliente no formato AAAA-MM-DD
11	valorUltimaCompra	Double		Valor da ultima compra do cliente
12	codRepres	String		Código do representante no ERP

Parâmetros da Consulta

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	codCliente	String		Código do cliente no ERP	Não
:p2	cidade	String		Cidade do cliente	Não
:p3	codRepres	String		Código do representante	Não
:p4	dataUltimaCompraInicial	Date	AAAA-MM-DD	Data inicial para consulta com base na data de ultima compra	Não
:p5	dataUltimaCompraFinal	Date	AAAA-MM-DD	Data final para consulta com base na data de última compra	Não

Carga Maquina¶

Nessa consulta será possível consultar os dados de Carga Maquina (customização Urbano).

Pos	Campo	Tipo	Precisão / Tamanho / Formato	Descrição
1	codigo	String		Código da máquina
2	produto	String		Código do Produto
3	maquina	String		Descrição da Máquina
4	qtdeProduto	String		Qtde padrão de principal
5	qtdeAcessorio	String		Qtde padrão de acessório
6	qtdeMinima	String		Qtde mínima para lote (principal + acessório)
7	qtdeMaxima	String		Qtde máxima para lote (principal + acessório)
8	Bocas	String		Quantidade de bocas da máquina

Politica Comercial - Dalila - Proporcional Condição de Pagamento ERP - Preço Sugerido¶

Retornar o preço sugerido apartir da condição de pagamento.

Pos	Campo	Tipo	Precisão	Descrição
1	preco *	Double		Preco retornado via stored procedure.

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa *	:p1	String		Código da cadastrado no tipo de pedido
codCondicaoVenda *	:p2	String		Código da condição de venda
precoBase *	:p3	Double		Preço base utilizado para o calculo
comissaoMaximo *	:p4	Double		Percentual de comissão máximo permitido.

Politica Comercial - Dalila - Proporcional Condição de Pagamento ERP - Comissão Sugerida¶

Retornar a comissão sugerida apartir da condição de pagamento.

Pos	Campo	Tipo	Precisão	Descrição
1	comissão *	Double		Comissão retornado via stored procedure.

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa *	:p1	String		Código da cadastrado no tipo de pedido.
codCondicaoVenda *	:p2	String		Código da condição de venda.
precoBase *	:p3	Double		Preço base utilizado para o calculo.
precoRepres *	:p4	Double		Preço informado pelo representante na digitação.

Carga Máquina - Dalila¶

Retorna os lotes de carga máquina com seus respectivos estoques.

Pos	Campo	Tipo	Precisão	Descrição
1	dataReferencia *	String	yyyy-MM-dd	Data referência do lote.
2	qtdeEstoque *	Double		Quantidade de estoque disponível para a data.

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa *	:p1	String		Código da cadastrado no tipo de pedido.
codProduto *	:p2	String		Código da referência.
dataInicio *	:p3	Date	yyyy-MM-dd	Data inicio da busca de lotes.
dataFim *	:p4	Date	yyyy-MM-dd	Data fim da busca de lotes.

Romaneios¶

Nessa consulta será possível consultar os romaneios.

Pos	Campo	Tipo	Precisão / Tamanho / Formato	Descrição
1	codRomaneio *	String		Código do romaneio
2	situacao *	String		Situação
3	codPedido *	String		Código do pedido
4	codCliente *	String		Código do cliente
5	nomeCliente *	String		Nome do cliente
6	codRepres *	String		Código do representante
7	nomeRepres *	String		Nome do representante
8	transportadora	String		Nome da transportadora
9	condPagamento	String		Nome da condição de pagamento
10	dataEmissao *	Date		Data de emissão do romaneio
11	valorFrete	Double		Valor do frete
12	pesoTotalRomaneado *	Double		Peso total do romaneio
13	qtdeTotalRolos *	Double		Quantidede total de rolos
14	valorTotalRomaneio *	Double		Valor total do romaneio

Parâmetros da Consulta

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	codPedido	String		Código do pedido	Não

Romaneios - Itens¶

Nessa consulta será possível consultar os romaneios.

Pos	Campo	Tipo	Precisão / Tamanho / Formato	Descrição
1	codRomaneio *	String		Código do romaneio
2	sequencia *	Integer		Sequência do item
3	codProduto *	String		Código do produto
4	codVariante *	String		Código da variante
5	sku *	String		Sku do produto
6	descricaoProdutoVariante *	String		Descrição do produto + variante
7	codPartida	String		Código da partida
8	codEtiqueta *	String		Código da etiqueta
9	pesoLiquido *	Double		Peso líquido
10	pesoBruto *	Double		Peso bruto
11	precoUnitario	Double		Preço unitário do item
12	valorLiquido *	Double		Valor liquido
13	codItem *	String		Código do Item do Pedido
14	qtdeRolos *	Integer		Quantidade de rolos
15	lote *	String		Lote
16	qualidadeSintetica *	String		Qualidade sintética
17	qualidadeAnalitica *	String		Qualidade analítica

Parâmetros da Consulta

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	codRomaneio	String		Código do romaneio	Não

Clientes (Infos Complementares)¶

Nessa consulta será possível consultar as informações do cliente que não estão na GeoMunicipioCliente.

Pos	Campo	Tipo	Precisão / Tamanho / Formato	Descrição
1	codCliente *	String		Código do cliente
2	inscricaoMunicipal	String		Inscrição municipal do cliente
3	suframa	String		Suframa do cliente
4	codIBGECobranca	String		Código IBGE do endereço de cobrança
5	cepCobranca	String		Cep do endereço de cobrança
6	ruaCobranca	String		Rua do endereço de cobrança
7	numeroRuaCobranca	String		Número do endereço de cobrança
8	bairroCobranca	String		Bairro do endereço de cobrança
9	cidadeCobranca	String		Cidade do endereço de cobrança
10	ufCobranca	String		Uf do endereço de cobrança
11	telefoneCobranca	String		Telefone do endereço de cobrança
12	emailCobranca	String		Email do endereço de cobrança
13	nomeComprador	String		Nome de comprador
14	telefoneComprador	String		Telefone de comprador
15	emailComprador	String		Email de comprador
16	dataFundacao	Date		Data de fundação
17	regimeTributario	Integer/String		1 - LUCRO PRESUMIDO / 2 - LUCRO REAL / 3 - SIMPLES NACIONAL
18	seguimentoCliente	Integer/String		1 - ATACADISTA / 2 - MALHARIA / 3 - CONFECÇÃO
19	sede	Integer/String		1 - PROPRIA / 2 - ALUGADA
20	formaPagamentoCliente	Integer/String		1 - DUPLICATA
21	pecasProduzidas	Double		Produção Mensal
22	FaturamentoMensal	Double		Faturamento mensal
23	marcasCliente	String		Marcas do cliente
24	parecerRepresentante	String		Parecer do representante
25	limiteDisponivel	Double		Limite disponível
26	dataReativacao	Date		Data solicitação de atualização do Cadastro
27	transportadoraPadrao	String		Código da transportadora padrão utilizada pelo cliente
28	redespachoPadrao	String		Código do redespacho padrão utilizado pelo cliente

Parâmetros da Consulta

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	codCliente	String		Código do cliente	Não

Consulta de pedido - ERP¶

Retornar a consulta de pedidos enviados ao ERP do cliente.

Pos	Campo	Tipo	Precisão	Descrição
1	identificador *	String		Identificador do pedido
2	codigoGeradoErp *	String		Código do pedido gerado no ERP

Parâmetros da Consulta

Parâmetro	Campo	Tipo	Precisão / Tamanho / Formato	Descrição	Obrigatório
:p1	identificador	String		Identificador do pedido	Não

Minimo Grupo Produto¶

Nessa consulta será possível consultar os mínimos grupos de produto.

Pos	Campo	Tipo	Precisão / Tamanho / Formato	Descrição
1	base *	String		Identificação do grupo, está identificação será unica
3	quantidadeMinima *	Double		Quantidade mínima do grupo
4	situacao *	String		ATIVO / INATIVO

Minimo Grupo Produto - Produtos¶

Nessa consulta será possível consultar os produtos cadastrado em um mínimo grupo de produto.

Pos	Campo	Tipo	Precisão / Tamanho / Formato	Descrição
1	base *	String		Identificação do grupo
2	produtos *	String		Lista de produtos do grupo separados por vírgula ex: ('cod1', 'cod2')