MIT044 Especificação de personalização do processo de importação Datasul x Protheus utilizando arquivos tipo texto

Transcrição

1 Cliente: TXKF6 - RAYMUNDO DA FONTE LTDA. Projeto: MAN Data: 29/01/2013 Dados da Personalização Extra Projeto: Sim Não Qtd. Horas.: Criticidade para Implementação (*): Alto Impacto Médio Impacto Baixo Impacto Responsável no Cliente: Responsável TOTVS: Josué Izidio (*) Alto Impacto: Não é possível implementar sem a modificação no software Médio Impacto: É possível implementar com entrega das modificações após a implementação. Baixo Impacto: É possível implementar sem a modificação no software. Especificação da Personalização Objetivos: Importar arquivos do tipo texto, oriundos do sistema Datasul para o Sistema Protheus, o processo será executado através de schedules. A finalidade é imputar informações nas tabelas das notas fiscais de entrada e notas fiscais de saida do módulo Frete Embarcador do sistema Protheus. Processos Mapeados: 1-Pastas: Abaixo as pastas relacionadas para conter arquivos do tipo texto: 1

2 Pastas e sub-pastas das importações da notas fiscais de saída e entrada: NFS_I Pasta que deve conter as sub-pastas com os arquivos de notas fiscais de saída e entrada, a serem importados do sistema Data Sul para o sistema Protheus. NFS_I\ CAN Sub-pasta da pasta NFS_I, que deve conter as pastas com os arquivos do tipo texto para exclusão das notas fiscais de entrada no sistema Protheus. O s arquivos dessa sub pasta, deverá ser os primeiros arquivos a ser processados. NFS_I\CAN\GW1 Sub-pasta da pasta NFS_I\CAN que deve conter os arquivos do tipo texto para exclusão dos registros do documento de carga no sistema Protheus. O s arquivos dessa sub pasta, deverá ser os primeiros arquivos a ser processados. NFS_I\CAN\GW3 Sub-pasta da pasta NFS_I\CAN, que deve conter os arquivos do tipo texto para exclusão das notas fiscais de entrada no sistema Protheus. O s arquivos dessa sub pasta, deverá ser os primeiros arquivos a ser processados. NFS_I\CAN\GW4 Sub-pasta da pasta NFS_I\CAN, que deve conter os arquivos do tipo texto para exclusão dos itens das notas fiscais de entrada no sistema Protheus. O s arquivos dessa sub pasta, deverá ser os primeiros arquivos a ser processados. NFS_I\CAN\GW8 Sub-pasta da pasta NFS_I\CAN que deve conter os arquivos do tipo texto para exclusão dos Itens dos documentos de carga no sistema Protheus. O s arquivos dessa sub pasta, deverá ser os primeiros arquivos a ser processados. NFS_I\CAN\GWB Sub-pasta da pasta NFS_I\CAN que deve conter os arquivos do tipo texto para exclusão dos registros dos utilizadores dos documentos de carga.no sistema Protheus. Os arquivos dessa sub pasta, deverá ser os primeiros arquivos a ser processados. NFS_I\CAN\GWN Sub-pasta da pasta NFS_I\CAN que deve conter os arquivos do tipo texto para exclusão dos romaneios de carga no sistema Protheus. O s arquivos dessa sub pasta, deverá ser os primeiros arquivos a ser processados. NFS_I\GW1 Sub-pasta da pasta NFS_I, que deve conter os arquivos do tipo texto contendo os registros do documento de carga. NFS_I \ GW3 Sub-pasta da pasta NFS_I, que deve conter os arquivos do tipo texto contendo os registros do documento de frete para importação. 2

3 NFS_I \ GW4 Sub-pasta da pasta NFS_I, que deve conter os arquivos do tipo texto contendo os registros dos Itens dos documentos de carga do documentos de frete para importação. NFS_I\GW8 Sub-pasta da pasta NFS_I, que deve conter os arquivos do tipo texto contendo os registros dos Itens dos documentos de carga. NFS_I\GWB Sub-pasta da pasta NFS_I, que deve conter os arquivos do tipo texto contendo os registros dos utilizadores dos documentos de carga. NFS_I\GWN Sub-pasta da pasta NFS_I, que deve conter os arquivos do tipo texto contendo os registros dos romaneios de carga. NFS_I\IMP Sub-pasta da pasta NFS_I, que deve conter os arquivos de confirmação da importação. O nome desses arquivos será igual ao nome do arquivo importado. NFS_I\LOG Sub-pasta da pasta NFS_I, que deve conter os arquivos com log de erro da importação 2-Identificação de tabelas e campos: Deverá ser identificado no módulo frete embarcador do sistema Protheus, as tabelas e campos que devem ser alimentados pela importação. Esse processo será feito seguindo as regras de campos obrigatórios de acordo com o dicionário de dados e campos já alimentados no sistema pelo processo atual de integração Datasul x Protheus. Essas informações de tabelas e campos será disponibilizada para o analista do Datasul em uma planilha do Excel, e servirá para como layout para a geração do arquivo do tipo texto proveniente do Datasul. 3-Layout de arquivo do tipo texto: Os arquivos do tipo texto gerados pelo sistema Datasul, deverá ter o delimitador de campos ponto e virgula (;), e cada nota deverá compor um arquivo diferente, seguindo a regra do primeiro registro ser o cabeçalho da tabela e os demais registros os itens da tabela. O arquivo texto gerado pelo sistema Datasul deverá seguir a ordem de campos apresentados no layout solicitado pelos analistas do sistema Protheus, caso a informação seja opcional e não conste no Datasul, deverá ser respeitada a posição do campo utilizando o delimitador de campo ponto e vírgula, os campos considerados 3

