How receitafederal/calculadora-rtc-simples-nacional works
This is a REST API for calculating CBS/IBS tax on Simples Nacional operations, alongside activity-catalog and version endpoints. The primary workflow accepts an operation, processes items with per-item observability, and returns calculation results and errors; the README documents the calculation capabilities, while excerpts show the controller dispatch and portions of processing. The graph also preserves activity lookup and version/status branches. Some service and repository wiring is supported by the source index rather than full excerpts; uncertain calculation-service wiring is marked dashed.
Main entry points: SimplesNacionalObservabilidadeService.java Item processing · AtividadeSimplesService.java Activity lookup · SimplesNacionalController.java Calculation API · VersaoOfflineService.java Offline comparison
Components 20
Tax calculation
- Calculation 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 - Item processing
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalObservabilidadeService.java - Item collector
src/main/java/br/gov/serpro/rtc/api/simplesnacional/collector/ItemCollectorSimples.java - Tax calculation
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalCalculoService.java - Calculation 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
Activity catalog
- 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 parameters
- Parameter lookup
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/ParametroCalculoSimplesService.java - Parameter repositories
src/main/java/br/gov/serpro/rtc/api/simplesnacional/repository - Tax database
Version status
- Version API
src/main/java/br/gov/serpro/rtc/api/versao/controller/VersaoController.java - Version service
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoService.java - Database version
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoBaseDadosService.java - Offline comparison
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoOfflineService.java
Other components
- API client
- Online installation
Connections 20
- API client → Calculation API: submits operation
README.md - Calculation API → Item processing: processes operation
src/main/java/br/gov/serpro/rtc/api/simplesnacional/controller/SimplesNacionalController.java - Calculation API → Operation input: accepts input
src/main/java/br/gov/serpro/rtc/api/simplesnacional/controller/SimplesNacionalController.java - Item processing → Item collector: collects item results
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalObservabilidadeService.java - Item processing → Tax calculation: delegates calculation
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalObservabilidadeService.java - Item processing → Parameter lookup: resolves parameters
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalObservabilidadeService.java - Item processing → Calculation result: returns results
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/SimplesNacionalObservabilidadeService.java - API client → Activity API: requests activities
README.md - Activity API → Activity lookup: queries activities
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 lookup → Activity records: maps activities
src/main/java/br/gov/serpro/rtc/api/atividadesimples/service/AtividadeSimplesService.java - Activity lookup → Parameter lookup: checks parameters
src/main/java/br/gov/serpro/rtc/api/atividadesimples/service/AtividadeSimplesService.java - Parameter lookup → Parameter repositories: queries parameters
src/main/java/br/gov/serpro/rtc/api/simplesnacional/service/ParametroCalculoSimplesService.java - Parameter repositories → Tax database: reads tax data
- API client → Version API: requests version
README.md - Version API → Version service: gets version
- Version service → Database version: gets database version
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoService.java - API client → Offline comparison: checks offline status
README.md - Offline comparison → Version service: gets local version
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoOfflineService.java - Offline comparison → Online installation: compares online version
src/main/java/br/gov/serpro/rtc/api/versao/service/VersaoOfflineService.java