Força de Vendas - Malharia » Histórico » Versão 11
Versão 10 (nicolli, 13/11/2023 15:21 h) → Versão 11/297 (nicolli, 13/11/2023 15:21 h)
h1. Força de Vendas - Malharia
*Índice*
# [[Força_de_Vendas_-_Malharia#Introdução|Introdução]]
# [[Força_de_Vendas_-_Malharia#Acesso-via-JDBC|Acesso via JDBC]]
# [[Força_de_Vendas_-_Malharia#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]
## [[Força_de_Vendas_-_Malharia#Tabelas-de-Integração|Tabelas de Integração]]
## [[Força_de_Vendas_-_Malharia#Parâmetros|Parâmetros]]
## [[Força_de_Vendas_-_Malharia#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Força_de_Vendas_-_Malharia#Layouts-de-Integração|Layouts de Integração]]
## [[Força_de_Vendas_-_Malharia#Produtos|Produtos]]
## [[Força_de_Vendas_-_Malharia#Tabela-de-preço|Tabela de Preço]]
## [[Força_de_Vendas_-_Malharia#Catalogos|Catalogos]]
## [[Força_de_Vendas_-_Malharia#Produto-vinculo-Acessórios|Produto vinculo Acessórios]]
h1. 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.
h1. 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.
h1. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
h2. 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.
h2. 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.
h2. 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*
<pre>SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmpresa = :p1
AND codTabela = :p2</pre>
h1. Layouts de Integração
Segue os layouts que devem servir de base para construção dos SQLs de integração.
h2. 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') ) |
h2. 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 |
h2. Tabela de preço
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 |
h2. Catálogos
Retornar a listagem de Catálogos. Catalagos.
|_. 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 |
h2. Produto vinculo Acessórios
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 |
*Índice*
# [[Força_de_Vendas_-_Malharia#Introdução|Introdução]]
# [[Força_de_Vendas_-_Malharia#Acesso-via-JDBC|Acesso via JDBC]]
# [[Força_de_Vendas_-_Malharia#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]
## [[Força_de_Vendas_-_Malharia#Tabelas-de-Integração|Tabelas de Integração]]
## [[Força_de_Vendas_-_Malharia#Parâmetros|Parâmetros]]
## [[Força_de_Vendas_-_Malharia#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Força_de_Vendas_-_Malharia#Layouts-de-Integração|Layouts de Integração]]
## [[Força_de_Vendas_-_Malharia#Produtos|Produtos]]
## [[Força_de_Vendas_-_Malharia#Tabela-de-preço|Tabela de Preço]]
## [[Força_de_Vendas_-_Malharia#Catalogos|Catalogos]]
## [[Força_de_Vendas_-_Malharia#Produto-vinculo-Acessórios|Produto vinculo Acessórios]]
h1. 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.
h1. 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.
h1. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
h2. 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.
h2. 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.
h2. 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*
<pre>SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmpresa = :p1
AND codTabela = :p2</pre>
h1. Layouts de Integração
Segue os layouts que devem servir de base para construção dos SQLs de integração.
h2. 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') ) |
h2. 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 |
h2. Tabela de preço
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 |
h2. Catálogos
Retornar a listagem de Catálogos. Catalagos.
|_. 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 |
h2. Produto vinculo Acessórios
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 |