VKN: Integração com o sistema VIPS (Volvo)

Transcrição

1 VKN: Integração com o sistema VIPS (Volvo) OBJETIVO Integração com o sistema da Volvo entre TI9 e VIPS para o processo de pedido de vendas e nota fiscal. O sistema funcionará da seguinte forma: importará do VIPS os pedidos de vendas, executará o processo interno no sistema para faturar os pedidos de vendas importados e após a transmissão e estar válido pela Sefaz estará pronto para a exportação para o sistema VIPS. Obs.: A nota fiscal não pode possuir cancelamento após validado pela Sefaz. UTILIZAÇÃO Criado campo no cadastro de Empresas e Filiais para validar se a filial possui integração com o VIPS e VR, conforme apresentado no Figura 01. Figura 01 - Cadastro de Empresas e Filiais (Integração) Ti9 Windows Services software/serviço responsável por executar os softwares "VKNVIPS" e "Ti9 FTP Client", em horários pré-determinados em seu parâmetro. Seu uso é necessário pois diversos arquivos podem ser recebidos e enviados ao longo do expediente. Ti9 FTP Client responsável por capturar os arquivos enviados pelo VIPS em pasta FTP e movê-los para pasta determinada, onde o software VKNVIPS poderá utilizá-lo para a importação dos dados. É responsável também por disponibilizar para o sistema VIPS, em pasta FTP, os arquivos gerados pelo VKNVIPS. VKNVIPS software responsável por: Importar para o Ti9 os dados dos pedidos de vendas de peças, emitidos pelas concessionárias. Estes dados serão disponibilizados em arquivo texto pelo sistema VIPS, em pasta FTP especificada, e será recuperado pelo software "Ti9 FTP Client"; Criar arquivos texto com as informações de faturamento ocorridas no Ti9 e disponibilizá-los para envio posterior pela aplicação "Ti9 FTP Client". O software se baseia no layout VIPS estabelecido pela Volvo para a geração e importação dos dados.

2 Funcionamento da Integração: Arquivo de importação dos dados: O arquivo a ser recuperado deverá ser disponibilizado pelo software VIPS, em uma área FTP que será criada e posteriormente serão informados os dados de acesso, que deverão ser destacados em parâmetro. "Ti9 Windows Services" executa o programa "Ti9 FTP Client"; "Ti9 FTP Client" tenta recuperar da pasta FTP o arquivo a ser importado; Se por algum motivo não conseguir acesso à pasta FTP, grava um registro de log (vide "Logs"). Caso contrário, move o arquivo para a pasta "movimentos\importa\" da aplicação "VKNVIPS"; "Ti9 Windows Services" executa o programa "VKNVIPS"; "VKNVIPS" tenta efetuar a importação dos dados, de acordo com o layout; Se por algum motivo não conseguir importar (exemplo, por incoerência no arquivo perante o layout), o arquivo será mantido na pasta "movimentos\importa\", para a verificação do administrador e/ou tentativa de importação posterior. Um registro de log também será gravado (vide "Logs"); Caso contrário, importa os dados e move o arquivo relativo para a pasta "movimentos\importa\processados\". Um registro de log também será gravado; Arquivo de exportação dos dados: O arquivo com as informações de faturamento realizadas no Ti9 será gerado pelo software VKNVIPS de acordo com o layout. O arquivo será disponibilizado em uma área FTP que será criada e posteriormente serão informados os dados de acesso, que deverão ser destacados em parâmetro. "Ti9 Windows Services" executa o programa "VKNVIPS"; "VKNVIPS" efetua a exportação dos dados - de acordo com o layout - e registra a geração em um arquivo de log (vide "Logs"). O arquivo exportado será nomeado da seguinte maneira: VIPS_[DATA HORA NO FORMATO YYYYMMDDHHMMSS].txt; "Ti9 Windows Services" executa o programa "Ti9 FTP Client"; "Ti9 FTP Client" recupera o arquivo gerado, na pasta "movimentos\exporta\" e tenta copiá-lo na pasta FTP parametrizada; Se por algum motivo não conseguir acesso à pasta FTP, grava um registro de log (vide "Logs") e mantém o arquivo na pasta "movimentos\exporta\"; Caso contrário, move o arquivo relativo para a pasta "movimentos\exporta\enviados\". Arquivo de exportação dos dados via CURL: O arquivo com as informações de faturamento realizadas no Ti9 será gerado pelo software VKNVIPS de acordo com o layout. O arquivo será disponibilizado em uma área FTP que será criada e posteriormente serão informados os dados de acesso, que deverão ser destacados em parâmetro. "Ti9 Windows Services" executa o programa "VKNVIPS"; "VKNVIPS" efetua a exportação dos dados - de acordo com o layout - e registra a geração em um arquivo de log (vide "Logs"). O arquivo exportado será nomeado da seguinte maneira: VIPS_[DATA HORA NO FORMATO YYYYMMDDHHMMSS].txt; "Ti9 Windows Services" executa o programa "Ti9 FTP Client"; "Ti9 FTP Client" cria um arquivo batch (na mesma pasta do executável) com a instrução de envio de todos os arquivos da pasta "movimentos\exporta\"; As instruções do arquivo batch seguira a seguinte regra: curl -v -T "caminho_nome_do_arquivo" "ftp_de_envio" --user "usuario_acesso_ftp":"senha_acesso_ftp" Se por algum motivo não conseguir gerar o arquivo, grava um registro de log (vide "Logs")

