Integração Analytics

h1. Força de Vendas - Malharia

*Índice* 

# [[Força_de_Vendas_-_Malharia#Introdução|Introdução]] 

# [[Força_de_Vendas_-_Malharia#Acesso-via-JDBC|Acesso via JDBC]] 

# [[Força_de_Vendas_-_Malharia#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]]

## [[Força_de_Vendas_-_Malharia#Tabelas-de-Integração|Tabelas de Integração]]

## [[Força_de_Vendas_-_Malharia#Parâmetros|Parâmetros]]

## [[Força_de_Vendas_-_Malharia#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]

# [[Força_de_Vendas_-_Malharia#Layouts-de-Integração|Layouts de Integração]]

## [[Força_de_Vendas_-_Malharia#Produtos|Produtos]]

## [[Força_de_Vendas_-_Malharia#Produtos-Variantes|Produtos - Variantes]]

## [[Força_de_Vendas_-_Malharia#Produtos-Exclusivos|Produtos - Exclusivos]]

## [[Força_de_Vendas_-_Malharia#Tabela-de-preço-Capa|Tabela de Preço - Capa]]

## [[Força_de_Vendas_-_Malharia#Tabela-de-preço-Itens|Tabela de Preço - Itens]]

## [[Força_de_Vendas_-_Malharia#Tabela-de-Preço-Clientes|Tabela de Preço - Clientes]]

## [[Força_de_Vendas_-_Malharia#Tabela-de-Preço-Representante|Tabela de Preço - Representantes]]

## [[Força_de_Vendas_-_Malharia#Catalogos|Catalogos]]

## [[Força_de_Vendas_-_Malharia#Acessórios-de-Produtos|Acessórios-de-Produtos]]

## [[Força_de_Vendas_-_Malharia#Lotes-de-Faturamento|Lotes de Faturamento]]

## [[Força_de_Vendas_-_Malharia#Condição-de-Venda|Condição de Venda]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Consulta|Listagem de Pedidos - Consulta]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Detalhamento-da-Capa|Listagem de Pedidos - Detalhamento da Capa]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Itens|Listagem de Pedidos - Itens]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Notas|Listagem de Pedidos - Notas]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Notas-Itens|Listagem de Pedidos - Notas Itens]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Situação-ERP|Listagem de Pedidos - Situação ERP]]

## [[Força_de_Vendas_-_Malharia#Listagem-de-Pedidos-Tipo-Nota|Listagem de Pedidos - Tipo Nota]]

## [[Força_de_Vendas_-_Malharia#Triangulação|Triangulação]]

## [[Força_de_Vendas_-_Malharia#Transportadoras|Transportadoras]]

## [[Força_de_Vendas_-_Malharia#Comissões-Extrato-Resumo|Comissões - Extrato Resumo]]

## [[Força_de_Vendas_-_Malharia#Comissões-Extrato-Detalhado|Comissões - Extrato Detalhado]]

## [[Força_de_Vendas_-_Malharia#Títulos|Títulos]]

## [[Força_de_Vendas_-_Malharia#Tipo-de-Cobrança|Tipo de Cobrança]]

## [[Força_de_Vendas_-_Malharia#Condição-de-Pagamento|Condição de Pagamento]]

## [[Força_de_Vendas_-_Malharia#Campos-Customizados|Campos Customizados]]

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.

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

| 1| codProduto * | String   | 255 | Código do Produto no ERP. É o código usado para gravar o produto no ERP. |

| 2| nomeProduto * | String | 255 | Descrição do Produto. |

| 3| larguraTxt * | String | 255 | Descrição da largura para exibição. |

| 4| largura * | Double |  | Largura. |

| 5| gramaturaTxt * | String | 255 | Informação de gramatura para exibição. |

| 6| gramatura * | Double |  | gramatura do produto. |

| 7| rendimentoMKG * | Double |  | rendimento do produto em M/KG. |

| 8| keyword * | String | 255 | keywords do produto. |

