Projeto

Geral

Perfil

Loja Virtual » Histórico » Versão 3

Versão 2 (ivo, 16/11/2015 10:10 h) → Versão 3/53 (ivo, 23/11/2015 15:19 h)

h1. Loja Virtual

*Índice*
# [[Loja Virtual#Introdução|Introdução]]
# [[Loja Virtual#Acesso-via-JDBC|Acesso via JDBC]]
# [[Loja Virtual#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]]
## [[Loja Virtual#Tabelas-de-Integração|Tabelas de Integração]]
## [[Loja Virtual#Parâmetros|Parâmetros]]
## [[Loja Virtual#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Loja Virtual#Layouts-de-Integração|Layouts de Integração]]
## [[Loja Virtual#Produtos|Produtos]] Virtual#Tabela-de-Preço|Tabela de Preço]]
## [[Loja Virtual#Produtos-Grades|Produtos Virtual#Tabela-de-Preço-Produto|Tabela de Preço - Grades]] Produto]]
## [[Loja Virtual#Produtos-Sortimentos|Produtos - Sortimentos]]

Virtual#Clientes|Clientes]]
## [[Loja Virtual#Tabela-de-Preço|Tabela de Preço]] Virtual#Produtos|Produtos]]
## [[Loja Virtual#Tabela-de-Preço-Produto|Tabela de Preço Virtual#Produtos-Grades|Produtos - Produto]] Grades]]
## [[Loja Virtual#Clientes|Clientes]] Virtual#Produtos-Sortimentos|Produtos - Sortimentos]]
## [[Loja Virtual#Pedido-Capa|Pedido - Capa]]

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

Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail suporte@ibtech.inf.br 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 IBTech 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 IBTech 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. Tabela de Preço

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 |

h2. Tabela de Preço - Produto

Retornar a listagem dos produtos da 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 |
| codProduto * | String/Integer | 255 | Código do produto no ERP |
| codGrade * | String/Integer | 255 | Código da grade de produto no ERP |
| preco | Double | | Preç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 |
| codTabela | :p2 | String/Integer | 255 | Código da tabela de preços no ERP |

h2. Clientes

Retornar a listagem de clientes de um representante.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codCliente * | String | 255 | Código do cliente no ERP |
| cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| razaoSocial | String | 255 | Razão social do cliente |
| situacao | Integer | | Situação conforme codificação: 0 - Inativo, 1 - Ativo |
| telefone | String | 255 | Telefone do cliente |
| email | String | 255 | Endereço de e-mail padrão do cliente |
| emailNFE | String | 255 | Endereço de e-mail para Nota Fiscal Eletrônica do do cliente |
| codIBGE | String | 255 | Código IBGE da cidade do cliente |
| endereco | String | 255 | Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a IBTech para discutir uma solução. |
| enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| bairro | String | 255 | Bairro do cliente |
| cep | String | 255 | CEP do cliente (somente números) |
| dataCadastro | Date | | Data de cadastro do cliente |
| inscricaoEstadual | String | 255 | Inscrição estadual do cliente |
| inscricaoSUFRAMA | String | 255 | Inscrição SUFRAMA do cliente se houver |
| flagConsumidorFinal | Integer | | Consumidor final: 0 - Não, 1 - Sim |
| cobrancaEmail | String | 255 | Endereço de e-mail de cobrança do cliente |
| cobrancaContato | String | 255 | Nome da pessoal de contato de cobrança do cliente |
| cobrancaTelefone | String | 255 | Telefone da pessoal de contato de cobrança do cliente |
| comprasEmail | String | 255 | Endereço de e-mail de compras do cliente |
| comprasContato | String | 255 | Nome da pessoal de contato de compras do cliente |
| comprasTelefone | String | 255 | Telefone da pessoal de contato de compras do cliente |
| avaliacaoRepres | Text | | (opcional) Observação de avaliação do representante sobre o cliente (somente informação digitada pelo representante) |
| celular | String | 255 | Celular de contato do cliente |
| fax | String | 255 | Celular de contato do cliente |
| flagClienteFinal | Integer | | Cliente Fiel/Especial: 0 - Não, 1 - Sim |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepresentante | :p2 | String/Integer | 255 | Código do representante no ERP |

h2. Produtos

