Portal Criar conta

Referência

Novidades

O que muda no JSON dos eventos, em linguagem simples. A mudança de cada nota técnica do eSocial aparece aqui antes da data em que passa a valer.

As mudanças, da mais nova para a mais antiga

Nota técnica Ainda vai valer

Nota Técnica S-1.3 nº 07/2026 — etapa de 26/10/2026

O que você precisa ajustar

S-2200 (admissão) e S-2205 (alteração cadastral) — infoDeficiencia.infoCota
Não envie mais infoCota em admissões com data igual ou posterior a 26/10/2026 (vale também para sucessão de vínculo e mudança de CPF a partir dessa data). Para admissões anteriores, continua como hoje.

S-2206 (alteração contratual) — horContratual
A jornada da alteração contratual passou a ter estrutura própria do S-2206. Revise o envio de qtdHrsSem, tpJornada, tmpParc, horNoturno e dscJorn na alteração contratual.

Mudanças que não exigem ação (mas convém conhecer)

  • Datas a partir de 01/01/1890 em dtAdm e dtExercicio (S-2190, S-2200), dtDeslig (S-2299), dtInicio (S-2300) e dtTerm (S-2399). Datas anteriores passam a ser recusadas.
  • observacao do contrato (S-2200, S-2206, S-2500) passa a usar um tipo próprio de observação trabalhista.
  • S-2230 (afastamento): infoMesmoMtv aceita S ou N.
  • Campos novos opcionais:
    • S-2299 e S-2399: mudancaCPF.indCPFDesvinc.
    • S-2500 (processo trabalhista): nmSoc (nome social), e em infoContr.infoCompl: nmCargo, nmFuncao, CBOFuncao e localTrabalho (localTrabGeral ou localTempDom); tpRegTrab aceita o valor 3; regras de indContr e codCBO revisadas.

Já anunciado para a próxima etapa (23/11/2026)

  • Jornada (qtdHrsSem): regra nova para admissões com data igual ou posterior a 23/11/2026. Detalhes serão publicados aqui antes da data.
Correção

Ajuste de obrigatoriedade dos campos

Não é nota técnica nova: o pacote XSD continua o da NT 07/2026 (S-1.3). Os schemas de validação do enviaeSocial passam a marcar como obrigatório exatamente o que o leiaute oficial exige. Antes, alguns campos eram exigidos pela API e o governo aceitaria sem eles; outros a API aceitava sem eles e o governo recusava o evento. Vale desde já, na Produção Restrita e em produção, para alinhar a API com o leiaute oficial e com o que o governo aceita ou recusa.

Campos que passam a ser obrigatórios

Sem eles a resposta agora é 422 validation_error (antes a API aceitava e o governo recusava o evento). Os que estão dentro de um grupo opcional só são exigidos quando o grupo é enviado.

  • S-1200 (remuneração): procjudtrab[].codsusp; dmdev[].ideestablot[].remunperapur[].itensremun[].vrrubr.
  • S-1299 (fechamento dos periódicos): o grupo infofech.
  • S-2200 (admissão): vinculo.infocontrato.alvarajudicial.nrprocjud; vinculo.mudancacpf.matricant.
  • S-2206 (alteração contratual): infocontrato.alvarajudicial.nrprocjud.
  • S-2210 (CAT): codsitgeradora; o grupo atestado e, dentro dele, atestado.dsclesao.
  • S-2220 (monitoramento da saúde): exmedocup.aso.exame[].procrealizado; exmedocup.aso.medico.nmmed; exmedocup.respmonit.nmresp, exmedocup.respmonit.nrcrm e exmedocup.respmonit.ufcrm.
  • S-2231 (cessão/exercício em outro órgão): matricula.
  • S-2240 (condições ambientais): agnoc[].epcepi.epi[].docaval.
  • S-2300 (TSV, início): fgts.dtopcfgts; infodirigentesindical.tpregprev.
  • S-2399 (TSV, término): verbasresc.procjudtrab[].codsusp.

Campos que deixam de ser obrigatórios

