Força de Vendas - Malharia » Histórico » Versão 89

« Anterior - Versão 89/297 (diff) - Próximo » - Versão atual
jean, 09/02/2024 09:34 h

Força de Vendas - Malharia¶

Índice

Introdução
Acesso via JDBC
Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
Layouts de Integração

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

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.

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

Catálogos¶

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.

Lista de Parâmetros:

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

Lotes de Faturamento¶

Retornar o cadastro de lotes de faturamento

Campo	Tipo	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/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	nomeTipoNota	String	255	Nome do Tipo da Nota
27	motivoQuarentenaPedidos	String	255	Motivo Da Quarentena dos pedidos
28	atendente	String	255	Atendente do pedido
29	tabPrecoPedido	String	255	Tabela de Preço do Pedido
30	situacaoWorkFlow	String	255	Situação do Ppedido no WorkFlow
31	nomeRepres	String	255	Nome Representante
32	valorFaturado	Double		Valor Faturado
33	qtdeEntregue	Double		Quantidade Entregue
34	percEntrega	Double		Percentual de Entrega
35	nomeFantasia	String	255	Nome Fantasia
36	nomeMarca	String	255	Marca do Pedido p/ Histórico de Pedidos

Lista de Parâmetros:

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

Parâmetro	Tipo	Precisão	Descrição
:p1	Date		(opcional) Data de Emissão do Pedido inicial
:p2	Date		(opcional) Data de Emissão do Pedido final
:p3	String	10	(opcional) Código do Cliente
:p4	String		(opcional) Nome do Cliente
:p5	List<String>		(opcional) Tipo da nota do pedido
:p6	List<String>		(opcional) Status do ERP
:p7	String	10	(opcional) Código da negociacao
:p8	String	10	(opcional) Código do pedido
:p9	Date		(opcional) Data de previsão de faturamento inicial
:p10	Date		(opcional) Data de previsão de faturamento final
:p11	String	10	(opcional) Código do representante

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
23	nomeTipoNota	String	255	Nome do Tipo de Nota
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	emailCliente	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

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.

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

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.

Pos	Campo	Tipo	Precisão	Descrição
1	dataEmissao	String		Data de Emissão da Nota Fiscal
2	numeroNF	String	255	Número da Nota Fiscal
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

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)

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)

Arquivos (0)

Projeto

Geral

Perfil

Integração Analytics

Wiki