Prezados cliente, Bem Vindo !

Versão 12: Todas as evoluções de produto e correções liberadas até a data de 16/0809/2019 estão contempladas na atualização abaixo, siga o procedimento de atualização descritos de acordo com o seu ERP para atualização do pacote do eSocial - Produtos TAF e TSS.

Versão 11: Todas as evoluções de produto e correções liberadas até a data de 30/05/2019 estão contempladas na atualização abaixo, siga o procedimento de atualização descritos de acordo com o seu ERP para atualização do pacote do eSocial - Produtos TAF e TSS.

Clientes Microsiga Protheus

Expandir

title	Obtendo os arquivos de atualização via Portal do Cliente TOTVS (clique para expandir)

Atualização de Produto

Acessar a página de Downloads e Atualizações, e selecionar a linha de produto e-SOCIAL:

1. Selecionar a opção correspondente ao MICROSIGA PROTHEUS, e baixar o pacote do release desejado.

_______________________________________ Versão P12 ____________________________________

_______________________________________ Versão P11 ____________________________________

Atenção: Para clientes que ainda não atualizaram seu ambiente da versão 11 com o pacote liberado no dia 05/01/2016 lembramos que essa atualização é obrigatória e deve ser realizada antes da aplicação da atualização abaixo, a não execução desse procedimento causará colaterais na utilização do produto e entrega do eSocial. ( Link do pacote https://suporte.totvs.com/portal/p/10098/download?e=737434 )

2. Existem três opções de idioma, escolha a que deseja utilizar, acima temos o exemplo da versão em Português.:

Os arquivos acima contém toda a atualização necessária para entrega do eSocial desde o RH Protheus (SIGAGPE), a diferença deles é o idioma; trata-se de um conjunto único de atualização. Conteúdo:

- Descompactar o pacote selecionado e utilizar no passo a passo de atualização

ATENÇÃO!

Avaliar se o Filtro está para apresentar "Todos Pacotes Disponíveis", e utilizar o ultimo pacote de atualização disponível;

Atualização de Framework (LIB)

Aviso

title	Framework

Realizar download do pacote de atualização de Lib. Link: https://suporte.totvs.com/portal/p/10098/download#000006/368/TFLIB/

Expandir

title	Passo a passo de atualização (clique para expandir)

Expandir

title	Atualização do TAF (clique para expandir)

Expandir

title	Atualização do repositório de objetos (clique para expandir)

Expandir

title	Execução via IDE de Desenvolvimento (TDS)

• O repositório de dados é utilizado para armazenar todas as funcionalidades desenvolvidas para o TAF, sendo assim é atualizado sempre que ocorrem melhorias ou implementações no produto.

• Para realizar a atualização do repositório de dados é necessário copiar o arquivo com extensão “. PTM” contido no pacote de atualização e aplicá-lo no ambiente do produto TAF, conforme abaixo:

• Abra o TDS (Totvs Developer Studio) e selecione o botão “Aplicar Patch”, para mais detalhes sobre o TDS acesse Como Instalar o Totvs Developer Studio :

• Indique o servidor, ambiente e o diretório onde se encontra o arquivo com extensão “. PTM”:

• Após selecionar o arquivo selecione o botão avançar:

• Na próxima tela serão exibidos todos os programas que serão atualizados no repositório de dados, selecione o botão concluir e a atualização será realizada:

Nota

title	LIB

Deve ser aplicado também o pacote da última LIB do Protheus disponível no Portal.

A LIB é outro pacote .ptm que deve seguir o mesmo processo de atualização comentado neste tópico.

Expandir

title	Execução via IDE de Desenvolvimento (DevStudio)

• O repositório de dados é utilizado para armazenar todas as funcionalidades desenvolvidas para o TAF, sendo assim é atualizado sempre que ocorrem melhorias ou implementações no produto.

• Para realizar a atualização do repositório de dados é necessário copiar o arquivo com extensão “. PTM” contido no pacote de atualização e aplicá-lo no ambiente do produto TAF, conforme abaixo:

Abra o DevStudio localizado na pasta \bin\smartclient\ no diretório de instalação do sistema:

Clique na opção Configurações em Arquivo, e depois em Adicionar, para criar novo ambiente de atualização:

Na tela de criação, dê um nome ao ambiente através do campo Descrição. No campo Ambiente informe o ambiente criado na instalação e a respectiva conexão do Client ao Server (padrão: ambiente = TAF e conexão = TCP):

Clique em OK e verfique se o ambiente foi criado com sucesso:

Selecione o ambiente criado conforme imagem abaixo:

Clique na opção Atualização de Repositório em Ferramentas:

Informe o usuário e senha do administrador:

Selecione o patch (*.ptm) para aplicação. Observe que o arquivo de extensão .ptm precisa estar em alguma pasta no diretório de instalação do sistema:

Nota

title	LIB

Deve ser aplicado também o pacote da última LIB do Protheus disponível no Portal.

A LIB é outro pacote .ptm que deve seguir o mesmo processo de atualização comentado neste tópico.

Expandir

title	Atualização do dicionário de dados (clique para expandir)

a) Copiar os arquivos sdfbra.txt e sx2.unq para a pasta \systemload\ do diretório de instalação do sistema

