Smart Component - Transmissao Automatica de Eventos do eSocial
De Touch ERP
Este Smart Component executa uma rotina automática que organiza Pré‑Eventos do eSocial em lotes, gera os Eventos correspondentes e realiza a transmissão ao eSocial sem intervenção manual. Ele foi criado para acelerar o processo, reduzir erros operacionais e manter um padrão de envio, seguindo a mesma lógica já utilizada no recurso “Lote Eventos eSocial” (recurso 588), porém focado especificamente em Pré‑Eventos ainda não vinculados.
Objetivo
- Automatizar a geração e o envio de eventos do eSocial, reduzindo atividades manuais.
- Apoiar usuários de RH/DP, analistas e gestores ao garantir padronização no envio.
- Melhorar eficiência operacional ao executar toda a cadeia: seleção → agrupamento → criação → transmissão → consulta.
Pré-requisitos
- Permissões para acessar e configurar Tasks ou executar Smart Components.
- Existência de Pré‑Eventos no sistema.
- Tipos de Eventos configurados com automação habilitada.
- Apenas Pré‑Eventos sem vínculo com Eventos serão processados.
- Cada lote conterá somente 1 tipo de evento e até 50 itens.
Fluxo Principal
- Configure a execução da rotina:
- Execução automática: Via Task (1673 - Tarefas/Tasks)
- Execução manual: via recurso 1957 - Iniciar Smart Component.
- Preencha os parâmetros:
- Identificador Usuário: Usuário que será associado ao Lote.
- Ambiente eSocial: Identificador do ambiente em que os Eventos serão transmitidos: 1 = Produção ou 2 = Produção Restrita.
- O sistema executa automaticamente após o início do Smart:
- Busca Pré‑Eventos aptos (automação habilitada e sem vínculo).
- Agrupa por tipo de evento.
- Ordena alfabeticamente por colaborador.
- Divide em lotes de até 50 itens.
- Cria lotes e eventos.
- Transmite cada lote individualmente.
- Consulta eventos em processamento (status 101) e atualiza os registros.
- O sistema finaliza exibindo uma mensagem na Central de Mensagens.
Orientação para preenchimento dos Parâmetros
| Nome do campo | Objetivo | Orientação de preenchimento | Referência Técnica |
|---|---|---|---|
| Identificador do Usuário | Usuário que será associado aos lotes | Informe o identificador de um usuário válido; escolha quem representa o time responsável. | ID_USUARIO |
| Ambiente eSocial | Definir em qual ambiente do eSocial o lote será transmitido | Informe "1" para utilizar o ambiente de “Produção” (envios reais). Informe "2" para “Produção Restrita” (testes controlados). | ID_AMBIENTE |
Funcionalidades
- Identificação automática de Pré‑Eventos elegíveis.
- Atualmente, apenas Pré-Eventos do tipo S‑1200, S‑1210, S‑2200 e S‑2299 são contemplados nesta rotina.
- Agrupamento por tipo de evento (S‑1200, S‑1210, S‑2200, S‑2299).
- Ordenação alfabética interna por nome de colaborador.
- Divisão automática dos grupos (máx. 50 itens por lote).
- Criação de Lotes e Eventos com sequência iniciando em 1.
- Relacionamento automático entre Pré‑Evento, Evento e Lote.
- Transmissão automática de lotes.
- Consulta e atualização de eventos em processamento (status 101).
- Exibição da mensagem final MSG01 ao concluir o processo.
Problemas e Soluções
| Problema | Solução |
|---|---|
| Nenhum lote é gerado | Verifique se há Pré‑Eventos com automação habilitada e sem vínculo com Evento. |
| Expectativa de lote único com muitos Pré‑Eventos | O limite é 50 itens por lote; acima disso, serão criados vários lotes automaticamente. |
Exemplos de Uso
- Analista de DP: agendar execução diária/semanal da rotina via Task, para gerar e enviar todos os Pré‑Eventos do tipo S‑1200, S‑1210, S‑2200 ou S‑2299 pendentes.
Exemplo Prático
Cenário fictício:
- Empresa: Indústria Exemplo Ltda.
- Identificador Usuário: 10 (referente ao usuário jose.silva)
- Ambiente eSocial: 1 (referente ao ambiente de Produção)
Pré‑Eventos encontrados:
- S‑2200: Amanda Souza, Gabriel Martins
- S‑1200: Bruno Lima, Eduardo Alves
- S‑1210: Carlos Nogueira, Fernanda Dias
- S‑2299: Daniela Ribeiro, Helena Castro
Grupos formados:
- Grupo S‑1200
- Grupo S‑1210
- Grupo S‑2200
- Grupo S‑2299
Lotes criados:
- L‑S1200‑2026‑01‑13‑001 → 2 eventos
- L‑S1210‑2026‑01‑13‑001 → 2 eventos
- L‑S2200‑2026‑01‑13‑001 → 2 eventos
- L‑S2299‑2026‑01‑13‑001 → 2 eventos
Observações Gerais
- A automação necessita estar habilitada no Tipo de Evento.
- Atualmente, apenas Pré-Eventos do tipo S‑1200, S‑1210, S‑2200 e S‑2299 são contemplados com esta automação.
- A rotina será executada no ambiente informado no parâmetro Ambiente eSocial.
- Após execução, acompanhe detalhes no recurso de Lote de Eventos (588).
- Selecione corretamente o ambiente (Produção x Produção Restrita) para evitar envios incorretos.
Benefícios do Recurso
- Reduz drasticamente o trabalho manual.
- Aumenta a produtividade ao automatizar processos repetitivos.
- Cria lotes consistentes, organizados e ordenados.
- Permite execução periódica automatizada via Task.
- Padroniza o fluxo de transmissão do eSocial.
Glossário de Termos
- Pré‑Evento — Registro preliminar antes da criação do Evento.
- Evento — Registro final, pronto para transmissão ao eSocial.
- Lote — Conjunto de Eventos do mesmo tipo enviados em bloco.
- Status 101 — Evento em processamento aguardando retorno.
- Automação habilitada — Configuração no tipo que permite envio automático.