Loja Virtual - B2B » Histórico » Versão 164
« Anterior -
Versão 164/371
(diff) -
Próximo » -
Versão atual
martin, 19/10/2022 14:03 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
- Produtos
- Produtos - Grades
- Produtos - Grade Fechada
- Produtos - Sortimentos
- Produtos - Tabela de Preço
- Produtos - Tabela de Preço por SKU
- Produtos - Estoque
- Pedido - Capa
- Pedido - Histórico
- Pedido - Detalhe
- Pedido - Itens
- Cliente
- Representantes - Clientes
- Clientes - Representantes
- Comissão por Repres/Cliente/Marca
- Condição de Venda
- Bloqueio Referências
- Boletos - Consulta Cliente
- Boletos - Listagem
- Boletos - Detalhado
- DANFE- Listagem
- DANFE- Itens da Nota
- DANFE- XML
- Lote de Faturamento
- Produto SKU - Cód. Barras
- Frete
- Espelho Nota de Devolução
- Produto Volume Valor por Referência
- Substituição Tributária
- Pedido - Recompra
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.
| Pos | Campo | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| 1 | codReferencia * | String/Integer | 255 | Código da Referência no ERP. É o código usado para gravar o produto no ERP |
| 2 | NomeReferencia | String | 255 | Descrição da referência |
| 3 | codEtiqueta | String | 255 | Código da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 4 | nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc |
| 5 | codLinha | String | 255 | Código da Linha de Produto da referência. |
| 6 | nomeLinha | String | 255 | Nome da Linha de Produto da referência. Ex: ADULTO, INFANTIL, etc |
| 7 | codTipoPeca | String | 255 | Código do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 8 | 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 |
| 9 | codTipoModelo | String | 255 | Código do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 10 | nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. Ex: Masculino / Feminino |
| 11 | precoUnitario | Double | Preço Unitário, geralmente deixado valor 0 | |
| 12 | GradesAtivas | String | Campo Específico. Retornar null , salvo alguma orientação diferente da IBTech. Somente se trabalha com Grade Estendida. Senão retornar null | |
| 13 | 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 | |
| 14 | descricao | String | 255 | Descrição |
| 15 | descricaoHTML | String | 255 | Descrição HTML (Se existir no ERP). Se não retornar null |
| 16 | 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. | |
| 17 | genero | String | 255 | - |
| 18 | keywords | String | 255 | Keywords do produto. |
| 19 | composicao | String | 255 | Composião do produto. |
| 20 | precoSugerido | Double | Preço sugerido de venda. | |
| 21 | flagGradeFechada | Integer | 0 ou 1 se utiliza grade fechada | |
| 22 | unidMedida | String | 20 | Unidade de Medida |
| 23 | codGrupo | String | 250 | Campo Específico. (Retornar null , salvo alguma orientação diferente da IBTech) - Código do Agrupador da Ref. |
| 24 | percentualIPI | Double | Percentual de incidência de IPI. | |
| 25 | grupo_st | String | 255 | Responsável por gravar o grupo do produto pertencente ao ST |
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 |
| codReferencia | #REFERENCIAS | String | text | Lista de Referências Ex: and (codReferencia in (#REFERENCIAS) or #REFERENCIAS_TODAS = '') Para ORACLE and (codReferencia in (#REFERENCIAS) or nvl(#REFERENCIAS_TODAS,'0') = nvl('','0') ) |
| CodTabela | #TABPRECO | Código da tabela de preços no ERP usando a clausula IN ('#TABPRECO') |
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 |
| CodTabela | #TABPRECO | Código da tabela de preços no ERP usando a clausula IN ('#TABPRECO') |
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 | |
| nome | String | Nome do grupo de grade |
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 |
| ordem | Integer | Ordenação das cores | |
| Integer | Indicativo que o sortimento é Pocket valores 0 ou 1 (Morena Rosa) | ||
| estampa | string | Código da estampa para envio de samples |
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 |
| CodTabela | #TABPRECO | Código da tabela de preços no ERP usando a clausula IN ('#TABPRECO') |
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) | |
| preco_sugerido | Double | Preço sugerido para venda (Campo deve vir com ponto em vez de virgula nos preços) | |
| precoPromocao | Double | Preço de promoção (Campo deve vir com ponto em vez de virgula nos preços) | |
| ignorarDescontoB2B | Integer | Se deve ignorar o desconto sobre o item. (Default é 0, não deve ignorar) | |
| markup | Double | Markup 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 - Tabela de Preço por SKU¶
Retornar a listagem dos produtos da tabela de preço por SKU 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 |
| seqSortimento * | String/Integer | 255 | Código do sortimento do produto no ERP |
| seqTamanho* | String/Integer | 255 | Código do tamanho do produto no ERP |
| preco | Double | Preço do produto (Campo deve vir com ponto em vez de virgula nos preços) | |
| preco_sugerido | Double | Preço sugerido para venda (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 |
| codColecao | :p2 | Código da tabela de preços no ERP usando a clausula IN | ||
| codTabela | #TABPRECO | Código da coleção do produto 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) | |
| 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 o código da 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 | Descrição da Situação do Pedido | |
| FormaPagamento * | String | Forma de pagamento do pedido | |
| Total * | String/Integer | Total líquido pedido | |
| codcliente * | String/Integer | Código cliente pedido | |
| cliCnpj * | String | cnpj cliente pedido | |
| nomecliente * | String | nome cliente 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 | |
| dataInicio | :p3 | Date | Data de Inicio do Periodo | |
| dataFim | :p4 | Date | Data Final do Periodo |
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 | Descrição da Situaçã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 |
|---|---|---|---|---|
| codPedido | :p1 | String | Código pedido erp |
Cliente¶
Consulta dados do cliente
| 0 | Campo | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| 1 | cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| 2 | nomeFantasia | String | 255 | Nome fantasia do cliente |
| 3 | String | 255 | Endereço de e-mail padrão do cliente | |
| 4 | cep | String | 255 | CEP do cliente (somente números) |
| 5 | 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. |
| 6 | enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| 7 | complemento | String | 255 | Complemento do endereço do cliente do cliente |
| 8 | bairro | String | 255 | Bairro do cliente |
| 9 | codIBGE | String | 255 | Código IBGE da cidade do cliente |
| 10 | telefone | String | 255 | Telefone do cliente |
| 11 | codRepres1 | String | 255 | Código do Representante Principal no ERP |
| 12 | codRepres2 | String | 255 | Código do Representante 2 no ERP |
| 13 | codRepres3 | String | 255 | Código do Representante 3 no ERP |
| 14 | codCliente | String | 255 | Código do cliente no ERP |
| 15 | flagAtivoParaLoja | Integer | Falg para Ativo na Loja | |
| 16 | flagIsRepresentanteB2B | Integer | Flag para saber se é um representante | |
| 17 | razaoSocial | String | 200 | Razão Social do Cliente |
| 18 | emailRepres | String | 255 | Email do representante para disparo de e-mail, ao cliente logar na loja |
| 19 | inscricaoEstadual | String | 255 | Inscrição Estadual |
| 20 | siglaUF | String | 255 | Sigla do Estado da Cidade do Cliente |
| 21 | nomeUF | String | 255 | Nome do Estado da Cidade do Cliente |
| 22 | populacao | Integer | População da Cidade do Cliente | |
| 23 | ipc | Double | IPC da Cidade do Cliente | |
| 24 | codGrupoCli | String | Código do Grupo do Cliente | |
| 25 | nomeGrupoCli | String | Nome do Grupo do Cliente | |
| 26 | salarioBase | Double | Salário base do funcionário (quando cliente for um funcionario - Haskell) | |
| 27 | limiteCredito | Double | Límite de crédito do cliente, já descontato os pedidos que estão em aberto | |
| 28 | codCondPagto | String | Código da condição de pagamento do cliente | |
| 29 | codTransportadora | String | Código da Transportadora do cliente | |
| 30 | descontoPadrao | Double | Desconto Padrão do Cliente | |
| 31 | pais | String | Código do País | |
| 32 | inadimplente | Integer | 0 = Não Inadimplente, 1 = Inadimplente | |
| 33 | cliente_novo_crm | Integer | 0 = Cliente da Base, 1 = Cliente Novo | |
| 34 | fax | String | Fax do Cliente | |
| 35 | celular | String | Celular do Cliente | |
| 36 | emailNfe | String | Email referente as notas fiscais | |
| 37 | telefoneCompras | String | Telefone do setor de compras | |
| 38 | telefoneCobranca | String | Telefone do setor de cobranças | |
| 39 | String | Facebook do cliente | ||
| 40 | String | Instagram do Cliente | ||
| 41 | dataFundacao | Date | Data de Fundação | |
| 42 | marcasLiberadas | Date | Código das Marcas liberadas para compra do cliente (separado por virgula) | |
| 43 | tipoFaturamento | String | Código do tipo de faturamento (Normal ou SKU) | |
| 44 | regime_st | String | Responsável por gravar o regime tributário do cliente (Simples, SST…) |
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 |
Clientes - Representantes¶
Consulta dados para trazer os clientes dos representantes que vendem pelo B2B
| 0 | Campo | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| 1 | cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| 2 | nomeFantasia | String | 255 | Nome fantasia do cliente |
| 3 | String | 255 | Endereço de e-mail padrão do cliente | |
| 4 | cep | String | 255 | CEP do cliente (somente números) |
| 5 | 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. |
| 6 | enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| 7 | complemento | String | 255 | Complemento do endereço do cliente do cliente |
| 8 | bairro | String | 255 | Bairro do cliente |
| 9 | codIBGE | String | 255 | Código IBGE da cidade do cliente |
| 10 | telefone | String | 255 | Telefone do cliente |
| 11 | codRepres1 | String | 255 | Código do Representante Principal no ERP |
| 12 | codRepres2 | String | 255 | Código do Representante 2 no ERP |
| 13 | codRepres3 | String | 255 | Código do Representante 3 no ERP |
| 14 | codCliente | String | 255 | Código do cliente no ERP |
| 15 | flagAtivoParaLoja | Integer | Falg para Ativo na Loja | |
| 16 | flagIsRepresentanteB2B | Integer | Flag para saber se é um representante | |
| 17 | razaoSocial | String | 200 | Razão Social do Cliente |
| 18 | emailRepres | String | 255 | Email do representante para disparo de e-mail, ao cliente logar na loja |
| 19 | inscricaoEstadual | String | 255 | Inscrição Estadual |
| 20 | siglaUF | String | 255 | Sigla do Estado da Cidade do Cliente |
| 21 | nomeUF | String | 255 | Nome do Estado da Cidade do Cliente |
| 22 | populacao | Integer | População da Cidade do Cliente | |
| 23 | ipc | Double | IPC da Cidade do Cliente | |
| 24 | codGrupoCli | String | Código do Grupo do Cliente | |
| 25 | nomeGrupoCli | String | Nome do Grupo do Cliente | |
| 26 | salarioBase | Double | Salário base do funcionário (quando cliente for um funcionario - Haskell) | |
| 27 | limiteCredito | Double | Límite de crédito do cliente, já descontato os pedidos que estão em aberto | |
| 28 | codCondPagto | String | Código da condição de pagamento do cliente | |
| 29 | codTransportadora | String | Código da Transportadora do cliente | |
| 30 | descontoPadrao | Double | Desconto Padrão do Cliente | |
| 31 | pais | String | Código do País | |
| 32 | inadimplente | Integer | 0 = Não Inadimplente, 1 = Inadimplente | |
| 33 | cliente_novo_crm | Integer | 0 = Cliente da Base, 1 = Cliente Novo | |
| 34 | fax | String | Fax do Cliente | |
| 35 | celular | String | Celular do Cliente | |
| 36 | emailNfe | String | Email referente as notas fiscais | |
| 37 | telefoneCompras | String | Telefone do setor de compras | |
| 38 | telefoneCobranca | String | Telefone do setor de cobranças | |
| 39 | String | Facebook do cliente | ||
| 40 | String | Instagram do Cliente | ||
| 41 | dataFundacao | Date | Data de Fundação | |
| 42 | regimeST | String | Regime ST 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 |
| codRepres | :p2 | String/Integer | 255 | codigo do Representante |
Representantes - Clientes¶
Consulta dados para login de venda como representante no B2B
| 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 de cliente do representante no ERP (Em alguns ERPs é diferente, por exemplo Consistem) |
| flagAtivoParaLoja | Integer | Falg para Ativo na Loja | |
| flagIsRepresentanteB2B | Integer | Flag 2 = 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 |
|---|---|---|---|---|
| cnpjrepres | :p2 | String/Integer | 255 | cnpj do Representante |
Comissão por Repres/Cliente/Marca¶
integracao para permitir a quebra do pedido por marca e representante
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| CodRepresentante | String | 255 | Codigo do Representante no ERP |
| codigoCliente | String | 255 | Codigo do Cliente no ERP |
| codMarca | String | 255 | Codigo Marca |
| PercComissao | String | 255 | Percentual de Comissao |
Condição de Venda¶
Retorna a listagem de Condições de Venda do ERP.- Lembrando que fará somente a carga de novos registros, pois os antigos não serão mexidos.
| 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. (GEOREPRESENTANTE - NÃO É O SQL DE LOGIN DE REPRESENTANTE DO B2B)
| 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 |
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 - Liberado |
| flagBloqueioProntaEntrega | Integer | 1 | Flag de Bloqueio 0 - Bloqueado, 1 - Liberado |
| flagBloqueioProgramado | Integer | 1 | Flag de Bloqueio 0 - Bloqueado, 1 - Liberado |
Boletos - Consulta Cliente¶
Estes dados serão utilizados realizar o vínculo entre os usuários B2B, para visualização de boletos para grupos comerciais.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codCliente * | String | 255 | Codigo do cliente |
| nome * | String | 255 | Nome do cliente |
| cnpj * | String | 11 | CNPJ do cliente |
| email * | String | 255 | E-Mail 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 | 11 | CNPJ do cliente a buscar |
Boletos - Listagem¶
Estes dados serão utilizados na listagem dos títulos, que poderão ser emitidos uma segunda via.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| titulo * | String | 255 | Código do Titulo |
| codCliente * | String | 255 | Código do cliente |
| cnpj * | String | 255 | CNPJ do Pagador |
| nome * | String | 255 | Nome do Pagador |
| cidade * | String | 255 | Cidade do pagador |
| codPortador * | String | 255 | Código do portador |
| nomePortador * | String | 255 | Nome do portador |
| notaFiscal * | String | 255 | Numero da nota fiscal |
| dataEmissao * | String | 255 | Data de emissão |
| dataVecto * | String | 255 | Data de vencimento |
| valor * | String | 255 | Valor do documento |
| tituloDisplay | String | 255 | Código do Titulo para Exibição (Na tabela e no boleto) |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| emissaoDe | :p2 | Date | Data de emissão Inicial | |
| emissaoAte | :p3 | Date | Data de emissão Final | |
| vectoDe | :p4 | Date | Data de vencimento Inicial | |
| vectoAte | :p5 | Date | Data de vencimento Final | |
| cnpjs | #CNPJS or #CNPJSNULL | String | CNPJ's para consulta (separados por virgula) | |
| codClientes | #CLIENTES or #CLIENTESNULL | String | Código dos clientes para consulta (separados por virgula) | |
| codRepres | #REPRES or #REPRESNULL | String | Código dos representantes para consulta (separados por virgula) |
Boletos - Detalhado¶
Estes dados serão utilizados na geração do boleto de cobrança
| - | Campo | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| 1 | banco * | String | 255 | Código do banco |
| 2 | codCliente * | String | 255 | Código do cliente |
| 3 | cnpjBenef * | String | 255 | CNPJ do Beneficiário |
| 4 | nomeBenef * | String | 255 | Nome do Beneficiário |
| 5 | agenciaBenef * | String | 255 | Agencia do Beneficiário |
| 6 | agDigitoBenef * | String | 255 | Digito da agencia do Beneficiário |
| 7 | carteiraBenef * | String | 255 | Carteira do Beneficiário |
| 8 | contaBenef * | String | 255 | Conta do Beneficiario |
| 9 | digitoContaBenef * | String | 255 | Digito da conta do Beneficiario |
| 10 | nossoNumero * | String | 255 | Nosso número boleto |
| 11 | digNossoNumero * | String | 255 | Digito nosso número boleto |
| 12 | cepBenef * | String | 255 | CEP do Beneficiário |
| 13 | logradouroBenef * | String | 255 | Logradouro Beneficiário |
| 14 | bairroBenef * | String | 255 | Bairro Beneficiário |
| 15 | cidadeBenef * | String | 255 | Cidade Beneficiário |
| 16 | ufBenef * | String | 255 | UF Beneficiário |
| 17 | cnpjPagador * | String | 255 | CNPJ Pagador |
| 18 | nomePagador * | String | 255 | Nome Pagador |
| 19 | cepPagador * | String | 255 | CEP do Pagador |
| 20 | logradouroPagador * | String | 255 | Logradouro Pagador |
| 21 | bairroPagador * | String | 255 | Bairro Pagador |
| 22 | cidadePagador * | String | 255 | Cidade Pagador |
| 23 | ufPagador * | String | 255 | UF Pagador |
| 24 | valorBoleto * | Double | 2 | Valor do Boleto |
| 25 | valorMulta * | Double | 2 | Valor da Multa |
| 26 | valorAcrescimos * | Double | 2 | Valor de acrescimos |
| 27 | descontos * | Double | 2 | Valor de descontos |
| 28 | deducoes * | Double | 2 | Valor de deduções |
| 29 | especieDoc * | String | 255 | Espécie do Documento |
| 30 | numDoc * | String | 255 | Número do Documento |
| 31 | dataEmissao * | String | 255 | Data de emissão |
| 32 | dataProcessamento * | String | 255 | Data de processamento do Documento |
| 33 | dataVencimento * | String | 255 | Data de vencimento |
| 34 | dataVencimentoOrig * | String | 255 | Data vencimento original |
| 35 | Instrucao1* | String | 255 | descricao da Instrucao titulo |
| 36 | Instrucao2* | String | 255 | descricao da Instrucao titulo |
| 37 | Instrucao3* | String | 255 | descricao da Instrucao titulo |
| 38 | Instrucao4* | String | 255 | descricao da Instrucao titulo |
| 39 | Instrucao5* | String | 255 | descricao da Instrucao titulo |
| 40 | flag_escritural* | String | 255 | se o titulo é ou nao de cobranca escritural |
| 41 | MenssagemErro | String | 255 | Menssagem Retorno caso titulo esteja faltando campos |
| 42 | Convenio | String | 255 | Numero do convenio |
| 43 | NumeroPosto | String | 255 | Numero do Posto Bancario |
| 44 | numParcela | String | 255 | Numero da parcela do boleto (tratado Sicoob) |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| numDoc | :p2 | String | 255 | Número do Documento |
DANFE - Listagem¶
Estes dados serão utilizados na listagem das notas fiscais no portal B2B.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| cnpj * | String | 255 | CNPJ do cliente |
| codCliente * | String | 255 | Código do cliente |
| nomeCliente * | String | 255 | Nome do cliente |
| cidade * | String | 255 | Cidade do cliente |
| notaFiscal * | String | 255 | Número da nota fiscal |
| chaveNFE * | String | 255 | Chave da Nota fiscal |
| dataEmissao * | Date ODBC | 255 | Data de emissão da nota fiscal |
| valor * | Double | 2 | Valor total da nota fiscal |
| ocorrencias | String | JSON das ocorrencias da nota fiscal. Campo especifico, mandar null salvo orientação |
Listagem de parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| emissaoDe | :p2 | Date | Data de emissão da nota Inicial | |
| emissaoAte | :p3 | Date | Data de emissão da nota Final | |
| cnpjs | #CNPJS or #CNPJSNULL | String | CNPJ's para consulta (separados por virgula) | |
| codClientes | #CLIENTES or #CLIENTESNULL | String | Código dos clientes para consulta (separados por virgula) | |
| codRepres | #REPRES or #REPRESNULL | String | Código dos representantes para consulta (separados por virgula) |
DANFE - Itens da Nota¶
Estes dados serão utilizados para baixar as imagens dos itens da nota fiscal.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codRef * | String | 255 | Codigo da referência |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| notaFiscal | :p2 | String | 255 | Código da nota fiscal |
DANFE - XML¶
Estes dados serão utilizados para gerar a visualização em PDF das notas fiscais.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codCliente * | String | 255 | Código do cliente |
| notaFiscal * | String | 255 | Código da Nota Fiscal |
| xml * | String | XML da nota fiscal completo (NÃO PODE SER O CAMINHO DO FILESERVER) |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| notaFiscal | :p2 | String | 255 | Código da nota fiscal |
Lote de Faturamento¶
Retorna a integração do ERP de Lotes de Faturamento.- Lembrando que fará somente a carga de novos registros, pois os antigos não serão mexidos.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| dataReferencia * | Date | Data de referência (limite) | |
| dataFaturamento * | Date | Data do faturamento | |
| descricao * | String | 255 | Descrição |
| codTabPreco * | String | 30 | Código da tabela de preço, se for geral enviar uma string '-1' |
Produto SKU - Cód. Barras¶
Retorna a integração do ERP dos códigos de barras de todos os SKUs.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia * | String | Código da referência | |
| codSortimento * | String | Código do sortimento | |
| codTamanho * | String | Código do tamanho | |
| colecao * | String | Código da coleção | |
| codEan * | String | Código de barras |
Frete¶
Retorna a integração do ERP das faixas de frete.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| código * | Long | Código da faixa de frete (ID Registro) | |
| codTabelasPreco | String | Códigos das tabelas de preço, separados por vírgula, ou null para todas | |
| codPaises | String | Códigos dos países, separados por vírgula, ou null para todos. Aqui vale lembrar que quando informado o país o estado e cidade devem ser null | |
| estados | String | Sigla dos estados, separados por vírgula, ou null para todos. | |
| cidades | String | Códigos dos IBGE das cidades, separados por vírgula, ou null para todas | |
| vlrInicialCompra * | Double | Valor inicial para a faixa de compra | |
| vlrFinalCompra * | Double | Valor Final para a faixa de compra | |
| vlrFreteCompra * | Double | Valor do frete para a faixa de compra | |
| prazoEntregaCompra * | Integer | Prazo, em dias, para a entrega para esta faixa de compra | |
| vlrInicialRecompra * | Double | Valor inicial para a faixa de recompra | |
| vlrFinalRecompra * | Double | Valor Final para a faixa de recompra | |
| vlrFreteRecompra * | Double | Valor do frete para a faixa de recompra | |
| prazoEntregaRecompra * | Integer | Prazo, em dias, para a entrega para esta faixa de recompra |
Espelho Nota de Devolução¶
Retorna os itens referente a entrada data para a nota de devolução
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| referencia | String | Código da referência (deve ser a mesma referência da combo ao selecionar o item para devolução) | |
| nome | String | Nome/descrição da referência | |
| tamanho | String | Codigo do tamanho | |
| quantidade | String | Quantidade de itens da nota original da referência em questão | |
| tipoUnidade | String | Tipo de unidade. Ex: cx, pç | |
| valorLiquidoUnidade | String | Valor líquida da unidade | |
| baseCalcIcmsUnidade | String | Base de calc icms da unidade | |
| aliqIcms | String | Alíquota icms | |
| aliqIpi | String | Alíquota IPI | |
| icmsValorUnidade | String | Valor referente ao ICMS da unidade | |
| ipiValorUnidade | String | Valor referente ao IPI da unidade | |
| CST ou O/CST | String | CST ou O/CST | |
| NCM | String | NCM | |
| nota | String | Número nota fiscal | |
| dataEmissao | Date | Data referente a nota fiscal de origem | |
| chaveNfe | String | Chave da NFE | |
| transportadoraCnpj | String | CNPJ da transportadora | |
| transportadoraRazaoSocial | String | Razão social da transportadora | |
| transportadoraUf | String | UF da transportadora | |
| transportadoraEndereco | String | Endereço da transportadora | |
| transportadoraNumeroEndereco | String | Número endereço da transportadora | |
| transportadoraCidade | String | Cidade da transportadora | |
| transportadoraIE | String | Inscrição Estadual da transportadora |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :codEmpresa | String/Integer | 10 | Código da empresa no ERP |
| numerosNotas | #numerosNotas | String | Array<String> | Array com o Código/número da nota fiscal |
| itensDevolucao | #itensDevolucao | String | Array<String> | Array com a referência dos itens para devolução |
Produto Volume Valor por Referência¶
Retorna a integração do ERP dos códigos de referências, faixa de quantidade versos o valor de cada faixa.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia * | String | Código da referência | |
| qtdeMaxima * | String | Quantidade da faixa | |
| valor * | Double | 2 | Valor da faixa |
| cor * | String | Código da cor |
Lista de Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
| #REFERS | IN | Recebe uma lista dos códigos dos produtos para integração (Pode ser null para todos) |
| #REFERSNULL | - | Parâmetro para trazer todos registros ((campo in (#REFERS)) OR (#REFERSNULL IS NULL)) |
Substituição Tributária¶
Retorna a integração dos dados referente ao cadastro de substituição tributária.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| grupo_produto * | String | Responsável por gravar o grupo ST pertencente ao produto | |
| regime * | String | Responsável por gravar o regime tributário (Simples, SST…) | |
| uf * | Double | 2 | Grava a sigla do estado pertencente |
| percentual_st * | Double | 2 | Grava o percentual de acrescimo no calculo |
Pedido - Recompra¶
Recompra de pedidos do cliente.
OBS. Este SQL deve retornar sempre só uma linha.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codEmpresa * | String/Integer | Código da empresa | |
| codCliente * | String | Código do cliente | |
| codPedido * | String | Código do pedido | |
| dataEmissao * | Date | Data de emissão do pedido | |
| codSituacao * | Integer | Código da situação do pedido | |
| valorBruto * | Double | Valor bruto do pedido | |
| valorLiquido * | Double | Valor liquido do pedido | |
| valorSaldo * | Double | Valor do saldo do pedido | |
| quantidade * | Double | Quantidade do pedido |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| Data Inicial | :p1 | Date | 10 | Data inicial do parametro na tabela de preço |
| Data Final | :p2 | Date | Data final do parametro na tabela de preço | |
| CNPJ do Cliente | :p3 | String | CNPJ do Cliente | |
| Tabela de preço | :p4 | String | Tabela de Preço |