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

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 XPlatform no SeniorConfigCenter

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.

• 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

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

Para fazer a integração do Integrador SST com o eDocs, você precisa gerar uma chave de acesso:

1. Na plataforma senior X, acesse Tecnologia > Administração > Gerenciamento de aplicações.
2. 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.
3. Clique em Salvar. Neste momento será gerada a chave de acesso que será usada pela aplicação.
   
   Exemplo:
   
   (clique para ampliar)
   

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)

Associar a aplicação criada na etapa anterior ao papel Integração prestadores SST:

1. Na plataforma senior X, acesse Tecnologia > Administração > Autorização > Gestão dos Papéis.
2. Localize o papel Integração prestadores SST e clique em Editar.
3. Em Configurações, clique na guia Aplicações e ative a aplicação:
   • integradorsst-edocs
4. Clique em Salvar para gravar as alterações.

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 XPlatform 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 XPlatform, é 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.

É 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.

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.

Disponibilizar a identidade visual da empresa na XPlatform, 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.

Preencher todos os campos do SMTP nas configurações de notificação da XPlatform.

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.