Loja Virtual - B2C¶

Índice

1. Introdução
2. Acesso via JDBC
3. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
   1. Tabelas de Integração
   2. Parâmetros
   3. Exemplo de SQL de Integração
4. Layouts de Integração
   1. Produtos
   2. Produtos - Grades
   3. Produtos - Sortimentos
   4. Produtos - Tabela de Preço
   5. Produtos - Estoque
   6. Pedido - Capa
   7. Condição de Venda
   8. Representantes

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.

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.

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 (prescisa tratar para nao vir NULO)
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 (prescisa 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 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

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

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