Descrição do pacote
Envia as informações do e-social com um conjunto de funções simples e intuitiva que irão simplificar o processo de emissão, assinatura e transmissão dos XMLs do e-social nas suas versões mais recentes. Compatível com certificados A1 (arquivo), A3 (cartão ou token) e com certificados instalados no Windows (MS CAPI). Com um agente especial que permite a execução das funções na camada cliente, mesmo em navegadores sem suporte a Java (Windows).
Ambientes suportados
A API trabalha no ambiente de produção (Ambiente de Produção – 1) e testes (Ambiente de Produção Restrita – 2), conforme documentação do e-Social.
- https://www.gov.br/esocial/pt-br/noticias/esocial-simplificado-ambiente-de-testes-em-producao-restrita-estara-disponivel-para-todas-as-empresas-a-partir-de-03-de-marco
- https://www.gov.br/esocial/pt-br/acesso-ao-sistema/ambiente-de-producao-restrita
- http://www.guiatrabalhista.com.br/tematicas/esocial-ambiente-producao-restrita.htm
Funções que integram o pacote
Geral
- eSocial – Inicializar Conexão: Permite conexão com certificados A1, A3 e Microsoft CryptoAPI (MS-CAPI);
e-Social
- eSocial – Assinar XML: Função de assinatura de XML;
- eSocial – Enviar Lote de Eventos: Faz a comunicação do WebService;
- eSocial – Consultar Lote de Eventos: Faz a comunicação do WebService;
- eSocial – XML – Montar Lote de Eventos;
- eSocial – XML – Criar Evento;
- eSocial – XML – Adicionar Elemento;
- eSocial – XML – Processar XML: Processar a resposta do e-Social.
Reinf
- EFD-Reinf – Consultar Lote;
- EFD-Reinf – Enviar Lote;
- EFD-Reinf – Consultas Reinf;
- EFD-Reinf – Consultas Recibo Evento.
Últimas versões
As últimas versões publicadas podem ser baixadas nos links abaixo:
- API de Integração com e-Social versão 1.8.4 publicada em 24/07/2024
- API de Integração com e-Social versão 1.8.0 publicada em 23/01/2024
- API de Integração com e-Social versão 1.7.4 publicada em 20/10/2023
- API de Integração com e-Social versão 1.7.1 publicada em 28/09/2023
- API de Integração com e-Social versão 1.7.0 publicada em 18/08/2023
Como instalar ou Atualizar
Para instalar basta baixar a versão mais recente se seguir os passos abaixo descritos, a atualização segue o mesmo roteiro, substituindo os arquivos e/ou funções existentes com os novos.
Maker
- Acesso o sistema onde deseja adicionar as funções do e-Social;
- Feche o editor de fluxos, e o cadastro de funções se estiverem abertos;
- Importe o arquivo ‘l2s-api-esocial-v*.frz’;
- Abra o edito de fluxos e procure pela nova categoria ‘e-Social (L2S)’;
- Pronto! Basta instalar no Webrun e usar a nova função.
Webrun
- Instale a biblioteca básica em sua versão mais recente;
- Copie o conteúdo da pasta Maker.Commons para a pasta
[WEBRUN]\systems\Maker.Commons (crie-a se não existir); - Reinicie o Tomcat do Webrun;
- Acesse o sistema (1a vez);
- Reinicie novamente o Tomcat do Webrun (segunda vez);
- Acesse o sistema novamente;
- Pronto! As bibliotecas estão instaladas.
- NOTA 1: Sempre que atualizar ou republicar o Webrun será necessário acessar, e em seguida reiniciar o Webrun uma vez para que as bibliotecas sejam carregadas.
- NOTA 2: Quando publicar seu sistema com JAR certifique-se de levar junto a pasta ‘Maker.Commons’.
DICAS e INSTRUÇÕES DE USO
VERSÃO DE AVALIAÇÃO
- A versão de avaliação apresenta uma ou mais das seguintes limitações:
- Só emite documentos nos ambientes de homologação;
- Restrições de dados nos XML enviados.