Força de Vendas - Malharia » Histórico » Versão 182
Versão 181 (jean, 18/04/2024 15:56 h) → Versão 182/297 (jean, 18/04/2024 15:56 h)
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]]
## [[Força_de_Vendas_-_Malharia#Partidas-de-Pedidos|Partidas de Pedidos]]
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 |
h2. Partidas de Pedidos
Nessa consulta será possível consultar as partidas dos pedidos efetuados.
|_.Pos|_. Campo |_. Tipo |_. Precisão|_. Descrição |
|1 | anoPartida | String | | Retorna a informação de mês e ano da partida no formato AAAAMM |
|2 | codPartida | String | | Código da partida no ERP |
|3 | situacao | Integer | | código da situação atual da partida |
|4 | codPedido | String | | Código do pedido no ERP ao qual a partida pertence |
|5 | sequenciaItem | Integer | | Sequência da partida na produção de acordo com o pedido |
|6 | dataEmissao | Date | | Data de início da produção da partida no formato AAAA-MM-DD |
|7 | dataPrevisaoFaturamento | Date | | Data de previsão de faturamento da partida no formato AAAA-MM-DD |
|8 | codReferencia | String | | Código da referência no ERP |
|9 | codVariante | String | | |
|10 | qtdeQuilos | Double | (10, 2) | Quantidade em kg da partida |
|11 | qtdePecas | Integer | | Quantidade de rolos da partida |
|12 | nomeProcessoAtual | String | | Nome do processo atual que a partida se encontra |
|13 | nomeProcessoSeguinte | String | | Nome da próxima etapa do fluxo de partidas |
|14 | qtdeRolos | Double | (10, 2) | Quantidade de rolos da partida |
|15 | dataBaixa | Date | | Data da baixa final da partida no formato AAAA-MM-DD |
|16 | loteCliente | String | | Lote do cliente |
|17 | descProduto | String | | Descrição do produto |
Parâmetros da Consulta
|_. | Parâmetro |_. | Campo |_. | Tipo |_. | Precisão / Tamanho / Formato |_. | Descrição |_. | Obrigatório |
| :p1 | codEmpresa | String | | Código da empresa dentro do ERP | Sim |
| :p2 | codCliente | String | | Código do cadastro do cliente no ERP | Sim |
| :p3 | dataEmissaoInicial | Date | AAAA-MM-DD | Data inicial para consulta com base na data de emissão | Sim |
| :p4 | dataEmissaoFinal | Date | AAAA-MM-DD | Data final para consulta com base na data de emissão | Sim |
| :p5 | codPedido | String | | Código do pedido no ERP (pode ser parcial) | Não |
| :p6 | codPartida | String | | Código da partida no ERP (pode ser parcial) | Não |
| :p7 | codReferPai | String | | Código da referência no ERP | Não |
| :p8 | cor | String | | Código da cor no ERP | Não |
| :p9 | qtde | Double | (10, 2) | Peso da partida no ERP | Não |
| :p10 | qtdePecas | Integer | | Quantidade de peças da partida | Não |
| :p11 | larguraAcab | Double | (10, 2) | Largura da partida | Não |
| :p12 | gramaturaAcab | Double | (10, 2) | Gramatura da partida | Não |
| :p13 | valorTotalLiquido | Double | (10, 2) | Valor total líquido da partida | Não |
| :p14 | dataPrevFat | Date | AAAA-MM-DD | Data de previsão de faturamento da partida | Não |
*Í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]]
## [[Força_de_Vendas_-_Malharia#Partidas-de-Pedidos|Partidas de Pedidos]]
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 |
h2. Partidas de Pedidos
Nessa consulta será possível consultar as partidas dos pedidos efetuados.
|_.Pos|_. Campo |_. Tipo |_. Precisão|_. Descrição |
|1 | anoPartida | String | | Retorna a informação de mês e ano da partida no formato AAAAMM |
|2 | codPartida | String | | Código da partida no ERP |
|3 | situacao | Integer | | código da situação atual da partida |
|4 | codPedido | String | | Código do pedido no ERP ao qual a partida pertence |
|5 | sequenciaItem | Integer | | Sequência da partida na produção de acordo com o pedido |
|6 | dataEmissao | Date | | Data de início da produção da partida no formato AAAA-MM-DD |
|7 | dataPrevisaoFaturamento | Date | | Data de previsão de faturamento da partida no formato AAAA-MM-DD |
|8 | codReferencia | String | | Código da referência no ERP |
|9 | codVariante | String | | |
|10 | qtdeQuilos | Double | (10, 2) | Quantidade em kg da partida |
|11 | qtdePecas | Integer | | Quantidade de rolos da partida |
|12 | nomeProcessoAtual | String | | Nome do processo atual que a partida se encontra |
|13 | nomeProcessoSeguinte | String | | Nome da próxima etapa do fluxo de partidas |
|14 | qtdeRolos | Double | (10, 2) | Quantidade de rolos da partida |
|15 | dataBaixa | Date | | Data da baixa final da partida no formato AAAA-MM-DD |
|16 | loteCliente | String | | Lote do cliente |
|17 | descProduto | String | | Descrição do produto |
Parâmetros da Consulta
|_. | Parâmetro |_. | Campo |_. | Tipo |_. | Precisão / Tamanho / Formato |_. | Descrição |_. | Obrigatório |
| :p1 | codEmpresa | String | | Código da empresa dentro do ERP | Sim |
| :p2 | codCliente | String | | Código do cadastro do cliente no ERP | Sim |
| :p3 | dataEmissaoInicial | Date | AAAA-MM-DD | Data inicial para consulta com base na data de emissão | Sim |
| :p4 | dataEmissaoFinal | Date | AAAA-MM-DD | Data final para consulta com base na data de emissão | Sim |
| :p5 | codPedido | String | | Código do pedido no ERP (pode ser parcial) | Não |
| :p6 | codPartida | String | | Código da partida no ERP (pode ser parcial) | Não |
| :p7 | codReferPai | String | | Código da referência no ERP | Não |
| :p8 | cor | String | | Código da cor no ERP | Não |
| :p9 | qtde | Double | (10, 2) | Peso da partida no ERP | Não |
| :p10 | qtdePecas | Integer | | Quantidade de peças da partida | Não |
| :p11 | larguraAcab | Double | (10, 2) | Largura da partida | Não |
| :p12 | gramaturaAcab | Double | (10, 2) | Gramatura da partida | Não |
| :p13 | valorTotalLiquido | Double | (10, 2) | Valor total líquido da partida | Não |
| :p14 | dataPrevFat | Date | AAAA-MM-DD | Data de previsão de faturamento da partida | Não |