Fatura do cartão (atual ou próxima)
invoice_for_periodFatura de um cartão pro período pedido em period (default 'current'). 'current': a mais antiga ainda não paga (isPaid = false), qualquer que seja seu status; se não houver nenhuma pendente, cai pra fatura do período vigente calculada pelo dia de fechamento/vencimento do cartão. 'next': fatura prevista pro ciclo seguinte ao atual (mês seguinte, mesma lógica de fechamento/vencimento) — use pra saber quanto já está comprometido no próximo fechamento antes dele fechar. Sem transações completas (só os vínculos de valor). Efeito colateral em ambos os casos: se a fatura do período pedido ainda não existir, ela é criada (linha OPEN com total 0) — não é uma leitura pura. cardId é o id do cartão, não da fatura.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cardId": "<cardId>"
},
"name": "invoice_for_period"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cardId | Yes | Id do cartão (Card) | |
| period | No | Default: 'current' |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| year | No | ||
| month | No | ||
| cardId | No | ||
| isPaid | No | ||
| status | No | ||
| userId | No | ||
| dueDate | No | ||
| paidDate | No | ||
| createdAt | No | ||
| updatedAt | No | ||
| paidAmount | No | ||
| closingDate | No | ||
| totalAmount | No | ||
| transactions | No |