eMensageria

eMensageria - Sistema de Mensageria Opensource do eSocial <www.emensageria.com.br> (em desenvolvimento)

Versões eMensageria

• 1.0 (eSocial versão S-1.0 - Leiautes (cons. até NT 01/2021))
• 1.1 (eSocial versão S-1.0 - Leiautes (cons. até NT 02/2021))
• 1.2 (eSocial versão S-1.0 - Leiautes (cons. até NT 03/2021))

Versões compatíveis do eSocial

• S 1.0

Requisitos de Sistema

• Python (versão 3.8.5);
• Django (versão 3.2);
• Postgres 12;
• outros requisitos no arquivo requirements.txt

Instalação em ambiente em ambiente de desenvolvimento

PASSO-A-PASSO SIMPLIFICADO, EXIGE CONHECIMENTOS TÉCNICOS.

• Crie o banco de dados em postgres:

host: localhost
name: emensageria
user: postgres
pass: postgres
port: 5432

• Faça o clone do repositório

git clone https://github.com/marcelomdevasconcellos/emensageria.git

• Crie e ative a virtualenv

python3 -m venv venv_emensageria
source venv_emensageria/bin/activate

• Acesse a pasta do repositório

cd emensageria

• Instale os requirements

pip install -r requirements.txt

• Inclua e edite as variáveis

cp config/.env_example config/.env
nano config/.env

• Altere as variáveis de acordo com seu ambiente: veja o arquivo no endereço https://github.com/marcelomdevasconcellos/emensageria/blob/main/config/.env_example
• Crie as tabelas no banco de dados

python manage.py migrate

• Crie do super usuário

python manage.py createsuperuser

• Acesse o sistema

http://localhost:8000/

O resto é configurações pelo sistema. Siga a sequência:

1. Certificado
2. Transmissor
3. Eventos ...

APIs

Atenção: O apache deverá estar configurado para passar o headers para o Django, para isso inclua a configuração abaixo no servidor de produção.

WSGIPassAuthorization On

Gerar token via GET:

• URL: http://localhost:8000/api-token-auth/
• Exemplo CURL (gerando token via requisição GET):

curl --data "username=admin&password=admin"
http://localhost:8000/api-token-auth/?format=json

• Exemplo CURL (gerando token via requisição REST):

curl -d '{"username":"admin", "password":"admin"}' -H "Content-Type:
application/json" -X POST http://localhost:8000/api-token-auth/?format=json

Consulta de eventos

• URL: http://localhost:8000/esocial/api/eventos/
• Metódos: 'get', 'put', 'patch', 'post', 'head'
• Exemplo CURL:

curl -X GET http://localhost:8000/esocial/api/eventos/?format=json -H
'Authorization: Token <token>'

• Filtros:

http://localhost:8000/esocial/api/eventos/?format=json&user_id=1&identidade=ID1346866130001462021062221014900001

Executando funções nos eventos individualmente ou consultando e alterando

• URL: http://localhost:8000/esocial/api/eventos/<evento_id>/
• Exemplo CURL:

curl -X GET http://localhost:8000/esocial/api/eventos/1/?format=json -H
'Authorization: Token <token>'

• Funções:

http://localhost:8000/esocial/api/eventos/<evento_id>/atualizar-identidade/?format=json
http://localhost:8000/esocial/api/eventos/<evento_id>/abrir-evento-para-edicao/?format=json
http://localhost:8000/esocial/api/eventos/<evento_id>/validar/?format=json
http://localhost:8000/esocial/api/eventos/<evento_id>/enviar/?format=json
http://localhost:8000/esocial/api/eventos/<evento_id>/consultar/?format=json

Validando eventos em lote

• URL: http://localhost:8000/esocial/validar-eventos/
• Exemplo CURL:

curl -X GET http://localhost:8000/esocial/validar-eventos/ -H
'Authorization: Token <token>'

Enviando eventos para o eSocial em lote

• Inclua esta chamada em uma CRON para que possa ser realizada periodicamente
• URL: http://localhost:8000/esocial/enviar-transmissores/
• Exemplo CURL:

curl -X GET http://localhost:8000/esocial/enviar-transmissores/ -H 'Authorization:
Token <token>'

• Exemplo em linha de comando:

python manage.py esocial_enviar

Consultando eventos no eSocial em lote

• Inclua esta chamada em uma CRON para que possa ser realizada periodicamente
• URL: http://localhost:8000/esocial/consultar-transmissores/
• Exemplo CURL:

curl -X GET http://localhost:8000/esocial/consultar-transmissores/ -H
'Authorization: Token <token>'

• Exemplo em linha de comando:

python manage.py esocial_consultar

Licença AGPL-3

eMensageria - Sistema de Mensageria Opensource do eSocial Copyright (C) 2021 Marcelo Medeiros de Vasconcellos

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Backlog

• Docker
• Impressão de recibos de transmissores
• Impressão e geração de relatórios
• Importação e recuperação de arquivos

Contato

Marcelo Medeiros de Vasconcellos marcelomdevasconcellos@gmail.com

Para maiores informações acesse: www.emensageria.com.br