| 9| composicao * | String | 255 | Descrição da composição do produto. |

|10| acessorio * | Integer| 0,1 | Deve ser informado 1, quando a linha representar um acessório. Default: 0 |

|11| vendaAcessorio * | Integer | 0,1  | Deve ser informado 1, quando é possível vender o acessório como um produto principal. Default: 0 |

|12| unidadeMedida * | String| KG,M  | Deve ser informado M para metros e KG para quilos. Default: KG |

|13| urlFichaTecnica  | String |  | URL da Ficha tecnica do produto. O arquivo PDF deve estar acessível publicamente caso seja uma URL direta ao arquivo, caso seja URL de página mesma não deve ter o cabeçalho X-Frame-Options configurada |

Lista de Parâmetros:

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

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

| codCatalogo | :p2     | String   | 255         | Código do catalogo no ERP |

| codProduto | #PRODUTOS | String | text | Lista de Referências Ex: and (codProduto in (#PRODUTOS) or #PRODUTOS_TODOS = '') *Para ORACLE* and (codProduto in (#PRODUTOS) or nvl(#PRODUTOS_TODOS,'0') = nvl('','0') ) |

h2. Produtos - Variantes

Retornar a listagem de variantes dos produtos.

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

| 1| codProduto * | String   | 255 | Código do Produto no ERP. É o código usado para gravar o produto no ERP. |

| 2| codVariante * | String | 255 | Código da da variante no ERP. |

| 3| nomeVariante * | String | 255 | Nome da Variante. |

| 4| skuReduzido * | String | 255 | SKU reduzido do produto. |

| 5| codCatalogo * | String | 255 |  Código do catalogo. |

| 6| pesoPadrao * | Double |  |  Peso padrão. |

| 7| codLinha * | String | 255 | Código da Linha. |

| 8| nomeLinha * | String | 255 | Nome da Linha. |

| 9| codGrupoCor * | String | 255 | Código do grupo cor. |

|10| nomeGrupoCor * | String | 255 | Nome do grupo da cor. |

|11| rgb * | String | | RGB referente a variante do produto. | 

|12| codTipoPeca * | String | | Código do tipo da peça. | 

|13| nomeTipoPeca * | String | | Nome do tipo de peça. | 

|14| especial* | Integer | | 1 se o produto for exclusivo. 0 para os demais casos. Se o código for 1, desviaremos para quem não tem autorização|

|15| codClassificacaoFiscal * | String | 255 | Código da classificação fiscal do produto. |

|16| descClassificacaoFiscal * | String | 255 | Descrição da classificação fiscal do produto. |

|17| codCategoria * | String | 255 | Código da Categoria do produto. |

|18| descCategoria * | String | 255 | Descrição da Categoria do produto. |

|19| codOrigem * | String | 255 | Código da Origem do produto. |

|20| descOrigem * | String | 255 | Descrição da Origem 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 |

| codCatalogo | :p2     | String   | 255         | Código do catalogo no ERP |

| codProduto | #PRODUTOS | String | text | Lista de Referências Ex: and (codProduto in (#PRODUTOS) or #PRODUTOS_TODOS = '') *Para ORACLE* and (codProduto in (#PRODUTOS) or nvl(#PRODUTOS_TODOS,'0') = nvl('','0') ) |

h2. Produtos - Exclusivos

Retornar a listagem de produtos exclusivos. Esta é a autorização do cliente para itens especiais.

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

|1| skuReduzido | String | 255 | SKU reduzido do produto. |

|2| codCliente | String | 255 | Código do Cliente |

Lista de Parâmetros:

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

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

h2. Tabela de preço - Capa

Retornar a capa da tabela de preço.

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

| 1| codTabela * | String   | 255 | Código da Tabela de preço no ERP. |

| 2| nomeTabela * | String | 255 | Descrição da Tabela de preço. |

|3| nomeApresentacao* | String | 255 | Nome para apresentação no FVM |

|4| ordem | Integer | 255 | Ordem |

