Integração Analytics

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-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#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-ItensNota|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]]

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. |

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 |

| 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 |

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 - 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 |

| 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 |

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

|_.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)|

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 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 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. 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.

|_. 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 |

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 |

| notaFiscal | :p2     | String   | 255         | Código da nota fiscal |

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 |

| dataEmissao            | Date     |         | Data referente a nota fiscal de origem |

| chaveNfe               | String   |         | Chave da NFE |

Lista de Parâmetros:

|_. Campo        |_. Parâmetro           |_. Tipo         |_. Precisão     |_. Descrição |

| codEmpresa     | :codEmpresa           | String/Integer | 10             | Código da empresa no ERP |

| notaFiscal     | :numeroNota           | String         | 255            | 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       |

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)) |