This project has not provided a description yet.
The project's README from github.com/ReceitaFederal/calculadora-rtc-simples-nacional. As one markdown file: README.md.
API REST que realiza o cálculo da CBS e do IBS (Reforma Tributária do Consumo — LC 214/2025) nas operações do regime do simples nacional.
Todos os caminhos começam com http://localhost:8082/api. A lista completa, com esquemas e exemplos, está no Swagger (http://localhost:8082/api/swagger-ui.html).
| Funcionalidade | Endpoint |
|---|---|
| Cálculo do Simples Nacional com observabilidade (erros por item, sem interromper os demais) | POST /calculadora/observabilidade/simples-nacional |
Descrição de um código de erro VSN- |
GET /calculadora/observabilidade/simples-nacional/erros?codigo=VSN-001 |
| Atividades do Simples Nacional vigentes em uma data, com filtros por anexo, tipo de documento e cClassTrib | GET /calculadora/simples-nacional/atividades?data=AAAA-MM-DD |
| Consulta de uma atividade pelo código, vigente na data | GET /calculadora/simples-nacional/atividades/{codigo}?data=AAAA-MM-DD |
| Informações de versão da aplicação, da base de dados e do ambiente | GET /versao |
| Status da versão no perfil offline, comparado à instalação online | GET /versao/status (somente perfil offline) |
mvnw / mvnw.cmd) baixa a versão necessária na primeira execução (requer internet)O projeto utiliza as seguintes tecnologias:
Certifique-se de ter instalado o Java 21 ou superior e verifique as versões:
# Verificar versão do Java
java -version
git clone https://github.com/ReceitaFederal/calculadora-rtc-simples-nacional.git
cd calculadora-rtc-simples-nacional
O perfil offline lê o banco ./calculadora/db/calculadora-pro.db, definido por application.db.filename em application-offline.yml. O caminho é relativo à raiz do projeto e o banco é aberto em modo somente leitura.
Atenção: use os scripts SQL para gerar o arquivo do Banco de Dados localizados no repositório https://github.com/ReceitaFederal/calculadora-rtc-simples-nacional.git
Atenção: a aplicação só funciona se o banco estiver gerado. Sem ele, o perfil offline não inicia.
Copie para a raiz deste projeto a pasta flyway/ presente no repositório https://github.com/ReceitaFederal/calculadora-rtc-simples-nacional.git
Linux/macOS:
mkdir -p ./calculadora/db
./mvnw flyway:migrate -Dflyway.configFiles=./flyway/flyway-pro.conf --batch-mode --errors
Windows:
mkdir calculadora\db
mvnw.cmd flyway:migrate -Dflyway.configFiles=flyway\flyway-pro.conf --batch-mode --errors
Confirme que o arquivo foi criado com ls -lah ./calculadora/db/calculadora-pro.db (Linux/macOS) ou dir calculadora\db\calculadora-pro.db (Windows).
Os testes exigem o banco gerado no passo 3, pois a maioria são testes de integração com o perfil testes.
Executar todos os testes com relatório de cobertura (JaCoCo):
Linux/macOS:
./mvnw clean test jacoco:report
Windows:
mvnw.cmd clean test jacoco:report
O relatório de cobertura fica em target/site/jacoco/index.html.
Linux/macOS:
./mvnw spring-boot:run -Dspring-boot.run.profiles=offline
Windows:
mvnw.cmd spring-boot:run "-Dspring-boot.run.profiles=offline"
A aplicação estará disponível em http://localhost:8080/api.
Linux/macOS:
./mvnw clean package
java -Dspring.profiles.active=offline -jar target/api-regime-geral.jar
Windows:
mvnw.cmd clean package
java "-Dspring.profiles.active=offline" -jar target\api-regime-geral.jar
Execute o JAR a partir da raiz do projeto, para que ./calculadora/db seja encontrado.
Este projeto é distribuído sob a licença especificada no arquivo LICENSE.
This project has not provided a description yet.