Websevices
Webservices XML
Os webservices para envio dos eventos XMLs são feitos baseado nas especificações oficiais dos webservices do governo, seguindo os WSDLs oficiais.
Manual de orientação do desenvolvedor do eSocial
Autenticação
Para utilização dos webservices é necessário a autenticação utilizando o protocolo "Basic"
Utilizando como usuário o valor do campo GRUPO e a senha o valor do campo TOKEN
Para mais detalhes https://en.wikipedia.org/wiki/Basic_access_authentication
Solicitar estes dados para a Compliance
Envio de requisição
Produção: https://apiesocial.compliancehcm.com.br/vch-esocial/envialote?wsdl
Homologação: https://hml-apiesocial.compliancehcm.com.br/vch-esocial/envialote?wsdl
Headers:
- Content-Type: application/xml
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/v1_1_0">
<soapenv:Header/>
<soapenv:Body>
<EnviarLoteEventos>
<loteEventos>
<eSocial xmlns="http://www.esocial.gov.br/schema/lote/eventos/envio/v1_1_1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<envioLoteEventos grupo="1">
<ideEmpregador>
<tpInsc>1</tpInsc>
<nrInsc>36635643</nrInsc> <!-- Base do CNPJ da Empresa -->
</ideEmpregador>
<ideTransmissor>
<tpInsc>1</tpInsc>
<nrInsc>36635643000159</nrInsc> <!-- CNPJ completo da matriz da empresa -->
</ideTransmissor>
<eventos>
<evento Id="ID1203198330000002023012511584600001">
<!-- XML DO EVENTO -->
<eSocial xmlns="http://www.esocial.gov.br/schema/evt/evtTabRubrica/v_S_01_00_00"><evtTabRubrica Id="ID1203198330000002023012511584600001"><ideEvento><tpAmb>1</tpAmb><procEmi>1</procEmi><verProc>S 1.0</verProc></ideEvento><ideEmpregador><tpInsc>1</tpInsc><nrInsc>20319833</nrInsc></ideEmpregador><infoRubrica><inclusao><ideRubrica><codRubr>426</codRubr><ideTabRubr>TABRUBRI</ideTabRubr><iniValid>2021-04</iniValid></ideRubrica><dadosRubrica><dscRubr>FALTAS ESTAGIARIO</dscRubr><natRubr>9209</natRubr><tpRubr>2</tpRubr><codIncCP>00</codIncCP><codIncIRRF>11</codIncIRRF><codIncFGTS>00</codIncFGTS><tetoRemun>S</tetoRemun></dadosRubrica></inclusao></infoRubrica></evtTabRubrica></eSocial>
</evento>
<evento Id="ID1203198330000002023012511584600001">
<!-- XML DO EVENTO -->
<eSocial xmlns="http://www.esocial.gov.br/schema/evt/evtTabRubrica/v_S_01_00_00"><evtTabRubrica Id="ID1203198330000002023012511584600001"><ideEvento><tpAmb>1</tpAmb><procEmi>1</procEmi><verProc>S 1.0</verProc></ideEvento><ideEmpregador><tpInsc>1</tpInsc><nrInsc>20319833</nrInsc></ideEmpregador><infoRubrica><inclusao><ideRubrica><codRubr>426</codRubr><ideTabRubr>TABRUBRI</ideTabRubr><iniValid>2021-04</iniValid></ideRubrica><dadosRubrica><dscRubr>FALTAS ESTAGIARIO</dscRubr><natRubr>9209</natRubr><tpRubr>2</tpRubr><codIncCP>00</codIncCP><codIncIRRF>11</codIncIRRF><codIncFGTS>00</codIncFGTS><tetoRemun>S</tetoRemun></dadosRubrica></inclusao></infoRubrica></evtTabRubrica></eSocial>
</evento>
</eventos>
</envioLoteEventos>
</eSocial>
</loteEventos>
</EnviarLoteEventos>
</soapenv:Body>
</soapenv:Envelope>
Resposta:
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:i0="http://www.esocial.gov.br/servicos/empregador/enviarloteeventos/v1_1_0"
xmlns:msc="http://schemas.microsoft.com/ws/2005/12/wsdl/contract"
xmlns:tns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/v1_1_0"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<soap:Body>
<EnviarLoteEventosResponse
xmlns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/v1_1_0">
<EnviarLoteEventosResult>
<eSocial
xmlns="http://www.esocial.gov.br/schema/lote/eventos/envio/retornoEnvio/v1_1_0"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<retornoEnvioLoteEventos>
<status>
<cdResposta>201</cdResposta>
<descResposta>Lote Recebido com sucesso.</descResposta>
</status>
<dadosRecepcaoLote>
<dhRecepcao>2022-10-05T21:11:07-0300</dhRecepcao>
<versaoAplicativoRecepcao>1.0.0</versaoAplicativoRecepcao>
<protocoloEnvio>3.2.102022.05102022211107520</protocoloEnvio>
</dadosRecepcaoLote>
</retornoEnvioLoteEventos>
</eSocial>
</EnviarLoteEventosResult>
</EnviarLoteEventosResponse>
</soap:Body>
</soap:Envelope>
Consulta do Resultado do Protocolo
Produção: https://apiesocial.compliancehcm.com.br/vch-esocial/consultalote?wsdl
Homologação: https://hml-apiesocial.compliancehcm.com.br/vch-esocial/consultalote?wsdl
Headers:
- Content-Type: application/xml
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<ConsultarLoteEventos xmlns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/consulta/retornoProcessamento/v1_1_0">
<consulta>
<eSocial xmlns="http://www.esocial.gov.br/schema/lote/eventos/envio/consulta/retornoProcessamento/v1_0_0">
<consultaLoteEventos>
<protocoloEnvio>3.2.102022.05102022211107520</protocoloEnvio>
</consultaLoteEventos>
</eSocial>
</consulta>
</ConsultarLoteEventos>
</Body>
</Envelope>
Resposta: Lote em processamento
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:msc="http://schemas.microsoft.com/ws/2005/12/wsdl/contract"
xmlns:i0="http://www.esocial.gov.br/servicos/empregador/lote/eventos/consultar/v1_1_0"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
xmlns:tns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/consulta/retornoProcessamento/v1_1_0">
<soap:Body>
<ConsultarLoteEventosResponse
xmlns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/consulta/retornoProcessamento/v1_1_0">
<ConsultarLoteEventosResult>
<eSocial
xmlns="http://www.esocial.gov.br/schema/lote/eventos/envio/retornoProcessamento/v1_1_0">
<retornoProcessamentoLoteEventos>
<ideEmpregador>
<tpInsc>1</tpInsc>
<nrInsc>36635643</nrInsc>
</ideEmpregador>
<ideTransmissor>
<tpInsc>1</tpInsc>
<nrInsc>36635643000159</nrInsc>
</ideTransmissor>
<status>
<cdResposta>101</cdResposta>
<descResposta>Lote aguardando processamento.</descResposta>
</status>
<dadosRecepcaoLote>
<dhRecepcao>2023-01-27T18:14:22-0300</dhRecepcao>
<versaoAplicativoRecepcao>1.0.0</versaoAplicativoRecepcao>
<protocoloEnvio>3.2.102022.05102022211107520</protocoloEnvio>
</dadosRecepcaoLote>
</retornoProcessamentoLoteEventos>
</eSocial>
</ConsultarLoteEventosResult>
</ConsultarLoteEventosResponse>
</soap:Body>
</soap:Envelope>
Lote com erro
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:msc="http://schemas.microsoft.com/ws/2005/12/wsdl/contract"
xmlns:i0="http://www.esocial.gov.br/servicos/empregador/lote/eventos/consultar/v1_1_0"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
xmlns:tns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/consulta/retornoProcessamento/v1_1_0">
<soap:Body>
<ConsultarLoteEventosResponse
xmlns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/consulta/retornoProcessamento/v1_1_0">
<ConsultarLoteEventosResult>
<eSocial
xmlns="http://www.esocial.gov.br/schema/lote/eventos/envio/retornoProcessamento/v1_1_0">
<retornoProcessamentoLoteEventos>
<ideEmpregador>
<tpInsc>1</tpInsc>
<nrInsc>36635643</nrInsc>
</ideEmpregador>
<ideTransmissor>
<tpInsc>1</tpInsc>
<nrInsc>36635643000159</nrInsc>
</ideTransmissor>
<status>
<cdResposta>201</cdResposta>
<descResposta>Lote processado com sucesso.</descResposta>
</status>
<dadosRecepcaoLote>
<dhRecepcao>2023-01-27T18:27:06-0300</dhRecepcao>
<versaoAplicativoRecepcao>1.0.0</versaoAplicativoRecepcao>
<protocoloEnvio>3.2.012019.11012019161601491</protocoloEnvio>
</dadosRecepcaoLote>
<retornoEventos>
<evento Id="ID1037296270000002019011111204500000-4">
<retornoEvento>
<eSocial
xmlns="http://www.esocial.gov.br/schema/evt/retornoEvento/v1_2_0">
<retornoEvento Id="ID1037296270000002019011114160300001">
<ideEmpregador>
<tpInsc>1</tpInsc>
<nrInsc>36635643</nrInsc>
</ideEmpregador>
<recepcao>
<tpAmb>1</tpAmb>
<dhRecepcao>2019-01-11T14:16:06.543</dhRecepcao>
<versaoAppRecepcao>0.1.0-A0352</versaoAppRecepcao>
<protocoloEnvioLote>1.1.201901.0000000000272987586</protocoloEnvioLote>
</recepcao>
<processamento>
<cdResposta>401</cdResposta>
<descResposta>Conteudo do evento inválido.</descResposta>
<versaoAppProcessamento>10.0.1-A3912</versaoAppProcessamento>
<dhProcessamento>2019-01-11T14:16:06.663</dhProcessamento>
<ocorrencias>
<ocorrencia>
<tipo>1</tipo>
<codigo>271</codigo>
<descricao>Os Horários/Turnos de Trabalho não existem no cadastro do empregador.
Ações Sugeridas:
- Verifique se os Horários/Turnos de Trabalho estão cadastrados na tabela de Horários/Turnos de Trabalho;
- Verifique o preenchimento das informações referentes aos Horários/Turnos de Trabalho informados.</descricao>
<localizacao>/eSocial/evtAltContratual/altContratual/infoContrato/horContratual/horario[1]/codHorContrat</localizacao>
</ocorrencia>
</ocorrencias>
</processamento>
</retornoEvento>
</eSocial>
</retornoEvento>
</evento>
</retornoEventos>
</retornoProcessamentoLoteEventos>
</eSocial>
</ConsultarLoteEventosResult>
</ConsultarLoteEventosResponse>
</soap:Body>
</soap:Envelope>
Lote com sucesso
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:msc="http://schemas.microsoft.com/ws/2005/12/wsdl/contract"
xmlns:i0="http://www.esocial.gov.br/servicos/empregador/lote/eventos/consultar/v1_1_0"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
xmlns:tns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/consulta/retornoProcessamento/v1_1_0">
<soap:Body>
<ConsultarLoteEventosResponse
xmlns="http://www.esocial.gov.br/servicos/empregador/lote/eventos/envio/consulta/retornoProcessamento/v1_1_0">
<ConsultarLoteEventosResult>
<eSocial
xmlns="http://www.esocial.gov.br/schema/lote/eventos/envio/retornoProcessamento/v1_1_0">
<retornoProcessamentoLoteEventos>
<ideEmpregador>
<tpInsc>1</tpInsc>
<nrInsc>36635643</nrInsc>
</ideEmpregador>
<ideTransmissor>
<tpInsc>1</tpInsc>
<nrInsc>36635643000159</nrInsc>
</ideTransmissor>
<status>
<cdResposta>201</cdResposta>
<descResposta>Lote processado com sucesso.</descResposta>
</status>
<dadosRecepcaoLote>
<dhRecepcao>2023-01-27T18:22:26-0300</dhRecepcao>
<versaoAplicativoRecepcao>1.0.0</versaoAplicativoRecepcao>
<protocoloEnvio>3.2.102022.05102022211107520</protocoloEnvio>
</dadosRecepcaoLote>
<retornoEventos>
<evento Id="ID1017112820000002019020711211700008-1">
<retornoEvento>
<eSocial
xmlns="http://www.esocial.gov.br/schema/evt/retornoEvento/v1_2_0">
<retornoEvento Id="ID1017112820000002019020712541200014">
<ideEmpregador>
<tpInsc>1</tpInsc>
<nrInsc>36635643</nrInsc>
</ideEmpregador>
<recepcao>
<tpAmb>1</tpAmb>
<dhRecepcao>2019-02-07T14:14:44.01</dhRecepcao>
<versaoAppRecepcao>0.1.0-A0352</versaoAppRecepcao>
<protocoloEnvioLote>1.1.201902.0000000000999999999</protocoloEnvioLote>
</recepcao>
<processamento>
<cdResposta>201</cdResposta>
<descResposta>Sucesso.</descResposta>
<versaoAppProcessamento>11.0.0-A3989</versaoAppProcessamento>
<dhProcessamento>2019-02-07T14:16:16.667</dhProcessamento>
</processamento>
<recibo>
<nrRecibo>1.1.0000000009999999999</nrRecibo>
<hash>zWKQd/2b0WurZQT29R28PWZaRqlkqaNmBcYl6+4seGM=</hash>
</recibo>
</retornoEvento>
</eSocial>
</retornoEvento>
</evento>
</retornoEventos>
</retornoProcessamentoLoteEventos>
</eSocial>
</ConsultarLoteEventosResult>
</ConsultarLoteEventosResponse>
</soap:Body>
</soap:Envelope>