|5| status | String | 255 | Status(ativo/inativo) |

|6| dataValidadeInicial | Date | | Data Validade Inicial |

|7| dataValidadeFinal | Date | | Data Validade Final |

|8| liberacaoAcesso | String | 255 | Liberação de Acesso (Todos/Específica) |

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ço no ERP |

h2. Tabela de preço - Itens

Retornar a listagem de tabela de preços.

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

| 1| codTabela * | String   | 255 | Código da Tabela de preço no ERP. |

| 2| codProduto * | String | 255 | Código do produto no ERP. |

| 3| codGrupoCor * | String | 255 | Código Grupo Cor. |

| 4| nomeGrupoCor * | String | 255 | Descrição do Grupo Cor. |

| 5| prazoMedio * | Integer |  |  Identificar do prazo medio. |

| 6| padrao * | Integer |  | 1 se for preço padrão. 0 caso não seja. |

| 7| rendimento * | Double |  | Rendimento do produto. |

| 8| precoQuilo * | Double |  | Preço do produto por quilo. |

| 9| precoMetro * | Double |  | Preço do produto por metro. |

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ço no ERP |

h2. Tabela de Preço - Clientes

Retornar a listagem de clientes de tabelas de preços.

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

|1| codigoTabela | String | 255 | Código da Tabela de Preço |

|2| codigoCliente | String | 255 | Código do Cliente |

h2. Tabela de Preço - Representante

Retornar a listagem de representantes de tabelas de preços.

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

|1| codigoTabela | String | 255 | Código da Tabela de Preço |

|2| codigoRepresentante | String | 255 | Código do Representante|

h2. Catalogos

Retornar a listagem de Catálogos.

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

| 1| codCatalogo * | String   | 255 | Código do Catalogo no ERP. |

| 2| nomeCatalogo * | String | 255 | Descrição do Catalogo no ERP. |

| 3| status * | Integer |  | 1 quando estiver liberado. 0 quando estiver bloqueado. |

Lista de Parâmetros:

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

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

h2. Acessórios de Produtos 

Retornar a listagem de vinculo de produtos com acessórios.

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

| 1| codProduto * | String   | 255 | Código do Produto no ERP. |

| 2| codAcessorio (codProduto) * | String | 255 | Código do acessório no ERP. |

| 3| multiplicador * | Double |  | Multiplicador proporcional entre a venda de um item principal e um acessório. EX: Se for inserido 18kg na quantidade principal e na integração estiver inserido que se aplica 0,250kg para cada kilo do principal, a quantidade a ser inserida automaticamente será 4,5kg.  |

Lista de Parâmetros:

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

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

h2. Lotes de Faturamento

Retornar o cadastro de lotes de faturamento

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

| dataLimite* | Date |  | Data Limite -- Data de referência  |

| dataFaturamento* | Date |  | Data de faturamento |

| descricao* | String |  | Descrição do lote de faturamento |

| codErp | String |  | Código do lote no ERP (Necessário APENAS se for essencial para a gravação do Pedido) |

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

|   codEmpresa    |  :p1         |  String/Integer   | 	 			   |    codEmpresa      |

| dataReferencia  |  :p2         |  Date   			 |                 | Data de referência |

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

Lista de Parâmetros:

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

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

h2. Listagem de Pedidos - Consulta

Retornar dados referentes a capa do pedido.

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

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

|2| codCliente | String | 255 | Código do Cliente |

|3| nomeCliente | String | 255 | Nome do Cliente |

|4| codRepres | String | 255 | Código do Representante |

|5| pedAutomacao | String | 255 | Número do Lote de Gravação |

|6| codPedido | String | 255 | Código do Pedido no ERP |

|7| dataEmissao | Date | | Data de Emissão do Pedido |

|8| dataPrevFat | Date | | Data de Previsão de Faturamento do Pedido |

|9| situacao | Integer | 10 | Código da Situação no ERP |

|10| situacaoEdt | String | 255 | Descrição da Situação do Pedido |