Retornar a listagem de produtos ATIVOS filtrando coleção.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codReferencia * | String/Integer | 255 | Código da Referência no ERP |
| descricao | String | 255 | Descrição da referência |
| codEtiqueta | String | 255 | Código da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| codLinha | String | 255 | Código da Linha de Produto da referência. |
| nomeLinha | String | 255 | Nome da Linha de Produto da referência. |
| codTipoPeca | String | 255 | Código do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeTpoPeca | String | 255 | Nome do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| codTipoModelo | String | 255 | Código do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| preco | Double | | DEPRECIADO. retornar zero (não há necessidade de incluir na view) |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |

h2. Produtos - Grades

Retornar a listagem das grades ATIVAS dos produtos filtrando coleção.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codReferencia * | String/Integer | 255 | Código da Referência no ERP |
| codGrade * | String/Integer | 255 | Código da Grade no ERP |
| seqTamanho * | Integer | | Código do tamanho na grade no ERP |
| seqOrdenacao * | Integer | | Sequencia de ordenação do tamanho na grade |
| codTamanho * | String | 255 | Descrição do tamanho no ERP (Ex: "P") |
| qtdPalito | Integer | | Quantidade de peças para grade palito |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |

h2. Produtos - Sortimentos

Retornar a listagem dos sortimentos ATIVOS dos produtos filtrando coleção.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codReferencia * | String/Integer | 255 | Código da Referência no ERP |
| codSortimento * | String/Integer | 255 | Código do Sortimento no ERP |
| descricao | String | 255 | Descrição do sortimento no ERP |
| codCorBase | String | 255 | Código da cor comercial (usada no catalogo) |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |

h2. Produto - Código Reduzido

Retornar o código reduzido para o produto (referecia, cor e tamanho)

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codReduzido * | String/Integer | 255 | Código reduzido do produto no ERP |
| seqTamanho * | String/Integer | 255 | Código do tamanho no ERP |
| seqTamOrdenacao | Integer | | Sequencia de ordenação do tamanho no ERP |
| seqSortimento * | String/Integer | 255 | Código da sortimento no ERP |
| seqSortOrdenacao | Integer | | Sequencia de ordenação do sortimento no ERP |
| codColecao | String/Integer | 255 | Código da coleção da referencia 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 |
| codReferencia | :p2 | String/Integer | 255 | Código da referência no ERP |

h2. Pedido - Capa

Retornar a situação do pedido no ERP.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codPedidoLoja * | String/Integer | 255 | Código do pedido na loja |
|
codPedido * | String/Integer | 255 | Código do pedido no ERP |
| situacao | Integer | | Situação do pedido no ERP, conforme regra abaixo. ERP.
Pedido FATURADO: Retornar 45 99
Pedido CANCELADO: Retornar 98
Qqr outra Situação: Retornar 40
Demais situações: retornar código do ERP |
| descSituacao | String | 255 | Descrição da situação |

Lista de Parâmetros:

|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codPedido | #PEDIDOS | | | Qualificar no WHERE como IN |



h2. Listagem de Pedidos - Capa

Retornar dados referentes a capa do pedido.

|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | String/Integer | 10 | Código da empresa no ERP |
| codCliente | String | 255 | Código do Cliente |
| nomeCliente | String | 255 | Nome do Cliente |
| codRepres | String | 255 | Código do Representante |
| pedAutomacao | String | 255 | Número do Lote de Gravação |
| codPedido | String | 255 | Código do Pedido no ERP |
| dataEmissao | Date | | Data de Emissão do Pedido |
| dataPrevFat | Date | | Data de Previsão de Faturamento do Pedido |
| situacao | Integer | 10 | Código da Situação no ERP |
| situacaoEdt | String | 255 | Descrição da Situação do Pedido |
| valorBruto | Double | | Valor Bruto do Pedido |
| valorLiquido | Double | | Valor Liquido do Pedido |
| valorSaldo | Double | | Valor Saldo do Pedido |

Lista de Parâmetros:

_Formato sugerido de data: dd/mm/yyyy (31/12/2013)_

|_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| :pDataEmissao | Date | | Data de Emissão do Pedido |
| :pCodRepresentante | String | 10 | (opcional) Código do Representante |
| :pCodTabPreco | String | 10 | (opcional) Código da Tabela de Preço |