Área do Cliente: as cobranças que o cliente-final enxerga no portal
Esta fonte trata de uma coisa só: o que o CLIENTE-FINAL enxerga do financeiro dele quando entra na Área do Cliente. Aqui, "assinante" é você, dono do ERP; "cliente-final" é o cliente que você cadastrou e liberou para entrar no portal. O portal não cria, não altera e não dá baixa em nada. Ele apenas expõe recebimentos que já existem no seu financeiro.
O QUE LIBERA ESSA TELA
No cadastro do cliente-final existe uma lista fechada de oito serviços. O que abre as cobranças tem dois nomes e é um só: na hora de liberar ele se chama Cobranças; no menu do portal ele aparece como Boleto. Procurar "Boleto" na tela de liberação não acha nada — a fonte dos oito serviços explica os dois nomes. Sem esse serviço marcado, o portal responde "Você não tem permissão para acessar esta área!" e devolve o cliente-final para o início. Cadastrar o cliente-final, ativar o acesso e definir e-mail e senha do portal são assunto da fonte de acesso da Área do Cliente, não desta.
O RECORTE: QUAIS LANÇAMENTOS APARECEM
São cinco condições, todas obrigatórias e aplicadas juntas.
Primeira: mesma empresa.
Segunda: o lançamento está no nome daquele cliente-final. Cobrança lançada em outro cadastro, mesmo que seja a mesma pessoa, não aparece.
Terceira: visibilidade Público. No ERP esse campo do recebimento tem duas opções, e são só essas duas: "Público: Exibir na Área do Cliente" e "Restrito: Não exibir na Área do Cliente". A lista é fechada.
Quarta: precisa ser um recebimento. O portal só traz as cobranças do cliente-final. Pagamentos (as suas despesas) nunca chegam ao cliente-final.
Quinta: o lançamento precisa ter uma forma de pagamento vinculada. A consulta usa junção obrigatória com formas de pagamento. Sem ela, o lançamento não sai na lista nem abre no detalhe.
Duas coisas do recorte que costumam surpreender. Não há filtro por loja: o cliente-final vê os recebimentos dele em todas as lojas da empresa. E não há filtro por tipo de forma de pagamento: aparece dinheiro, cartão, transferência, boleto, o que estiver lançado. Existe no código uma restrição por tipo de forma de pagamento, mas ela está comentada, ou seja, desligada — não conte com ela.
Cada parcela é um lançamento próprio, com sua visibilidade, sua forma de pagamento e sua data. Por isso é normal aparecer uma parcela e não aparecerem as outras: o problema é de cada lançamento, não do conjunto.
Parcelas geradas por assinatura e por locação herdam a visibilidade do contrato que as gerou. Contrato restrito gera parcela restrita.
O PERÍODO PADRÃO É O MÊS ATUAL
Sem nenhum filtro, a lista traz apenas o mês corrente, do dia 1 ao último dia. O corte é pela data de fluxo. E essa janela só é aplicada quando a consulta não traz situação, período nem pedido. Havendo qualquer um deles, a busca passa a varrer o histórico inteiro.
A data de fluxo é o ponto que mais gera confusão. Enquanto o recebimento está em aberto, ela é a data de vencimento. Quando você dá baixa, ela passa a ser a data da baixa. Ou seja: uma parcela que vencia em janeiro e foi paga em março sai da janela de janeiro e passa a aparecer na de março.
A ordem é da mais antiga para a mais nova, pela data de fluxo, e a lista é paginada.
FILTROS E SITUAÇÕES
A busca avançada do portal carrega quatro campos: descrição, data inicial, data final e situação. As duas datas já vêm preenchidas com o primeiro e o último dia do mês atual.
As situações do filtro são uma lista fechada de três: Em Aberto, Em Atraso e Pago. Em Aberto é o não baixado. Em Atraso é o não baixado com vencimento anterior a hoje. Pago é o baixado.
O rótulo de cada linha é outra lista fechada de três, calculada na hora a partir da baixa e da data de fluxo: Em aberto, Atrasado e Confirmado. Repare que o filtro diz Pago e o rótulo diz Confirmado — é o mesmo conjunto. Detalhe fino: o filtro Em Atraso olha a data de vencimento e o rótulo Atrasado olha a data de fluxo; em lançamento aberto as duas são a mesma data, então na prática coincidem.
Por baixo, a consulta ainda aceita categoria, conta bancária, pedido, serviço, forma de pagamento e faixa de valor.
OS TOTAIS NÃO SEGUEM O PERÍODO DA LISTA
O painel de totais devolve quatro números: vencidos, a vencer, pagos e em aberto (que é vencidos mais a vencer). Eles obedecem exatamente o mesmo recorte de lançamentos, mas não obedecem período nenhum e não recebem os filtros escolhidos na tela: somam o histórico inteiro do cliente-final. A lista ao lado mostra o mês. Por isso os dois quase nunca fecham, e isso é comportamento do código, não erro de dado. Para separar vencido de a vencer, os totais usam a data de vencimento.
O QUE O CLIENTE-FINAL CONSEGUE FAZER
Três coisas: listar, ver os totais e abrir o detalhe de um lançamento. Não existe ação de pagar, dar baixa, confirmar recebimento, anexar comprovante ou contestar. No financeiro, o portal é somente leitura.
Por linha, ele recebe código, descrição, identificação da parcela, data de fluxo, valor total e situação. No detalhe, descrição, código, situação, data de fluxo, data de vencimento, valor, desconto, juros, valor total e forma de pagamento.
BOLETO, PIX E NOTA
Junto de cada linha e do detalhe, a resposta traz o hash do lançamento e os indicadores da forma de pagamento (boleto, pix, cartão). As páginas de boleto, pix, fatura e recibo do ERP são abertas por esse hash e não pedem login: quem tem o link, abre.
A emissão do boleto tem exigência própria: a forma de pagamento do lançamento precisa ser de boleto ou de cartão. Fora disso a página recusa, dizendo que o lançamento não está vinculado a uma forma de pagamento válida para quem está logado no ERP, e que o lançamento não está disponível para quem não está. Se o boleto ainda não foi registrado no banco, a página avisa que é preciso enviar o arquivo de remessa e oferece imprimir assim mesmo — como registrar e emitir boleto é assunto da fonte de Financeiro.
Quando o recebimento está amarrado a uma NF-e ou NFS-e, a resposta também traz o hash dessa nota, que tem página pública do mesmo jeito.
O QUE COSTUMA DAR ERRADO
Meu cliente-final não vê a cobrança. Confira nesta ordem: o recebimento está no cadastro dele, a visibilidade está Público, existe forma de pagamento vinculada, é recebimento e não pagamento, e a data de fluxo cai no mês atual.
Ele via e sumiu. Quase sempre é a baixa: ao pagar, a data de fluxo virou a data da baixa e o lançamento mudou de mês. Filtrando pela situação Pago o histórico inteiro aparece.
Sumiu só um lançamento. Forma de pagamento apagada ou nunca preenchida. A junção é obrigatória: o registro some da lista e o detalhe responde "Você não tem permissão para acessar este recebimento!".
O total não bate com a lista. Esperado. Total é histórico inteiro, lista é o mês.
O cliente-final não chega na tela de cobranças. O serviço Cobranças — que no menu do portal aparece como Boleto — não está marcado no cadastro dele.
Apareceu cobrança que ele não deveria ver. Aquele lançamento está com visibilidade Público. Marque Restrito no lançamento. Em assinatura e locação, corrija no contrato, porque as parcelas herdam dele.
O boleto não abre. A forma de pagamento não é de boleto nem de cartão, ou o boleto ainda não foi registrado no banco.
O QUE NÃO SE RESPONDE POR AQUI
Como cadastrar o cliente-final, liberar o acesso, enviar convite ou trocar a senha do portal. Como lançar, editar ou baixar um recebimento. Como emitir boleto, pix ou nota. Isso é do ERP e das fontes dele. As parcelas exibidas dentro da tela de pedidos do portal seguem a visibilidade do pedido, não a do lançamento financeiro — outro recorte, outra fonte. E não confunda com a área do cliente da Gestão de Cobranças, onde o devedor paga a cobrança, nem com a Área da Contabilidade, que é outro produto.