|11| valorBruto | Double | | Valor Bruto do Pedido |

|12| valorLiquido | Double | | Valor Liquido do Pedido |

|13| valorSaldo | Double | | Valor Saldo do Pedido |

|14| qtdePedLiquida | Integer | | Quantidade Pedida Liquida |

|15| motivo | String | 255 | Motivo do pedido |

|16| pedidoCliente | String | 255 | Codigo do Pedido de controle do cliente |

|17| pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |

|18| percComissao | Double | | Percentual de comissão do pedido |

|19| usuarioDigitacao | String | 255 | Usuário digitação do pedido |

|20| valorComissao | Double | | Valor da comissão do pedido |

|21| percDescGeral | Double | | Percentual de desconto geral do pedido |

|22| valorDesconto | Double | | Valor total de desconto do pedido |

|23| nomeColecao | String | 255 | Coleção do Pedido p/ Histórico de Pedidos |

|24| codTipoNota | String | 255 | Código do Tipo de nota p/ Histórico de Pedidos |

|25| currency | String | 255 | Config de moeda para o ISF, fixo 'R$' |

|26| nomeTipoNota | String | 255 | Nome do Tipo da Nota |

|27| motivoQuarentenaPedidos | String | 255 | Motivo Da Quarentena dos pedidos |

|28| atendente | String | 255 | Atendente do pedido |

|29| tabPrecoPedido | String | 255 | Tabela de Preço do Pedido |

|30| situacaoWorkFlow | String | 255 | Situação do Ppedido no WorkFlow |

|31| nomeRepres | String | 255 | Nome Representante |

|32| valorFaturado | Double | | Valor Faturado |

|33| qtdeEntregue | Double | | Quantidade Entregue |

|34| percEntrega | Double | | Percentual de Entrega |

|35| nomeFantasia | String | 255 | Nome Fantasia |

|36| nomeMarca | String | 255 | Marca do Pedido p/ Histórico de Pedidos |

Lista de Parâmetros:

_Formato sugerido de data: yyyy-mm-dd (2023-12-13)_

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

| :p1 | Date | | (opcional) Data de Emissão do Pedido inicial |

| :p2 | Date | | (opcional) Data de Emissão do Pedido final |

| :p3 | String | 10 | (opcional) Código do Cliente |

| :p4 | String | | (opcional) Nome do Cliente |

| :p5 | List<String> | | (opcional) Tipo da nota do pedido |

| :p6 | List<String> | | (opcional) Status do ERP |

| :p7 | String | 10 | (opcional) Código da negociacao |

| :p8 | String | 10 | (opcional) Código do pedido |

| :p9 | Date | | (opcional) Data de previsão de faturamento inicial |

| :p10 | Date | | (opcional) Data de previsão de faturamento  final |

| :p11 | String | 10 | (opcional) Código do representante |

h2. Listagem de Pedidos - Detalhamento da Capa

Retornar dados detalhados do pedido.

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

|1| dataEmissao | Date | | Data de Emissão do Pedido |

|2| dataPrevFat | Date | | Data de Previsão do Faturamento |

|3| situacaoEdt | String | 255 | Descrição da Situação do Pedido |

|4| codCliente | String | 255 | Código do Cliente |

|5| nomeCliente | String | 255 | Nome do Cliente |

|6| cidadeCliente | String | 255 | Nome da Cidade do Cliente (cidade da venda) |

|7| ufCliente | String | 255 | Sigla do Estado do Cliente (estado da venda). |

|8| inscEstadual | String | 255 | Inscrição Estadual do Cliente | 

|9| cnpjCliente | String | 255 | Cnpj do Cliente |

|10| codRepres | String | 255 | Código do Representante |

|11| percComissao | Double | | Percentual de Comissão do Pedido |

|12| codTabPreco | String | 255 | Código da Tabela de Preço |

|13| nomeTabPreco | String | 255 | Nome da Tabela de Preço |

|14| codCondVenda | String | 255 | Código da Condição de Venda |