b) Executar o compatibilizar de dicionário de dados (UPDDISTR)

Será solicitado a seleção dos Grupos de Empresa que devem ser atualizados:

• Nas telas iniciais serão exibidas as informações de ambiente e o propósito do compatibilizador, selecione o botão “Avançar”:

• Após o processamento do compatibilizador o dicionário do TAF estará atualizado:

• Para verificar se houve alguma inconsistência durante a atualização do dicionário de dados, clique em "Consulta LOG":

• Então clique em "Filtrar" e selecione o campo "Tipo do evento" como "Critical Error".

• Caso o filtro retorne algum evento de "Critical Error", significa que foram encontrados problema na base de dados e nenhuma atualização foi efetivada no ambiente. Neste caso o UPDDISTR não tem autonomia para corrigir e os ajustes devem ser realizados pelo Administrador do Sistema.

• Para maiores detalhes de utilização da ferramenta UPDDISTR acesse Atualizador de dicionário e base de dados - UPDDISTR.

Nova execução

Neste momento, ao concluir a execução desta atualização, deve ser avaliado a necessidade de nova execução do UPDTAF, conforme informado no início do tópico III. Atualizar o Dicionário de Dados ( UPDTAF )

Segunda etapa de atualização de dicionário de dados

• Após finalizar a execução dos pacotes atualizados pelo UPDDISTR, deve-se executar novamente o UPDTAF para realizar demais ajustes de ambiente:

• Quando a varredura do sistema identificar que não há necessidade de execução do UPDDISTR, será apresentada uma lista de ajustes que devem ser realizados no ambiente, conforme demonstrado abaixo:

• Selecione as atualizações, por release, que devem ser realizadas.

Status

A coluna 'Status' informa quais atualizações ainda são necessárias. Caso todas estejam com o Status "Executado", este procedimento pode ser ignorado.

• Após realizar a seleção, clique em 'Processar' e aguarde o término da execução.

• No final do processamento serão apresentadas os ajustes realizados no ambiente, conforme demonstrado abaixo:

Expandir

title	Atualização do TSS (clique para expandir)

Atualização do repositório de objetos: TSS0009_Procedimento_para_Aplicação_de_Patch_no_TSS

Atualização dos arquivos de schema: TSS0010_Procedimento_para_Atualização_de_Arquivo_Schema_xsd_no_TSS

Atualização dos arquivos de URL: TSS0012_Procedimento_para_Troca_de_url_no_TSS / TSS0044_O que é o arquivo TSSATUURL.JSON ?

Expandir

title	Atualização GPE P11 (Clique para expandir)

Para a versão P11, este procedimento deve ser efetuado conforme a seguir:

Após finalizar a execução dos pacotes atualizados pelo UPDDISTR, deve-se executar o compatibilizador RHUPDMOD, para realizar as atualizações/ajustes do ambiente SIGAGPE:

Selecione conforme abaixo e <Confirmar> :

Clicar no Check Box "Li e Compreendi" e <Confirmar> para completar a execução do compatibilizador:

• No final do processamento será apresentado um Log com todos os ajustes realizados no ambiente.

Clientes DATASUL e RM

Expandir

title	Obtendo os arquivos de atualização via Portal do Cliente TOTVS (clique para expandir)

