Área do Cliente: as assinaturas que o seu cliente enxerga no portal

A Área do Cliente é o portal onde o SEU cliente entra com login próprio para acompanhar o que é dele. Esta fonte trata de uma aba só desse portal: Assinaturas (os serviços recorrentes). Quem cria, edita, pausa e fatura a assinatura é você, dentro do ERP. O portal apenas expõe o registro pronto.

QUEM É QUEM AQUI
Assinante é você, dono do ERP. Cliente-final é a pessoa que você cadastrou em Clientes e liberou para entrar no portal. Sempre que este texto disser "o cliente-final vê", é ele vendo, dentro do portal, uma assinatura que você cadastrou para ele.

O QUE PRECISA ESTAR LIBERADO
A aba tem um serviço próprio no cadastro do cliente, chamado Assinaturas. Sem ele liberado, o portal responde "Você não tem permissão para acessar esta área!" e devolve o cliente-final para a tela inicial. Essa checagem é feita cadastro de cliente por cadastro de cliente: liberar para um não libera para os outros. (O portal como um todo ainda depende do seu plano ter o recurso Área do Cliente em dia, mas isso é validado nas telas de entrada do portal, não nesta aba.) Como se libera um serviço e como se dá o acesso está na fonte sobre dar acesso ao seu cliente.

Um detalhe que gera chamado: a relação de serviços que a tela inicial do portal monta cobre Ordens de serviço, Pedidos, Boleto, Atendimento, NF-e, NFS-e e NFC-e. Assinaturas não está nessa relação. Ou seja, a aba pode estar liberada e funcionando e mesmo assim não figurar naquela lista da tela inicial.

O RECORTE: QUAIS ASSINATURAS APARECEM
Três amarrações valem sempre, e nenhuma delas o cliente-final consegue burlar. A empresa tem que ser a mesma do login. O contrato tem que estar no cadastro do cliente-final logado. E o tipo tem que ser assinatura (serviço recorrente) — contrato de serviço e locação não entram nessa aba.

Além disso vale um recorte por situação. Quando o cliente-final não escolhe nenhuma situação no filtro, o portal só mostra as assinaturas cuja situação está marcada com "Exibir na listagem". É por isso que assinatura em situação de encerramento some da tela do cliente-final sem você ter mexido nela: a marcação está na situação, não na assinatura. Quando o cliente-final escolhe uma situação específica no filtro, essa regra cai e a assinatura naquela situação aparece mesmo que ela não seja de exibir na listagem.

Consequência importante: assinatura sem situação preenchida não aparece na listagem padrão. Sem situação não há o que marcar como exibível, e o registro fica de fora.

Um ponto que confunde: o campo Visibilidade do contrato ("Público: exibir na Área do Cliente" / "Restrito") NÃO filtra esta aba. Assinatura marcada como Restrito continua aparecendo aqui. Esse campo serve para outra coisa — é ele que a cobrança gerada pela assinatura herda, e é lá, na aba Boletos, que ele decide o que aparece.

O FILTRO DE PERÍODO ENGANA
O portal filtra por data da assinatura — a data do próprio contrato — e não por vencimento. E o bloco de busca avançada já volta preenchido com o primeiro e o último dia do mês corrente. Se esses campos forem enviados na busca, assinatura antiga fica fora do período e o cliente-final jura que sumiu. Limpar ou alargar o período resolve.

O filtro de situação oferecido ao cliente-final lista todas as situações de assinatura cadastradas por você naquela empresa, na ordem que você definiu — inclusive as que não são de exibir na listagem.

OS DADOS DA LISTA
A lista é paginada e vem da assinatura cadastrada mais recentemente para a mais antiga (é a ordem de cadastro, não a ordem da data que você digitou). Os campos são poucos e fixos: código, data, periodicidade, próximo vencimento, situação (nome e cor), valor total e nome do plano. Fora isso só trafegam identificadores internos. A periodicidade sai por extenso, e as opções são uma lista fechada de nove: a cada 1 dia, a cada 7 dias, a cada 15 dias, a cada 20 dias, a cada 1 mês, a cada 2 meses, a cada 3 meses, a cada 6 meses, a cada 1 ano.

Repare no que não está aí: a lista não traz a marcação interna de assinatura ativa ou pausada, aquela que decide se a rotina automática vai gerar fatura. O que o cliente-final enxerga como situação é a situação que você cadastrou, com o nome e a cor que você deu a ela. Se você quer que ele perceba que a assinatura está parada, isso tem que estar no nome da situação.

