Estrutura do XML de Envio da API eSocial

A API do eSocial da TecnoSpeed possui uma rota especifica onde é possível enviar diretamente os XML´s dos eventos descritos no manual do eSocial.

Essa rota foi preparada para suportar o envio de lote de eventos do eSocial, e para isso ela espera o XML de envio dentro de uma determinada estrutura hierarquica. A cada requisição feita para a rota de envio de XML da API, ocorre uma validação dessa estrutura.

A API valida se o XML tem as seguintes tags: <eventos></eventos>, <evento Id=""></evento> e <eSocial></eSocial>.

A tag <eventos> é a tag principal onde dentro dela devem existir 1 ou mais tags filhas do tipo <evento Id=""> dependendo da quantidade de eventos enviada.

A tag <evento Id=""> deve conter cada evento do eSocial gerado dentro da estrutura especificada pela SEFAZ que contém obrigatoriamente a tag <eSocial>. E o Id="" da tag <evento> deve ser preenchido com o Id do evento do eSocial.

Segue abaixo um exemplo de XML que possui essa estrutura:

<eventos>
  <evento Id="ID2024734999000002022031415073500001">
    <eSocial xmlns="http://www.esocial.gov.br/schema/evt/evtMonit/v_S_01_00_00">
      <evtMonit Id="ID2024734999000002022031415073500001">
        <ideEvento>
          <indRetif>1</indRetif>
          <tpAmb>1</tpAmb>
          <procEmi>1</procEmi>
          <verProc>v1.000</verProc>
        </ideEvento>
        <ideEmpregador>
          <tpInsc>2</tpInsc>
          <nrInsc>99999999999</nrInsc>
        </ideEmpregador>
        <ideVinculo>
          <cpfTrab>88888888888</cpfTrab>
          <matricula>000999_FL09999488800999</matricula>
        </ideVinculo>
      <exMedOcup>
          <tpExameOcup>1</tpExameOcup>
          <aso>
            <dtAso>2022-03-11</dtAso>
            <exame>
              <dtExm>2022-03-11</dtExm>
              <procRealizado>0069</procRealizado>
            </exame>
            <exame>
              <dtExm>2022-03-11</dtExm>
              <procRealizado>0295</procRealizado>
            </exame>
            <medico>
              <nmMed>Jose do Teste</nmMed>
              <nrCRM>143.546</nrCRM>
              <ufCRM>SP</ufCRM>
            </medico>
          </aso>
          <respMonit>
            <cpfResp>77777777777</cpfResp>
            <nmResp>Fernando do Teste</nmResp>
            <nrCRM>99999</nrCRM>
            <ufCRM>SP</ufCRM>
          </respMonit>
        </exMedOcup>
      </evtMonit>
    </eSocial>
  </evento>
</eventos>

Abaixo um exemplo de XML dentro da estrutura que possui dois eventos:

