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:
Apenas informaçõesSerão selecionadas apenas as seguintes informações:
- da filial "001";
- do almoxarifado '001'.fornecedor: ;
- referente ao período de emissão das notas fiscais;
- do fornecedor Hill's (grupo de estoque 02.01);.
Origem das Informações Exportadas (ambos ambientes)Anchor
Acesse o 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;
e preencha os campos destacados na Figura 1:
Figura 1 - Tabela e linha do preço padrão
Tabela de Informações coletadas e locaisreferência de informações coletadas pelo exportador:
| Descrição Neogrid | Campo no Ti9 | |
| Vendedores | Companhias & Pessoas (do Vendedor em “Comissões Por Produto X Cliente X Vended”: Todos os Vendedores (Geral > Nosso Representante) | |
| Nome Vendedor | Razão Social | |
| Código Vendedor | CódigoCPF do Vendedor | |
| Nome Supervisor | Logística > Geral Logística > Supervisor (Razão Social) | |
| Código Supervisor | Logística > Geral Logística > Supervisor (CódigoBusca 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 Exportaçãoú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 e , 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 anterior ao 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 | (Em branco)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 | Guia Duplicata > Coluna Dias (conforme condição de pagamentoCondiçã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:
- 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;
- Novos campos de classificação da Neogrid para Segmento e Frequência de Visita no cadastro do cliente, conforme Figura 102:
Figura 2 - Novos campos no cadastro do cliente
...
Os testes utilizam o programa exQuery.exe. Este aplicativo deve ser adicionado 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 3.
| ArquivoTipo | 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) |
...
Figura 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 4 - Script do arquivo de vendedoresArquivo 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.
...
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.
...
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 atraveś através do Ti9 - Fase de Testes/Homologação
| Anchor | ||
|---|---|---|
|
Módulo 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 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", os arquivos de dados exportados serão ser gerados na pasta especificada naqueles arquivos de configuração, contidos na subpasta WIN.
...
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.
...