OBJETIVO

Atender a necessidade de integração do fornecedor Hills (fornecedor Abase), utilizando a ferramenta de EDI Neogrid, através dos layouts disponibilizados.

UTILIZAÇÃO

 

Nesta pagina:




Pré-definições

As informações são consultadas e exportadas seguindo algumas configurações pré-definidas a seguir:

(aviso)  Apenas informações:

 


Origem das Informações Exportadas (ambos ambientes)

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 1 - Tabela e linha do preço padrão

 

Tabela de Informações coletadas e locais:

Descrição NeogridCampo no Ti9
VendedoresCompanhias & Pessoas (do Vendedor em “Comissões Por Produto X Cliente X Vended”)
Nome VendedorRazão Social
Código VendedorCódigo
Nome SupervisorLogística > Geral Logística > Supervisor (Razão Social)
Código SupervisorLogística > Geral Logística > Supervisor (Código)
Nome Gerente(Em branco)
Código Gerente(Em branco)
Status VendedorAtivação > Status
Data de Desligamento VendedorData da Exportação
 
ClientesCompanhias & Pessoas
Código clienteCNPJ / CPF
Nome ClienteRazão Social
Código Segmento ClienteGeral > Segmento Neogrid (tecle F3)
Frequência VisitaGeral > Frequência Visita Neogrid (tecle F3)
Telefone ClienteTelefone 1
Contato ClienteContato
 
ProdutosCadastro de Produtos
CNPJ da Indústria/Fornecedor(03816532000190 = Hill's)
Código ItemCódigo do Produto
Código ProdutoEAN (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)
Descrição Interna do ItemDescrição Produto
Status ProdutoAtivação > Status
 
EstoqueCadastro de Produtos
Data – Hora do Estoque(Data da Exportação do Arquivo)
Código ItemCódigo do Produto
Quantidade em EstoqueSaldo de Estoque > Saldo Físico
Quantidade Estoque Trânsito(Saídas do dia anterior ao período)
 
Vendas – NotasDocumento de Saída (NF de Venda / Cancelamento / Devolução)
Tipo de Faturamento(“02” = Indireto - venda via revenda)
Número NFNúmero
Série NFSérie
Data Emissão NFEmissão da NF de Venda
Código do Vendedor(Em branco)
Código clienteCNPJ / CPF do Destinatário
UF Emissor MercadoriaUF da Filial 001
CEP Emissor MercadoriaCEP da Filial 001
UF Destinatário MercadoriaUF do Destinatário
CEP Destinatário MercadoriaCEP 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 PagamentoGuia Duplicata > Coluna Dias (conforme condição de pagamento)
 
Vendas – ItensNF de Venda / Cancelamento - Documento de Saída > Detalhes dos itensNF de Devolução - Documento de Entrada > Itens do Documento de Entrada
Código do ItemCodigo de Produto AssociadoProduto/Serviço
Quantidade VendidaQtdeQtde
Preço Unitário Bruto PraticadoValor UnitárioValor 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 BrutoValor TotalValor Total Bruto
Valor Total LíquidoTotal LíquidoValor Total Bruto – Valor Desconto
Valor IPIIPI ValorIPI Imposto
Valor PIS \ CONFINSPIS Valor + COFINS ValorPIS Imposto + COFINS Imposto
Valor Substituição TributáriaValor ICMS STICMS ST Imposto
Valor ICMSICMS ValorICMS Imposto
Valor DescontosValor DescontoValor Desconto


(informação) Outras Informações:

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 deve ser adicionado na subpasta "..\INTEGRADOR\".

No ambiente de testes, o exQuery gera os arquivos executando os scripts localizados na subpasta "..\Scripts exQuery\Abase\NeogridV5\ERP", conforme a Tabela 1 e Figura 3.

 

ArquivoPasta ScriptArquivo “.exScript”Função SQL
RELVEN01_relvenSQL_relvenarq_integracao_neogrid_relven
RELCLI02_relcliSQL_relcliarq_integracao_neogrid_relcli
RELPRO03_relproSQL_relproarq_integracao_neogrid_relpro
RELEST04_relestSQL_relestarq_integracao_neogrid_relest
VENDAS05_vendasSQL_vendasarq_integracao_neogrid_vendas
TODOS06_todos(Todos acima)(Todas acima)

Tabela 1 - Arquivos ".exScript" para testes

Figura 3 - Pastas de scripts

 

Os arquivos da Tabela 1 contém 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 vendedores

 

(aviso) 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.

(aviso) 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 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

(aviso) Assim como os arquivos de testes/homologação, estes arquivos de produção também devem ser todos configurados.

No exemplo da figura acima, o caminho escolhido para exportar os arquivos de resultado foi: "C:\Layout\Hills\NeogridV5\".

 


Execução atraveś do Ti9 - Fase de Testes/Homologação

Módulo Faturamento, menu "Processos > Integrações > Exportação Neogrid V5", preencha as datas inicial e final, 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 ser gerados na pasta especificada naqueles arquivos de configuração, contidos na subpasta WIN.

(informação) 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

 




(informaçã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