|15| nomeCondVenda | String | 255 | Nome da Condição de Venda |

|16| codTranspDespacho | String | 255 | Código da Transportadora de Despacho | 

|17| nomeTranspDespacho | String | 255 | Nome da Transportadora de Despacho | 

|18| tipoFreteTranspDespacho | String | 255 | Tipo de Frete do Transporte de Despacho |

|19| codTranspRedespacho | String | 255 | Código da Transportadora de Redespacho |

|20| nomeTranspRedespacho | String | 255 | Nome da Transportadora de Redespacho | 

|21| tipoFreteTranspRedespacho | String | 255 | Tipo de Frete do Transporte de Redespacho |

|22| codTipoNota | String | 255 | Código do Tipo de Nota |

|23| nomeTipoNota | String | 255 | Nome do Tipo de Nota |

|24| valorBruto | Double | | Valor Bruto do Pedido |

|25| valorLiquido | Double | | Valor Liquido do Pedido |

|26| valorSaldo | Double | | Valor Saldo do Pedido |

|27| percDesconto1 | Double | | Percentual de Desconto 1 |

|28| percDesconto2 | Double | | Percentual de Desconto 2 |

|29| percDesconto3 | Double | | Percentual de Desconto 3 |

|30| percDesconto4 | Double | | Percentual de Desconto 4 |

|31| percDesconto5 | Double | | Percentual de Desconto 5 |

|32| nomeFantasia | String | 255 | Nome Fantasia |

|33| emailCliente | String | 255 | E-mail do Cliente |

|34| pedidoCliente | String | 255 | Codigo do Pedido de controle do cliente |

|35| pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |

|36| flagAntecipacaoPedido | Integer | | Flag de antecipação |

|37| flagPedidoParcial | Integer | | Flag pedido parcial |

|38| flagFaturamentoTriangular | Integer | | Flag faturamento triangular |

|39| endereco | String | 255 | Endereço |

|40| endNumero | String | 255 | Número do endereço |

|41| bairro | String | 255 | Bairro |

|42| complemento| String | 255 | Complemento |

|43| currency | String | 255 | Tipo de moeda |

|44| negociacao | Integer | | Tipo de negociação |

|45| observacaoPedido | String | 255 | Observação do Pedido |

|46| observacaoNota | String | 255 | Observação da Nota |

|47| nomeRepres | String | 255 | Nome do representante |

|48| codTriangulador | String | 255 | Código do Triangulador |

|49| nomeTriangulador | String | 255 | Nome do Triangulador |

Lista de Parâmetros:

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

| :p1 | String/Integer | | Código do pedido |

| :p2 | String/Integer | | (opcional) Código da empresa |

h2. Listagem de Pedidos - Itens

Retornar dados dos Itens do pedido.

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

|1| codItem | String | 255 | Código do Item para Ordenação |

|2| codProduto | String | 255 | Código do Produto |

|3| nomeProduto | String | 255 | Nome do Produto |

|4| qtdePedida | Double | | Quantidade Pedida do Produto |

|5| valorPedidoBruto | Double | | Quantidade Saldo Bruto do Produto |

|6| valorPedidoLiquido | Double | | Quantidade Saldo Liquido do Produto |

|7| qtdeSaldo | Double | | Quantidade Saldo |

|8| valorSaldoBruto | Double | | Quantidade Saldo Bruto do Produto |

|9| valorSaldoLiquido | Double | | Quantidade Saldo Liquido do Produto |

|10| qtdeFaturado | Double | | Quantidade Faturada do Produto |

|11| valorFaturadoBruto | Double | | Quantidade Saldo Bruto do Produto |

|12| valorFaturadoLiquido | Double | | Quantidade Saldo Liquido do Produto |

|13| qtdeCancelada | Double | | Quantidade Cancelada do Produto |

|14| valorCanceladoBruto | Double | | Quantidade Saldo Bruto do Produto |

|15| valorCanceladoLiquido | Double | | Quantidade Saldo Liquido do Produto |