O QUE APARECE AO ABRIR UMA ASSINATURA
Abrindo o registro, o portal recebe o contrato inteiro daquela assinatura, com o nome e a cor da situação, e junto vêm os registros filhos do contrato — entre eles os arquivos anexados e as parcelas do contrato, que é o que o portal trata de forma especial. Os anexos saem com o caminho de download montado, então tudo que você anexou naquela assinatura fica ao alcance do cliente-final. Não anexe ali documento interno.

Sobre as parcelas: o cadastro de assinatura não grava parcelas de contrato — parcela de contrato é coisa do contrato de serviço. Por isso esse bloco costuma vir vazio numa assinatura. O que a assinatura produz é cobrança no financeiro, mês a mês. (No ERP, a impressão em PDF da assinatura reconstrói uma lista de parcelas a partir dessas cobranças; o portal não faz essa reconstrução.)

A abertura repete o mesmo recorte da lista. Se o id não for de uma assinatura daquele cadastro de cliente e daquela empresa, o portal responde "Você não tem permissão para acessar esta assinatura!" e joga o cliente-final de volta para a tela inicial do portal. É a mesma resposta para assinatura de outro cliente e para assinatura que não existe mais.

O QUE O CLIENTE-FINAL NÃO CONSEGUE FAZER
A aba tem duas ações e só: listar e abrir. Não existe, pelo portal, cancelar assinatura, pausar, alterar valor, trocar forma de pagamento, antecipar, gerar fatura, imprimir o contrato em PDF nem pagar. Qualquer pedido desses tem que chegar até você por fora — pelos Atendimentos do portal, se você liberou esse serviço, ou pelo canal que você usa.

AS COBRANÇAS DA ASSINATURA NÃO FICAM NESTA ABA
Quando a assinatura fatura, o ERP gera a cobrança no financeiro amarrada àquela assinatura (e, se ela estiver configurada para isso, também uma venda de serviço). Como esse faturamento funciona é assunto do ERP, nas áreas de Assinaturas e Financeiro. O que importa aqui: nada disso é mostrado dentro da tela da assinatura no portal.

Para o cliente-final ver o que ele deve, quanto já pagou e o boleto, o serviço que precisa estar liberado é Cobranças, não Assinaturas. A aba Boletos é uma área própria, com regras próprias de exibição: ela mostra só lançamentos daquele cliente, daquela empresa e marcados como Público na Área do Cliente. E a cobrança nasce com a visibilidade que estava no contrato da assinatura — se a assinatura estava como Restrito, a cobrança nasce Restrito e não aparece.

Existe ainda um caminho fora do portal: o link de cobrança da assinatura, que é uma página própria, aberta por link, onde a assinatura aparece junto com suas cobranças e boletos. É outra coisa que não a Área do Cliente, e não depende de login.

O QUE COSTUMA DAR ERRADO
"O cliente-final não vê nenhuma assinatura." Confira nesta ordem: o serviço Assinaturas está liberado no cadastro daquele cliente; a assinatura está amarrada exatamente àquele cadastro de cliente (cliente duplicado é a causa mais comum — a assinatura ficou no cadastro antigo e o acesso foi criado no novo); a situação da assinatura está marcada com Exibir na listagem; e a busca não está presa no mês corrente.

"Sumiu uma assinatura que aparecia." Quase sempre foi mudança de situação. A assinatura passou para uma situação que não é de exibir na listagem. Ela continua inteira no ERP.

"A assinatura aparece, mas a cobrança dela não." São áreas diferentes. Verifique se o serviço Cobranças está liberado; se a assinatura tem forma de pagamento (sem forma de pagamento a fatura nem chega a ser gerada, e a rotina automática pula esse contrato de propósito — assim como pula assinatura que não está ativa); se o período da aba Boletos, que abre no mês corrente, está escondendo o lançamento; e se a cobrança herdou do contrato a visibilidade Público.

"O cliente-final quer cancelar pelo portal." Não existe. Só você cancela, no ERP.

"O cliente-final vê a assinatura de outro cliente." Não acontece pelo recorte do portal. Se duas pessoas enxergam a mesma assinatura, é porque compartilham o mesmo cadastro de cliente e, portanto, o mesmo acesso.

ONDE ISSO NÃO SE RESOLVE
Cadastrar assinatura, mudar periodicidade, gerar ou reenviar fatura, mexer em situações, baixar cobrança: tudo isso é ERP, nas áreas de Assinaturas e Financeiro. Esta fonte só responde pelo que o portal mostra e pelo motivo de algo não estar sendo mostrado.