Checklist de implantação (integração via importação) - Integrador SST

Este conteúdo é voltado para consultores de implantação e administradores de sistema que estejam implantando ou desejam configurar a Senior X para integrar as informações entre o sistema do prestador e o Integrador SST da Senior.

Esta documentação orienta sobre a implantação do cenário onde a integração dos dados com o sistema do prestador é feita exclusivamente por meio da importação de arquivos. Para saber mais sobre isso, veja a documentação de cenários de integração do Integrador SST.

Recomendações

Antes de começar:

Veja a página de pré-requisitos do Integrador SST e certifique-se de que todos foram atendidos.

Envolva o prestador de serviço e/ou o cliente em reuniões de alinhamento e definição de atividades no projeto.
Leia a página de perguntas frequentes para solucionar algumas dúvidas comuns sobre a integração.

Checklist

	Responsável	Etapa	Detalhes e documentação adicional
1	Consultor / Administrador de sistema	Configurar informações na Central de Configurações Senior (SeniorConfigCenter)	Preencher as configurações de login e URLs de conexão com a plataforma na Central de Configurações Senior (SeniorConfigCenter). Acesse o conteúdo abaixo para ver mais informações sobre esta configuração: Configurar informações da Senior X no SeniorConfigCenter
2	Consultor / Administrador de sistema	Criar os usuários de acesso à plataforma senior X	Crie os usuários que terão acesso à plataforma senior X. Estes usuários serão associados a papéis e permissões no próximo passo. Para saber mais sobre o procedimento, consulte a documentação de gestão de usuários no manual da plataforma.
3	Consultor / Administrador de sistema	Configurar os papéis na plataforma senior X conforme as necessidades da empresa	Crie os papéis que serão associados aos usuários que vão acessar o Integrador SST. Configure as permissões de acesso que serão concedidas aos papéis. Se quiser saber mais sobre gestão de papéis e permissões, consulte a seguinte documentação: Gestão dos papéis Permissões do Integrador SST
4	Consultor / Administrador de sistema	Criar um papel para fazer a integração com o prestador e com o eDocs	Criar o papel abaixo, que será associado à aplicação do Integrador SST. Este papel será usado para fazer a integração com o sistema do prestador e com o eDocs da Senior: Nome: Integração prestadores SST Descrição: Papel da plataforma específico para a integração com prestadores SST e com o eDocs Permissões do papel: atribuir todas as permissões (Editar, Excluir, Incluir, Visualizar) aos seguintes itens: HCM > eSocial HCM > eSocial2Doc Se quiser saber mais sobre gestão de papéis e permissões, consulte a documentação: Gestão dos papéis Permissões do Integrador SST
5	Consultor / Administrador de sistema	Gerar a chave de acesso para integração com o mensageiro (eDocs)	Para fazer a integração do Integrador SST com o eDocs, você precisa gerar uma chave de acesso: Na plataforma senior X, acesse Tecnologia > Administração > Gerenciamento de aplicações. Clique em Nova aplicação e preencha as informações: Nome: integradorsst-edocs Descrição: Integrador SST - eDocs Geração dos tokens: A definição do formato deve ser configurada para: Reutilizar o mesmo token para múltiplas sessões de aplicação: permite que ao utilizar a mesma aplicação em sessões em máquinas diferentes, todas as sessões ficam sincronizadas, possibilitando que, por exemplo, ao realizar o logoff em uma das máquinas, todas as demais sessões também são encerradas. Gerar um token diferente para cada sessão de aplicação: faz com que, ao utilizar o mesmo login para autenticar em máquinas diferentes, cada sessão seja independente. Clique em Salvar. Neste momento será gerada a chave de acesso que será usada pela aplicação. Exemplo: (clique para ampliar) Importante Qualquer alteração feita nas chaves de acesso da aplicação impacta diretamente nos próximos passos da implantação. Caso você altere essas configurações, precisará rever o item Configurar a conexão do eDocs com a plataforma senior X, mais adiante neste checklist. Para saber mais, consulte também a seguinte documentação: Gerenciamento de aplicações Central de Configurações Senior (SeniorConfigCenter) (campo Token de autorização)
6	Consultor / Administrador de sistema	Associar a aplicação ao papel Integração prestadores SST	Associar a aplicação criada na etapa anterior ao papel Integração prestadores SST: Na plataforma senior X, acesse Tecnologia > Administração > Autorização > Gestão dos Papéis. Localize o papel Integração prestadores SST e clique em Editar. Em Configurações, clique na guia Aplicações e ative a aplicação: integradorsst-edocs Clique em Salvar para gravar as alterações.
7	Consultor / Administrador de sistema	Configurar a conexão do eDocs com a plataforma senior X	Certifique-se que as configurações abaixo foram feitas no eDocs. Elas são necessárias para que o eDocs consiga consumir os eventos a partir da plataforma senior X. Habilitar os serviços referentes ao eSocial Onde configurar no eDocs: Configurações > Gerais > guia Avançado > guia Serviços O que fazer: habilitar os serviços referentes aos documentos do eSocial. Definir o protocolo de conexão Onde configurar no eDocs: Configurações > Gerais > guia Avançado > guia Conexão O que fazer: ativar o protocolo TLS 1.2 no eDocs. Isso permite configurar os possíveis protocolos de segurança das conexões do eDocs. Após a alteração deste parâmetro é necessário reiniciar a aplicação (no serviço do Windows ou IIS). Orientação adicional para clientes que têm o ambiente na cloud da Senior (SaaS): nesse cenário, o menu Configurações > Gerais não estará disponível no eDocs. Nesse caso, o consultor responsável pela implantação deve abrir um ticket para a equipe de IT Services da Senior, solicitando que façam a configuração do protocolo de conexão. Liberar acesso à URL da API da plataforma Onde configurar: no servidor do eDocs O que fazer: liberar o acesso à URL da API da Senior X no servidor do eDocs. URL da API: https://platform.senior.com.br/t/senior.com.br/bridge/1.0/ Ativar a integração de eventos para as filiais Onde configurar no eDocs: Configurações > Filiais > guia Filial > guia Empregadores / Outorgados O que fazer: habilitar a opção Sim no assinalamento Utiliza integração com a plataforma. Isso deve ser feito somente para uma filial por raiz de CNPJ. Nesse caso, a opção deve ser habilitada para a filial que é a responsável pelo certificado daquela raiz de CNPJ. Ativar a integração de eventos para a empresa Onde configurar no eDocs: Configurações > Empresas > guia Integração O que fazer: na seção “Plataforma senior X”, fazer as configurações: Habilitar a opção Sim no assinalamento Ativar integração de eventos do eSocial com a plataforma. Preencher os campos: URL Plataforma: https://platform.senior.com.br/t/senior.com.br/bridge/1.0/ Tenant: tenant do cliente que está sendo configurado Chave e Secret: chaves de acesso da aplicação integradorsst-edocs, que foi cadastrada na Etapa 2 desse checklist. Habilitar a opção de reenvio de leiautes Se o status de algum leiaute for divergente entre o eDocs e a Senior X, é preciso reenviar esse leiaute do eDocs para a plataforma. Para habilitar a opção de reenviar um leiaute do eDocs para a plataforma, faça a seguinte configuração: Onde configurar no eDocs: Configurações > Filiais > guia Filial > guia Geral O que fazer: selecione ao opção Arquivo XML (NF-e, MDF-e, e-Social e EFD-Reinf) no assinalamento Forma integração (Saída). Ao fazer esta configuração, o botão Reenviar Retorno será habilitado na tela de não periódicos do eDocs, permitindo reenviar os leiautes quando necessário. Importante Se você usa a integração do eDocs com o ERP da Senior, faça a seguinte configuração adicional: ainda no cadastro da Filial, na guia eSocial, selecione a opção Arquivo XML no campo Forma integração (Saída). Isto é necessário para garantir a integração correta de notas fiscais e do eSocial.
8	Consultor / Administrador de sistema	Fazer configurações do empregador	É preciso fazer as configurações do empregador no Integrador SST. Elas são necessárias para receber e enviar os eventos do eSocial. Estas são algumas configurações dessa etapa: Receber os eventos do prestador SST Enviar os eventos do eSocial para o eDocs Receber o retorno do ambiente do eSocial por meio do eDocs Para fazer as configurações do empregador, siga os passos descritos na documentação de envio dos eventos do eSocial e eDocs.
9	Consultor / Administrador de sistema	Configurar relatórios de integração e envio de alertas de erros	Criar visões dinâmicas e configurar notificações de alertas sobre erros que podem ocorrer internamente ou no ambiente do prestador. A recomendação é configurar todas as visões dinâmicas e notificações, conforme descrito na documentação de Visões Dinâmicas do Integrador SST. Essa mesma documentação também especifica quem são os destinatários de cada tipo de notificação: Notificação de erros no prestador: A responsável pelas informações de SST na empresa (exemplo: técnico de segurança, alguém da área de RH, etc.). Uma pessoa no prestador SST responsável pelas informações da empresa (exemplo: alguém que faça a gestão ocupacional). Notificação de erros internos: Uma pessoa responsável que possa identificar o motivo das pendências de integração terem apresentado erro.
10	Consultor / Administrador de sistema	Customizar a logo e a cor(opcional)	Disponibilizar a identidade visual da empresa na Senior X, alterando as características para todos os usuários de um tenant. É preciso solicitar ao cliente as informações da identidade visual, tais como: cor do topo, da fonte dos menus, do fundo da área de autenticação, logotipo, entre outras. Saiba mais sobre a customização da identidade visual acessando a documentação de logos e cores no manual da plataforma.
11	Consultor / Administrador de sistema	Configurar o recebimento de notificações por e-mail(opcional)	Preencher todos os campos do SMTP nas configurações de notificação da Senior X. Os campos que devem ser preenchidos na implantação estão em: Tecnologia > Configuração > Por Tenant > Nome do Tenant > Domínios e Serviços > Platform > Notifications > botão Editar > guia Sistema.

PORTAL DE DOCUMENTAÇÃO
Gestão de Pessoas \| HCM - senior X