|16| valorUnitarioBruto | Double | | Valor Unitário Bruto do Produto |

|17| valorUnitarioLiquido | Double | | Valor Unitário Liquido do Produto |

|18| codVariante        | String  | 255            | Código da Variante do Item.           |

|19| nomeVariante        | String  | 255            | Cor do Item.           |

|20| codSKU        | String  | 255            | Código do SKU.           |

|21| codColecao | String | 255 | Código da coleção |

|22| nomeColecao | String | 255 | Nome da coleção |

|23| codCategoria | String | 255 | Código da Categoria |

|24| nomeCategoria | String | 255 | Nome da Categoria |

|25| codLinha | String | 255 | Código da linha |

|26| nomeLinha | String | 255 | Nome da linha | 

|27| codTipoPeca | String | 255 | Código do tipo de peça |

|28| nomeTipoPeca | String | 255 | Nome do tipo de peça |

|29| dataEntrega        | String  | 255            | Data de Entrega do Item.           |

|30| acessorio        | Boolean  | | Se o item é acessório.           |

|31| seqItemPai        | Integer  | | Referência do item pai (Se for acessório)           |

|32| percComissao        | Double  | | Percentual de comissão do item           |

|33| qualidadeSintetica        | String  | 255 | Qualidade Sintética do item           |

|34| qualidadeAnalitica        | String  | 255 | Qualidade Analítica do item            |

Lista de Parâmetros:

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

| :p1 | String   |  255          | Código do Pedido (É comparado com o "código do pedido no Erp" do "Listagem de Pedidos - Capa" e com o valor do "Pedido ERP" no botão azul de pedidos finalizados do FV)|

h2. Listagem de Pedidos - Notas

Retornar dados das Notas Fiscais do pedido.

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

|1| dataEmissao | Date | | Data de Emissão da Nota Fiscal (timestamp)|

|2| numeroNF | String | 255 | Número da Nota Fiscal (separar a série com /) |

|3| situacao | String | 255 | Situação da Nota Fiscal |

|4| valorLiquido | Double | | Valor Total da Nota Fiscal |

|5| codTransp | String | 255 | Código da Transportadora |

|6| nomeTransp | String | 255 | Nome da Transportadora |

|7| codRedespacho | String | 255 | Código do Redespacho |

|8| nomeRedespacho | String | 255 | Nome do Redespacho |

|9| chaveNFE | String | 255 | Chave da Nota Fiscal |

|10| qtdeFaturado | Double | | Quantidade de quilos faturados |

|11| dataEntrega | Date | | Data de entrega da Nota Fiscal |

|12| descSituacaoEntrega | String | | Descrição da situação atual da entrega |

|13| dataSaida | Date | | Data de saida da Nota Fiscal |

|14| tipo | String | | Tipo da Nota Fiscal |

|15| codPedido | String | | Código do Pedido (se mais de um, separar por ponto e vírgula) |

|16| pesoBruto | Double | | Peso bruto |

|17| pesoLiquido | Double | | Peso líquido |

|18| volumes | Integer | | Quantidade de volumes da Nota Fiscal |

|19| condPagamento | String | | Condição de Pagamento da Nota Fiscal |

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

Lista de Parâmetros:

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

| :p1 | String | | (opcional) codPedido (Utilizar comparador LIKE) |

| :p2 | String | | (opcional) codCliente |

| :p3 | String | | (opcional) numeroNf (separar a série com /) |

h2. Listagem de Pedidos - Notas Itens

Retornar dados dos Itens das Notas Fiscais do pedido.

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

|1| empresa | String | 255 | Nome da Empresa |

|2| numeroNF | String | 255 | Número da Nota Fiscal (separar a série com /)|

|3| sequenciaNF | String | 255 | Sequência do item na Nota Fiscal |

|4| codProduto | String | 255 | SKU do produto |

|5| descricao | String | 255 | Descrição do item |

|6| unidadeMedida | String | 255 | Unidade de medida do item |

