How receitafederal/calculadora-rtc-regime-regular works
Calculadora de Tributos is a Spring REST API for calculating CBS, IBS and Imposto Seletivo, looking up official tax tables, and generating or validating fiscal-document XML. The main request flow accepts an operation, processes and validates its items, calculates taxes, and returns a consolidated result. Separate API branches provide unified tax bases, NFS-e services, open-data lookups, toll calculations, and offline-version/download functions. The graph reflects README capabilities and sampled/indexed source; unsampled controller wiring and several auxiliary branches are shown only as unverified dashed links.
Main entry points: CalculoCbsIbsService.java CBS IBS calculation · BaseCalculoController.java Base controllers · controller Auxiliary controllers · CalculadoraTributoController.java Tax controller
Components 25
REST API
- Application
src/main/java/br/gov/serpro/rtc/CalculadoraTributoApplication.java - Tax controller
src/main/java/br/gov/serpro/rtc/api/controller/CalculadoraTributoController.java - Base controllers
src/main/java/br/gov/serpro/rtc/api/controller/BaseCalculoController.java - Open-data controller
src/main/java/br/gov/serpro/rtc/api/controller/DadosAbertosController.java - XML controller
src/main/java/br/gov/serpro/rtc/api/controller/XMLController.java - NFS-e controller
src/main/java/br/gov/serpro/rtc/api/controller/NfseController.java - Auxiliary controllers
src/main/java/br/gov/serpro/rtc/api/controller - Operation input
src/main/java/br/gov/serpro/rtc/api/model/input/ItemOperacaoInput.java
Tax Calculation
- Item validation
src/main/java/br/gov/serpro/rtc/domain/service/ProcessamentoItemService.java - CBS IBS calculation
src/main/java/br/gov/serpro/rtc/domain/service/calculotributo/CalculoCbsIbsService.java - Tax orchestration
src/main/java/br/gov/serpro/rtc/domain/service/calculotributo/CalculoTributoService.java - Tax result model
src/main/java/br/gov/serpro/rtc/api/model/roc/ObjetoDomain.java - Unified tax base
src/main/java/br/gov/serpro/rtc/domain/service/basecalculo/BaseCalculoService.java - NFS-e tax base
src/main/java/br/gov/serpro/rtc/domain/service/basecalculo/BaseCalculoUnificadaNfseService.java - Precision utilities
src/main/java/br/gov/serpro/rtc/core/util/ArredondamentoUtils.java
Fiscal Services
- NFS-e services
src/main/java/br/gov/serpro/rtc/domain/service/nfse/NfseService.java - Document XML
src/main/java/br/gov/serpro/rtc/domain/service/xml/XmlService.java - Toll calculation
src/main/java/br/gov/serpro/rtc/domain/service/pedagio/PedagioService.java - Offline version
src/main/java/br/gov/serpro/rtc/domain/service/offline/VersaoOfflineService.java
Tax Data
- Open-data queries
src/main/java/br/gov/serpro/rtc/domain/service/dadosabertos/DadosAbertosService.java - Tax repositories
src/main/java/br/gov/serpro/rtc/domain/repository/ClassificacaoTributariaRepository.java - Government reducer
src/main/java/br/gov/serpro/rtc/domain/service/RedutorCompraGovernamentalService.java - Reducer repository
src/main/java/br/gov/serpro/rtc/domain/repository/RedutorCompraGovernamentalRepository.java - SQLite database
Other components
- API caller
Connections 22
- API caller → Tax controller: submits operation
README.md - Tax controller → Item validation: dispatches items
- Item validation → CBS IBS calculation: validates for
- Tax orchestration → CBS IBS calculation: runs calculations
src/main/java/br/gov/serpro/rtc/domain/service/calculotributo/CalculoTributoService.java - CBS IBS calculation → Tax result model: builds tax data
src/main/java/br/gov/serpro/rtc/domain/service/calculotributo/CalculoCbsIbsService.java - CBS IBS calculation → Precision utilities: uses precision
src/main/java/br/gov/serpro/rtc/domain/service/calculotributo/CalculoCbsIbsService.java - API caller → Base controllers: requests tax base
README.md - Base controllers → Unified tax base: dispatches request
- Base controllers → NFS-e tax base: dispatches NFS-e
- NFS-e tax base → Precision utilities: rounds amounts
src/main/java/br/gov/serpro/rtc/domain/service/basecalculo/BaseCalculoUnificadaNfseService.java - API caller → Open-data controller: queries tax tables
README.md - Open-data controller → Open-data queries: dispatches query
src/main/java/br/gov/serpro/rtc/api/controller/DadosAbertosController.java - Open-data queries → Tax repositories: queries classifications
src/main/java/br/gov/serpro/rtc/domain/service/dadosabertos/DadosAbertosService.java - Government reducer → Reducer repository: fetches reducer
src/main/java/br/gov/serpro/rtc/domain/service/RedutorCompraGovernamentalService.java - Reducer repository → SQLite database: reads tax data
- API caller → XML controller: generates or validates XML
README.md - XML controller → Document XML: dispatches document
- API caller → NFS-e controller: requests NFS-e service
- NFS-e controller → NFS-e services: dispatches request
src/main/java/br/gov/serpro/rtc/api/controller/NfseController.java - API caller → Auxiliary controllers: uses auxiliary endpoints
- Auxiliary controllers → Toll calculation: dispatches toll request
- Auxiliary controllers → Offline version: dispatches version request