Loja Virtual¶

Í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. Cliente
   8. Cliente - Representante

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
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
precoB2B	Double		DEPRECIADO --> Não precisa mais essa coluna
precoB2C	Double		DEPRECIADO --> Não precisa mais essa coluna
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.

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. Usado no B2C para calcular Frete
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

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

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.
Esta tabela é não obrigatório. Em muitos casos de loja B2B não se trabalha com estoque.

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
codColecao *	String/Integer	255	Código da coleçã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	#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

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

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

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

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