|7| quantidade | Double | 255 | Quantidade do item |

|8| precoBruto | Double | 255 | Preço Bruto do item |

|9| precoLiquido | Double | 255 | Preço Líquido do item |

h2. Listagem de Pedidos - Situação ERP

Retorna todas as situações de pedidos do ERP.

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

| situacaoEdt| String | 255 | Situação de pedido |

h2. Listagem de Pedidos - Tipo Nota

Retorna todos os tipos de notas de pedidos do ERP.

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

| tipoNota| String | 255 | Tipo de nota de pedido |

h2. Triangulação

Retornar relação dos trianguladores (Geral, por representante ou por cliente).

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

|1| codEmpresa * | String | 255 | Código da Empresa |

|2| codClienteTriangulacao  *| String | 255 | Código do cliente triagulador |

|3| nomeClienteTriangulacao * | String | 255 | Nome do cliente de triangulação. O nome está aqui pois podem existir clientes onde a base de clientes de triangulação não é a mesma da de clientes de venda. |

|4| codClienteVenda | String | 255 | Código do cliente da venda a ser relacionado o cliente de triangulação (é opcional, se enviar nulo entende-se que o cliente de triangulação está disponível para todos os clientes de venda)|

|5| codRepresentante | String | 255 | Código do representante a ser relacionado o cliente de triangulação (é opcional, se enviar nulo entende-se que o cliente de triangulação está disponível para todos os representantes)|

h2. Transportadoras

Retornar relação das transportadoras 

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

|1| codEmpresa * | String | 255 | Código da Empresa |

|2| codTransportadora  *| String | 255 | Código da transportadora |

|3| nomeTransportadora * | String | 255 | Nome da transportadora. |

|4| situacao | Inteiro |  | 1 - Ativo / 0 - Inativo |

h2. Comissões - Extrato Resumo

Retornar de forma resumida os resultados dos meses de comissões

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

|1| anoMes | Integer | 6| Ano/mês de referencia ex:  201708 |

