¶ Renegociações
Junta faturas atrasadas do cliente numa renegociação: aplica desconto ou acréscimo, parcela em até 12x (com entrada opcional) e gera os boletos/PIX das parcelas. As faturas antigas são canceladas. A tela Financeiro → Renegociações é o acompanhamento; a renegociação se faz pelo contrato.
¶ Como chegar
- Fazer: Menu → Provedor → Contratos → abre o contrato → aba Faturas → marca as faturas atrasadas → ação Renegociar.
- Acompanhar: Menu → Financeiro → Renegociações (lista, filtros, status).
¶ Como fazer — wizard de 3 passos
Na aba Faturas do contrato, marca as faturas atrasadas (checkbox) → Renegociar.
¶ Passo 1 — Início
- Valor ⭐ — vem a soma das faturas (com juros/multa). Editável.
- Calcular com juros? — Sim soma juros/multa; Não usa só o valor.
- Acréscimo ou Desconto? — opcional:
- Desconto → abate do total + escolhe o Motivo (ex: cortesia).
- Acréscimo → soma ao total + Motivo (ex: juros).
- Mostra a lista das faturas que serão canceladas (em vermelho).
¶ Passo 2 — Parcelamento
- Com entrada? — Sim/Não.
- Se Sim: Data da entrada (dia útil, até 30 dias) + Valor da entrada (mín R$ 10). O restante vira as parcelas.
- Parcelas — 1x a 12x (do valor restante).
- Vencimento da 1ª parcela — opcional (vazio = 1 mês após a última fatura cancelada; respeita dia útil/feriado).
- Desconto de pontualidade? — desconto por parcela se pagar até o vencimento (padrão R$ 10).
¶ Passo 3 — Resumo
Mostra: entrada, parcelas (valor/vencimento), faturas canceladas, mensalidades mescladas e novas faturas. Marca "Confirmo" → Finalizar Renegociação.
Mescla inteligente: se uma parcela cai perto (±5 dias) de uma mensalidade futura, o sistema junta as duas (cancela a mensalidade e soma na parcela) — evita boleto duplicado.
¶ O que acontece ao confirmar
Sem entrada: faturas antigas → canceladas, parcelas viram boletos/PIX na hora, renegociação fica Aprovada.
Com entrada: cria a fatura da entrada e fica Pendente (aguardando o cliente pagar a entrada). Quando a entrada é paga, o sistema cria as parcelas e a renegociação vira Aprovada.
As parcelas aparecem em Faturas como boletos normais.
¶ Status
| Status | Cor | Significa |
|---|---|---|
| Iniciada | 🔵 | Criada (sem entrada) |
| Pendente | 🟡 | Aguardando o pagamento da entrada |
| Aprovado | 🟢 | Entrada paga, parcelas geradas e ativas |
| Concluído | 🟢 | Todas as parcelas pagas |
| Cancelado | 🔴 | Cancelada (operador ou rotina automática — ver abaixo) |
Fluxo: Iniciada/Pendente → Aprovado → Concluído.
¶ Filtros (tela Financeiro)
Status · Tipo (Desconto/Acréscimo) · Criado por · Data de criação · Data de conclusão.
¶ Acompanhar / cancelar (Financeiro → Renegociações ou no contrato)
- Visualizar — detalhes (entrada, parcelas, faturas).
- Cancelar Renegociação — reativa as faturas antigas (se não pagas) e cancela as parcelas não pagas. Entrada já paga vira crédito.
- Histórico — quem fez e quando.
¶ ⏰ Cancelamento automático de acordos (entrada não paga)
Uma rotina roda todo dia às 03:00 e cancela apenas acordos COM entrada cuja entrada não foi paga no prazo. Serve pra limpar acordos que o cliente montou mas nunca confirmou (não pagou a entrada).
O que o robô faz:
- Só pega acordo Pendente (aguardando entrada). Acordo SEM entrada nunca é cancelado por essa rotina — ele já nasce Aprovado.
- Conta o prazo a partir da emissão da entrada (não do vencimento do boleto).
- Só cancela se não houve nenhum pagamento no acordo.
- Ao cancelar: reabre as faturas antigas e cancela a entrada/parcelas não pagas (igual ao cancelamento manual).
Acordo já Aprovado (entrada paga, parcelas ativas) NUNCA é quebrado por essa rotina, mesmo com parcela vencida. Aí quem decide é o operador (cancelar / renegociar de novo).
¶ 🔧 Onde configurar o prazo
Configurações → Configurações padrão → aba Contratos → seção "Cancelamento Automático de Acordos"
- Campo: Prazo para cancelar acordo sem pagamento (dias) — padrão 15 dias.
- O mesmo prazo aparece como dica na tela de renegociação, embaixo do campo Data da entrada.
¶ 🔎 Consultas rápidas (buscar os dados)
Comandos read-only pra rodar no servidor. Não alteram nada — só mostram.
Ver o prazo configurado hoje:
docker compose exec -T app php artisan tinker --execute="echo negotiationExpireDays().' dias';"
Ver todos os acordos de um contrato (troque 23035 pelo número do contrato):
docker compose exec -T app php artisan tinker --execute="
App\Models\Financial\Negotiation::where('subscription_id', 23035)
->orderBy('id')->get(['id','status','entry_amount','created_at','updated_at'])
->each(fn(\$n) => print(\"#{\$n->id} | {\$n->status->value} | entrada R\$ {\$n->entry_amount} | criado {\$n->created_at} | atualizado {\$n->updated_at}\n\"));
"
Ver quais acordos a rotina das 03:00 cancelou (nos logs):
docker compose exec -T app grep "CancelExpiredNegotiations" storage/logs/laravel.log | tail -50
Descobrir se um acordo foi cancelado pela rotina ou por uma pessoa (rotina = sem "causador"; pessoa = com nome/ID):
docker compose exec -T app php artisan tinker --execute="
Spatie\Activitylog\Models\Activity::where('subject_type','like','%Negotiation%')
->where('subject_id', 2355)
->get(['description','causer_id','created_at'])
->each(fn(\$a) => print(\"{\$a->created_at} | {\$a->description} | causador=\".(\$a->causer_id ?? 'ROTINA/sistema').\"\n\"));
"
¶ Regras importantes
- Entrada: mínimo R$ 10, máximo = total. Se entrada = total, não tem parcela.
- Parcelas: até 12x; o sistema distribui os centavos e ajusta vencimento pra dia útil.
- Fatura já em renegociação ativa não entra em outra ("já vinculado a renegociação X").
- Entrada não paga (acordo Pendente com entrada): a rotina das 03:00 cancela sozinha após o prazo (padrão 15 dias da emissão). Ver seção acima.
- Parcela não paga (acordo já Aprovado): não quebra sozinho — a parcela fica vencida e o operador decide (cancelar a renegociação ou renegociar de novo).
¶ Erros comuns / dúvidas
- "Boleto já vinculado a renegociação" → a fatura já está numa renegociação ativa; conclua/cancele antes.
- Parcelas não apareceram (com entrada) → só são geradas depois que a entrada é paga. Confira a fatura da entrada.
- Valor da parcela "estranho" → pode ter mesclado uma mensalidade futura (soma) — confira no Resumo/Detalhes.
- Cliente desistiu → Cancelar Renegociação reativa as faturas antigas.
- "Meu acordo sumiu / foi cancelado sozinho" → se era com entrada e a entrada não foi paga, a rotina das 03:00 cancelou após o prazo (padrão 15 dias). Acordo sem entrada ou já aprovado não é cancelado pela rotina. Use as Consultas rápidas acima pra confirmar quem cancelou e quando.