Loja Virtual - B2B¶

Í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
   9. Condição de Venda
   10. 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
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

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

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

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		Se vende somente estoque ou trabalha com programação (1,0)
ncm	String		NCM
ean13	String		Ean 13
qtdeEstoqueProducao	Integer		Estoque a Produzir (Só popular caso seja solicitado Pela IBTECH, por padrão trazer 0)
codTabelaPreco	String		Código da tabela de preço
data	String		Data do depósito "yyyy-mm-dd hh:mm:ss" (ano, mês, dia, hora 24h, min, seg)
codDeposito	String		Código do depósito

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

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

Pedido - Histórico¶

Histórico pedido ERP.

Campo	Tipo	Precisão	Descrição
NumeroErp *	String/Integer		Código pedido ERP
Data *	String		Data de Emissão do Pedido
Situacao *	String		Situação do Pedido
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
cnpjCliente	:p2	String		CNPJ do Cliente

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
cnpjCliente	:p2	String		CNPJ Cliente
codPedido	:p3	String		Código pedido erp

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

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
inscricaoEstadual	String	255	Inscrição Estadual
siglaUF	String	255	Sigla do Estado da Cidade do Cliente
nomeUF	String	255	Nome do Estado da Cidade do Cliente
populacao	Integer		População da Cidade do Cliente
ipc	Double		IPC da Cidade do Cliente
codGrupoCli	String		Código do Grupo do Cliente
nomeGrupoCli	String		Nome do Grupo do Cliente

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

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.

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

Bloqueio de Referências¶

Estes dados serão utilizada para bloquear as referências no B2B a nível de SKU. Esta integração não alterará bloqueios feitos manualmente.

Campo	Tipo	Precisão	Descrição
codigo *	String	50	Código da Referência
tamanho *	String	50	Código do Tamanho
cor *	String	50	Código da Cor
flagBloqueio	Integer	1	Flag de Bloqueio 0 - Bloqueado, 1 - Não bloqueado