|2| flagMesFechado | Integer | 1 | Identificador para a situação do mês (0 - Em Aberto(Box Amarelo) / 1 - Fechado (Box Verde) |

|3| valorIRF | Double |  | Valor de IR Total |

|4| valorLiquido | Double | | Valor líquido |

|5| valorBruto | Double | | Valor bruto |

Lista de Parâmetros:

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

| :p1 | List<String/Integer> | | anoMes |

| :p2 | String | | Código do representante |

h2. Comissões - Extrato Detalhado

Retornar de extrato detalhado das comissões

Os 5 primeiros campos, são os mesmos retornados na Integração Anterior, os valores deles são referentes ao total do periodo

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

|1| anoMes | Integer | 6| Ano/mês de referencia ex:  201708 |

|2| flagMesFechado | Integer | 1 | Identificador para a situação do mês (0 - Em Aberto(Box Amarelo) / 1 - Fechado (Box Verde) |

|3| valorIRF | Double |  | Valor de IR Total |

|4| valorLiquido | Double | | Valor líquido |

|5| valorBruto | Double | | Valor bruto |

|6| dataLcto | Date | | Data do registro |

|7| lancamento | Integer  | | Identificador do registro (usado para ordenação) |

|8| cliente | String | 255 | Código do do Cliente |

|9| baseComissao | Double | | Valor base para calculo da comissão |

|10| percBaseComissao| Double | | Percentual Base Cálculo comissão |

|11| percComiss | Double | | Percentual de comissão |

|12| valorCredito | Double | | Valor para credito |

|13| valorDebito | Double | | Valor para debito |

|14| observacao | String | 255 | Historico ou Descrição do lançamento |

|15| codPedido | String | 255 | Código do pedido |

|16| numeroNF | String | 255 | Número da Nota Fiscal (separar a série com /) |

|17| titulo | String | 255 | Título da comissão |

|18| representante | String | 255 | Código do representante |

Lista de Parâmetros:

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

| :p1 | String/Integer | | anoMes |

| :p2 | String | | Código do representante |

h2. Títulos

Retornar a listagem de títulos (duplicatas) dos clientes do representante.

*Atenção! Para que o cliente seja impedido de fazer pedidos por possuir títulos vencidos, independente do representante, deve-se retornar o título para todos os representantes da carteira do cliente e não o representante do título.*

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

|1| titulo * | String/Integer | 255 | Chave única do título no ERP |

|2| numeroNf| String/Integer | 255 | Número da nota fiscal ou documento (separar a série com /) |

|3| dataEmissao | Date | | Data de Emissão do título |

|4| dataVecto | Date | | Data de Vencimento do título |

|5| valor | Double | | Valor do título em aberto |

|6| nomePortador | String/Integer | 255 | Nome/Descrição do portador |

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

|8| nomeCliente | String/Integer | 255 | Nome do cliente |

|9| codgrupocliente | String/Integer | 255 | Código do grupo do cliente |

|10| moeda | String/Integer | 255 | Moeda (O padrão é R$, deixar null) |

|11| nomeFantasiaCliente | String | 255 | Nome fantasia do cliente |

|12| dataPagamento | Date | | Data de pagamento do título |

|13| condVenda | String | 255 | Condição de Venda |

|14| situacao | String | 255 | Situação |

|15| diasAtraso | Integer | 255 | Número de dias de atraso |

|16| desconto | Double | 255 | Desconto |

|17| baseComLiq | Double | 255 | Valor do título após aplicação do desconto |

|18| valorJuros | Double | 255 | Valor do Juros |

|19| valorPago | Double | 255 | Valor pago |

|20| codRepresentante | String | 255 | Código do representante |

Lista de Parâmetros:

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

| :p1 | Date | | (opcional) Data de emissão inicial |

| :p2 | Date | | (opcional) Data emissão final |

| :p3 | Date | | (opcional) Data vencimento inicial |

| :p4 | Date | | (opcional) Data vencimento final |

| :p5 | String | | (opcional) Código do cliente |

| :p6 | String | | (opcional) Código do representante |

| :p7 | String | | (opcional) Número da nota fiscal ou documento |

| :p8 | String | | (opcional) Chave única do título no ERP |

| :p9 | List<String> | | (opcional) Situação |

h2. Tipo de Cobrança

Retornar a listagem de tipos de cobranças da condição de pagamento.

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

|1| codigo | String | 255 | Código do Tipo de Cobrança |

|2| descricao | String | 255 | Descrição do Tipo de Cobrança |

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

Lista de Parâmetros:

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

| :p1 | String/Integer | | (opcional) Código da empresa |

h2. Condição de Pagamento

Retornar a listagem de condição de pagamento.

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

|1| nome* | String | 255 | Nome da condição de pagamento |

|2| condicaoVenda* | Long | 255 | Condição de Venda ERP |

|3| portador | String | 255 | Portador |

|4| tipoCobranca | String | 255 | Código doTipo de cobrança |

|5| prazoMedio* | Double | 255 | Prazo médio |

|6| qtdeParcelas | Integer | 255 | Quantidade de Parcelas |

|7| disponivelForcaVendas | Boolean | 255 | Disponível no força de vendas |

|8| disponivelEcommerce | Boolean | 255 | Disponível no E-commerce |

|9| valorMinimo | Double | 255 | Valor mínimo para apresentação |

h2. Campos Customizados

Retornar as informações dos Campos Customizados

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

|1| codCliente * | String | 255 | Cod do Cliente |

|2| codIdentificador * | String | 255 | Código do identificador |

|3| idCampoCustomizado * | String | 255 | Id do campo Customizado Criado no FV Malharia |

|4| valorCampoCustomizado * | String | 255 | Valor que vai retornar no Campo. |

Lista de Parâmetros:

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

| :p1         | codEmpresa    | String/Integer   | 10         | Código da Empresa |

| :p2         | codRepres     | String/Integer   | 10         | Código do Representante |