Assessor Financeiro Tool icon

Assessor Financeiro Tool

Tool do Meu Assessor Financeiro para uso com AI Agents

Pagar Fatura

AI-generated

Summary

Registra o pagamento de uma fatura de cartão, debitando a conta de origem e marcando a fatura como paga. Configure o telefone do usuário e o cartão; opcionalmente, escolha a fatura por data de referência, informe um valor parcial e defina a data do pagamento.

Inputs

  • Telefone (required) — Telefone do usuário associado à conta; vem do workflow, por exemplo ={{ $json.phone }}.
  • ID do Cartão (required) — ID do cartão de crédito cuja fatura será paga. Embora a propriedade não esteja marcada como obrigatória, o código omite o valor quando é 0 ou não informado; a descrição do node indica que a API retorna um erro amigável nesse caso.
  • ID da Conta de Origem (required) — ID da conta bancária debitada para o pagamento.
  • Valor (centavos) — Valor a pagar em centavos. Se for 0, o parâmetro é omitido e a API recebe a instrução para pagar o valor total da fatura; valores positivos são enviados como inteiros.
  • Data de Referência — Data YYYY-MM-DD para identificar a fatura; se vazia, o parâmetro é omitido e aplica-se o padrão da API, descrito como mês atual.
  • Data de Pagamento — Data YYYY-MM-DD do pagamento; se vazia, o parâmetro é omitido e aplica-se o padrão da API, descrito como hoje.
  • Descrição da Tool — Descrição opcional que orienta o AI Agent sobre quando usar esta tool; vazia, usa a descrição padrão.

Output shape

Um item com a resposta JSON da API por item de entrada.

A operação faz uma chamada autenticada ao webhook /api/v1/webhooks/n8n com a ação pay_invoice, o telefone e os parâmetros não vazios. O código empacota a resposta da API diretamente em json; o formato dos campos retornados não está especificado.

Examples

Example 1: Pagar a fatura completa do cartão 123 usando a conta 45

Defina cardId como 123, sourceAccountId como 45 e deixe amountCents em 0.

Example 2: Pagar parcialmente uma fatura

Informe amountCents como o valor em centavos — por exemplo, 15000 para R$ 150,00 — e, se necessário, referenceDate para identificar a fatura.

Links

Discussion