How andreramosleite1982/calculadora-rtc-simples-nacional works
This is a REST API for calculating CBS and IBS taxes on Simples Nacional operations, with activity lookup, item-level observability, error descriptions, and version reporting. The main workflow accepts an operation, validates its global and item data, resolves applicable parameters and rates, processes items, and returns calculation results and totals. The excerpts establish several calculation-layer relationships; controller wiring and some storage details are not shown, so those links are omitted or marked unverified.
Main entry points: SimplesNacionalController.java Simples API · SimplesNacionalObservabilidadeService.java Operation validation · VersaoOfflineService.java Offline status · AtividadeSimplesController.java Activity API
Components 22
API and Observability
- Simples API
src/main/java/br/gov/serpro/rtc/api/simplesnacional/controller/SimplesNacionalController.java - Operation input
src/main/java/br/gov/serpro/rtc/api/simplesnacional/model/input/OperacaoSimplesInput.java - Operation validation
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalObservabilidadeService.java - Observable result
src/main/java/br/gov/serpro/rtc/api/simplesnacional/model/output/ObservabilidadeSimplesDomain.java - Error descriptions
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalErroService.java
Activities
- Activity API
src/main/java/br/gov/serpro/rtc/api/atividadesimples/controller/AtividadeSimplesController.java - Activity lookup
src/main/java/br/gov/serpro/rtc/api/atividadesimples/service/AtividadeSimplesService.java - Activity records
src/main/java/br/gov/serpro/rtc/api/atividadesimples/entity/AtividadeSimplesNacional.java - Activity repository
src/main/java/br/gov/serpro/rtc/api/atividadesimples/repository/AtividadeSimplesRepository.java
Tax Calculation
- Item processing
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/ProcessadorItemSimples.java - Unified calculation
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/CalculoSimplesUnificadoService.java - Calculation parameters
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/ParametroCalculoSimplesService.java - Rate selection
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/EscolhaParAliquotasService.java - Tax computation
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalCalculoService.java
Tax Reference Data
- Nomenclature validation
src/main/java/br/gov/serpro/rtc/domain/service/ValidacaoNomenclaturaService.java - Nomenclature lookup
src/main/java/br/gov/serpro/rtc/domain/service/NomenclaturaService.java - Embedded database
Version Status
- Version API
src/main/java/br/gov/serpro/rtc/api/versao/controller/VersaoController.java - Version reporting
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoService.java - Offline status
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoOfflineService.java
Other components
- API client
- Online version service
Connections 16
- API client → Simples API: submits operation
README.md - Simples API → Operation input: accepts payload
src/main/java/br/gov/serpro/rtc/api/simplesnacional/controller/SimplesNacionalController.java - Simples API → Operation validation: dispatches calculation
src/main/java/br/gov/serpro/rtc/api/simplesnacional/controller/SimplesNacionalController.java - Operation validation → Item processing: processes items
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalObservabilidadeService.java - Item processing → Tax computation: delegates calculation
- Operation validation → Observable result: builds response
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalObservabilidadeService.java - API client → Activity API: requests activities
README.md - Activity API → Activity lookup: dispatches lookup
src/main/java/br/gov/serpro/rtc/api/atividadesimples/controller/AtividadeSimplesController.java - Activity lookup → Activity repository: queries records
src/main/java/br/gov/serpro/rtc/api/atividadesimples/service/AtividadeSimplesService.java - Activity repository → Activity records: reads
src/main/java/br/gov/serpro/rtc/api/atividadesimples/repository/AtividadeSimplesRepository.java - Nomenclature validation → Nomenclature lookup: checks nomenclature
src/main/java/br/gov/serpro/rtc/domain/service/ValidacaoNomenclaturaService.java - Nomenclature lookup → Embedded database: reads reference data
- API client → Version API: requests version
README.md - Version API → Version reporting: dispatches lookup
- Offline status → Version reporting: compares local version
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoOfflineService.java - Offline status → Online version service: queries remotely
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoOfflineService.java