4 obrigatórios devem constar no arquivo do tipo texto. Não haverá o processo de alteração, o registro deverá ser cancelado através de um novo arquivo do tipo texto, que ficará disponibilizado na subpastas CAN. Após o cancelamento ser processado a sub pasta IMP poderá conter um arquivo do tipo texto com a nota que foi cancelada. 5-Configuração da Schedule: Será configurado Jobs conforme descrição abaixo: a) Job para leitura dos arquivos do tipo texto a serem importados do Datasul para o Protheus. 6- Composição dos nomes dos arquivos tipo texto: NNNNNNSSSCCCCCCDDMMAAAA.txt Onde: NNNNNN SSS CCCCCC DD MM AA AA = Numero da nota fiscal. (Remover os zeros a esquerda dos números das notas) = Série da notafiscal. = Código do fornecedor ou cliente. = Dia da emissão da nota fiscal. = Mês da emissão da nota fiscal. = Ano da emissão da nota fiscal. Funcionalidades das Rotinas: Schedule ativa: Leitura das pastas que contém os arquivos do tipo texto gerados pelo sistema Datasul. Existindo arquivo do tipo texto, o mesmo será importado para o sistema Protheus. Importação de arquivos do tipo texto: Será importado para o sistema Protheus os arquivos do tipo texto gerados pelo sistema Datasul, dessa importação será inicializada por meio de schedules, o processo de gravação não será feito com os recursos da função Execauto pelo motivo deste recurso não esta disponibilizado nas rotinas que gravam as tabelas do modulo frete embarcador. Renomear arquivos do tipo texto: Cada arquivo importado, terá sua extensão alterada de TXT para OLD, o que identificará se o arquivo foi importado. Gerar arquivos do tipo texto de erro log: Caso o haja algum erro na importação do arquivo, será gerado um arquivo log de erro e disponibilizado nas subpastas de LOG. Funções customizadas: Será desenvolvida uma rotina genérica fnfretemb.prw que deverá conter as funções abaixo 4

5 fnchkpastas(): Função que verifica se existe os arquivos do tipo texto para importação. Essa função é executada pelo Job de verificação de existência de arquivos textos. fnimpnfs(): Função que grava as notas fiscais de entradas e saidas utilizando o arquivo texto. fncannfs(): Função que cancela todas as tabelas envolvidas com documentos de cargas (Entrada e Saida). fnrenarq(): Função genérica que renomeia a extensão do arquivo do tipo texto importado de TXT para OLD. fnerrolog(): Função genérica que gera os logs de erros das importações. Essa função é executada pelo Job de verificação dos Flags. fnlerarq(): Função genérica que carrega os nomes dos arquivos contidos nas pastas de importação. fnmontquery(): Função genérica que gera query para verificar a existência do registro na tabela. fngravtab(): Função genérica que grava as tabelas com conteúdo dos arquivos do tipo texto que foram importados. fncannfs(): Função genérica que deleta todas as tabelas envolvidas no cancelamento da importação. 5

6 Fluxo de Inclusão: Inicio Job de inclusão ativo Detalhamentos do Processo Verificar se existe arquivo texto Existe Arquiv o? N s Importar o arquivo texto Importad o com sucesso? N 6

7 s Enviar informando erro log Renomear arquivo importado Gerar arquivo de erro log Termino Fluxo de Cancelamento: Inicio Ativar Job de Cancelamento Existe Arquiv o? N s Importar o arquivo texto Importad o com sucesso? N 7 s

8 Excluir tabelas relacionadas Tabelas Excluida s? N Gerar arquivo de erro log Especificação de Tabelas, Campos e Índices s Renomear arquivo importado Termino Tabelas que são excluídas no momento do cancelamento importado do Sistema Datasul: Especificação de Parâmetros 8

9 Não se aplica. Premissas para implementação Definição de layout: Definir os layouts de importação para a geração do arquivo texto pelo analista do Datasul. Disponibilização dos arquivos do tipo texto por parte do Datasul. Pastas contendo os arquivos do tipo texto deverão ser pastas acessíveis para o Protheus. Endereço de dos usuários que devem ser informados sobre os logs de erros e documentos digitados que foram excluídos Critérios para Validação Importar arquivo do tipo texto (inclusão). Renomear arquivos do tipo texto após a importação ter ocorrido com sucesso. Verificar os campos de Flags de importação após o término da importação Forçar um erro de importação que deverá gerar um arquivo log de erro e enviar para usuário Digitar conhecimentos de frete e importar um cancelamento para verificar o envio do alertando ao usuário sobre a necessidade de digitar novamente os conhecimentos de frete. Analisar os arquivos textos gerados pelo Protheus nas pastas de importação e log de erros. 9

10 Aprovação: Aprovador por: Assinatura Data Gilberto N. Almeida Analista MRW Solution Luiz Bueno Coordenador Projeto Totvs Roberta Pereira Analista Totvs Gabriel Momm Analista Totvs Josué Izidio Analista Totvs Valdemir Silva Analista Totvs 10