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

  1. Configure a execução da rotina:
    1. Execução automática: Via Task (1673 - Tarefas/Tasks)
    2. Execução manual: via recurso 1957 - Iniciar Smart Component.
  2. Preencha os parâmetros:
    1. Identificador Usuário: Usuário que será associado ao Lote.
    2. Ambiente eSocial: Identificador do ambiente em que os Eventos serão transmitidos: 1 = Produção ou 2 = Produção Restrita.
  3. O sistema executa automaticamente após o início do Smart:
    1. Busca Pré‑Eventos aptos (automação habilitada e sem vínculo).
    2. Agrupa por tipo de evento.
    3. Ordena alfabeticamente por colaborador.
    4. Divide em lotes de até 50 itens.
    5. Cria lotes e eventos.
    6. Transmite cada lote individualmente.
    7. Consulta eventos em processamento (status 101) e atualiza os registros.
  4. 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.

Links Relacionados

Os cookies ajudam-nos a fornecer os nossos serviços. Ao navegar no sítio, está a consentir o uso de cookies.