> ## Documentation Index > Fetch the complete documentation index at: https://docs.jusfy.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Calcula correção de valores (simples) > Corrige valores monetários aplicando um índice e uma taxa de juros únicos a todos os lançamentos (`items`), com multa e honorários opcionais. A resposta traz os valores atualizados por lançamento, a evolução mês a mês e os totais do cálculo. ## OpenAPI ````yaml /openapi/legado.json post /api/calculadoras/correction_simple openapi: 3.0.0 info: title: Calculadoras Jusfy API description: >- Rotas sem versão (`/api/...`). Continuam funcionando, mas a versão atual da API é a v1 (`/api/v1`): para integrações novas, use a v1 e siga o [guia de migração](https://api.jusfy.dev/calculators/api/reference/fundamentos/migracao-do-legado). A política de versionamento e depreciação está na [política de versionamento](https://api.jusfy.dev/calculators/api/reference/fundamentos/migracao-do-legado#pol%C3%ADtica-de-versionamento). version: legacy contact: {} servers: - url: https://api.jusfy.dev/calculators security: [] tags: - name: Calculadoras description: >- Execução das calculadoras jurídicas e consulta dos índices de correção. Cada cálculo recebe um payload, retorna o resultado processado e exige API key no header `x-api-key`. - name: Consultas description: >- Consultas de dados (veículos, condutores e documentos). Cada consulta recebe o documento, retorna os dados encontrados e exige API key no header `x-api-key`. A maioria responde na mesma requisição; o **rastreamento veicular** e o **buscador processual** são assíncronos — devolvem `202` com um protocolo e entregam o resultado por webhook e/ou pelo `GET` do protocolo. - name: JusScore description: >- Consulta de processos judiciais por CPF/CNPJ, com score de risco consolidado e a lista detalhada dos processos. É assíncrona: o POST inicia a consulta e o GET devolve o resultado quando pronto. Exige API key no header `x-api-key`. - name: Consumo description: >- Consumo da própria API key: quantas chamadas cada produto recebeu num período, separando as cobradas das não cobradas. Não exige escopo; exige API key no header `x-api-key`. - name: Health description: >- Verificações de disponibilidade do serviço (liveness e readiness). Rotas abertas, sem autenticação. paths: /api/calculadoras/correction_simple: post: tags: - Calculadoras summary: Calcula correção de valores (simples) description: >- Corrige valores monetários aplicando um índice e uma taxa de juros únicos a todos os lançamentos (`items`), com multa e honorários opcionais. A resposta traz os valores atualizados por lançamento, a evolução mês a mês e os totais do cálculo. operationId: CalculatorsController_correctionSimple parameters: [] requestBody: required: true description: Payload da calculadora de correção simples. content: application/json: schema: type: object description: >- Payload da correção simples. Informe os lançamentos (`items`), o índice de correção, as regras de juros e multa; a resposta traz os valores atualizados e a evolução mês a mês por lançamento. required: - items - index - end_date - interest_rate - interest_rate_period - pro_rata - pro_rata_interest - fine - fine_interests - legal_fees - legal_fees_type properties: items: type: array description: Lançamentos a corrigir. Deve conter **pelo menos um** item. items: type: object properties: description: type: string date: type: string format: date description: Data do lançamento (`YYYY-MM-DD`). amount: type: number description: Valor original. debt: type: object description: Dívida do lançamento. properties: id: type: string name: type: string fine: type: number description: Percentual de multa do lançamento. index: type: object description: >- Índice de correção a aplicar. Obtenha o objeto em `GET /api/calculadoras/indices-correcao`. properties: id: type: number nullable: true name: type: string bacen_code: type: string end_date: type: string format: date description: Data final da correção (`YYYY-MM-DD`). interest_rate: type: number description: Taxa de juros (percentual). interest_rate_period: type: object description: Periodicidade dos juros. properties: id: type: string name: type: string pro_rata: type: boolean description: Se a correção é aplicada pro rata die. pro_rata_interest: type: boolean description: Se os juros são aplicados pro rata die. fine: type: number description: Percentual de multa aplicado ao total. fine_interests: type: boolean description: Se a multa incide sobre o saldo já com juros. legal_fees: type: number description: >- Honorários (percentual ou valor fixo, conforme `legal_fees_type`). legal_fees_type: type: object description: >- Tipo dos honorários: `id: "percentage"` percentual · `id: "fixed"` valor fixo. properties: id: type: string enum: - percentage - fixed name: type: string old_rule: type: boolean description: >- Opcional (default `false`). Quando `true`, zera a correção negativa (regra antiga). examples: correction_simple: summary: Correção de valores (índice único) value: items: - description: Parcela 01 date: '2024-01-01' amount: 1000 debt: id: '0' name: Principal fine: 0 - description: Parcela 02 date: '2024-06-01' amount: 500 debt: id: '0' name: Principal fine: 0 index: id: 3 name: SELIC bacen_code: '4390' end_date: '2026-06-21' interest_rate: 1 interest_rate_period: id: '0' name: Mensal pro_rata: false pro_rata_interest: false fine: 0 fine_interests: false legal_fees: 10 legal_fees_type: id: percentage name: Percentual old_rule: false responses: '200': description: Resultado da correção, com valores atualizados e totais. content: application/json: schema: type: object example: statusCode: 200 message: Cálculo concluído com sucesso timestamp: '2026-06-22T18:00:00.000Z' path: /api/calculadoras/correction_simple result: items: - description: Parcela 01 date: '2024-01-01' amount: 1000 debt: id: '0' name: Principal interests: 290 subtotal: 1290 differenceAdjustedAmount: 1000 outstanding_balance: 1290 schedule: - date: '2024-01-01' amount: 1000 correction: 0 amount_adjusted: 0 interests: 0 outstanding_balance: 1000 - date: '2024-01-31' amount: 1000 correction: 0 amount_adjusted: 1000 interests: 0 outstanding_balance: 1000 - date: '2026-06-21' amount: 1000 correction: 0 amount_adjusted: 1000 interests: 290 outstanding_balance: 1290 - description: Parcela 02 date: '2024-06-01' amount: 500 debt: id: '0' name: Principal interests: 120 subtotal: 620 differenceAdjustedAmount: 500 outstanding_balance: 620 schedule: - date: '2024-06-01' amount: 500 correction: 0 amount_adjusted: 0 interests: 0 outstanding_balance: 500 - date: '2024-06-30' amount: 500 correction: 0 amount_adjusted: 500 interests: 0 outstanding_balance: 500 - date: '2026-06-21' amount: 500 correction: 0 amount_adjusted: 500 interests: 120 outstanding_balance: 620 total_interests: 410 total_outstanding_balance: 1910 subtotal_amount: 1500 subtotal: 1910 subtotal_nofine: 1500 legal_fees: 191 total: 2101 total_fines: 0 index_name: SELIC latest_index_update: até 11/2022 '401': description: >- API key ausente ou que não pertence a nenhum cliente (`code: invalid_api_key`). A `message` diz qual dos dois. content: application/json: examples: missing: summary: Key ausente value: statusCode: 401 message: Missing API key code: invalid_api_key requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-10-14T18:00:00.000Z' path: /api/calculadoras/trabalhista invalid: summary: Key inválida value: statusCode: 401 message: Invalid API key code: invalid_api_key requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-10-14T18:00:00.000Z' path: /api/calculadoras/trabalhista '403': description: >- Acesso negado. Dois motivos, distinguidos pelo `code`: o cliente não está ativo (`inactive_client`), ou a API key não tem o escopo deste produto (`insufficient_scope`, com o escopo na `message`). A liberação de produtos é feita pela equipe Jusfy. content: application/json: examples: inactive_client: summary: Cliente não ativo value: statusCode: 403 message: Client is not active code: inactive_client requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-10-14T18:00:00.000Z' path: /api/calculadoras/trabalhista insufficient_scope: summary: Sem o escopo do produto value: statusCode: 403 message: 'Missing scope: ' code: insufficient_scope requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-10-14T18:00:00.000Z' path: /api/calculadoras/trabalhista '422': description: Payload inválido. `message` indica o campo e o motivo. content: application/json: schema: example: statusCode: 422 code: payload_rejected message: 'Expected number, received null (property: fine)' requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-06-22T18:00:00.000Z' path: /api/calculadoras/correction_simple '429': description: >- Limite de requisições por minuto do cliente neste produto excedido. `Retry-After` diz em quantos segundos a janela vira. Toda resposta traz `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`. content: application/json: schema: example: statusCode: 429 code: rate_limit_exceeded message: >- Rate limit exceeded for calculadoras.trabalhista:execute: 60 requests per minute. Retry in 42s. requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-06-22T18:00:00.000Z' path: /api/calculadoras/trabalhista '502': description: Erro no motor de cálculo da Jusfy. content: application/json: schema: example: statusCode: 502 code: upstream_error message: Calculation backend error requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-06-22T18:00:00.000Z' path: /api/calculadoras/correction_simple '504': description: Tempo limite ao falar com o motor de cálculo. content: application/json: schema: example: statusCode: 504 code: upstream_timeout message: Calculation backend timed out requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-06-22T18:00:00.000Z' path: /api/calculadoras/correction_simple security: - api-key: [] components: securitySchemes: api-key: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.