Integração Analytics

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

## [[Loja Virtual#Produtos-Grades|Produtos - Grades]]

## [[Loja Virtual#Produtos-Sortimentos|Produtos - Sortimentos]]

## [[Loja Virtual#Produtos-Tabela-de-Preço|Produtos - Tabela de Preço]]

## [[Loja Virtual#Produtos-Estoque|Produtos - Estoque]]

## [[Loja Virtual#Pedido-Capa|Pedido - Capa]]

## [[Loja Virtual#Cliente|Cliente]]

## [[Loja Virtual#Cliente-Representante|Cliente - Representante]]

## [[Loja Virtual#Condicao-de-Venda|Condição de Venda]]

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, geralmente deixado valor 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. |

| precoSugerido | Double | | Preço sugerido de venda. |

| flagGradeFechada | Integer | | 0 ou 1 se utiliza grade fechada |

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 - Grade Fechada

Retornar a listagem das grades fechadas

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| codReferencia * | String/Integer   | 255 | Código da Referência no ERP |

| seqTamanho * | String |  | Código do tamanho na grade no ERP |

| multiplo * | Integer |  | Multiplo do tamanho a ser considerado na grade fechada |

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 |

| estoqueLimitado *  | Integer   |   | Se vende somente estoque ou trabalha com programação (1,0)|

| qtdeEstoqueProducao    | Integer |   | Estoque a Produzir (Só popular caso seja solicitado Pela IBTECH, por padrão trazer 0) |

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 |

h3. Campos Referentes ao B2C

| 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. Pedido - Histórico

Histórico pedido ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| NumeroErp * | String/Integer   |  | Código pedido ERP |

| Data * | String   |  | Código do pedido na loja |

| Situacao * | String   |  | Código do pedido na loja |

| FormaPagamento * | String   |  | Forma de pagamento do pedido |

| Total * | String/Integer   |  | Total líquido pedido |

Lista de Parâmetros:

|_. Campo |_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa | :p1     | String/Integer   | 10         | Código da empresa no ERP |

| codEmpresa | :p2     | String   |          | CNPJ Cliente |

h2. Pedido - Detalhe

Detalhe pedido ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| NumeroErp * | String/Integer   |  | Código pedido ERP |

| Data * | String   |  | Data emissão pedido |

| Situacao * | String |  | Situção do pedido |

| FormaPagamento * | String  |  | Forma de pagamento pedido |

| Total * | double   |  | total líquido pedido |

| TotalBruto * | double   |  | Total bruto pedido |

| Observacoes * | String   |  | Obs pedido |

Lista de Parâmetros:

|_. Campo |_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa | :p1     | String/Integer   | 10         | Código da empresa no ERP |

| codEmpresa | :p2     | String   |          | CNPJ Cliente |

| codEmpresa | :p3     | String   |          | Código pedido erp |

h2. Pedido - Itens

Itens detalhe pedido ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| CodItem * | String   |  | Código do item |

| CodProduto * | String   |  | Código do produto |

| NomeProduto * | Double   |  | Nome do item |

| QtdePedida * | Double   |  | Quantidade pedida |

| QtdeSaldo * | Double   |  | Quantidade saldo |

| QtdeFaturado * | Double   |  | Quantidade faturada |

| QtdeCancelado * | Double   |  | Quantidade cancelada |

| ValorUnitarioBruto * | Double   |  | Valor unitário bruto |

| ValorUnitarioLiquido * | Double   |  | Valor líquido |

| ValorTotal * | Double   |  | Valor total |

| CodReferencia * | Double   |  | Código referencia |

| SeqTamanho * | String   |  | Seq tamanho |

| SeqSortimento * | String   |  | Seq sortimento |

| QtdeReservado * | Double   |  | Quantidade reservada |

Lista de Parâmetros:

|_. Campo |_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa | :p1     | String   |          | Código pedido erp |

h2. Cliente

Consulta dados do cliente

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |

| nomeFantasia | String | 255 | Nome fantasia do cliente |

| email | String | 255 | Endereço de e-mail padrão do cliente |

| cep | String | 255 | CEP do cliente (somente números) |

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

| complemento | String | 255 | Complemento do endereço do cliente do cliente |

| bairro | String | 255 | Bairro do cliente |

| codIBGE | String | 255 | Código IBGE da cidade do cliente |

| telefone | String | 255 | Telefone do cliente |

| codRepres1   | String   | 255        | Código do Representante Principal no ERP |

| codRepres2  | String   | 255        | Código do Representante 2 no ERP |

| codRepres3   | String   | 255        | Código do Representante 3 no ERP |

| codCliente  | String | 255 | Código do cliente no ERP |

| flagAtivoParaLoja | Integer | | Falg para Ativo na Loja |

| flagIsRepresentanteB2B | Integer | | Flag para saber se é um representante |

| razaoSocial | String | 200 | Razão Social do Cliente |

| emailRepres | String | 255 | Email do representante para disparo de e-mail, ao cliente logar na loja |

Lista de Parâmetros:

|_. Campo |_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa | :p1     | String/Integer   | 10         | Código da empresa no ERP |

| cnpj | :p2     | String/Integer   | 255         | CNPJ ou CPF do Cliente |

h2. Cliente - Representante

Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech

Consulta representantes do cliente. Se o cliente tiver mais de um representante, todos devem ser listados com seus respectivos código e nome.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| codRepres | String | 255 | Código do represetnante |

| nomeRepres | String | 255 | Nome do representante |

Lista de Parâmetros:

|_. Campo |_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa | :p1     | String/Integer   | 10         | Código da empresa no ERP |

| cnpj | :p2     | String/Integer   | 255         | CNPJ ou CPF do Cliente |

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 |