Loja Virtual - B2B » Histórico » Versão 4
« Anterior -
Versão 4/371
(diff) -
Próximo » -
Versão atual
comin, 22/01/2021 09:59 h
Loja Virtual - B2B¶
Índice- Introdução
- Acesso via JDBC
- Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
- Layouts de Integração
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) |
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 |
| 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 |
| String | 255 | ||
| 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 |