Força de Vendas - Malharia » Histórico » Versão 17
« Anterior -
Versão 17/297
(diff) -
Próximo » -
Versão atual
maikeu, 05/12/2023 12:42 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. |
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') ) |
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 | 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) |
| 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 | Integer | 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 |