A API passa a aceitar o evento sem eles. Quando o leiaute põe condição (ex.: tpdep só quando depirrf = "S"), a regra fica com o governo: confira a condição na documentação do evento.

  • S-1200 (remuneração): dmdev[].inforra.ideadv[].vlradv.
  • S-1202 (remuneração RPPS): dmdev[].inforra.ideadv[].vlradv.
  • S-1210 (pagamentos): infoircomplem[].infodep[].nome; infoircomplem[].infoircr[].infoprocret[].codsusp.
  • S-2200 (admissão): endereco; trabimig.tmpresid; dependente[].tpdep; dependente[].inctrab.
  • S-2205 (alteração cadastral): endereco; endereco.exterior.codpostal; dependente[].tpdep; dependente[].inctrab.
  • S-2206 (alteração contratual): infocontrato.localtempdom.tplograd; infocontrato.horcontratual.qtdhrssem.
  • S-2210 (CAT): ultdiatrab; houveafast; atestado.ufoc.
  • S-2299 (desligamento): verbasresc.dmdev[].infoperant.ideadc[].dtacconv.
  • S-2300 (TSV, início): endereco; endereco.exterior.codpostal; dependente[].tpdep; cargofuncao.cbocargo; cargofuncao.cbofuncao.
  • S-2400 (beneficiário, cadastro): dependente[].tpdep.
  • S-2405 (beneficiário, alteração): dadosbenef.dependente[].tpdep.
  • S-2500 (processo trabalhista): o grupo infocontr[].infocompl.infovinc.infodeslig (o governo só exige quando tpcontr é diferente de 8).
  • S-2501 (tributos do processo trabalhista): idetrab[].infocrirrf[].infoprocret[].codsusp.

Grupo renomeado

EventoAntes (não chegava ao XML)Agora
S-2306 (TSV, alteração)estagiario.supervisorestagiario.supervisorestagio (mesmo cpfsupervisor dentro)

Com o nome antigo, a resposta agora é 422 unknown_field.

Campos retirados (não existem no leiaute S-1.3)

Não chegavam ao XML. Se o seu sistema ainda envia, tire: agora a resposta é 422 unknown_field.

  • S-1200 (remuneração): os grupos dmdev[].infoperapur e dmdev[].infoperant (use dmdev[].ideestablot[] e dmdev[].ideadc[], direto em dmdev); dmdev[].ideestablot[].remunperapur[].detoper; dmdev[].ideestablot[].remunperapur[].infotrabinterm; dmdev[].ideadc[].compacconv; dmdev[].ideadc[].dtefacconv; dmdev[].ideadc[].ideperiodo[].ideestablot[].remunperant[].infotrabinterm.
  • S-2220 (monitoramento da saúde): exmedocup.aso.medico.cpfmed e exmedocup.aso.medico.nismed.
  • S-2240 (condições ambientais): agnoc[].epcepi.epi[].dscepi.
Correção

Nomes de grupos corrigidos em 12 eventos (S-1.3, NT 07/2026)

Não é nota técnica nova: os schemas de validação do enviaesocial passam a usar os nomes do XSD do eSocial, que são os que de fato chegam ao XML. Antes, quem seguia o schema mandava o nome errado: o envio era aceito e o grupo sumia do XML sem erro. Valem já, na Produção Restrita e em produção.

O que você precisa ajustar

EventoAntes (não chegava ao XML)Agora
S-2200 (admissão)deficienciainfodeficiencia (mesmos campos dentro)
S-2299 (desligamento)verbasresc.procsverbasresc.proccs
S-2240 (condições ambientais)agnoc[].umedagnoc[].unmed
S-2300 (TSV, início)cargoduncaocargofuncao
S-2306 (TSV, alteração)mandeleltmandelet
S-2500 (processo trabalhista)infocontr[].infocompl.infovinc.duracao.clouassec...duracao.clauassec
S-2220 (monitoramento da saúde)respmonit fora de exmedocup (não era conferido)exmedocup.respmonit
// S-2200, antes                                  // S-2200, agora
"deficiencia": { "deffisica": "N", ... }          "infodeficiencia": { "deffisica": "N", ... }

