Envio de eventos · Enviar um lote

Enviar um lote

Envia de 1 a 50 eventos numa chamada, o tamanho do lote do eSocial. Cada item volta com o que o envio único responderia, na mesma ordem.

POST https://integration.enviaesocial.com.br/v1/events/batch

Autenticação Bearer es_…

Corpo application/json

Sucesso 200 events_processed

Um item com erro não derruba os outros: no exemplo, o primeiro é aceito e o segundo volta sozinho com http_status 422, message validation_error e code unknown_field. O field de cada erro é relativo ao item.

Corpo

events lista

obrigatório

De 1 a 50 eventos, cada um com os cinco campos do envio único. Outro campo ao lado de events é recusado.

Respostas

200 events_processed

Os itens em data.items, cada um com index, http_status, status, message e data.

422 validation_error

O corpo não é um objeto JSON, traz campo além de events (code unknown_field), ou events falta, está vazia ou passa de 50.

402 payment_overdue

Fatura vencida há 10 dias ou mais. Só na produção: a Produção Restrita nunca é bloqueada.

402 subscribe_required

Sem plano ativo e sem envios do bônus. Só na produção: a Produção Restrita nunca é bloqueada.

401 invalid_api_key

Chave ausente, inválida ou revogada.

curl -X POST "https://integration.enviaesocial.com.br/v1/events/batch" \ -H "Authorization: Bearer $ENVIAESOCIAL_KEY" \ -H "Content-Type: application/json" \ -d '{ "events": [ { "type": "S-2230", "employer_document": "11.222.333/0001-81", "layout": "S-1.3", "client_reference": "afastamento-0042", "data": { "indretif": 1, "idevinculo": { "cpftrab": "41872634036", "matricula": "0042" }, "iniafastamento": { "dtiniafast": "2026-10-13", "codmotafast": "03" } } }, { "type": "S-2230", "employer_document": "11.222.333/0001-81", "layout": "S-1.3", "client_reference": "afastamento-0043", "data": { "indretif": 1, "idevinculo": { "cpftrab": "41872634117", "matricula": "0043" }, "iniafastamento": { "dtiniafast": "2026-10-13", "codmotafast": "03" }, "campoinventado": "x" } } ] }'

$http = new GuzzleHttp\Client([ 'base_uri' => 'https://integration.enviaesocial.com.br/v1/', 'headers' => ['Authorization' => 'Bearer ' . getenv('ENVIAESOCIAL_KEY')],]); $response = $http->post('events/batch', ['json' => [ 'events' => [ [ 'type' => 'S-2230', 'employer_document' => '11.222.333/0001-81', 'layout' => 'S-1.3', 'client_reference' => 'afastamento-0042', 'data' => [ 'indretif' => 1, 'idevinculo' => [ 'cpftrab' => '41872634036', 'matricula' => '0042', ], 'iniafastamento' => [ 'dtiniafast' => '2026-10-13', 'codmotafast' => '03', ], ], ], [ 'type' => 'S-2230', 'employer_document' => '11.222.333/0001-81', 'layout' => 'S-1.3', 'client_reference' => 'afastamento-0043', 'data' => [ 'indretif' => 1, 'idevinculo' => [ 'cpftrab' => '41872634117', 'matricula' => '0043', ], 'iniafastamento' => [ 'dtiniafast' => '2026-10-13', 'codmotafast' => '03', ], 'campoinventado' => 'x', ], ] ],]]); $result = json_decode($response->getBody(), true);

