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 S-1.3 nº 07/2026 — etapa de 26/10/2026
- Produção Restrita (testes): desde 13/10/2026
- Produção: a partir de 26/10/2026
- Fonte: Documentação Técnica do eSocial · Agenda de implantação
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
dtAdmedtExercicio(S-2190, S-2200),dtDeslig(S-2299),dtInicio(S-2300) edtTerm(S-2399). Datas anteriores passam a ser recusadas. observacaodo contrato (S-2200, S-2206, S-2500) passa a usar um tipo próprio de observação trabalhista.- S-2230 (afastamento):
infoMesmoMtvaceitaSouN. - Campos novos opcionais:
- S-2299 e S-2399:
mudancaCPF.indCPFDesvinc. - S-2500 (processo trabalhista):
nmSoc(nome social), e eminfoContr.infoCompl:nmCargo,nmFuncao,CBOFuncaoelocalTrabalho(localTrabGeraloulocalTempDom);tpRegTrabaceita o valor3; regras deindContrecodCBOrevisadas.
- S-2299 e S-2399:
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.
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 grupoatestadoe, dentro dele,atestado.dsclesao. - S-2220 (monitoramento da saúde):
exmedocup.aso.exame[].procrealizado;exmedocup.aso.medico.nmmed;exmedocup.respmonit.nmresp,exmedocup.respmonit.nrcrmeexmedocup.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 quandotpcontré diferente de8). - S-2501 (tributos do processo trabalhista):
idetrab[].infocrirrf[].infoprocret[].codsusp.
Grupo renomeado
| Evento | Antes (não chegava ao XML) | Agora |
|---|---|---|
| S-2306 (TSV, alteração) | estagiario.supervisor | estagiario.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[].infoperapuredmdev[].infoperant(usedmdev[].ideestablot[]edmdev[].ideadc[], direto emdmdev);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.cpfmedeexmedocup.aso.medico.nismed. - S-2240 (condições ambientais):
agnoc[].epcepi.epi[].dscepi.
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
| Evento | Antes (não chegava ao XML) | Agora |
|---|---|---|
| S-2200 (admissão) | deficiencia | infodeficiencia (mesmos campos dentro) |
| S-2299 (desligamento) | verbasresc.procs | verbasresc.proccs |
| S-2240 (condições ambientais) | agnoc[].umed | agnoc[].unmed |
| S-2300 (TSV, início) | cargoduncao | cargofuncao |
| S-2306 (TSV, alteração) | mandelelt | mandelet |
| 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,vrrubreindapurirsã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[].
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.
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)infoInterme 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:
dscSuspensaoagora 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 comindGuiavazio e terminava em erro de geraçã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" } ] }
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.