Problemas e limitações de assinaturas
Use este diagnóstico antes de depender do próximo ciclo. As limitações descritas foram encontradas na revisão do código em 08/10/2026; não foram corrigidas pela atualização da documentação.
| Sintoma | Causa possível | O que conferir |
|---|---|---|
| Cliente/produto não aparece | Seletores carregam inicialmente até 100 registros | Perfil empresarial, cadastro e limites da consulta. |
| Não consegue cadastrar no perfil empresarial | Criação exige um perfil de colaborador em requesting | Contexto de acesso e vínculo do colaborador. |
| Valor mudou ao trocar produto | Troca do produto não recalcula o total | Informe novamente quantidade e confira Valor. |
| Valor mudou ao abrir edição | Inicialização recalcula pelo preço atual e marca Valor como alterado | Não salve uma divergência; Valor não tem edição manual nessa tela. |
| Dia de cobrança aparece, mas não houve pedido | Campo salvo não comprova job existente | Scheduler habilitado, job, última edição, vigência e logs. |
| Recorrência parou após editar outro campo | Omissão de billDate cancela o job no backend | Corpo da edição e cancelamento do job. |
| Reescolher o mesmo dia não recuperou o ciclo | Mesmo valor não recria job ausente | Recuperação técnica do agendamento. |
| Ciclo parou na data de vencimento | Data é limite de vigência | Data e horário efetivos, não apenas o rótulo “Próximo vencimento”. |
| Não houve ciclo no fim do mês | Não há ajuste automático de dia inválido no mês | Dia selecionado e próximas execuções calculadas. |
| Total do pedido diverge da assinatura | Preço atual do catálogo, desconto ignorado ou acordo fixo | Quantidade, preço unitário e valor faturado no pedido. |
| Desconto aparece como reais | Edição usa percentual; ficha/resumo formatam como moeda | Percentual salvo e valor efetivo do pedido. |
| Número de parcelas não encerra a geração | Job não usa plots como limite | Vigência e agendamento. |
| Indicadores não mudam após pesquisar | Resumo usa toda a coleção carregada | Não usar o resumo como total do resultado da busca. |
| Mais registros não aparecem ao rolar | Paginação solicita novamente página 1 | Consulta técnica paginada e limite de 100. |
| Link funciona na lista e falta na ficha | Lista usa fallback do produto; detalhe não | Link salvo na assinatura e no produto. |
| Pagamento do pedido não altera assinatura | Falta sincronização entre os estados | Estado financeiro do pedido. |
Limites do fluxo atual
Não há configuração semanal/anual, plano de cobrança, débito automático, gestão de cartão, contador de ciclos, pausa com histórico ou renovação assistida nesta interface. A unidade Mês/Ano do produto não muda a frequência mensal do job.
As notificações possuem incompatibilidades de destinatário e rota no backend. Não conte com entrega de aviso ao cliente como parte garantida do cadastro ou encerramento.
Informações para suporte
Registre identificador da assinatura e do pedido, empresa, cliente, produto, dia de cobrança, vigência, horário esperado e última alteração feita. Informe o sintoma e anexe um print da ficha sem expor dados desnecessários. Para recorrência, a equipe técnica precisa conferir também Agenda, fuso, configuração do scheduler e logs de execução.
As falhas de isolamento por empresa, validação e agendamento estão detalhadas na referência técnica.