<eventos>
  <evento Id="ID2024734999000002022031415073500001">
    <eSocial xmlns="http://www.esocial.gov.br/schema/evt/evtMonit/v_S_01_00_00">
      <evtMonit Id="ID2024734999000002022031415073500001">
        <ideEvento>
          <indRetif>1</indRetif>
          <tpAmb>1</tpAmb>
          <procEmi>1</procEmi>
          <verProc>v1.000</verProc>
        </ideEvento>
        <ideEmpregador>
          <tpInsc>2</tpInsc>
          <nrInsc>99999999999</nrInsc>
        </ideEmpregador>
        <ideVinculo>
          <cpfTrab>88888888888</cpfTrab>
          <matricula>000999_FL09999488800999</matricula>
        </ideVinculo>
        <exMedOcup>
          <tpExameOcup>1</tpExameOcup>
          <aso>
            <dtAso>2022-03-11</dtAso>
            <exame>
              <dtExm>2022-03-11</dtExm>
              <procRealizado>0069</procRealizado>
            </exame>
            <exame>
              <dtExm>2022-03-11</dtExm>
              <procRealizado>0295</procRealizado>
            </exame>
            <medico>
              <nmMed>Jose do Teste</nmMed>
              <nrCRM>143.546</nrCRM>
              <ufCRM>SP</ufCRM>
            </medico>
          </aso>
          <respMonit>
            <cpfResp>77777777777</cpfResp>
            <nmResp>Fernando do Teste</nmResp>
            <nrCRM>99999</nrCRM>
            <ufCRM>SP</ufCRM>
          </respMonit>
        </exMedOcup>
      </evtMonit>
    </eSocial>
  </evento>
  <evento Id="ID2024734999000002022031425088800001">
    <eSocial xmlns="http://www.esocial.gov.br/schema/evt/evtMonit/v_S_01_00_00">
      <evtMonit Id="ID2024734999000002022031425088800001">
        <ideEvento>
          <indRetif>1</indRetif>
          <tpAmb>1</tpAmb>
          <procEmi>1</procEmi>
          <verProc>v1.000</verProc>
        </ideEvento>
        <ideEmpregador>
          <tpInsc>2</tpInsc>
          <nrInsc>99999999999</nrInsc>
        </ideEmpregador>
        <ideVinculo>
          <cpfTrab>55555555555</cpfTrab>
          <matricula>000999_FL08888488800777</matricula>
        </ideVinculo>
        <exMedOcup>
          <tpExameOcup>1</tpExameOcup>
          <aso>
            <dtAso>2022-03-12</dtAso>
            <exame>
              <dtExm>2022-03-12</dtExm>
              <procRealizado>0079</procRealizado>
            </exame>
            <exame>
              <dtExm>2022-03-12</dtExm>
              <procRealizado>0300</procRealizado>
            </exame>
            <medico>
              <nmMed>Maria do Teste</nmMed>
              <nrCRM>100.546</nrCRM>
              <ufCRM>SP</ufCRM>
            </medico>
          </aso>
          <respMonit>
            <cpfResp>77777777777</cpfResp>
            <nmResp>João do Teste</nmResp>
            <nrCRM>88888</nrCRM>
            <ufCRM>SP</ufCRM>
          </respMonit>
        </exMedOcup>
      </evtMonit>
    </eSocial>
  </evento>
</eventos>

Atenção! A API eSocial não suporta o envio de XMLs individuais. Mesmo que seja enviado apenas um evento, o XML deve conter as tags de lote <eventos></eventos> e <evento Id=""></evento>, ou o mesmo será rejeitado pela API.

Abaixo um exemplo de XML individual fora da estrutura suportada pela API:

    <eSocial xmlns="http://www.esocial.gov.br/schema/evt/evtMonit/v_S_01_00_00">
      <evtMonit Id="ID2024734999000002022031415073500001">
        <ideEvento>
          <indRetif>1</indRetif>
          <tpAmb>1</tpAmb>
          <procEmi>1</procEmi>
          <verProc>v1.000</verProc>
        </ideEvento>
        <ideEmpregador>
          <tpInsc>2</tpInsc>
          <nrInsc>99999999999</nrInsc>
        </ideEmpregador>
        <ideVinculo>
          <cpfTrab>88888888888</cpfTrab>
          <matricula>000999_FL09999488800999</matricula>
        </ideVinculo>
      <exMedOcup>
          <tpExameOcup>1</tpExameOcup>
          <aso>
            <dtAso>2022-03-11</dtAso>
            <exame>
              <dtExm>2022-03-11</dtExm>
              <procRealizado>0069</procRealizado>
            </exame>
            <exame>
              <dtExm>2022-03-11</dtExm>
              <procRealizado>0295</procRealizado>
            </exame>
            <medico>
              <nmMed>Jose do Teste</nmMed>
              <nrCRM>143.546</nrCRM>
              <ufCRM>SP</ufCRM>
            </medico>
          </aso>
          <respMonit>
            <cpfResp>77777777777</cpfResp>
            <nmResp>Fernando do Teste</nmResp>
            <nrCRM>99999</nrCRM>
            <ufCRM>SP</ufCRM>
          </respMonit>
        </exMedOcup>
      </evtMonit>
    </eSocial>

Caso o XML de envio estiver fora da estrutura, a API eSocial irá retornar um mensagem de erro no seguinte formato:

{

"error": {

"message": "Campo \"xml\" é inválido para o e-Social."

}

Para maiores informações sobre a rota de envio acesse o link.

Bem-vindo(a) ao Suporte da Tecnospeed

Artigos nessa seção

Comentários

Artigos nessa seção

Artigos relacionados