Motor eSocial
O Motor eSocial é responsável por montar os arquivos XML após a geração das informações no Gestão de Pessoas, executado como serviço do Windows.
Existem dois tipos de processamento, permitindo enviar os arquivos para o eDocs eSocial (via web service), ou salvar arquivos em disco (serviço de mensageria de terceiros).
Nota
As orientações abaixo se referem aos principais passos necessários para configurar o Motor eSocial. Para uma orientação campo a campo de como preencher as telas, consulte a documentação da tela Definições Motor eSocial no Manual do Usuário.
Configuração
- Após a instalação ou atualização do sistema Gestão de Pessoas | HCM, o Motor deve ser configurado no módulo Administração de Pessoal.
- Em Diversos > Definições Motor eSocial (FR000DME), preencha a guia Geral. Ela é de preenchimento obrigatório, e as configurações informadas nesta guia serão aplicadas para todas as empresas do sistema.
- Caso possua mais de uma empresa cadastrada no eDocs, preencha também a guia Empresa. Ela deve obrigatoriamente ser configurada para cada uma das empresas cadastradas. Isto é preciso, pois cada empresa possui seu certificado digital, assim como os dados de usuário e senha.
Se não possuir mais de uma empresa cadastrada no eDocs, a guia Empresa não é de preenchimento obrigatório. Ela possibilitará cadastrar configurações específicas para uma ou mais empresas, desta forma, a empresa que estiver cadastrada nessa guia deixa de seguir as configurações cadastradas na guia Geral, ou seja, prevalecerão sobre as da guia Geral.
Notas
- Para saber qual a forma de integração configurada consulte o módulo Administração de Pessoal no caminho Diversos > Definições Motor eSocial, verifique a informação no campo Tipo Processamento.
- Para iniciar o serviço do Motor deve-se configurar a tela Definições Motor eSocial (FR000DME). Por esta razão, em uma nova instalação do sistema, o serviço deverá ser iniciado manualmente após configuração.
- Durante uma atualização do sistema, o serviço será iniciado sem ação do usuário.
Utilizando o Motor eSocial
Envio por web services
Quem utilizar web service para integrar as informações com o eDocs, não necessitará gerar arquivos para salvá-los em disco, porque as informações serão enviadas pelo web service ConsultarSituacaoDocumentos.
Arquivos salvos em disco
Geração de arquivos XML
Quem não utilizar web service para integrar as informações com o eDocs, terá que gerar os arquivos XML no formato abaixo. Esses arquivos devem ser gravados na pasta "Retorno" dentro do diretório configurado em Diversos > Definições Motor eSocial > campo Diretório dos Arquivos XML.
ID | Campo | Pai | Tipo | Ocorrência | Descrição |
---|---|---|---|---|---|
0 | SitucaoDocumento | 1-1 | Situação de documento eletrônico | ||
1 | Documento | 0 | 1-1 | Dados de identificação do documento | |
1.1 | ChaveDocumento | 1 | Texto | 1-1 | Chave/Identificador do documento |
2 | Situacao | 0 | Número | 1-1 |
Deve ser informada a situação do documento. 1 - Autorizado: Deve ser utilizado quando o governo processou o envio e retornou o número de recibo do evento. 2 - Rejeitado: Deve ser utilizando quando o governo processou o envio e retornou críticas identificadas no evento. |
3 | ProtocoloAutorizacao | 0 | Texto | 0-1 | Número de recibo retornado pelo governo para o evento. Obrigatório quando Situacao = 1 - Autorizado. |
4 | DataAutorizacao | 0 | Data | 0-1 | Data de autorização retornada pelo governo. Obrigatório quando Situacao = 1 - Autorizado. |
5 | Mensagem | 0 | Texto | 0-1 | Resumo da situação do evento. Quando Situacao = 2. Exemplos: a) Conteúdo do evento inválido; b) Retornado com erros do Governo. |
6 | DetalhesCritica | 0 | 0-1 | Gerado para eSocial com detalhes da rejeição | |
6.1 | DetalheCritica | 5 | 0-N | Gerado para eSocial com detalhes da rejeição | |
6.1.1 | Codigo | 5.1 | Número | 1-1 | Código da rejeição |
6.1.2 | Localização | 5.1 | Texto | 0-1 | Localização da tag com problema |
6.1.3 | Mensagem | 5.1 | Texto | 1-1 | Mensagem do problema |
Segue um exemplo de envio autorizado, ou seja, informações foram enviadas através dos leiautes e o retorno foi positivo:
<?xml version="1.0" encoding="utf-8"?> <SituacaoDocumento xmlns:ds="http://www.w3.org/2000/09/xmldsig#"> <Documento> <ChaveDocumento>ID1806800930000002017071917133100001</ChaveDocumento> </Documento> <Situacao>1</Situacao> <ProtocoloAutorizacao>1.2.0000000000000011124</ProtocoloAutorizacao> <DataAutorizacao>2016-11-07T10:30:33-02:00</DataAutorizacao> </SituacaoDocumento> |
Na sequência, seguem dois exemplos de envios rejeitados, ou seja, informações foram enviadas através dos leiautes e o retorno foi negativo.
Exemplo 1:
<?xml version="1.0" encoding="utf-8"?> <SituacaoDocumento xmlns:ds="http://www.w3.org/2000/09/xmldsig#"> <Documento> <ChaveDocumento>ID1806800930000002017071917133100001</ChaveDocumento> </Documento> <Situacao>2</Situacao> <Codigo>401</Codigo> <DetalhesCritica> <DetalheCritica> <Codigo>537</Codigo> <Mensagem>Já existe no sistema registro com mesmo código de identificação (chave) em período de vigência conflitante com o período informado no registro atual. Ação Sugerida: O evento somente pode ser recepcionado se não existir outro evento para a tabela com o mesmo código de identificação (chave) em período de vigência conflitante com o período informado no evento atual. Certifique-se que o código de identificação e os períodos informados estejam corretos.</Mensagem> <Localizacao /> </DetalheCritica> </DetalhesCritica> </SituacaoDocumento> |
Exemplo 2:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <ConsultarSituacaoDocumentosResponse xmlns="http://www.senior.com.br/nfe"> <ConsultarSituacaoDocumentosResult xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:anyType i:type="SituacaoDocumento"> <Documento> <ChaveDocumento>ID1123456780000002017071115003800010</ChaveDocumento> </Documento> <Situacao>2</Situacao> <DetalhesCritica> <DetalheCritica> <Codigo>537</Codigo> <Localizacao>Testes</Localizacao> <Mensagem>Já existe no sistema registro com mesmo código de identificação (chave) em período de vigência conflitante com o período informado no registro atual. Ação Sugerida: O evento somente pode ser recepcionado se não existir outro evento para a tabela com o mesmo código de identificação (chave) em período de vigência conflitante com o período informado no evento atual. Certifique-se que o código de identificação e os períodos informados estejam corretos.</Mensagem> </DetalheCritica> <DetalheCritica> <Codigo>986</Codigo> <Mensagem>AAAAAAAAAAAAAAAA AAAAAAAAAAAAAA AAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAA AAAAAAA AAAAAAAAAAAAA AAAAAAAAAAA AAAA AAAAAAAAAAAAAA AAAAAAAAAA AAA A AA A AAAAAAAAAAAAAAAAA. Ação Sugerida: O evento somente pode ser recepcionado se não existir outro evento para a tabela com o mesmo código de identificação (chave) em período de vigência conflitante com o período informado no evento atual. Certifique-se que o código de identificação e os períodos informados estejam corretos.</Mensagem> </DetalheCritica> </DetalhesCritica> </a:anyType> </ConsultarSituacaoDocumentosResult> </ConsultarSituacaoDocumentosResponse> </s:Body> </s:Envelope> |