Loja Virtual - B2C¶
Í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.
Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail suporte@ibtech.inf.br 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 ATIVOS filtrando coleção.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia * | String/Integer | 255 | Código da Referência no ERP. É o código usado para gravar o produto no ERP |
| descricao | String | 255 | Descrição da referência (precisa tratar para não vir NULO) |
| codEtiqueta | String | 255 | Código da Etiqueta (ou Marca) da referência. Consultar a GEOvendas sobre o que trazer neste campo. |
| nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc |
| codLinha | String | 255 | Código da Linha de Produto da referência. |
| nomeLinha | String | 255 | Nome da Linha de Produto da referência. Ex: ADULTO, INFANTIL, etc |
| codTipoPeca | String | 255 | Código do Tipo de Peça da referência. Consultar a GEOvendas sobre o que trazer neste campo. |
| nomeTpoPeca | String | 255 | Nome do Tipo de Peça da referência. Consultar a GEOvendas sobre o que trazer neste campo. Ex: CALCA, BLUSA, CAMISA, SHORTS, etc |
| codTipoModelo | String | 255 | Código do Tipo Modelo da referência. Consultar a GEOvendas sobre o que trazer neste campo. |
| nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a GEOvendas sobre o que trazer neste campo. Ex: Masculino / Feminino |
| precoUnitario | Double | Preço Unitário, retornar 0 | |
| GradesAtivas | String | Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas. Somente se trabalha com Grade Estendida. Senão retornar null | |
| codReferenciaProvisoria | String | Código de Referencia "Provisória", ou aquela que o cliente "conhece". Caso seja a mesma do campo codReferencia, retornar o mesmo valor | |
| descricao | String | 255 | Descrição (precisa tratar para nao vir NULO) |
| descricaoHTML | String | 255 | Descrição HTML (Se existir no ERP). Se não retornar null |
| qtdeEmbarquePadrao | Integer | Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas. Quantidade Embarque Padrão. Para o caso de compras múltiplas. | |
| genero | String | 255 | - |
| keywords | String | 255 | Keywords do produto. |
| composicao | String | 255 | 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 |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |
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") |
| pesoPeca | Double | Peso da Peça. (Separado por ponto e não por virgula) | |
| nomeGrade | Double | Nom da Grade. Exemplo: P/M/G/GG ou 01/02/03 ou Única | |
| altura | Double | Altura do produto: Exemplo: 0.050 (Separado por ponto e não por virgula) | |
| largura | Double | Largura do produto: Exemplo: 0.101 (Separado por ponto e não por virgula) | |
| comprimento | Double | Comprimento do produto: Exemplo: 0.150 (Separado por ponto e não por virgula) |
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 |
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) |
| codRGBCorBase | String | 255 | Código em RGB da cor |
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 |
Produtos - Tabela de Preço¶
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 (Campo deve vir com ponto em vez de virgula nos 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 | #TABPRECO | Código da tabela de preços no ERP usando a clausula IN |
Produtos - Estoque¶
Retornar a listagem dos estoques dos produtos. Para bom funcionamento o ideal é ter um "Almoxarifado" (ou o que for similar no seu ERP) exclusivo para loja.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codProduto * | String/Integer | 255 | Código do produto no ERP |
| seqTamanho * | Integer | Código do tamanho na referencia | |
| seqSortimento * | Integer | Código do sortimento na referencia | |
| qtdeEstoque * | Integer | Estoque do Produto | |
| estoqueLimitado * | Integer | Trazer fixo 1 |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | #COLECOES | Lista de coleções para filtro com a cláusula IN | ||
| codTabPreco | #TABPRECO | Lista de tabelas de preços para filtro com a cláusula IN | ||
| codNatureza/codDeposito | #NATUREZA | Lista de natureza/deposito para filtro com a cláusula IN |
Pedido - Capa¶
Consulta 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 | Retornar a situação do pedido no ERP | |
| descSituacao | String | 255 | Descrição da situação no ERP |
| numeroNotaFiscal | Integer | _. | Número da primeira nota fiscal do pedido no ERP |
| serieNotaFiscal | String | 255 | Série da primeira nota fiscal do pedido no ERP |
| numeroDanfNfe | String | 255 | Número da DANF da NFE |
| valorNotaFiscal | Double | Valor da Nota Fiscal |
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_LOJA | Qualificar no WHERE como IN |
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 | 255 | Condição de Parcelamento EX:30/60/90 |
Representantes¶
Esta tabela/visão será utilizada para carregar no IGS a lista de representantes (Usado para Configurar o Representante padrão das Vendas B2C na integração de Pedidos).
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codRepres * | String/Integer | 255 | Código do Representante no ERP |
| nome | String | 255 | Nome do Representante |
| telefone | String | 255 | Telefone de Contato |
| String | 255 | ||
| endereco | String | 255 | Rua + Número do endereço do Representante |
| bairro | String | 255 | Bairro do Endereço do Representante |
| CEP | String | 8 | CEP do endereço do Representante |
| Cidade | String | 255 | Nome da Cidade do Endereço do Representante |
| UF | String | 2 | Sigla da UF da Cidade |
| codIBGE | String | 7 | Código do IBGE da Cidade |
| situacao | Integer | Situação do cadastro do representante: 0 - Inativo, 1 - Ativo | |
| Cod Repres Agrupador | String | 255 | Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas |
| telefone 2 | String | 255 | Telefone de Contato 2 |
| telefone 3 | String | 255 | Telefone de Contato 3 |
| codigoAdministrador | String | 255 | Código do administrador do representante no erp |
| cnpj | String | 255 | CNPJ do representante |
| codAgrupadorEscritorio | String | 255 | Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas |
| flagAgrupadorMaster | Integer | 0 - Não, 1 - Sim (Somente um por grupo) / Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas | |
| percComissa | Double | Percentual de comissão | |
| codigoPessoaFisica | String | 255 | Código que representa o cadastro da pessoa física do representante |
| nomePessoaFisica | String | 255 | Nome da pessoa física |