Loja Virtual - B2B » Histórico » Versão 149
Versão 148 (maikeu, 23/08/2022 17:59 h) → Versão 149/371 (paulo, 24/08/2022 08:25 h)
h1. Loja Virtual - B2B
*Índice*
# [[Loja_Virtual_-_B2B#Introdução|Introdução]]
# [[Loja_Virtual_-_B2B#Acesso-via-JDBC|Acesso via JDBC]]
# [[Loja_Virtual_-_B2B#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]
## [[Loja_Virtual_-_B2B#Tabelas-de-Integração|Tabelas de Integração]]
## [[Loja_Virtual_-_B2B#Parâmetros|Parâmetros]]
## [[Loja_Virtual_-_B2B#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Loja_Virtual_-_B2B#Layouts-de-Integração|Layouts de Integração]]
## [[Loja_Virtual_-_B2B#Produtos|Produtos]]
## [[Loja_Virtual_-_B2B#Produtos-Grades|Produtos - Grades]]
## [[Loja_Virtual_-_B2B#Produtos-Grade-Fechada|Produtos - Grade Fechada]]
## [[Loja_Virtual_-_B2B#Produtos-Sortimentos|Produtos - Sortimentos]]
## [[Loja_Virtual_-_B2B#Produtos-Tabela-de-Preço|Produtos - Tabela de Preço]]
## [[Loja_Virtual_-_B2B#Produtos-Tabela-de-Preço-por-SKU|Produtos - Tabela de Preço por SKU]]
## [[Loja_Virtual_-_B2B#Produtos-Estoque|Produtos - Estoque]]
## [[Loja_Virtual_-_B2B#Pedido-Capa|Pedido - Capa]]
## [[Loja_Virtual_-_B2B#Pedido-Histórico|Pedido - Histórico]]
## [[Loja_Virtual_-_B2B#Pedido-Detalhe|Pedido - Detalhe]]
## [[Loja_Virtual_-_B2B#Pedido-Itens|Pedido - Itens]]
## [[Loja_Virtual_-_B2B#Cliente|Cliente]]
## [[Loja_Virtual_-_B2B#Representantes - Clientes|Representantes - Clientes]]
## [[Loja_Virtual_-_B2B#Clientes-Representantes|Clientes - Representantes]]
## [[Loja_Virtual_-_B2B#Comissão por Repres/Cliente/Marca|Comissão por Repres/Cliente/Marca]]
## [[Loja_Virtual_-_B2B#Condição de Venda|Condição de Venda]]
## [[Loja_Virtual_-_B2B#Bloqueio-de-Referências|Bloqueio Referências]]
## [[Loja_Virtual_-_B2B#Boletos-Consulta-Cliente|Boletos - Consulta Cliente]]
## [[Loja_Virtual_-_B2B#Boletos-Listagem|Boletos - Listagem]]
## [[Loja_Virtual_-_B2B#Boletos-Detalhado|Boletos - Detalhado]]
## [[Loja_Virtual_-_B2B#DANFE-Listagem|DANFE- Listagem]]
## [[Loja_Virtual_-_B2B#DANFE-Itens-da-Nota|DANFE- Itens da Nota]]
## [[Loja_Virtual_-_B2B#DANFE-XML|DANFE- XML]]
## [[Loja_Virtual_-_B2B#Lote de Faturamento| Lote de Faturamento]]
## [[Loja_Virtual_-_B2B#Produto SKU - Cód. Barras| Produto SKU - Cód. Barras]]
## [[Loja_Virtual_-_B2B#Frete| Frete]]
## [[Loja_Virtual_-_B2B#Espelho Nota de Devolução| Espelho Nota de Devolução]]
## [[Loja_Virtual_-_B2B#Produto Volume Valor por Referência| Produto Volume Valor por Referência]]
## [[Loja_Virtual_-_B2B#Substituição Tributária| Substituição Tributária]]
h1. 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.
h1. 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.
h1. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
h2. 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.
h2. 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.
h2. 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*
<pre>SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmpresa = :p1
AND codTabela = :p2</pre>
h1. Layouts de Integração
Segue os layouts que devem servir de base para construção dos SQLs de integração.
h2. 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') |
h2. 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') |
h2. 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 |
h2. 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 |
| pocket | 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') |
h2. 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) |
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 |
h2. 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 |
h2. 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 |
h2. 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 |
h3. 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 |
h2. 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 |
ped.pvpd -> codcliente,
ped.pvpd -> cliCnpj,
ped.pvpd -> nomecliente
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 |
h2. 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 |
h2. 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 |
h2. 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 | email | 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 | facebook | String | | Facebook do cliente|
|_.40 | instagram | 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 |
h2. 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 | email | 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 | facebook | String | | Facebook do cliente|
|_.40 | instagram | String | | Instagram do Cliente|
|_.41 | dataFundacao | Date | | Data de Fundação|
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 |
h2. 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 |
| 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 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 |
h2. 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 |
h2. 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 |
h2. 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 |
| 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 |
h2. 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 |
h2. 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 |
h2. 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 |
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) |
h2. Boletos - Detalhado
Estes dados serão utilizados na geração do boleto de cobrança
|_.0|_. 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 |
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 |
h2. 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) |
h2. 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 |
h2. 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 |
h2. 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' |
h2. 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 |
h2. 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 |
h2. 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 |
h2. 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)) |
h2. 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 |
*Índice*
# [[Loja_Virtual_-_B2B#Introdução|Introdução]]
# [[Loja_Virtual_-_B2B#Acesso-via-JDBC|Acesso via JDBC]]
# [[Loja_Virtual_-_B2B#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]
## [[Loja_Virtual_-_B2B#Tabelas-de-Integração|Tabelas de Integração]]
## [[Loja_Virtual_-_B2B#Parâmetros|Parâmetros]]
## [[Loja_Virtual_-_B2B#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Loja_Virtual_-_B2B#Layouts-de-Integração|Layouts de Integração]]
## [[Loja_Virtual_-_B2B#Produtos|Produtos]]
## [[Loja_Virtual_-_B2B#Produtos-Grades|Produtos - Grades]]
## [[Loja_Virtual_-_B2B#Produtos-Grade-Fechada|Produtos - Grade Fechada]]
## [[Loja_Virtual_-_B2B#Produtos-Sortimentos|Produtos - Sortimentos]]
## [[Loja_Virtual_-_B2B#Produtos-Tabela-de-Preço|Produtos - Tabela de Preço]]
## [[Loja_Virtual_-_B2B#Produtos-Tabela-de-Preço-por-SKU|Produtos - Tabela de Preço por SKU]]
## [[Loja_Virtual_-_B2B#Produtos-Estoque|Produtos - Estoque]]
## [[Loja_Virtual_-_B2B#Pedido-Capa|Pedido - Capa]]
## [[Loja_Virtual_-_B2B#Pedido-Histórico|Pedido - Histórico]]
## [[Loja_Virtual_-_B2B#Pedido-Detalhe|Pedido - Detalhe]]
## [[Loja_Virtual_-_B2B#Pedido-Itens|Pedido - Itens]]
## [[Loja_Virtual_-_B2B#Cliente|Cliente]]
## [[Loja_Virtual_-_B2B#Representantes - Clientes|Representantes - Clientes]]
## [[Loja_Virtual_-_B2B#Clientes-Representantes|Clientes - Representantes]]
## [[Loja_Virtual_-_B2B#Comissão por Repres/Cliente/Marca|Comissão por Repres/Cliente/Marca]]
## [[Loja_Virtual_-_B2B#Condição de Venda|Condição de Venda]]
## [[Loja_Virtual_-_B2B#Bloqueio-de-Referências|Bloqueio Referências]]
## [[Loja_Virtual_-_B2B#Boletos-Consulta-Cliente|Boletos - Consulta Cliente]]
## [[Loja_Virtual_-_B2B#Boletos-Listagem|Boletos - Listagem]]
## [[Loja_Virtual_-_B2B#Boletos-Detalhado|Boletos - Detalhado]]
## [[Loja_Virtual_-_B2B#DANFE-Listagem|DANFE- Listagem]]
## [[Loja_Virtual_-_B2B#DANFE-Itens-da-Nota|DANFE- Itens da Nota]]
## [[Loja_Virtual_-_B2B#DANFE-XML|DANFE- XML]]
## [[Loja_Virtual_-_B2B#Lote de Faturamento| Lote de Faturamento]]
## [[Loja_Virtual_-_B2B#Produto SKU - Cód. Barras| Produto SKU - Cód. Barras]]
## [[Loja_Virtual_-_B2B#Frete| Frete]]
## [[Loja_Virtual_-_B2B#Espelho Nota de Devolução| Espelho Nota de Devolução]]
## [[Loja_Virtual_-_B2B#Produto Volume Valor por Referência| Produto Volume Valor por Referência]]
## [[Loja_Virtual_-_B2B#Substituição Tributária| Substituição Tributária]]
h1. 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.
h1. 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.
h1. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
h2. 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.
h2. 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.
h2. 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*
<pre>SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmpresa = :p1
AND codTabela = :p2</pre>
h1. Layouts de Integração
Segue os layouts que devem servir de base para construção dos SQLs de integração.
h2. 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') |
h2. 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') |
h2. 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 |
h2. 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 |
| pocket | 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') |
h2. 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) |
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 |
h2. 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 |
h2. 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 |
h2. 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 |
h3. 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 |
h2. 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 |
ped.pvpd -> codcliente,
ped.pvpd -> cliCnpj,
ped.pvpd -> nomecliente
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 |
h2. 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 |
h2. 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 |
h2. 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 | email | 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 | facebook | String | | Facebook do cliente|
|_.40 | instagram | 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 |
h2. 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 | email | 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 | facebook | String | | Facebook do cliente|
|_.40 | instagram | String | | Instagram do Cliente|
|_.41 | dataFundacao | Date | | Data de Fundação|
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 |
h2. 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 |
| 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 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 |
h2. 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 |
h2. 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 |
h2. 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 |
| 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 |
h2. 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 |
h2. 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 |
h2. 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 |
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) |
h2. Boletos - Detalhado
Estes dados serão utilizados na geração do boleto de cobrança
|_.0|_. 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 |
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 |
h2. 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) |
h2. 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 |
h2. 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 |
h2. 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' |
h2. 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 |
h2. 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 |
h2. 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 |
h2. 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)) |
h2. 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 |