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-Tabela-de-Preço-por-SKU|Produtos - Tabela de Preço por SKU]]

## [[Loja_Virtual_-_B2B#Produtos-Estoque|Produtos - Estoque]]

## [[Loja_Virtual_-_B2B#Produtos-Pocket|Produtos - Pocket]]

## [[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#Licenciados-Fornecedor|Licenciados - Fornecedores]]

## [[Loja_Virtual_-_B2B#Licenciados-Pedido-Histórico|Licenciados - Pedido - Histórico]]

## [[Loja_Virtual_-_B2B#Licenciados-Pedido-Itens|Licenciados - Pedido - Itens]]

## [[Loja_Virtual_-_B2B#Licenciados-DANFE-Listagem|Licenciados - DANFE - Listagem]]

## [[Loja_Virtual_-_B2B#Licenciados-DANFE-XML|Licenciados - DANFE - XML]]

## [[Loja_Virtual_-_B2B#Cliente|Cliente]]

## [[Loja_Virtual_-_B2B#Clientes-Crédito-troca-e-garantia|Clientes - Crédito troca e garantia]]

## [[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#Boletos-Pagos-Listagem-(somente-via-API-com-ELT)|Boletos Pagos - Listagem (somente via API com ELT)]]

## [[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#Nota-de-Devolução-Integral| Nota de Devolução Integral]]

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

## [[Loja_Virtual_-_B2B#Pedido-Recompra|Pedido - Recompra]]

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

*Atenção!! Os campos que estiverem com a descrição "Campo Específico" retornar null, salvo se for combinado algo diferente com a GEOvendas durante o processo.*

*Atenção!! Cabe ao desenvolvedor das Views retornar nas views os campos obrigatórios e os campos não obrigatórios que forem pertinentes ao processo do Cliente, ou a informação que o cliente deseja enxergar.*

Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail atendimento@geovendas.com 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 GEOvendas 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 GEOvendas 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 GEOvendas sobre o que trazer neste campo. |

| 4| nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a GEOvendas 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 GEOvendas sobre o que trazer neste campo. |

| 8| nomeTpoPeca | String | 255 | Nome do Tipo de Peça da referência. Consultar a GEOvendas 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 GEOvendas sobre o que trazer neste campo. |

|10| nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a GEOvendas 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 GEOvendas. 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 GEOvendas. 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 GEOvendas) - 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 |

|26| data_referencia | String | 255 | Data de referência do produto - usado para quebra de pedido - Formato: "yyyy-mm-dd hh:mm:ss" (ano, mês, dia, hora 24h, min, seg)|

|27| codCoringa1 | String | 255 | Código do campo coringa 1. Consultar a GEOvendas sobre o que trazer neste campo. |

|28| nomeCoringa1 | String | 255 | Nome do coringa 1. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc|

|29| codCoringa2 | String | 255 | Código do campo coringa 2. Consultar a GEOvendas sobre o que trazer neste campo. |

|30| nomeCoringa2 | String | 255 | Nome do coringa 2. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc|

|31| codCoringa3 | String | 255 | Código do campo coringa 3. Consultar a GEOvendas sobre o que trazer neste campo. |

|32| nomeCoringa3 | String | 255 | Nome do coringa 3. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc|

|33| codCoringa4 | String | 255 | Código do campo coringa 4. Consultar a GEOvendas sobre o que trazer neste campo. |

|34| nomeCoringa4 | String | 255 | Nome do coringa 4. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc|

|35| codCoringa5 | String | 255 | Código do campo coringa 5. Consultar a GEOvendas sobre o que trazer neste campo. |

|36| nomeCoringa5 | String | 255 | Nome do coringa 5. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc|

|37| sequencia | Integer | | Sequência do produto para exibição na loja |

|38| agrupador_kit | String | 255 | Código do agrupador de kits - *EM DESENVOLVIMENTO* |

|39| nome_agrupador_kit | String | 255 | Nome do agrupador de kits - *EM DESENVOLVIMENTO* |

|40| embarque_referencia | Integer | | Quantidade mínimo da referência em um pedido - *EM DESENVOLVIMENTO* |

|41| embarque_sortimento | Integer | | Quantidade mínima de um sortimento de uma referência em um pedido - *EM DESENVOLVIMENTO* |

|42| embarque_sku | Integer | | Quantidade mínima de uma SKU em um pedido - *EM DESENVOLVIMENTO* |

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 |  | Múltiplo 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) |

| precoPromocao    | Double   |            | Preço de promoção (Campo deve vir com ponto em vez de virgula nos preços) |

