Loja Virtual - B2B » Histórico » Versão 33
Versão 32 (andreg, 13/04/2021 14:46 h) → Versão 33/371 (andreg, 13/04/2021 14:48 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-Sortimentos|Produtos - Sortimentos]]
## [[Loja_Virtual_-_B2B#Produtos-Tabela-de-Preço|Produtos - Tabela de Preço]]
## [[Loja_Virtual_-_B2B#Produtos-Estoque|Produtos - Estoque]]
## [[Loja_Virtual_-_B2B#Pedido-Capa|Pedido - Capa]]
## [[Loja_Virtual_-_B2B#Cliente|Cliente]]
## [[Loja_Virtual_-_B2B#Representantes|Representantes - Cliente]]
## [[Loja_Virtual_-_B2B#Cliente-Representante|Cliente - Representante]]
## [[Loja_Virtual_-_B2B#Condicao-de-Venda|Condição de Venda]]
## [[Loja_Virtual_-_B2B#Bloqueio-de-Referências|Bloqueio Referências]]
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.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codReferencia * | String/Integer | 255 | Código da Referência no ERP. É o código usado para gravar o produto no ERP |
| descricao | String | 255 | Descrição da referência |
| codEtiqueta | String | 255 | Código da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc|
| codLinha | String | 255 | Código da Linha de Produto da referência. |
| nomeLinha | String | 255 | Nome da Linha de Produto da referência. Ex: ADULTO, INFANTIL, etc|
| codTipoPeca | String | 255 | Código do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeTpoPeca | String | 255 | Nome do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. Ex: CALCA, BLUSA, CAMISA, SHORTS, etc|
| codTipoModelo | String | 255 | Código do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. Ex: Masculino / Feminino|
| precoUnitario | Double | | Preço Unitário, geralmente deixado valor 0 |
| GradesAtivas | String | | *Campo Específico.* Retornar null , salvo alguma orientação diferente da IBTech. Somente se trabalha com Grade Estendida. Senão retornar null |
| codReferenciaProvisoria| String | | Código de Referencia "Provisória", ou aquela que o cliente "conhece". Caso seja a mesma do campo codReferencia, retornar o mesmo valor |
| descricao | String | 255 | Descrição |
| descricaoHTML | String | 255 | Descrição HTML (Se existir no ERP). Se não retornar null |
| qtdeEmbarquePadrao | Integer | | *Campo Específico.* Retornar null , salvo alguma orientação diferente da IBTech. Quantidade Embarque Padrão. Para o caso de compras múltiplas. |
| genero| String | 255 | - |
| keywords | String | 255 | Keywords do produto. |
| composicao | String | 255 | Composião do produto. |
| precoSugerido | Double | | Preço sugerido de venda. |
| flagGradeFechada | Integer | | 0 ou 1 se utiliza grade fechada |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |
| 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') ) |
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 |
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 |
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 |
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 - Tabela de Preço
Retornar a listagem dos produtos da tabela de preço do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codTabela * | String/Integer | 255 | Código da tabela de preços no ERP |
| codProduto * | String/Integer | 255 | Código do produto no ERP |
| codGrade * | String/Integer | 255 | Código da grade de produto no ERP |
| preco | Double | | Preço do produto (Campo deve vir com ponto em vez de virgula nos preços) |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codTabela | #TABPRECO | | | Código da tabela de preços no ERP usando a clausula IN |
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 a 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 | | Situação do Pedido |
| FormaPagamento * | String | | Forma de pagamento do pedido |
| Total * | String/Integer | | Total líquido pedido |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpjCliente | :p2 | String | | CNPJ do Cliente |
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 | | Situção do pedido |
| FormaPagamento * | String | | Forma de pagamento pedido |
| Total * | double | | total líquido pedido |
| TotalBruto * | double | | Total bruto pedido |
| Observacoes * | String | | Obs pedido |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpjCliente | :p2 | String | | CNPJ Cliente |
| codPedido | :p3 | String | | Código pedido erp |
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
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| email | String | 255 | Endereço de e-mail padrão do cliente |
| cep | String | 255 | CEP do cliente (somente números) |
| endereco | String | 255 | Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a IBTech para discutir uma solução. |
| enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| complemento | String | 255 | Complemento do endereço do cliente do cliente |
| bairro | String | 255 | Bairro do cliente |
| codIBGE | String | 255 | Código IBGE da cidade do cliente |
| telefone | String | 255 | Telefone do cliente |
| codRepres1 | String | 255 | Código do Representante Principal no ERP |
| codRepres2 | String | 255 | Código do Representante 2 no ERP |
| codRepres3 | String | 255 | Código do Representante 3 no ERP |
| codCliente | String | 255 | Código do cliente no ERP |
| flagAtivoParaLoja | Integer | | Falg para Ativo na Loja |
| flagIsRepresentanteB2B | Integer | | Flag para saber se é um representante |
| razaoSocial | String | 200 | Razão Social do Cliente |
| emailRepres | String | 255 | Email do representante para disparo de e-mail, ao cliente logar na loja |
| inscricaoEstadual | String | 255 | Inscrição Estadual |
| siglaUF | String | 255 | Sigla do Estado da Cidade do Cliente |
| nomeUF | String | 255 | Nome do Estado da Cidade do Cliente |
| populacao | Integer | | População da Cidade do Cliente |
| ipc | Double | | IPC da Cidade do Cliente |
| codGrupoCli | String | | Código do Grupo do Cliente |
| nomeGrupoCli | String | | Nome do Grupo do Cliente |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpj | :p2 | String/Integer | 255 | CNPJ ou CPF do Cliente |
h2. Cliente - Representante
Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech
Consulta representantes do cliente. Se o cliente tiver mais de um representante, todos devem ser listados com seus respectivos código e nome.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codRepres | String | 255 | Código do represetnante |
| nomeRepres | String | 255 | Nome do representante |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpj | :p2 | String/Integer | 255 | CNPJ ou CPF do Cliente |
h2. Clientes - Representantes
Consulta dados do cliente
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| email | String | 255 | Endereço de e-mail padrão do cliente |
| cep | String | 255 | CEP do cliente (somente números) |
| endereco | String | 255 | Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a IBTech para discutir uma solução. |
| enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| complemento | String | 255 | Complemento do endereço do cliente do cliente |
| bairro | String | 255 | Bairro do cliente |
| codIBGE | String | 255 | Código IBGE da cidade do cliente |
| telefone | String | 255 | Telefone do cliente |
| codRepres1 | String | 255 | Código do Representante Principal no ERP |
| codRepres2 | String | 255 | Código do Representante 2 no ERP |
| codRepres3 | String | 255 | Código do Representante 3 no ERP |
| codCliente | String | 255 | Código do cliente no ERP |
| flagAtivoParaLoja | Integer | | Falg para Ativo na Loja |
| flagIsRepresentanteB2B | Integer | | Flag para saber se é um representante |
| razaoSocial | String | 200 | Razão Social do Cliente |
| emailRepres | String | 255 | Email do representante para disparo de e-mail, ao cliente logar na loja |
| inscricaoEstadual | String | 255 | Inscrição Estadual |
| siglaUF | String | 255 | Sigla do Estado da Cidade do Cliente |
| nomeUF | String | 255 | Nome do Estado da Cidade do Cliente |
| populacao | Integer | | População da Cidade do Cliente |
| ipc | Double | | IPC da Cidade do Cliente |
| codGrupoCli | String | | Código do Grupo do Cliente |
| nomeGrupoCli | String | | Nome do Grupo do Cliente |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepres| :p2 | String/Integer | 255 | codigo do Representante |
h2. Representantes - Clientes
Consulta dados do cliente
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| email | String | 255 | Endereço de e-mail padrão do cliente |
| cep | String | 255 | CEP do cliente (somente números) |
| endereco | String | 255 | Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a IBTech para discutir uma solução. |
| enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| complemento | String | 255 | Complemento do endereço do cliente do cliente |
| bairro | String | 255 | Bairro do cliente |
| codIBGE | String | 255 | Código IBGE da cidade do cliente |
| telefone | String | 255 | Telefone do cliente |
| codRepres1 | String | 255 | Código do Representante Principal no ERP |
| codRepres2 | String | 255 | Código do Representante 2 no ERP |
| codRepres3 | String | 255 | Código do Representante 3 no ERP |
| codCliente | String | 255 | Código do cliente no ERP |
| flagAtivoParaLoja | Integer | | Falg para Ativo na Loja |
| flagIsRepresentanteB2B | Integer | | Flag 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. Condição de Venda
Retorna a listagem de Condições de Venda do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codPagamento * | String/Integer | 255 | Código da condição de Venda no ERP |
| nome | String | 255 | Nome da condição de venda |
| qtdeParcelas | Integer | | Número de parcelas da condição de venda |
| prazoMedio | Double | | Prazo médio das parcelas da condição de venda |
| situacao | Integer | | Situação conforme codificação: 0 - Inativo, 1 - Ativo |
| Parcelamento| String | 255 | Condicao de Parcelamento EX:30/60/90 |
h2. Representantes
Esta tabela/visão será utilizada para carregar no IGS a lista de representantes.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codRepres * | String/Integer | 255 | Código do Representante no ERP |
| nome | String | 255 | Nome do Representante |
| telefone | String | 255 | Telefone de Contato |
| email | String | 255 | E-Mail |
| endereco | String | 255 | Rua + Número do endereço do Representante |
| bairro | String | 255 | Bairro do Endereço do Representante |
| CEP | String | 8 | CEP do endereço do Representante |
| Cidade | String | 255 | Nome da Cidade do Endereço do Representante |
| UF | String | 2 | Sigla da UF da Cidade |
| codIBGE | String | 7 | Codigo do IBGE da Cidade |
| situacao | Integer | | Situação do cadastro do representante: 0 - Inativo, 1 - Ativo |
| Cod Repres Agrupador | String | 255 | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
| telefone 2 | String | 255 | Telefone de Contato 2 |
| telefone 3 | String | 255 | Telefone de Contato 3 |
| codigoAdministrador | String | 255 | Código do administrador do representante no erp |
| cnpj | String | 255 | CNPJ do representante |
| codAgrupadorEscritorio | String | 255 | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
| flagAgrupadorMaster | Integer | | 0 - Não, 1 - Sim (Somente um por grupo) / *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
| percComissa | Double | | Percentual de comissao |
| codigoPessoaFisica | String | 255 | Código que representa o cadastro da pessoa fisica do reperesentante |
| nomePessoaFisica | String | 255 | Nome da pessoa fisica |
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 - Não bloqueado |
*Í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-Sortimentos|Produtos - Sortimentos]]
## [[Loja_Virtual_-_B2B#Produtos-Tabela-de-Preço|Produtos - Tabela de Preço]]
## [[Loja_Virtual_-_B2B#Produtos-Estoque|Produtos - Estoque]]
## [[Loja_Virtual_-_B2B#Pedido-Capa|Pedido - Capa]]
## [[Loja_Virtual_-_B2B#Cliente|Cliente]]
## [[Loja_Virtual_-_B2B#Representantes|Representantes - Cliente]]
## [[Loja_Virtual_-_B2B#Cliente-Representante|Cliente - Representante]]
## [[Loja_Virtual_-_B2B#Condicao-de-Venda|Condição de Venda]]
## [[Loja_Virtual_-_B2B#Bloqueio-de-Referências|Bloqueio Referências]]
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.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codReferencia * | String/Integer | 255 | Código da Referência no ERP. É o código usado para gravar o produto no ERP |
| descricao | String | 255 | Descrição da referência |
| codEtiqueta | String | 255 | Código da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc|
| codLinha | String | 255 | Código da Linha de Produto da referência. |
| nomeLinha | String | 255 | Nome da Linha de Produto da referência. Ex: ADULTO, INFANTIL, etc|
| codTipoPeca | String | 255 | Código do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeTpoPeca | String | 255 | Nome do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. Ex: CALCA, BLUSA, CAMISA, SHORTS, etc|
| codTipoModelo | String | 255 | Código do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. Ex: Masculino / Feminino|
| precoUnitario | Double | | Preço Unitário, geralmente deixado valor 0 |
| GradesAtivas | String | | *Campo Específico.* Retornar null , salvo alguma orientação diferente da IBTech. Somente se trabalha com Grade Estendida. Senão retornar null |
| codReferenciaProvisoria| String | | Código de Referencia "Provisória", ou aquela que o cliente "conhece". Caso seja a mesma do campo codReferencia, retornar o mesmo valor |
| descricao | String | 255 | Descrição |
| descricaoHTML | String | 255 | Descrição HTML (Se existir no ERP). Se não retornar null |
| qtdeEmbarquePadrao | Integer | | *Campo Específico.* Retornar null , salvo alguma orientação diferente da IBTech. Quantidade Embarque Padrão. Para o caso de compras múltiplas. |
| genero| String | 255 | - |
| keywords | String | 255 | Keywords do produto. |
| composicao | String | 255 | Composião do produto. |
| precoSugerido | Double | | Preço sugerido de venda. |
| flagGradeFechada | Integer | | 0 ou 1 se utiliza grade fechada |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |
| 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') ) |
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 |
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 |
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 |
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 - Tabela de Preço
Retornar a listagem dos produtos da tabela de preço do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codTabela * | String/Integer | 255 | Código da tabela de preços no ERP |
| codProduto * | String/Integer | 255 | Código do produto no ERP |
| codGrade * | String/Integer | 255 | Código da grade de produto no ERP |
| preco | Double | | Preço do produto (Campo deve vir com ponto em vez de virgula nos preços) |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codTabela | #TABPRECO | | | Código da tabela de preços no ERP usando a clausula IN |
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 a 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 | | Situação do Pedido |
| FormaPagamento * | String | | Forma de pagamento do pedido |
| Total * | String/Integer | | Total líquido pedido |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpjCliente | :p2 | String | | CNPJ do Cliente |
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 | | Situção do pedido |
| FormaPagamento * | String | | Forma de pagamento pedido |
| Total * | double | | total líquido pedido |
| TotalBruto * | double | | Total bruto pedido |
| Observacoes * | String | | Obs pedido |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpjCliente | :p2 | String | | CNPJ Cliente |
| codPedido | :p3 | String | | Código pedido erp |
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
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| email | String | 255 | Endereço de e-mail padrão do cliente |
| cep | String | 255 | CEP do cliente (somente números) |
| endereco | String | 255 | Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a IBTech para discutir uma solução. |
| enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| complemento | String | 255 | Complemento do endereço do cliente do cliente |
| bairro | String | 255 | Bairro do cliente |
| codIBGE | String | 255 | Código IBGE da cidade do cliente |
| telefone | String | 255 | Telefone do cliente |
| codRepres1 | String | 255 | Código do Representante Principal no ERP |
| codRepres2 | String | 255 | Código do Representante 2 no ERP |
| codRepres3 | String | 255 | Código do Representante 3 no ERP |
| codCliente | String | 255 | Código do cliente no ERP |
| flagAtivoParaLoja | Integer | | Falg para Ativo na Loja |
| flagIsRepresentanteB2B | Integer | | Flag para saber se é um representante |
| razaoSocial | String | 200 | Razão Social do Cliente |
| emailRepres | String | 255 | Email do representante para disparo de e-mail, ao cliente logar na loja |
| inscricaoEstadual | String | 255 | Inscrição Estadual |
| siglaUF | String | 255 | Sigla do Estado da Cidade do Cliente |
| nomeUF | String | 255 | Nome do Estado da Cidade do Cliente |
| populacao | Integer | | População da Cidade do Cliente |
| ipc | Double | | IPC da Cidade do Cliente |
| codGrupoCli | String | | Código do Grupo do Cliente |
| nomeGrupoCli | String | | Nome do Grupo do Cliente |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpj | :p2 | String/Integer | 255 | CNPJ ou CPF do Cliente |
h2. Cliente - Representante
Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech
Consulta representantes do cliente. Se o cliente tiver mais de um representante, todos devem ser listados com seus respectivos código e nome.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codRepres | String | 255 | Código do represetnante |
| nomeRepres | String | 255 | Nome do representante |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpj | :p2 | String/Integer | 255 | CNPJ ou CPF do Cliente |
h2. Clientes - Representantes
Consulta dados do cliente
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| email | String | 255 | Endereço de e-mail padrão do cliente |
| cep | String | 255 | CEP do cliente (somente números) |
| endereco | String | 255 | Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a IBTech para discutir uma solução. |
| enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| complemento | String | 255 | Complemento do endereço do cliente do cliente |
| bairro | String | 255 | Bairro do cliente |
| codIBGE | String | 255 | Código IBGE da cidade do cliente |
| telefone | String | 255 | Telefone do cliente |
| codRepres1 | String | 255 | Código do Representante Principal no ERP |
| codRepres2 | String | 255 | Código do Representante 2 no ERP |
| codRepres3 | String | 255 | Código do Representante 3 no ERP |
| codCliente | String | 255 | Código do cliente no ERP |
| flagAtivoParaLoja | Integer | | Falg para Ativo na Loja |
| flagIsRepresentanteB2B | Integer | | Flag para saber se é um representante |
| razaoSocial | String | 200 | Razão Social do Cliente |
| emailRepres | String | 255 | Email do representante para disparo de e-mail, ao cliente logar na loja |
| inscricaoEstadual | String | 255 | Inscrição Estadual |
| siglaUF | String | 255 | Sigla do Estado da Cidade do Cliente |
| nomeUF | String | 255 | Nome do Estado da Cidade do Cliente |
| populacao | Integer | | População da Cidade do Cliente |
| ipc | Double | | IPC da Cidade do Cliente |
| codGrupoCli | String | | Código do Grupo do Cliente |
| nomeGrupoCli | String | | Nome do Grupo do Cliente |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepres| :p2 | String/Integer | 255 | codigo do Representante |
h2. Representantes - Clientes
Consulta dados do cliente
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| email | String | 255 | Endereço de e-mail padrão do cliente |
| cep | String | 255 | CEP do cliente (somente números) |
| endereco | String | 255 | Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a IBTech para discutir uma solução. |
| enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| complemento | String | 255 | Complemento do endereço do cliente do cliente |
| bairro | String | 255 | Bairro do cliente |
| codIBGE | String | 255 | Código IBGE da cidade do cliente |
| telefone | String | 255 | Telefone do cliente |
| codRepres1 | String | 255 | Código do Representante Principal no ERP |
| codRepres2 | String | 255 | Código do Representante 2 no ERP |
| codRepres3 | String | 255 | Código do Representante 3 no ERP |
| codCliente | String | 255 | Código do cliente no ERP |
| flagAtivoParaLoja | Integer | | Falg para Ativo na Loja |
| flagIsRepresentanteB2B | Integer | | Flag 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. Condição de Venda
Retorna a listagem de Condições de Venda do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codPagamento * | String/Integer | 255 | Código da condição de Venda no ERP |
| nome | String | 255 | Nome da condição de venda |
| qtdeParcelas | Integer | | Número de parcelas da condição de venda |
| prazoMedio | Double | | Prazo médio das parcelas da condição de venda |
| situacao | Integer | | Situação conforme codificação: 0 - Inativo, 1 - Ativo |
| Parcelamento| String | 255 | Condicao de Parcelamento EX:30/60/90 |
h2. Representantes
Esta tabela/visão será utilizada para carregar no IGS a lista de representantes.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codRepres * | String/Integer | 255 | Código do Representante no ERP |
| nome | String | 255 | Nome do Representante |
| telefone | String | 255 | Telefone de Contato |
| email | String | 255 | E-Mail |
| endereco | String | 255 | Rua + Número do endereço do Representante |
| bairro | String | 255 | Bairro do Endereço do Representante |
| CEP | String | 8 | CEP do endereço do Representante |
| Cidade | String | 255 | Nome da Cidade do Endereço do Representante |
| UF | String | 2 | Sigla da UF da Cidade |
| codIBGE | String | 7 | Codigo do IBGE da Cidade |
| situacao | Integer | | Situação do cadastro do representante: 0 - Inativo, 1 - Ativo |
| Cod Repres Agrupador | String | 255 | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
| telefone 2 | String | 255 | Telefone de Contato 2 |
| telefone 3 | String | 255 | Telefone de Contato 3 |
| codigoAdministrador | String | 255 | Código do administrador do representante no erp |
| cnpj | String | 255 | CNPJ do representante |
| codAgrupadorEscritorio | String | 255 | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
| flagAgrupadorMaster | Integer | | 0 - Não, 1 - Sim (Somente um por grupo) / *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
| percComissa | Double | | Percentual de comissao |
| codigoPessoaFisica | String | 255 | Código que representa o cadastro da pessoa fisica do reperesentante |
| nomePessoaFisica | String | 255 | Nome da pessoa fisica |
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 - Não bloqueado |