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

« Anterior - Versão 40/297 (diff) - Próximo » - Versão atual
jean, 14/12/2023 18:22 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	codVariante *	String	255	Código da da variante no ERP.
4	nomeVariante *	String	255	Nome da Variante.
5	skuReduzido *	String	255	SKU reduzido do produto.
6	codCatalogo *	String	255	Código do catalogo.
7	codLinha *	String	255	Código da Linha.
8	nomeLinha *	String	255	Nome da Linha.
9	codGrupoCliente *	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	larguraTxt *	String	255	Descrição da largura para exibição.
15	largura *	Double		Largura.
16	gramaturaTxt *	String	255	Informação de gramatura para exibição.
17	gramatura *	Double		gramatura do produto.
18	rendimento *	Double		rendimento do produto.
19	keyword *	String	255	keywords do produto.
20	especial *	Integer		1 se o produto for especial. 0 para os demais casos.
21	composicao *	String	255	Descrição da composição do produto.
22	codClassificacaoFiscal *	String	255	Código da classificação fiscal do produto.
23	descClassificacaoFiscal *	String	255	Descrição da classificação fiscal do produto.
24	codCategoria *	String	255	Código da Categoria do produto.
25	descCategoria *	String	255	Descrição da Categoria do produto.
26	codOrigem *	String	255	Código da Origem do produto.
27	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 os produtos exclusivo de um cliente

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.

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

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

Lista de Parâmetros:

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

Parâmetro	Tipo	Precisão	Descrição
:pDataEmissao	Date		Data de Emissão do Pedido
:p3	String	10	Código do Representante
:p4	String	10	(opcional) Código do Cliente
#COLECOES (#COLECAONULL)	string		(opcional) para ser utilizado na consulta de pedidos Online
#MARCAS (#MARCANULL)	String	255	Marcas do pedido
#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
#CORINGAS1 (#CORINGA1NULL)	String	255	Coringa 1 (campo dinâmico opcional)
#CORINGAS2 (#CORINGA2NULL)	String	255	Coringa 2 (campo dinâmico opcional)
#CORINGAS3 (#CORINGA3NULL)	String	255	Coringa 3 (campo dinâmico opcional)
#CORINGAS4 (#CORINGA4NULL)	String	255	Coringa 4 (campo dinâmico opcional)
#CORINGAS5 (#CORINGA5NULL)	String	255	Coringa 5 (campo dinâmico opcional)
#CORINGAS6 (#CORINGA6NULL)	String	255	Coringa 6 (campo dinâmico opcional)

Listagem de Pedidos - Detalhado¶

Retornar dados detalhados do pedido.

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	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	nomeFantasia	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
37	flagAntecipacaoPedido	Integer		Flag de antecipação
38	flagPedidoParcial	Integer		Flag pedido parcial
39	flagFaturamentoTriangular	Integer		Flag faturamento triangular
40	endereco	String	255	Endereço
41	endNumero	String	255	Número do endereço
42	bairro	String	255	Bairro
43	emailCliente	String	255	Complemento
44	currency	String	255	Tipo de moeda
45	negociacao	Integer		Tipo de negociação

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	qtdeSaldoBruto	Double		Quantidade Saldo Bruto do Produto
6	qtdeSaldoLiquido	Double		Quantidade Saldo Liquido do Produto
7	qtdeFaturado	Double		Quantidade Faturada do Produto
8	qtdeCancelada	Double		Quantidade Cancelada do Produto
9	valorUnitarioBruto	Double		Valor Unitário Bruto do Produto
10	valorUnitarioLiquido	Double		Valor Unitário Liquido do Produto
11	valorTotal	Double		Valor Total do Produto
12	codReferencia	String	255	Código da Referência do Item.
13	seqTamanho	String	255	Tamanho do Item.
14	variante	String	255	Cor do Item.
15	codColecao	String	255	Código da coleção
16	nomeColecao	String	255	Nome da coleção
17	codEtiqueta	String	255	Código da etiqueta
18	nomeEtiqueta	String	255	Nome da etiqueta
19	codLinha	String	255	Código da linha
20	nomeLinha	String	255	Nome da linha
21	codFamilia	String	255	Código da família
22	nomeFamilia	String	255	Nome da família
23	codTipoPeca	String	255	Código do tipo de peça
24	nomeTipoPeca	String	255	Nome do tipo de peça
25	qtdePendente	Double		Quantidade pendente
26	codGrade	String	255	Código da grade
27	dataEntrega	String	255	Data de Entrega do Item.
27	acessorio	Boolean		Se o item é acessório.
28	seqItemPai	Integer		Referência do item pai (Se for acessório)

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	Date		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 peças faturadas
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)

Arquivos (0)

Projeto

Geral

Perfil

Integração Analytics

Wiki