Campos que passam a ser obrigatórios, como no XSD

  • S-2200: dependente[].depirrf ("S" ou "N": o dependente é para fins de IRRF?).
  • S-1260 (comercialização da produção rural): estabelecimento.tpcomerc[].ideadquir[].nfs[].vrratdescpr.
  • S-1207 (benefícios do RPPS): os itens de dmdev[].infoperant.ideperiodo[].ideestab[].itensremun[] passam a ser conferidos: codrubr, idetabrubr, vrrubr e indapurir são obrigatórios (antes nenhuma regra deles era aplicada).

Campos novos aceitos (opcionais)

S-2200 vinculo.infoceletista.matanotjud; S-1260 indguia; S-3500 ideproctrab.ideseqproc; S-2400 nrrecibo; S-1200 indapurir em remunperant[].itensremun[].

Correção

Texto das mensagens de validação (422)

O texto em português das mensagens de validation_error foi revisado (concordância, acentos e um erro de tradução). Exemplos: "A propriedade X é obrigatória" (antes "é obrigatório"); "Integer encontrado, mas o esperado é uma string"; "Data e hora inválidas" no lugar de "Data inválida-time". Os códigos, o field e o formato da resposta não mudam: não compare o texto da mensagem no seu sistema; use o field e o código.

Correção

S-1299, S-2210, S-2299, S-2416 e S-1270 (correções, S-1.3, NT 07/2026)

Correções para o JSON aceito ficar igual ao XSD do eSocial. Valem já, na Produção Restrita e em produção.

O que você precisa ajustar

S-1299 (fechamento dos periódicos) — evtComProd passa a ser obrigatório
Informe "S" ou "N" em infoFech.evtComProd (houve comercialização da produção rural no período?). Antes o campo faltava no schema: o envio era aceito e o evento terminava em erro de geração. Agora, sem ele, a resposta é 422 validation_error.

"infofech": { "evtremun": "S", "evtpgtos": "S", "evtcomprod": "N", "evtcontratavnp": "N", "evtinfocomplper": "N" }

Mudanças que não exigem ação (mas convém conhecer)

  • S-2210 (CAT) dscCompLesao, S-2299 (desligamento) infoInterm e S-2416 (alteração de benefício) dscSuspensao: as regras do schema desses campos passam a ser conferidas (antes ficavam de fora). Envio fora do formato do leiaute agora volta 422 em vez de seguir para o eSocial.
  • S-2416: dscSuspensao agora chega ao XML (antes era descartado).
  • S-1270 (contratação de avulsos não portuários): indGuia é opcional, como no XSD; sem ele o evento volta a ser gerado (antes saía com indGuia vazio e terminava em erro de geração).
Correção

Correções nos schemas de três eventos (S-1.3, NT 07/2026)

Não é nota técnica nova: são correções para o JSON aceito pelo enviaesocial ficar igual ao XSD do eSocial. Valem já, na Produção Restrita e em produção.

S-1000 (informações do empregador) — campo novo opcional indPertIRRF
Aceita "S" em infoCadastro. Quem não envia não precisa mudar nada.

S-1210 (pagamentos) — infoReembMed.cnpjOper deixou de ser obrigatório
Como no XSD, o CNPJ da operadora do plano de saúde é opcional no reembolso médico.

S-2501 (tributos do processo trabalhista) — ideAdv mudou de lugar e tpCR passa a ser conferido
O ideAdv (advogados) fica em infoCRIRRF.infoRRA, e não mais dentro de infoRRA.despProcJud, que é a posição do XSD; enviado no lugar antigo, ele é ignorado e não chega ao XML. O tpCR passa a exigir 6 dígitos (a regra existia, mas não era aplicada): com menos, a resposta é 422 validation_error.

// antes
"inforra": { "despprocjud": { "vlrdespcustas": 10.5, "ideadv": [ { "tpinsc": 2, "nrinsc": "12345678909" } ] } }
// agora
"inforra": { "despprocjud": { "vlrdespcustas": 10.5 }, "ideadv": [ { "tpinsc": 2, "nrinsc": "12345678909" } ] }
Correção

URL base da integração

URL base nova: https://integration.enviaesocial.com.br/v1 (antes, as rotas com chave ficavam em api.enviaesocial.com.br/v1, junto com o portal). Os caminhos (/v1/events, /v1/certificates, /v1/employers, /v1/ping) não mudam.