Atualização de Produto

Acessar a página de Downloads e Atualizações, e selecionar a linha de produto e-SOCIAL:

1. Selecionar a opção correspondente ao DATASUL/ RM, e baixar o pacote do release desejado.

2. Existem três opções de idioma, escolha a que deseja utilizar, acima temos o exemplo da versão em Português.:

Estes arquivos acima contém toda a atualização necessária de TAF e TSS para entrega do eSocial, a diferença deles é o idioma; trata-se de um conjunto único de atualização. Conteúdo:

- Descompactar o pacote selecionado e utilizar no passo a passo de atualização

ATENÇÃO!

Avaliar se o Filtro está para apresentar "Todos Pacotes Disponíveis", e utilizar o ultimo pacote de atualização disponível;

Expandir

title	Instalação das aplicações via Software Instalador (Passo a Passo)

Expandir

title	Requisitos - Pré Configurações

Para instalação dos produtos TAF e TSS são necessários os produtos abaixo:

2 bancos de dados (1 para cada aplicação) seguindo as especificações dos documentos abaixo:

Banco Microsoft SQL:

Collation e versões suportadas: http://tdn.totvs.com/x/tSuLFQ

Banco Oracle:

Collation e versões suportadas: http://tdn.totvs.com/x/cpRc

Servidor de Licenças: http://tdn.totvs.com/x/lPKRDg

Expandir

title	Execução do Instalador

1. Após a instalação descompactar o arquivo e executar o arquivo TOTVS.PackManager:

2. Selecionar quais aplicações devem ser instaladas, para a transmissão do e-Social/Reinf é necessário que sejam selecionadas as opções TAF e TSS.

→ Próximo

3. Definir um diretório para a instalação:

→ Próximo

4. Informar o endereço do Servidor de Licenças:

→ Próximo

5. Clicar em Parâmetros da Instalação, será exibida a interface descrita no passo 5:

*Parâmetros de Instalação

6 - Realizar a definição do banco de dados:

Informar os parâmetros relacionados ao banco de dados criado para a instalação do TAF:

Informar os parâmetros relacionados ao banco de dados criado para a instalação do TSS:

Após a parametrização dos do banco de dados os ícones em vermelho mudarão para verde permitindo o prosseguimento da instalação:

→ Próximo

7 - Informar as portas que serão utilizadas para o servidor de mensageiria (TSS - Totvs Service SOA) e o servidor de integração entre TAF x ERP (REST).

→ Próximo

8 - Neste momento o Instalador irá realizar a extração,cópia e configuração dos arquivos necessários para a instalação do TAF/TSS.

Após o termino da instalação será exibido a interface abaixo

Expandir

title	Configuração pós instalação

1 - Logo após a instalação será aberto uma interface para login, por default na instalação é criado o usuário "admin" sem senha.

→ Entrar

2 - Selecione se a estrutura do ambiente será para um empresa teste ou para uma empresa real (produção).

→ Selecionar

3 - Caso seja selecionado a criação de um ambiente com empresa real, será exibido uma interface para a criação da empresa "start" (inicial)

No exemplo abaixo está sendo criado uma empresa com as seguintes características:

- Grupo de Empresas utilizando o código 01, abaixo do grupo podemos ter Empresas, Unidades de Negócios e Filiais

- Leiaute EEFFFF, foi definido que neste grupo serão criadas empresas com até 2 dígitos e filiais com até 4 dígitos EE = Empresas , FFFF = Filiais:

Nota
E - 0-9 (Somente números entre 0 e 9) E - 5-9 (Somente números entre 5 e 9) U - A-Z (Somente caracteres entre A e Z) U - X-Z (Somente caracteres entre X e Z) F - !-! (Qualquer dígito numérico ou alfanumérico) F - A,B,5,9 (Somente caracteres entre A,B,5 e 9) F - 0-9 (Somente números entre 0 e 9) F - A-Z (Somente caracteres entre A e Z)

Saiba mais sobre cadastros de empresas em : http://tdn.totvs.com/x/TMwpE

- Empresa utilizando o código 01 respeitando o que foi especificado na máscara do layout (EE)