| ignorarDescontoB2B    | Integer  |            | Se deve ignorar o desconto sobre o item. (Default é 0, não deve ignorar) |

| markup    | Double   |            | Markup do Produto |

Lista de Parâmetros:

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

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

| codTabela | #TABPRECO     |   |   | Código da tabela de preços no ERP usando a clausula IN |

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

| flagBloqueio    | Integer   |            | Flag bloqueado |

| precoPromocional    | Double   |            | Preço promocional do produto |

| dataInicioPromo   | Date   |            | Data inicial da vigência do preço promocional (Formato yyyy-MM-dd) |

| dataFimPromo   | Date   |            | Data final da vigência do preço promocional (Formato yyyy-MM-dd) |

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 GEOvendas, 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ções para filtro com a cláusula IN |

| codTabPreco | #TABPRECO |  |  | Lista de tabelas de preços para filtro com a cláusula IN |

| codNatureza/codDeposito | #NATUREZA |  |  | Lista de natureza/deposito para filtro com a cláusula IN |

h2. Produtos - Pocket

Retornar as SKUS que compõem o pocket, por cliente e referência..

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| codCliente *  | String/Integer   | 255        | Código do cliente |

| codReferencia * | String/Integer| 255 | Código da referencia |

| seqSortimento * | String/Integer| 255 | Código do sortimento na referencia |

| seqTamanho *   | String/Integer|    255    | Código do tamanho na referência |

| quantidade *  | Integer   |   | Quantidade que será enviada no pocket |

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 |

| pedidoCliente  | String   |  | numero do pedido 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 |

| cnpjCliente | :p2     | String   |          | CNPJ do Cliente |

| dataInicio | :p3     | Date   |          | Data de Inicio do Período |

| dataFim | :p4     | Date   |          | Data Final do Período |

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 |

| CodReferenciaReduzida * | Double   |  | Código referencia Reduzido |

| 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. Licenciados - Pedido - Histórico

Histórico pedido ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| NumeroErp * | String/Integer   |  | Código pedido ERP |

| Data * | Date   |  | Data de Emissão do Pedido |

| Situacao * | String   |  | Descrição da Situação do Pedido |

| codColecao * | String   |  | Código da Coleção |

| nomeColecao * | String   |  | Nome da Coleção |

| dataPrevisaoEntrega * | Date   |  | Data de Previsão de Entrega |

| qtdePecas * | Integer   |  | Quantidade de Peças |

| Total * | String/Integer   |  | Total líquido pedido |

| codcliente * | String/Integer   |  | Código cliente pedido |

| cliCnpj * | String   |  | CNPJ cliente pedido |

| nomecliente * | String   |  | Nome cliente pedido |

| cnpjFornecedor * | String   |  | Código do fornecedor |

| codFornecedor * | String   |  | Código do fornecedor |

| codEmpresa * | String  |  | Código da empresa |

| cidadeCliente * | String  |  | Nome da cidade do cliente |

| estadoCliente * | String  |  | Nome do estado do cliente  |

| logradouroCliente * | String  |  | logradouro do cliente  |

| bairroCliente * | String  |  | bairro do cliente  |

| cepCliente * | String  |  | CEP do cliente  |

| telefoneCliente * | String  |  | Telefone do cliente  |

| emailCliente * | String  |  | E-mail do cliente  |

| inscricaoEstadualCliente * | String  |  | Inscrição Estadual 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 |

| cnpjFornecedor | :p2     | String   |          | CNPJ do Fornecedor |

| dataInicio | :p3     | Date   |          | Data de Inicio do Período |

| dataFim | :p4     | Date   |          | Data Final do Período |

h2. Licenciados - Pedido - Itens

Itens detalhe pedido ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| CodProduto * | String   |  | Código do produto |

| NomeProduto * | String   |  | Nome do item |

| QtdePedida * | Double   |  | Quantidade pedida |

| ValorUnitarioLiquido * | Double   |  | Valor líquido |

| ValorTotal * | Double   |  | Valor total |

| SeqTamanho * | String   |  | Seq tamanho |

| SeqSortimento * | String   |  | Seq sortimento |

| CodReferenciaReduzida * | String   |  | Código referencia Reduzido |

| DescTamanho * | String   |  | Descrição do tamanho |

| DescSortimento * | String   |  | descrição do Sortimento |

Lista de Parâmetros:

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

| codPedido | :p1     | String   |          | Código pedido erp |

