> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Escopo de ledger do Billing v2 do Midaz

> Os pacotes e os cálculos do Billing usam rotas v2 com escopo de ledger; a URL é a única entrada de ledger.

<Badge stroke icon="calendar-days" iconType="regular">29 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Correção da documentação</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Ação necessária</Badge>

## Afeta

Equipes que criam, gerenciam ou calculam pacotes de billing do Midaz.

## O que mudou

A documentação agora informa corretamente o contrato atual do Billing: use as rotas v2 com escopo de ledger para pacotes e cálculos de billing. A organização e o ledger ficam na URL. Não envie `ledgerId` em um parâmetro de query nem no corpo da requisição; o campo do corpo é rejeitado. Os valores monetários do Midaz são strings decimais sem escala específica por ativo.

Esta é uma correção da documentação do comportamento atual de runtime; ela não anuncia um release de runtime.

## Impacto

**Classificação: Ação necessária.**

## O que você precisa fazer

Atualize os clientes, os exemplos e os runbooks de deploy do Billing para usar `/v2/organizations/{organization_id}/ledgers/{ledger_id}/...`. Remova o `ledgerId` do corpo da requisição e defina as regras de exibição e de arredondamento na sua integração, em vez de tratar os valores do Midaz como ponto flutuante binário.

### Prazo

Atualize antes do próximo deploy de integração do Billing.