CLI FIDEM — débito automático¶
Rotinas pontuais de débito (FIDEM + Supabase). Implementação no pacote MCP; wrappers
pnpm fidem:* em apps/api-menos-juros já usam railway run.
Relacionado: index · nest-api · carteira.
Uso¶
cd apps/api-menos-juros
pnpm fidem --
pnpm fidem:situacao -- --codigo-operacao 195579
pnpm fidem:reenviar-parcela -- --parcela-id 18269 # dry-run
pnpm fidem:reenviar-parcela -- --parcela-id 18269 --dry-run false
-- depois do script passa flags ao CLI.
Catálogo¶
Leitura (seguro)¶
| Script | Flags |
|---|---|
fidem:situacao |
--cpf ou --codigo-operacao |
fidem:consultar-mandatos |
--mandato-ids id1,id2 |
fidem:find-transaction |
--reference (usa id do fluxo, não id do agendamento local) |
Escrita (dry-run padrão)¶
| Script | Flags |
|---|---|
fidem:reenviar-parcela |
--parcela-id ou --codigo-operacao+--numero-parcela |
fidem:criar-operacao |
--proposta-id [--codigo-operacao-fiducia] |
Escrita destrutiva (sem dry-run — confirme)¶
| Script | Flags |
|---|---|
fidem:reenviar-mandatos |
--mandato-ids |
fidem:corrigir-conta |
CPF + dados da conta nova |
fidem:cancel-transaction |
--transaction-id |
Fluxo típico¶
fidem:situacao— diagnosticar- Mandato ruim →
consultar-mandatos→reenviar-mandatos - Conta diverge →
corrigir-conta→reenviar-parcela - Falta operação →
criar-operacao
Regras aprendidas (ops)¶
- Transação FIDEM só nasce no enviar (API
createTransaction), não no agendar local. - Reference =
fluxo_pagamentos.id(ex.18269). O id longo tipo1784812048231éagendamentos[].id(Date.now()) — consultar FIDEM com ele dá 404. - Pagador FIDEM pode ser o CPF do titular da conta, não o CPF do contato.
- Amount na API é em reais (ex.
319.03), não centavos.
Onde vive¶
- CLI:
agents/servidores-mcp-menos-juros/src/cli/fidem.ts - Tools:
agents/servidores-mcp-menos-juros/src/tools/debito/* - Doc canônica:
agents/servidores-mcp-menos-juros/docs/fidem-cli.md