IPCA & IGP-M — Motor de Reajuste Contratual

What problem does it solve?

This skill solves the complex, error-prone task of calculating contractual price adjustments by leveraging official Brazilian indices (IPCA and IGP-M) retrieved through public APIs, ensuring precise and auditable results.

Core Features & Use Cases

• Index-based recalculation: computes reajustes using IPCA (Número-Índice) or IGP-M (monthly variation) with correct defasagem rules and optional deflation handling.
• APIs & data sources: integrates with IBGE SIDRA and Banco Central SGS to fetch index data, includes strict validation (Zod) and precise decimal arithmetic (Prisma Decimal) for storage and downstream computations.
• Use Case: when a contract anniversary requires a price update, automatically fetches the relevant index values, applies the multiplier, and returns the updated amount for persistence and reporting.

Quick Start

Run a reajuste calculation by providing the original monetary value, the base period (YYYYMM), and the current period (YYYYMM) to obtain the updated amount.