3 Após executar o arquivo batch o sistema se por algum motivo não conseguir enviar os arquivo o sistema mantém os arquivos na pasta "movimentos\exporta\"; Caso contrário, move o arquivo relativo para a pasta "movimentos\exporta\enviados\". Configuração: Estrutura das pastas: Ti9 Windows Services O arquivo de configuração, chamado "ListaDeApp.txt", será disponibilizado na mesma pasta da aplicação para conter os parâmetros: Modo de execução (0 ou 1): 0 = determina que o aplicativo deve ser executado sem restrições. / 1 = determina que o aplicativo deve ser executado apenas uma vez, até que "Ti9 Windows Services" seja reiniciado; Intervalo de tempo: intervalo em segundos para a próxima execução do aplicativo; Caminho e nome do aplicativo: caminho completo somado ao nome do aplicativo que deve ser executado (somado a parâmetros do aplicativo, se houver). Exemplo de configuração. O aplicativo será executado a cada 30 minutos: D:\FTPClient\ftpclient.exe Figura 02 - Arquivo "ListaDeApp.txt", contém a configuração da execução do aplicativo Ti9 FTP Client. Ti9 FTP Client O executável do programa FTP Client deve estar dentro da subpasta "ftp client", bem como seu arquivo de parâmetro "listaftp.txt".

4 O arquivo de configuração, chamado "listaftp.txt", disponibilizado na mesma pasta da aplicação FTP Client, para conter os parâmetros: Caminho da pasta FTP (origem ou destino): caminho absoluto para a pasta FTP para a recuperação ou disponibilização dos arquivos; Nome de usuário: nome de usuário para acesso à pasta FTP; Senha: senha para acesso à pasta FTP; Método (GET, PUT ou CURL): determina a ação, se "download", "upload" ou gerar o arquivo Batch com as instruções do CURL (arquivo será gerado com o nome "CURL_FTP"); Pasta local: determina a origem ou o destino do arquivo a ser enviado ou baixado, dependendo do parâmetro "Método"; Exemplo de configuração. Neste caso, a aplicação envia um arquivo (PUT) da pasta local para a pasta FTP: vol vo.serve.com/vips/incoming/ user pwd PUT G:\VKNVR\movimentos Figura 03 - Arquivo "listaftp.txt", contém os endereços de FTP e pasta disponibilizadas para o envio dos arquivos. VKNVIPS O executável " VKNVIPS.exe" deve estar dentro da pasta " VKNVIPS" para efetuar a chamado do executável deve-se passar o parâmetro após a chamado do executável "IMPORT" ou "EXPORT", exemplo na Figura 02, bem como seu arquivo de configuração. Arquivo de configuração, chamado "PG_CONF.INI", disponibilizado na mesma pasta da aplicação para conter os parâmetros de acesso à base de dados; Servidor (PG_SERVER): endereço IP da máquina servidora da base de dados; Porta (PG_PORT): porta utilizada pelo servidor, dedicada à conexão à base de dados; Base de dados (PG_BASE): nome da base de dados a ser utilizada. Filiai (PG_FILIAL): filial ativa a ser considerada.

5 Figura 04 - Arquivo "PG_CONF.INI", contém os dados de acesso ao banco de dados e filial. Layout de cada transação possui uma quantidade específica de posições, conforme definido no arquivo "DDLS_File Layout v2", e serão importadas e exportadas as informações dos pedidos de vendas/itens e notas Fiscais/Itens. Campos: Numero do Pedido do Vips; Pedido de Vendas Código do Cliente; Código da Operação; Data Entrada; Finalidade; Condição de Pagamento; Indicador de Presença; Origem do Registro; Valor Total das Mercadorias; Valor Total do Pedido;

6 Código do Item; Item do Pedido Unidade de Medida; Quantidade Pedida; Quantidade Atendida; Preço Unitário; Preço Total; Almoxarifado; Numero do Pedido do Vips; Numero do Item no Vips; Finalidade; Para o preenchimento do Indicador de Presença, Código da Operação e Código do Cliente a comporem os pedidos de vendas foram criados três novos campos no cadastro "Companhias & Pessoas" os campos são: "Operação Padrão nas Operações de Saída", "Indicador de Presença Padrão nas Operações de Saída" e "Código Cliente Integrador Vips", conforme ilustrado na Figura 05.

7 Figura 05: Companhias e Pessoas (Geral Faturamento) - Novos campos criados. Numero da Nota Fiscal Cabeçalho da Nota Fiscal Data de Emissão; Valor Total da Nota Fiscal; Valor Total dos Impostos; Valor Total dos Itens; Código Cliente do Vips; Item da Nota Fiscal Numero do Pedido do Vips; Código do Item; Quantidade Atendida; Numero do Item no Vips; Preço Unitário; Nas integrações foram inclusos alguns campos com valores fixos conforme solicitado no layout, foi criado novo cadastro com esses valores fixos, por padrão estes campos já possuem valores definidos, mas é possível editá-los. Figura 06. Figura 06: Campos Fixos Integração Volvo

8 Configurar o "Agendador de Tarefas do Windows" para executar o programa "VKNVIPS" exportação, em horário pré-determinado. Um exemplo de configuração do agendador de tarefas pode ser encontrado neste link, seção " Agendador de Tarefas": Logs VKNVIPS A aplicação deve criar uma subpasta "Log" caso esta não exista. Dentro desta, deve criar - caso não exista - um arquivo de nome "logvips.txt"; Ti9 FTP Client Os registros de log a serem considerados são: data, hora, nome do arquivo, sucesso/erros/problemas. A aplicação possui um arquivo chamado "logftp.txt", armazenado no mesmo nível na pasta do executável; Ti9 Windows Services Os registros considerados neste log são: data / hora, nome do arquivo, mensagem de erros. A aplicação possui um arquivo chamado "LogEventos.txt", armazenado no mesmo nível na pasta do executável; Os registros considerados neste log são: data / hora, mensagem de erros, caminho e nome do aplicativo.