const res = await fetch('https://integration.enviaesocial.com.br/v1/events/batch', { method: 'POST', headers: { Authorization: `Bearer ${process.env.ENVIAESOCIAL_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ events: [ { type: "S-2230", employer_document: "11.222.333/0001-81", layout: "S-1.3", client_reference: "afastamento-0042", data: { indretif: 1, idevinculo: { cpftrab: "41872634036", matricula: "0042", }, iniafastamento: { dtiniafast: "2026-10-13", codmotafast: "03", }, }, }, { type: "S-2230", employer_document: "11.222.333/0001-81", layout: "S-1.3", client_reference: "afastamento-0043", data: { indretif: 1, idevinculo: { cpftrab: "41872634117", matricula: "0043", }, iniafastamento: { dtiniafast: "2026-10-13", codmotafast: "03", }, campoinventado: "x", }, } ], }),});const { data } = await res.json();

import osimport requests auth = {"Authorization": f"Bearer {os.environ['ENVIAESOCIAL_KEY']}"} res = requests.post( "https://integration.enviaesocial.com.br/v1/events/batch", headers=auth, json={ "events": [ { "type": "S-2230", "employer_document": "11.222.333/0001-81", "layout": "S-1.3", "client_reference": "afastamento-0042", "data": { "indretif": 1, "idevinculo": { "cpftrab": "41872634036", "matricula": "0042", }, "iniafastamento": { "dtiniafast": "2026-10-13", "codmotafast": "03", }, }, }, { "type": "S-2230", "employer_document": "11.222.333/0001-81", "layout": "S-1.3", "client_reference": "afastamento-0043", "data": { "indretif": 1, "idevinculo": { "cpftrab": "41872634117", "matricula": "0043", }, "iniafastamento": { "dtiniafast": "2026-10-13", "codmotafast": "03", }, "campoinventado": "x", }, } ], },)data = res.json()["data"]

using System.Text; using var http = new HttpClient { BaseAddress = new Uri("https://integration.enviaesocial.com.br/v1/") };http.DefaultRequestHeaders.Authorization = new("Bearer", Environment.GetEnvironmentVariable("ENVIAESOCIAL_KEY")); var body = """{ "events": [ { "type": "S-2230", "employer_document": "11.222.333/0001-81", "layout": "S-1.3", "client_reference": "afastamento-0042", "data": { "indretif": 1, "idevinculo": { "cpftrab": "41872634036", "matricula": "0042" }, "iniafastamento": { "dtiniafast": "2026-10-13", "codmotafast": "03" } } }, { "type": "S-2230", "employer_document": "11.222.333/0001-81", "layout": "S-1.3", "client_reference": "afastamento-0043", "data": { "indretif": 1, "idevinculo": { "cpftrab": "41872634117", "matricula": "0043" }, "iniafastamento": { "dtiniafast": "2026-10-13", "codmotafast": "03" }, "campoinventado": "x" } } ]}"""; var res = await http.PostAsync("events/batch", new StringContent(body, Encoding.UTF8, "application/json"));var json = await res.Content.ReadAsStringAsync();

{ "status": "success", "message": "events_processed", "data": { "items": [ { "index": 0, "http_status": 202, "status": "success", "message": "event_accepted", "data": { "event": { "uuid": "7c1e4f9a-3b2d-4e8f-9a61-0d5c2b8e4f17", "type": "S-2230", "layout": "S-1.3", "client_reference": "afastamento-0042", "employer_document": "11222333000181", "status": "VALIDATED", "response_code": null, "protocol": null, "receipt": null, "occurrences": [], "esocial_id": null, "period": null, "worker_cpf": "41872634036", "totalizers": [], "created_at": "2026-10-17T14:32:08-03:00", "updated_at": "2026-10-17T14:32:08-03:00", "processed_at": null } } }, { "index": 1, "http_status": 422, "status": "error", "message": "validation_error", "data": { "errors": [ { "field": "data.campoinventado", "code": "unknown_field", "detail": "Campo não existe no leiaute deste evento." } ] } } ] }}

{ "status": "error", "message": "validation_error", "data": { "errors": [ { "field": "events", "code": "require", "detail": "Informe a lista events com 1 a 50 eventos." } ] }}

{ "status": "error", "message": "payment_overdue", "data": { "errors": [ { "field": null, "code": "payment_overdue", "detail": "Há uma fatura vencida há 10 dias ou mais: regularize o pagamento para enviar em produção." } ] }}

{ "status": "error", "message": "subscribe_required", "data": { "errors": [ { "field": null, "code": "subscribe_required", "detail": "Você não tem plano ativo e não há mais envios do bônus. Assine um plano para enviar em produção." } ] }}

{ "status": "error", "message": "invalid_api_key", "data": { "errors": [ { "field": null, "code": "invalid_api_key", "detail": "Chave de API ausente, inválida ou revogada." } ] }}