Pular para o conteúdo
API de admissãov1OpenAPIPara IA

Códigos de recusa

Toda recusa tem codigo (estável — decida por ele), mensagem (para pessoas) e campos[]. Com problemas de mais de um tipo no mesmo pedido, o código é o primeiro desta ordem: CAMPO_DESCONHECIDO, DADOS_INVALIDOS, DADOS_FALTANDO.

A conferência garante a forma que o leiaute do eSocial exige; não garante que o eSocial aceite o evento. As regras de validação dele (o cruzamento com o cadastro do empregador e com eventos anteriores) só ele aplica, e a recusa chega depois, pelo aviso admissao.recusada e pela consulta.

Os códigos da recusa

HTTPcódigoo que fazer
400IDEMPOTENCY_KEY_INVALIDA

O cabeçalho Idempotency-Key falta ou está fora da forma (8 a 100 caracteres, letras, dígitos e . _ : -). Nada foi gravado.

401CHAVE_INVALIDA

Confira o cabeçalho Authorization: Bearer <chave> e se a chave é a de integração. Também sai quando a empresa deixou de ser atendida pelo escritório que gerou a chave.

401CHAVE_REVOGADA

Use a outra chave ativa, ou peça ao escritório uma nova.

403EMPRESA_NAO_HABILITADA

A empresa não envia ao eSocial pelo Motor, ou não envia esta admissão por ele (por exemplo, quem declara é outro sistema). Fale com o escritório. Nada foi gravado.

403CERTIFICADO_INDISPONIVEL

O certificado A1 da empresa falta ou venceu; o escritório precisa subir o novo. Nada foi gravado.

403CHAVE_SEM_ESCOPO

A chave não alcança a admissão; peça ao escritório uma chave de admissão.

404NAO_ENCONTRADA

O id não existe ou não é da empresa desta chave; também a rota que não existe na API.

405METODO_NAO_PERMITIDO

A rota existe, com outro método (o cabeçalho Allow diz qual).

409TRABALHADOR_JA_ADMITIDO

Já há cadastro com este CPF na empresa. Se for reenvio seu, use a mesma Idempotency-Key; se for readmissão, fale com o escritório.

409IDEMPOTENCIA_CONFLITO

A Idempotency-Key já foi usada com outro corpo. Reenvie o corpo original, ou use uma nova se for outra admissão.

409IDEMPOTENCIA_EM_CURSO

Repita em alguns segundos com a mesma Idempotency-Key.

413CORPO_GRANDE_DEMAIS

O corpo passa de 256 KB (uma admissão com 99 dependentes cabe com folga).

422CAMPO_DESCONHECIDO

Tire do corpo o campo apontado em campos[] (inclusive matricula).

422DADOS_INVALIDOS

Corrija os campos apontados em campos[] (forma, valor ou referência inexistente).

422DADOS_FALTANDO

Complete os campos apontados em campos[]; os de jornada e sindicato são do cadastro do escritório.

429LIMITE_EXCEDIDO

Mais de 60 chamadas por minuto com esta chave (ou credenciais recusadas demais vindas do mesmo endereço). Espere o Retry-After, em segundos.

503INDISPONIVEL

Falha do Motor, não sua. Repita com a mesma Idempotency-Key, respeitando o Retry-After; não haverá duplicata.

Os códigos por campo

Vêm em campos[], um por problema, com o caminho do campo no pedido.

códigocampo e quem corrige
CPF_AUSENTECPF_INVALIDO
trabalhador.cpf
Corrige: você (o pedido)
NOME_AUSENTE
trabalhador.nome_completo
Corrige: você (o pedido)
SEXO_AUSENTE
trabalhador.genero
Corrige: você (o pedido)
RACA_COR_AUSENTE
trabalhador.raca_cor
Corrige: você (o pedido)
GRAU_INSTRUCAO_AUSENTE
trabalhador.grau_instrucao
Corrige: você (o pedido)
DATA_NASCIMENTO_AUSENTE
trabalhador.data_nascimento
Corrige: você (o pedido)
EMAIL_INVALIDO
trabalhador.email
Corrige: você (o pedido)

Recusado, nunca descartado em silêncio.

LOGRADOURO_AUSENTEBAIRRO_AUSENTECEP_AUSENTEUF_AUSENTE
endereco.*
Corrige: você (o pedido)
MUNICIPIO_AUSENTEMUNICIPIO_INVALIDOMUNICIPIO_DIVERGE_DA_UF
endereco.cod_municipio_ibge
Corrige: você (o pedido)
DATA_ADMISSAO_AUSENTE
vinculo.data_admissao
Corrige: você (o pedido)
CATEGORIA_AUSENTECATEGORIA_INVALIDA
vinculo.categoria
Corrige: você (o pedido)

Só 101 ou 103.

TP_REG_JOR_AUSENTETP_REG_JOR_INVALIDO
vinculo.tp_reg_jor
Corrige: você (o pedido)

De 1 a 4.

HORAS_MENSAIS_INVALIDAS
vinculo.horas_mensais
Corrige: você (o pedido)

Inteiro de 1 a 220.

SALARIO_AUSENTESALARIO_INVALIDO
vinculo.salario_base
Corrige: você (o pedido)

