OBJETIVO
Atender 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 a ferramenta de EDI Neogrid, através -se dos layouts Neogrid disponibilizados.
UTILIZAÇÃO
| Info |
|---|
Nesta pagina: |
...
Visão GeralAnchor visaogeral
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)
| Anchor | ||
|---|---|---|
|
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çãoAnchor confighomol
| confighomol |
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 que se encontra na 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 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 13.
| Tipo | Pasta Script | 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 1 3 - Pastas de scripts
Os arquivos da Tabela 1 contémpossuem 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 2 4 - Script do arquivo de vendedores
...
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
| Anchor | ||
|---|---|---|
|
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" que .
Este arquivo está localizado na subpasta na subpasta "..\Scripts exQuery\Abase\NeogridV5\" do 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
...
Caminho_Executavel_exQuery.exe -v -utp -ec=2 -p "Caminho_ERP_Ti9\Scripts exQuery\Abase\NeogridV5\WIN\"
...
REM ********************************* NEOGRID ****************************************
"D:\ti9\INTEGRADOR\exquery.exe" -v -utp -ec=2 -p "D:\ti9\Scripts exQuery\Abase\NeogridV5\WIN\"
O No exemplo acima, o arquivo "EXEC_PRODUCAO_WIN.cmd" irá executar os scripts 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 3 5 - Script do arquivo de clientes
O caminho de destino dos arquivos de exportação diária é fixo.
Deve sempre existir a pasta especificada nestes arquivos da pasta WIN onde os arquivos serão gerados.
Exemplo da figura acima 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\".Origem das Informações no ERP Ti9
Módulo Faturamento, menu "Auxiliar > Parâmetros do Faturamento > Parâmetros Gerais"
- Tabela de preços padrão para exportação;
- Preço padrão para exportação;
Figura 4 - Tabela e linha do preço padrão
Teste de Execução pelo ERP Ti9
Módulo
...
Execução através do Ti9 - Fase de Testes/Homologação
| Anchor | ||
|---|---|---|
|
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 5 6 a 89.
Figura 5 6 - Janela para teste de exportação
Figura 6 7 - Início do processo
Figura 7 8 - Andamento do processo
Figura 8 9 - Arquivos exportados
...
Execução diária em Produção pelo Agendador de Tarefas do WindowsAnchor execprod
| execprod |
Ao executar o arquivo "EXEC_PRODUCAO_WIN.cmd" da subpasta "..\Scripts exQuery\Abase\NeogridV5\" do ERP Ti9, os arquivos devem ser de dados exportados serão gerados na pasta (no servidor) especificada nos arquivos da naqueles arquivos de configuração, contidos na subpasta WIN. Exemplo: "
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 9 10 - Arquivos em ambiente de produção
...
- Apenas informações referente ao período de emissão das notas fiscais.
- Informações não existentes ficarão em branco no arquivo e serão tratadas na homologação com a Neogrid (exceções).
- Grupo de Estoque: 02.01.
- Quantidade em Estoque: saldo físico.
- Quantidade Estoque Trânsito: produtos expedidos no dia anterior.
- Vendas - Devoluções: informações da nota de saída a que a devolução se refere.
- Tipo de Faturamento: indireto = venda via revenda.
- Novos campos de classificação da Neogrid para Segmento e Frequência de Visita no cadastro do cliente, conforme Figura 10:
...
...
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.
...