Projeto

Geral

Perfil

Loja Virtual - B2C » Histórico » Versão 4

Versão 3 (alexandre, 13/11/2020 11:09 h) → Versão 4/9 (alexandre, 13/11/2020 11:15 h)

h1. Loja Virtual - B2C

*Índice*
# [[Loja_Virtual_-_B2C#Introdução|Introdução]] [[Loja Virtual#Introdução|Introdução]]
# [[Loja_Virtual_-_B2C#Acesso-via-JDBC|Acesso [[Loja Virtual#Acesso-via-JDBC|Acesso via JDBC]]
# [[Loja_Virtual_-_B2C#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas [[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_-_B2C#Tabelas-de-Integração|Tabelas [[Loja Virtual#Tabelas-de-Integração|Tabelas de Integração]]
## [[Loja_Virtual_-_B2C#Parâmetros|Parâmetros]] [[Loja Virtual#Parâmetros|Parâmetros]]
## [[Loja_Virtual_-_B2C#Exemplo-de-SQL-de-Integração|Exemplo [[Loja Virtual#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Loja_Virtual_-_B2C#Layouts-de-Integração|Layouts [[Loja Virtual#Layouts-de-Integração|Layouts de Integração]]
## [[Loja_Virtual_-_B2C#Produtos|Produtos]] [[Loja Virtual#Produtos|Produtos]]
## [[Loja_Virtual_-_B2C#Produtos-Grades|Produtos [[Loja Virtual#Produtos-Grades|Produtos - Grades]]
## [[Loja_Virtual_-_B2C#Produtos-Sortimentos|Produtos [[Loja Virtual#Produtos-Sortimentos|Produtos - Sortimentos]]
## [[Loja_Virtual_-_B2C#Produtos-Tabela-de-Preço|Produtos [[Loja Virtual#Produtos-Tabela-de-Preço|Produtos - Tabela de Preço]]
## [[Loja_Virtual_-_B2C#Produtos-Estoque|Produtos [[Loja Virtual#Produtos-Estoque|Produtos - Estoque]]
## [[Loja_Virtual_-_B2C#Pedido-Capa|Pedido [[Loja Virtual#Pedido-Capa|Pedido - Capa]]
## [[Loja_Virtual_-_B2C#Condicao-de-Venda|Condição [[Loja Virtual#Condicao-de-Venda|Condição de Venda]]
## [[Loja_Virtual_-_B2C#Representantes|Representantes]] [[Loja Virtual#Representantes|Representantes]]

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. 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 |
| 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. 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 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. Ex: CALCA, BLUSA, CAMISA, SHORTS, etc|
| 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. Ex: Masculino / Feminino|
| precoUnitario | Double | | Preço Unitário, retornar 0 |
| GradesAtivas | String | | *Campo Específico.* Retornar null , salvo alguma orientação diferente da IBTech. 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 |
| 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 IBTech. 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 |

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") |
| 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 Unica |

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) |
| 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 |

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

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

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çoes para filtro com a cláusula IN |
| codTabPreco | #TABPRECO | | | Lista de tabelas de precos para filtro com a cláusula IN |
| codNatureza/codDeposito | #NATUREZA | | | Lista de natureza/deposito para filtro com a cláusula IN |

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

h2. 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 | Condicao de Parcelamento EX:30/60/90 |

h2. 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 |
| email | String | 255 | E-Mail |
| 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 | Codigo 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 IBTech |
| 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 IBTech |
| flagAgrupadorMaster | Integer | | 0 - Não, 1 - Sim (Somente um por grupo) / *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
| percComissa | Double | | Percentual de comissao |
| codigoPessoaFisica | String | 255 | Código que representa o cadastro da pessoa fisica do reperesentante |
| nomePessoaFisica | String | 255 | Nome da pessoa fisica |