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

Testar na Produção Restrita

O ambiente do eSocial é da empresa, não da chave. Não existe chave "de teste": para testar, você precisa de uma empresa de teste ligada à Produção Restrita do eSocial (o ambiente de teste do governo, sem valor legal) e de uma chave dela.

O que pedir ao escritório

Envie ao escritório de contabilidade que opera a empresa no Motor:

  1. Uma empresa de teste ligada à Produção Restrita, com as informações do empregador e do estabelecimento (S-1000 e S-1005) já aceitas lá.
  2. O cadastro completo para o caminho feliz: ao menos um sindicato com CNPJ e, se você vai enviar controle de jornada normal (tp_reg_jor 1), uma jornada pronta para o eSocial no catálogo da empresa.
  3. Uma chave de integração dessa empresa e, se for testar os avisos, o endereço do seu webhook de teste, para o escritório cadastrar e lhe repassar o segredo.
  4. Se quiser testar o envio sem clique, que o escritório ligue o envio automático nessa empresa. Sem ele, cada admissão espera uma pessoa do escritório aprovar.

Sem o item 1 ou o 2, a admissão é recusada na entrada (422) ou pelo eSocial.

Como saber em que ambiente você está

As respostas de admissão (o 202 e a consulta) e todo aviso trazem ambiente (RESTRITA ou PRODUCAO): confira-o antes de tratar um recibo como definitivo.

Quanto tempo leva

Medido numa admissão real: o 202 com a matrícula sai na hora; o recibo do eSocial vem cerca de 20 a 30 segundos depois, com o envio automático ligado; o aviso chega até 1 minuto depois disso. Com o eSocial congestionado, o recibo pode levar minutos — o Motor espera, e o estado fica ENVIADA. Sem envio automático, o tempo é o de uma pessoa do escritório aprovar.

Roteiro mínimo

  1. Admissão completa → 202 → aviso admissao.processada com a assinatura conferida → consulta com xml_evento e xml_retorno.
  2. O mesmo pedido de novo, com a mesma Idempotency-Key → a mesma resposta, com X-Motor-Repetido: true.
  3. Sem jornada_id → 422 DADOS_FALTANDO com JORNADA_AUSENTE; nada gravado.
  4. Um campo a mais no corpo → 422 CAMPO_DESCONHECIDO.
  5. Chave revogada → 401 CHAVE_REVOGADA.

Esta documentação não chama a API: os testes saem do seu sistema, com a chave da empresa de teste.