OBJETIVO
Prover ambientes de homologação e produção, utilizando as configurações necessárias, para atender a necessidade de integração específica de informação do fornecedor Hills (fornecedor Abase), utilizando-se dos layouts Neogrid disponibilizados.
UTILIZAÇÃO
 | Nesta pagina: |
Visão Geral
Para que a exportação em arquivos específicos ocorra, a ferramenta exQuery utilizará os dados contidos nos arquivos de configuração localizados nas pastas relativas (pasta "01_relven", pasta "02_relcli", pasta "03_relpro" etc).
Logo, estes arquivos contém os dados de acesso (IP, porta, base de dados etc) que o exQuery usará para executar a função responsável por exportar as informações.
Sendo assim, além das pastas e subpastas necessárias, estes arquivos de extensão ".exScript", devem estar todos configurados, para que o aplicativo exQuery consiga acessar a base de dados, executar a função e gerar o arquivo no local indicado.
Em outras palavras, cada layout disponibilizado contém seu próprio arquivo de configuração, com seus respectivos parâmetros.
Veja a seção de configuração de cada ambiente (Homologação, Produção) para todo o detalhamento.
Pré-definições e Origem das Informações Exportadas (ambos ambientes)
As informações são consultadas e exportadas seguindo algumas configurações pré-definidas a seguir:
Serão selecionadas apenas as seguintes informações:
- da filial "001";
- do almoxarifado '001';
- referente ao período de emissão das notas fiscais;
- do fornecedor Hill's (grupo de estoque 02.01).
Tabela e Preço padrão dos produtos:
Acesse o módulo Faturamento, menu "Auxiliar > Parâmetros do Faturamento > Parâmetros Gerais" e preencha os campos destacados na Figura 1:
Figura 1 - Tabela e linha do preço padrão
Tabela de referência de informações coletadas pelo exportador:
| Descrição Neogrid | Campo no Ti9 | |
| Vendedores | Companhias & Pessoas: Todos os Vendedores (Geral > Nosso Representante) | |
| Nome Vendedor | Razão Social | |
| Código Vendedor | CPF do Vendedor | |
| Nome Supervisor | Logística > Geral Logística > Supervisor (Razão Social) | |
| Código Supervisor | Logística > Geral Logística > Supervisor (Busca o CPF do Supervisor selecionado, no cadastro deste supervisor) | |
| Nome Gerente | (Em branco) | |
| Código Gerente | (Em branco) | |
| Status Vendedor | Ativação > Status | |
| Data de Desligamento Vendedor | Data da última alteração no vendedor | |
| Clientes | Companhias & Pessoas | |
| Código cliente | CNPJ / CPF | |
| Nome Cliente | Razão Social | |
| Código Segmento Cliente | Geral > Segmento Neogrid (tecle F3) | |
| Frequência Visita | Geral > Frequência Visita Neogrid (tecle F3) | |
| Telefone Cliente | Telefone 1 | |
| Contato Cliente | Contato | |
| Produtos | Cadastro de Produtos | |
| CNPJ da Indústria/Fornecedor | (03816532000190 = Hill's) | |
| Código Item | Código do Produto | |
| Código Produto | EAN (Código de Barras) | |
| Tipo Item | (“01” = Regular) | |
| Quantidade Produto Embalagem | (“1.00000” = Um) | |
| Preço Tabela Unidade | (Parâmetros do Faturamento > Parâmetros Gerais > Tabela de Preços Padrão Exportação, Preço Padrão Exportação e UF Padrão Exportação) | |
| Descrição Interna do Item | Descrição Produto | |
| Status Produto | Ativação > Status | |
| Estoque | Cadastro de Produtos | |
| Data – Hora do Estoque | (Data da Exportação do Arquivo) | |
| Código Item | Código do Produto | |
| Quantidade em Estoque | Saldo de Estoque > Saldo Físico | |
| Quantidade Estoque Trânsito | (Saídas do último dia do período) | |
| Vendas – Notas | Documento de Saída (NF de Venda / Cancelamento / Devolução) | |
| Tipo de Faturamento | (“02” = Indireto - venda via revenda) | |
| Número NF | Número | |
| Série NF | Série | |
| Data Emissão NF | Emissão da NF de Venda | |
| Código do Vendedor | CNPJ/CPF do representante do pedido de venda. Para os pedidos de origem "4vets" deve permanecer em branco. | |
| Código cliente | CNPJ / CPF do Destinatário | |
| UF Emissor Mercadoria | UF da Filial 001 | |
| CEP Emissor Mercadoria | CEP da Filial 001 | |
| UF Destinatário Mercadoria | UF do Destinatário | |
| CEP Destinatário Mercadoria | CEP do Destinatário | |
| Condição de Entrega (tipo de frete) | Pedido da NF de Venda > Dados de Entrega/Outras Informações > Tipo do Frete | |
| Dias de Pagamento | Condição de Pagamento, conforme o campo Qtde Total de Dias (Parâmetro Habilitar cálculo dias pagto, em Parâmetros do Faturamento) | |
| Vendas – Itens | NF de Venda / Cancelamento - Documento de Saída > Detalhes dos itens | NF de Devolução - Documento de Entrada > Itens do Documento de Entrada |
| Código do Item | Codigo de Produto Associado | Produto/Serviço |
| Quantidade Vendida | Qtde | Qtde |
| Preço Unitário Bruto Praticado | Valor Unitário | Valor Unitário |
| Bonificação | (Informação da Integração com a plataforma 4Vets) | (NF de Venda > Informação da Integração com a plataforma 4Vets) |
| Valor Total Bruto | Valor Total | Valor Total Bruto |
| Valor Total Líquido | Total Líquido | Valor Total Bruto – Valor Desconto |
| Valor IPI | IPI Valor | IPI Imposto |
| Valor PIS \ CONFINS | PIS Valor + COFINS Valor | PIS Imposto + COFINS Imposto |
| Valor Substituição Tributária | Valor ICMS ST | ICMS ST Imposto |
| Valor ICMS | ICMS Valor | ICMS Imposto |
| Valor Descontos | Valor Desconto | Valor Desconto |
Outras Informações:
- Informações não existentes ficarão em branco no arquivo e serão tratadas na homologação com a Neogrid (exceções);
- Novos campos de classificação da Neogrid para Segmento e Frequência de Visita no cadastro do cliente, conforme Figura 2:
Figura 2 - Novos campos no cadastro do cliente
Configuração do Ambiente de Testes/Homologação
A funcionalidade necessita que as pastas e arquivos abaixo estejam disponíveis nas subpastas do ERP Ti9. Portanto, na etapa de configuração é necessário criar as pastas caso não existam e adicionar os arquivos necessários, conforme segue:
Os testes utilizam o programa exQuery.exe. Este aplicativo já é usado para outro processo de integração da Abase, está contido na pasta do sistema em seu servidor e deve ter uma cópia adicionada na subpasta "..\INTEGRADOR\".
No ambiente de testes, o exQuery gera os arquivos executando os scripts/funções informados nos arquivos de configuração, localizados na subpasta "..\Scripts exQuery\Abase\NeogridV5\ERP", conforme a Tabela 1 e Figura 3.
| Tipo | Pasta | Arquivo “.exScript” | Script/Função SQL |
| RELVEN | 01_relven | SQL_relven | arq_integracao_neogrid_relven |
| RELCLI | 02_relcli | SQL_relcli | arq_integracao_neogrid_relcli |
| RELPRO | 03_relpro | SQL_relpro | arq_integracao_neogrid_relpro |
| RELEST | 04_relest | SQL_relest | arq_integracao_neogrid_relest |
| VENDAS | 05_vendas | SQL_vendas | arq_integracao_neogrid_vendas |
| TODOS | 06_todos | (Todos acima) | (Todas acima) |
Tabela 1 - Arquivos ".exScript" para testes
Figura 3 - Pastas de scripts
Os arquivos da Tabela 1 possuem a seguinte estrutura de parametrização:
IP_Servidor|Porta_PostgreSQL|Nome_Banco|none|[caminho]Nome_Arquivo.txt|
SELECT arq_integracao_neogrid_Nome_Rel('numero_filial', [data_inicial], [data_final]);
Exemplo:
Figura 4 - Arquivo de configuração para a exportação dos dados dos vendedores (RelVen).
Estes arquivos devem ser configurados adicionando os dados relativos, como Ip do servidor, porta de acesso à base, base de dados, local padrão para os arquivos exportados etc.
Os dados contidos entre [ ] são parâmetros passados diretamente pela janela de homologação "Exportação Neogrid V5" quando da execução da mesma, portanto manter estes parâmetros.
Configuração do Ambiente de Produção
A funcionalidade necessita que as pastas e arquivos abaixo estejam disponíveis nas subpastas do ERP Ti9. Portanto, na etapa de configuração é necessário criar as pastas caso não existam e adicionar os arquivos necessários, conforme segue:
Para configurar a execução diária que deve ser executada após a etapa de homologação, será necessário fazer uso da ferramenta "Agendador de Tarefas do Windows". O agendador deve ser configurado, com a periodicidade de sua escolha, utilizando o arquivo "EXEC_PRODUCAO_WIN.cmd".
Este arquivo está localizado na subpasta "..\Scripts exQuery\NeogridV5\" do ERP Ti9. Não é necessário movê-lo, ficando à sua escolha se o mantém neste local. Contudo, o local onde este arquivo for colocado, deve ser o local a ser configurado no Agendador de Tarefas.
Este arquivo contém:
@echo off
REM ********************************* NEOGRID ****************************************
Caminho_Executavel_exQuery.exe -v -ec=2 -p "Caminho_ERP_Ti9\Scripts exQuery\Abase\NeogridV5\WIN\"
Exemplo:
@echo off
REM ********************************* NEOGRID ****************************************
"D:\ti9\INTEGRADOR\exquery.exe" -v -ec=2 -p "D:\ti9\Scripts exQuery\Abase\NeogridV5\WIN\"
No exemplo acima, o arquivo "EXEC_PRODUCAO_WIN.cmd" irá executar os scripts/funções informados nos arquivos de configuração, localizados na pasta "Scripts exQuery\Abase\NeogridV5\WIN\" com os parâmetros para a integração diária.
Exemplo:
Figura 5 - Script do arquivo de clientes
Assim como os arquivos de testes/homologação, estes arquivos de produção também devem ser todos configurados.
Diferentemente do processo de homologação, os arquivos de configuração não devem estar em cada subpasta (ex.: relven, relprod), mas sim todos diretamente na pasta "WIN".
Diferentemente do processo de homologação, os arquivos de configuração de produção devem ter o caminho de exportação completo indicado no arquivo. No exemplo da figura acima, o caminho escolhido para exportar os arquivos de resultado foi: "C:\Layout\Hills\NeogridV5\".
Execução através do Ti9 - Fase de Testes/Homologação
Após configurar o ambiente seguindo as especificações descritas acima, acesse o módulo Faturamento, menu "Processos > Integrações > Exportação Neogrid V5", preencha as datas inicial e final (não visíveis para Vendedores e Produtos), escolha a opção de arquivo a gerar, informe o caminho da pasta para os arquivos exportados e clique no botão OK, conforme figuras 6 a 9.
Figura 6 - Janela para teste de exportação
Figura 7 - Início do processo
Figura 8 - Andamento do processo
Figura 9 - Arquivos exportados
Execução diária em Produção pelo Agendador de Tarefas do Windows
Ao executar o arquivo "EXEC_PRODUCAO_WIN.cmd", os arquivos de dados exportados serão gerados na pasta especificada naqueles arquivos de configuração, contidos na subpasta WIN.
Exemplo: Se o arquivo "SQL_relven.exScript" determinar como local de saída "C:\Layout\Hills\NeogridV5\", então será neste local que os arquivos dos dados exportados serão gerados. Veja a imagem abaixo.
Figura 10 - Arquivos em ambiente de produção
Observações Finais:
- O programa "exQuery" é utilizado nestes processos como exportador das informações. Ele é executado de maneira automática tanto pela janela "Exportação Neogrid V5", na etapa de homologação, quanto pelo arquivo de comando "EXEC_PRODUCAO_WIN.cmd", não sendo necessário executá-lo manualmente através do menu próprio do "exQuery" no Ti9. Para mais informações específicas sobre o programa exQuery, acesse: Ferramenta ExQuery
- Este manual não contempla o detalhamento dos layouts Neogrid mencionados, apenas a funcionalidade de exportação dos dados com base nestes. Logo todo o detalhamento sobre estes layouts deve ser recuperado diretamente com a empresa Neogrid.
Labels