Inválido quando tem mais de duas casas decimais.

CARGO_AUSENTECBO_AUSENTE
vinculo.cargo.*
Corrige: você (o pedido)
CARGO_SEM_CBO
vinculo.cargo.nome
Corrige: o escritório (o cadastro)

O cargo já cadastrado está sem CBO; o escritório o corrige no cadastro do cargo.

JORNADA_AUSENTEJORNADA_NAO_ENCONTRADA
vinculo.jornada_id
Corrige: você (o pedido)

Use um id do catálogo de jornadas.

JORNADA_SEM_HORASJORNADA_SEM_TIPOJORNADA_SEM_DESCRICAOJORNADA_PARCIAL_SO_DOMESTICO
vinculo.jornada_id
Corrige: o escritório (o cadastro)

O escritório completa a jornada no cadastro dela.

SINDICATO_AUSENTESINDICATO_NAO_ENCONTRADO
vinculo.sindicato_id
Corrige: você (o pedido)

Use um id do catálogo de sindicatos.

SINDICATO_SEM_CNPJ
vinculo.sindicato_id
Corrige: o escritório (o cadastro)

O escritório completa o sindicato no cadastro dele.

CLAUSULA_ASSECURATORIA_AUSENTE
contrato.clausula_assecuratoria
Corrige: você (o pedido)
EXPERIENCIA_ACIMA_DE_90_DIAS
contrato.dias_*
Corrige: você (o pedido)
DATA_TERMINO_INVALIDA
contrato.data_termino
Corrige: você (o pedido)

Tem de ser igual ou posterior à admissão.

APRENDIZ_DADOS_OBRIGATORIOS
contrato · aprendiz.modalidade
Corrige: você (o pedido)

Categoria 103 sem contrato PRAZO_DETERMINADO ou sem a modalidade.

APRENDIZ_FORA_DA_CATEGORIA
aprendiz
Corrige: você (o pedido)

Enviado fora da categoria 103.

APRENDIZ_MODALIDADE_AUSENTEAPRENDIZ_INVALIDOAPRENDIZ_ENTIDADE_AUSENTEAPRENDIZ_ESTABELECIMENTO_AUSENTEAPRENDIZ_INCOERENTE
aprendiz.*
Corrige: você (o pedido)
APRENDIZ_CNPJ_INVALIDO
aprendiz.cnpj_entidade_qualificadora · aprendiz.cnpj_pratica
Corrige: você (o pedido)
APRENDIZ_INSCRICAO_INVALIDAAPRENDIZ_INSCRICAO_DA_PROPRIA_EMPRESAAPRENDIZ_CPF_NAO_SUPORTADO
aprendiz.estabelecimento_da_cota
Corrige: você (o pedido)
PCD_TIPO_OBRIGATORIOPCD_COTA_INCOERENTEPCD_TIPO_SEM_DEFICIENCIA
deficiencia.*
Corrige: você (o pedido)
PCD_COTA_APRENDIZ
deficiencia.conta_na_cota
Corrige: você (o pedido)

O aprendiz não conta na cota de pessoas com deficiência.

DEPENDENTE_TIPO_OBRIGATORIODEPENDENTE_TIPO_INVALIDO
dependentes.N.tipo
Corrige: você (o pedido)
DEPENDENTE_NOME_OBRIGATORIODEPENDENTE_NOME_INVALIDO
dependentes.N.nome
Corrige: você (o pedido)
DEPENDENTE_NASCIMENTO_INVALIDO
dependentes.N.data_nascimento
Corrige: você (o pedido)
DEPENDENTE_CPF_OBRIGATORIODEPENDENTE_CPF_INVALIDODEPENDENTE_CPF_DO_TRABALHADORDEPENDENTE_CPF_DO_EMPREGADORDEPENDENTE_CPF_REPETIDO
dependentes.N.cpf
Corrige: você (o pedido)
DEPENDENTE_DESCRICAO_OBRIGATORIADEPENDENTE_DESCRICAO_INDEVIDADEPENDENTE_DESCRICAO_INVALIDA
dependentes.N.descricao
Corrige: você (o pedido)
DEPENDENTE_REPETIDODEPENDENTE_LIMITE
dependentes.N · dependentes
Corrige: você (o pedido)
DATA_INVALIDA
qualquer data
Corrige: você (o pedido)
CAMPO_OBRIGATORIO
uma parte inteira do pedido
Corrige: você (o pedido)

trabalhador, endereco, vinculo, contrato, contrato.tipo, os dias do 1º período ou a data de término.

VALOR_INVALIDO
qualquer campo
Corrige: você (o pedido)

Tipo errado (texto onde vai número, "sim" onde vai true, null onde se omite) ou fora das opções do contrato.

DADOS_S2200_FALTANDO
(corpo)
Corrige: depende do campo

O que o S-2200 exige e não tem código próprio; a mensagem diz o quê. Na dúvida, o escritório.

JSON_INVALIDO
(corpo)
Corrige: você (o pedido)

Avisos na resposta

Observações que não impediram a admissão, em avisos[] do 202.

códigoo que significa
CBO_DO_CADASTRO

O cargo já existia com CBO diferente do informado; vale o do cadastro.