- Filial utilizando o código 0001 respeitando o que foi especificado na máscara do layout (FFFF), o código da filial sempre é composto pelo código da empresa + o código da filial, por este motivo para controle interno o sistema utilizará 010001.

→ Confirmar

4 - Após a configuração da empresas "start" será exibido uma interface com os parâmetros relacionados a empresa recém criada.:

→ Entrar

5 - Selecionar a localização, para a utilização do TAF a mesma deve ser sempre "Brasil":

→ Ok

6 - Selecionar o diretório de arquivo de dados, escolha Servidor:

→ Abrir

7 - O Sistema iniciará a criação dos dicionários de dados, esse processo pode levar alguns minutos:

Expandir

title	Atualização e Parametrização Inicial

1 - Após a criação dos dicionários é necessário é necessário realizar o de/para de códigos de empresas entre ERP x TAF:

→ Avançar

2 - Clicar em amarração dos Estabelecimentos:

3 - Ao clicar 2x no campo Código complementar o sistema sugere o código a ser utilizado no ERP utilizando o Grupo de Empresas + Código da Empresa + Código da Filial, este código deve ser cadastrado no ERP caso não exista:

→ Finalizar

4 - Após o cadastrado o sistema é fechado e é necessário um novo acesso para continuação da parametrização:

5 - Acessar o modulo pelo menu recém criado:

Aviso
Os ambientes são criados dinamicamente, por este motivo as ultimas 5 letras existentes na descrição dos itens são variáveis, no exemplo abaixo as letras correspondem a "CULAK".

6 - Na abertura do módulo será exibido uma interface para criação das tabelas autocontidas, essas tabelas são utilizadas pelo módulo para suporte as tabelas utilizadas pelo RET (Layout e-Social - Anexo I - Tabelas) e demais tabelas referentes a obrigações acessórias:

→ Avançar

7 - Selecionar o Item referente ao Grupo de empresa:

Informações
Será necessário a execução deste processo cada vez que 1 grupo de empresas for criado.

→ Avançar

8 - Marcar a opção de integração, para o e-Social marcar sempre a opção "Layout TOTVS ou Web Service", se o sistema for utilizado também para a entrega do REINF a opção "Layout TOTVS ou Tabela Compartilhada no SGDB" também deve ser marcada, caso contrario Não marcar esta opção:

→ Avançar

9 - Indique a porta que deverá ser utilizada pelo serviço REST para comunicação entre ERPs x TAF:

→ Avançar

10 - Clicar em "Processar as configurações realizadas neste assistente" para o inicio da criação das tabelas autocontidas e parametrização do serviço REST:

11 - Ao final será exibido um log das operações realizadas:

→ Finalizar

13 - O sistema é encerrado para que as configurações sejam de fato efetivadas:

→ Finalizar

14 - O próximo passo é migrar o dicionário do TAF para a ultima versão, para isso é necessário executar o Atualizador de Dicionários (UPDDISTR):

15 - Ao clicar no ícone exibido na imagem anterior, será exibido uma nova Wizard com orientações para a migração do dicionario, o instalador já inclui o arquivo sdfbra.txt no diretório correto, por este motivo só é necessário clicar em "Avançar":

→ Avançar

15 - Na primeira utilização do produto não é necessário a realização de backup no banco de dados e arquivo de dicionários por ainda não conter dados referentes as obrigações acessórias, porem o backup facilita a restauração do sistema em caso de falhas críticas:

→ Avançar

16 - A atualização de dicionários só pode ser realizadas pelo usuário Administrador, este usuário foi recém criado na instalação como já citado nos itens anteriores, desta forma clique na tecla "Tab" 2x para mudar o foco dos campos usuário e senha que neste momento ainda está em branco e clique em avançar:

→ Avançar

Informações
Marcar a opção "Corrigir erros automaticamente"

→ Avançar

Expandir

title	Passo a passo de atualização (clique para expandir)

Expandir

title	Atualização do TAF (clique para expandir)

Expandir

title	Atualização do repositório de objetos (clique para expandir)

Substituir o arquivo tttp120.rpo na pasta \apo\ do diretório de instalação do sistema

Aviso

title	Importante!

Faça um backup do arquivo antes de substituí-lo!

Expandir

title	Atualização do dicionário de dados (clique para expandir)