h2. Licenciados - 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 ocorrências da nota fiscal. Campo especifico, mandar null salvo orientação |

| codEmpresa | String   | 255         | Código da empresa |

Listagem de parâmetros:

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

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

| codPedido | :p2     | String   | | Código do pedido |

h2. Licenciados - 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. 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 GEOvendas 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 funcionário - Haskell) |

|_.27 | limiteCredito | Double |  | Limite de crédito do cliente, já descontado 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…) |

|_.45 | depositos_cliente | String |  | Definição dos depósitos do cliente (para quebra de pedido e exibição/validação de estoque) |

|_.46 | percAcrescimo | Double |  | Percentual de acréscimo do Cliente (Royaltie) |

|_.47 | dataFaturamento | Date |  | Data de faturamento do cliente (*EM DESENVOLVIMENTO*) |

|_.48 | dataLimiteCompra | Date |  | Data de limite para o cliente poder digitar pedidos (*EM DESENVOLVIMENTO*) |

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 - Crédito troca em garantia

Retornar saldos e notas disponíveis para que o cliente use na troca e garantia.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| filial *  | String   | 100        | Código/nome da filial |

| notaFiscal * | String | 100 | Número da nota fiscal |

| codCliente * | String | 100 | Código do cliente |

| cnpjCliente *   | String | 20 | CNPJ do cliente |

| codGrupoCliente *   | String | 20 | Código do Grupo do cliente |

| nomeCliente *   | String | 300 | Nome do cliente |

| valor *  | Double |  10,2  | Valor do credito disponível |

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 GEOvendas 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 | E-mail 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 funcionário - Haskell) |

|_.27 | limiteCredito | Double |  | Límite de crédito do cliente, já descontado 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 | regimeST | String |  | Regime ST do cliente |

