Como funciona a transmissão de eventos ao eSocial via requests no RESocial.
O RESocial foi pensado para ser consumido de forma programática. Na prática, o seu sistema monta os dados necessários, envia uma requisição HTTP para a nossa API e o RESocial assume a camada de montagem, envio e leitura do retorno do evento no eSocial.
Se a sua linguagem faz requests HTTP, ela pode integrar com o RESocial.
O formato de transmissão foi desenhado para não prender a operação a uma linguagem específica. Se a sua stack consegue enviar requisições HTTP autenticadas e tratar resposta da API, a integração é viável.
Cada rota principal de integração tem uma página própria com payload e exemplo prático.
Abaixo estão as rotas centrais que fazem parte do fluxo via requests. Em todas as rotas protegidas sob /api-esocial, os headers CNPJ e TOKEN são obrigatórios em todos os requests.
Cadastro de certificado
Cadastro programático de certificado digital por JSON com arquivo em base64.
Cadastro de empregador
Cadastro programático de empregador para a base do cliente autenticado.
Envio de eventos
Envio assíncrono de um único tipo de evento por request, com protocolo para consulta posterior.
Consulta de protocolo
Consulta do processamento de lote a partir do protocolo criptografado e do identificador do evento.
Listar certificados
Lista os certificados já cadastrados para o cliente autenticado e devolve o id usado nas rotas de vínculo e exclusão.
Excluir certificado
Remove um certificado pelo certificado_id, que deve ser obtido antes na listagem de certificados.
Vincular certificado
Vincula um certificado ativo a um empregador usando o certificado_id retornado pela listagem de certificados.
Desvincular certificado
Remove o vínculo entre um empregador e o certificado que estava associado a ele.
O envio acontece em uma sequência simples e previsível.
O ponto de partida é a informação já existente no ERP, na folha ou no sistema interno da sua operação.
O consumo é parecido com qualquer integração baseada em API.
O exemplo abaixo é ilustrativo, apenas para mostrar o conceito da transmissão por requests. O contrato real, autenticação e payload exatos são alinhados na implantação.
POST https://resocial.com.br/sua-rota-de-eventos
Authorization: Bearer <seu-token>
Content-Type: application/json
{
"evento": "S-1200",
"dados": {
"empregador": { "...": "..." },
"trabalhador": { "...": "..." },
"itens": [ ... ]
}
}O que a sua aplicação precisa ter
Capacidade de fazer requests HTTP, autenticar a chamada, enviar dados estruturados e tratar o retorno da API.
O que o RESocial assume
A camada de montagem do evento, o envio ao eSocial e a devolução do status operacional da transmissão.
Quando esse modelo faz sentido
Quando a empresa quer sair do preenchimento manual e integrar o envio de eventos direto ao fluxo do próprio sistema.