Pular para o conteúdo principal

Serviço eCarta

Serviço destinado ao módulo negocial eCarta. O serviço é uma solução de captação eletrônica dos dados da mensagem que depois são processados para o meio físico pelos Correios, automatizando o envio e retorno de correspondências.

Como funciona

O serviço eCarta recebe informações e retorna relatórios via interface REST, e realiza o retorno de documentos via MNI.

Configuração do tribunal no eCarta

Pode-se configurar o serviço eCarta para um tribunal através de serviço disponível em /api/v1/configuracoes.

Monitoramento de batch e relatórios

Os relatórios de execução dos batchs do eCarta são obtidos via serviços disponíveis em /api/v1/jobs.

Relatórios negociais

Os relatórios negociais do eCarta são obtidos via serviços disponíveis em /api/v1/relatorio.

Retorno via MNI

O eCarta retorna documentos por meio do mni-client-service.

Fluxo básico do sistema

Imagem do fluxo básico do eCarta

Testes

ATENÇÃO!

Somente será dado acesso ao código fonte deste projeto àqueles que efetivamente irão contribuir com o seu desenvolvimento. Portanto, é necessário haver pelo menos uma demanda aberta no sistema de controle de demandas (Jira) para o projeto PJEECT.

Remoto

Acesse a API em https://gateway.stg.cnj.cloud/ecarta-service/swagger-ui.html.

Local

Execute o comando abaixo:
docker container run --rm --name ecarta -it -p 8880:8880 \
registry.cnj.jus.br/pje2/pje2-servicos/ecarta:latest
VariávelValor padrãoDescrição
SERVER_PORT8880Porta do serviço.
SSO_AUTH_SERVERhttp://localhost:8080/authURL do Keycloak.
SSO_REALMpjeRealm da aplicação no Keycloak.
SSO_RESOURCEecarta-serviceResource no keycloak.
DB_DRIVERorg.h2.DriverDriver do banco de dados.
DB_URLjdbc:h2:mem:mydb;DB_CLOSE_ON_EXIT=FALSEURL do banco.
DB_USERsaUsuário do banco.
DB_PASSWORDSenha de acesso ao banco.
EUREKA_SERVER_DEFAULT_ZONEhttp://localhost:8761/eurekaUrl do service discovery
EUREKA_CLIENT_ENABLEDtrueIndicativo de que o serviço deve ou não se registrar no service discovery.

Tecnologias empregadas

O serviço eCarta foi construído com SpringBoot 2. Este serviço fornece API para manipulação e recuperação de seus recursos utilizando REST. Utiliza o banco de dados PostgreSQL.

Linguagem de programação

Java versão 11.

Framework

SpringBoot 2.

Armazenamento dos dados

Banco relacional PostgreSQL.

Outros temas

Os logs da aplicação podem ser enviados à um serviço REDIS para que seja consumido pelo Logstash e indexado no ElasticSearch.

Os logs de auditoria da aplicação são armazenados no banco de dados e disponibilizados via API, concedendo acesso por tribunal conforme configurado no Keycloak.

Comunidade

Dúvidas

Faça parte da nossa comunidade no RocketChat! Acesse https://rocketchat.cloud.pje.jus.br/channel/ecarta.

Requisição de melhorias e correções de defeitos

Pode-se abrir uma demanda no sistema Jira para o projeto PJEECT.