|_.43 | depositosCliente | String |  | Depósitos liberados do cliente (Utilizado para estoque e quebra de pedido por 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 |

| codRepres| :p2     | String/Integer   | 255         | código do Representante |

h2. Licenciados - Fornecedor

Consulta dados dos fornecedor para disponibilizar no b2b

|_.0 |_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

|_.1 | cnpj * | String | 255 | CNPJ ou CPF do fornecedor (somente números) |

|_.2 | nomeFantasia | String | 255 | Nome fantasia do fornecedor |

|_.3 | email | String | 255 | Endereço de e-mail padrão do fornecedor |

|_.4 | cep | String | 255 | CEP do fornecedor (somente números) |

|_.5 | endereco | String | 255 | Endereço do fornecedor sem o número. Caso o número estiver gravado no mesmo fornecedor, contate a GEOvendas para discutir uma solução. |

|_.6 | enderecoNumero | String | 255 | Número do endereço do fornecedor |

|_.7 | complemento | String | 255 | Complemento do endereço do fornecedor |

|_.8 | bairro | String | 255 | Bairro do fornecedor |

|_.9 | codIBGE | String | 255 | Código IBGE da cidade do fornecedor |

|_.10 | telefone | String | 255 | Telefone do fornecedor |

|_.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 | codFornecedor  | String | 255 | Código do fornecedor no ERP |

|_.15 | flagAtivoParaLoja | Integer | | Falg para Ativo na Loja |

|_.16 | flagIsRepresentanteB2B | Integer | | Flag para saber se é um representante, vira como 4 para fornecedor |

|_.17 | razaoSocial | String | 200 | Razão Social do fornecedor |

|_.18 | emailRepres | String | 255 | Email do representante para disparo de e-mail, ao fornecedor logar na loja |

|_.19 | inscricaoEstadual | String | 255 | Inscrição Estadual |

|_.20 | siglaUF | String | 255 | Sigla do Estado da Cidade do fornecedor |

|_.21 | nomeUF | String | 255 | Nome do Estado da Cidade do fornecedor |

|_.22 | populacao | Integer |  | População da Cidade do fornecedor |

|_.23 | ipc | Double |  | IPC da Cidade do fornecedor |

|_.24 | codGrupoCli | String |  | Código do Grupo do fornecedor |

|_.25 | nomeGrupoCli | String |  | Nome do Grupo do fornecedor |

|_.26 | salarioBase | Double |  | Salário base do funcionário (quando fornecedor for um funcionário - Haskell) |

|_.27 | limiteCredito | Double |  | Limite de crédito do fornecedor, já descontado os pedidos que estão em aberto |

|_.28 | codCondPagto | String |  | Código da condição de pagamento do fornecedor |

|_.29 | codTransportadora | String |  | Código da Transportadora do fornecedor |

|_.30 | descontoPadrao | Double |  | Desconto Padrão do fornecedor |

|_.31 | pais | String |  | Código do País |

|_.32 | inadimplente | Integer |  | 0 = Não Inadimplente, 1 = Inadimplente|

|_.33 | fornecedor_novo_crm | Integer |  | 0 = fornecedor da Base, 1 = fornecedor Novo|

|_.34 | fax | String |  | Fax do fornecedor|

|_.35 | celular | String |  | Celular do fornecedor|

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

|_.40 | instagram | String |  | Instagram do fornecedor|

|_.41 | dataFundacao | Date |  | Data de Fundação|

|_.42 | marcasLiberadas | Date |  | Código das Marcas liberadas para compra do fornecedor (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 fornecedor (Simples, SST…) |

|_.45 | depositos_fornecedor | String |  | Definição dos depósitos do fornecedor (para quebra de pedido e exibição/validação de estoque) |

|_.46 | percAcrescimo | Double |  | Percentual de acréscimo do fornecedor (Royaltie) |

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

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

| salarioBase | String |  | Salario Base do Cliente |

| limiteCrédito | String |  | Limite de Crédito 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 | Código do Representante no ERP |

| codigoCliente | String | 255 | Código do Cliente no ERP |

| codMarca| String | 255 | Código Marca |

| PercComissao| String | 255 | Percentual de Comissão |

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      | Condição de Parcelamento EX:30/60/90 |

| Clientes | String  |         | CNPJ dos clientes separados por vírgula |

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          | Código 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 GEOvendas |

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

| flagAgrupadorMaster     | Integer   |         | 0 - Não, 1 - Sim (Somente um por grupo) / *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas   |

| percComissa | Double   |            | Percentual de comissão |

| codigoPessoaFisica    | String   | 255        | Código que representa o cadastro da pessoa física do representante |

| nomePessoaFisica    | String   | 255        | Nome da pessoa física |

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 |

Lista de Parâmetros:

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

| codColecoes | #COLECOES or #COLECOESNULL | String | | Coleções separadas por virgula |

| codTabPrecos | #TABPRECOS or #TABPRECOSNULL | String | | Tabelas de preços separadas por virgula |

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         | Código do cliente  |

| nome * | String   | 255         | Nome do cliente  |

| cnpj * | String   | 11         | CNPJ do cliente SEM FORMATACAO |

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

| tituloDisplay  | String   | 255         | Código do Titulo para Exibição (Na tabela e no boleto) |

| chaveNFE | String   | 255         | Chave da NFE para emissão via API |

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 Pagos - Listagem (somente via API com ELT)

Estes dados serão utilizados somente se a integração for via API para remover os títulos já pagos do lado da GEOVENDAS, eles não serão listados mais para pagamento.

Esse endpoint deve conter um filtro para passar de "pagametoDe" e de "pagamentoAté" para filtrar no endpoint.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa | String   | 10         | Código da empresa no ERP |

| titulo * | String   | 255         | Código do Titulo  |

| codCliente * | String   | 255         | Código do cliente |

| cnpj * | String   | 255         | CNPJ do Pagador |

| dataPagamento * | Date   | -         | Data de pagamento |

h2. Boletos - Detalhado

Estes dados serão utilizados na geração do boleto de cobrança

|_.-|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

|_.1| banco * | String   | 255         | Código do banco  |

|_.2| codCliente * | String   | 255         | Código do cliente |

|_.3| cnpjBenef * | String   | 255         | CNPJ do Beneficiário |

|_.4| nomeBenef * | String   | 255         | Nome do Beneficiário |

|_.5| agenciaBenef * | String   | 255         | Agencia do Beneficiário |

|_.6| agDigitoBenef * | String   | 255         | Digito da agencia do Beneficiário |

|_.7| carteiraBenef * | String   | 255         | Carteira do Beneficiário |

|_.8| contaBenef * | String   | 255         | Conta do Beneficiário |

|_.9| digitoContaBenef * | String   | 255         | Digito da conta do Beneficiário |

|_.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 acréscimos |

|_.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         | descrição da Instrução titulo |

|_.36| Instrucao2* | String   | 255         | descrição da Instrução titulo |

|_.37| Instrucao3* | String   | 255         | descrição da Instrução titulo |

|_.38| Instrucao4* | String   | 255         | descrição da Instrução titulo |

|_.39| Instrucao5* | String   | 255         | descrição da Instrução titulo |

|_.40| flag_escritural* | String   | 255         | se o titulo é ou não de cobrança escritural|

|_.41| MenssagemErro | String   | 255         | Mensagem Retorno caso titulo esteja faltando campos|

|_.42| Convenio | String   | 255         | Numero do convenio |

|_.43| NumeroPosto| String   | 255         | Numero do Posto Bancário |

|_.44| numParcela | String   | 255         | Numero da parcela do boleto (tratado Sicoob) |

|_.45| linhaDigitavel | String   | 255         | Linha digitável pronta, para ser utilizada quando não podemos gerar com os dados fornecidos |

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 ocorrências da nota fiscal. Campo especifico, mandar null salvo orientação |

| codEmpresa | String   | 255         | Código da empresa |

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         | Código 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' |

| codLoteErp         | String      | 50    | Código do lote de faturamento no ERP |

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   |         | Código 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 |

| cor                             | String   |         | Código da cor |

| nomeCor                         | String   |         | Nome da Cor |

| nomeTamanho                     | String   |         | Nome do Tamanho |

Lista de Parâmetros:

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

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

| itensDevolucao | #itensDevolucao | String         | Array<String>  | Array com o Código do produto |

| numerosNotas | #numerosNotas | String         | Array<String>  | Array com o número das notas |

h2. Nota de Devolução Integral

Retorna os itens referente a nota para a inclusão integral.

|_. Campo                         |_. Tipo   |_. Precisão |_. Descrição |

| nota *                          | String   |         | Número da Nota (deve ser montado igualmente a KEY do EditDisplay para selecionar a nota para devolução) |

| descricaoNota *                 | String   |         | Descrição da Nota (deve ser montado igualmente ao LABEL do EditDisplay para selecionar a nota para devolução) |

| referencia *                    | String   |         | Código da referência (deve ser a mesma KEY da combo ao selecionar o item para devolução) |

| descricaoReferencia *           | String   |         | Nome/descrição da referência (deve ser a mesma KEY da combo ao selecionar o item para devolução) |

| tamanho *                       | String   |         | Código do tamanho (deve ser a mesma KEY da combo ao selecionar o Tamanho para devolução) |

| descricaoTamanho *              | String   |         | Descrição do Tamanho (deve ser a mesma KEY da combo ao selecionar o Tamanho para devolução) |

| quantidade *                    | String   |         | Quantidade de itens da nota original da referência em questão |

| cor                             | String   |         | Código da cor |

| nomeCor                         | String   |         | Nome 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 |

| nota *         | :p2                   | String         |                | Número da nota para a inclusao integral |

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 *       | Integer   |         | Quantidade da faixa  |

| valor *            | Double   |  2      | Valor da faixa       |

| cor**              | String   |         | Código da cor        |

| codTabPreco              | String   |         | Código da tabela de preço        |

| agrupador              | String   |         | Agrupador para referências que compartilham as quantidades informadas       |

| tamanho              | String   |         | Código do tamanho       |

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

| #TABPRECOS     | IN | Recebe uma lista dos códigos das tabelas de preços ativas para o B2B (Pode ser null para todos) |

| #TABPRECOSNULL | - | Parâmetro para trazer todos registros ((campo in (#TABPRECOS)) OR (#TABPRECOSNULL IS NULL)) |

.* Campos obrigatórios

.** Campo obrigatório, quando não informado o campo Agrupador

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 acréscimo no calculo       |

h2. Pedido - Recompra

Recompra de pedidos do cliente.

*OBS. Este SQL deve retornar sempre só uma linha.*

|_. Campo        |_. Tipo          |_. Precisão |_. Descrição |

| codEmpresa *   | String/Integer  |  | Código da empresa |

| codCliente *   | String          |  | Código do cliente |

| codPedido *    | String          |  | Código do pedido |

| dataEmissao *  | Date            |  | Data de emissão do pedido |

| codSituacao *  | Integer         |  | Código da situação do pedido |

| valorBruto *   | Double          |  | Valor bruto do pedido |

| valorLiquido * | Double          |  | Valor liquido do pedido |

| valorSaldo *   | Double          |  | Valor do saldo do pedido |

| quantidade *   | Double          |  | Quantidade do pedido |

Lista de Parâmetros:

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

| Data Inicial    | :p1     | Date   | 10       | Data inicial do parâmetro na tabela de preço |

| Data Final      | :p2     | Date   |          | Data final do parâmetro na tabela de preço |

| CNPJ do Cliente | :p3     | String |          | CNPJ do Cliente |

| Tabela de preço | :p4     | String |          | Tabela de Preço |