Cobrar dentro do aplicativo da Conta Integrada: BolePix, Pix e a tela de boleto que ficou para trás
Esta fonte trata de gerar cobrança de dentro do aplicativo da Conta Integrada. Gerar a cobrança a partir de um lançamento do contas a receber do ERP é outro caminho, com fonte própria: aqui você está dentro do aplicativo, criando a cobrança do zero.
A TELA DE BOLETOS NÃO SUMIU, ELA VIROU BOLEPIX
Hoje a cobrança por boleto do aplicativo é o BolePix: um boleto que traz o Pix no mesmo documento. A tela continua se chamando Boletos, mas o endereço dela agora é o do BolePix. Os endereços antigos de boletos não foram apagados: eles redirecionam para essa mesma lista. É por isso que quem tinha o link antigo salvo, ou quem lembra do caminho velho, diz que "sumiu a tela de boletos". Não sumiu, você foi levado para a lista nova.
Na lista, a Busca avançada tem um filtro Tipo com duas opções e só duas: Boleto e Bolepix. A tela abre sempre em Bolepix. Os boletos antigos, gerados antes da mudança, continuam existindo e aparecem nessa mesma lista quando você troca o Tipo para Boleto. Repare que o período muda de sentido junto: no Bolepix ele é o período de vencimento e no Boleto é o período de emissão. O período já vem preenchido com o mês atual.
A Busca avançada ainda tem Situação e Cliente nos dois tipos, e Número do documento só no Bolepix. Os cards de totais do período — Recebidos, Atrasados, A receber e Cancelados — também aparecem só no Bolepix.
GERAR UM BOLEPIX
Na lista de Boletos, o botão Adicionar abre o formulário. Se o seu usuário não tiver a permissão de receber boletos, ele avisa que você não tem permissão para receber boletos e não abre. Se isso acontecer com o Tipo trocado para Boleto, volte o Tipo para Bolepix e recarregue a lista antes de concluir que é permissão.
Os campos são estes. Valor. Vencimento. Cliente, por busca e obrigatório (dá para cadastrar um cliente novo ali mesmo). Descrição da Movimentação, obrigatória. Mensagem, livre. Depois, o bloco Juros e multa, com juros ao mês em porcentagem, o tipo da multa (valor fixo ou porcentagem) e o valor da multa. E o bloco Desconto, com o tipo do desconto (valor fixo ou porcentagem), o valor e o Prazo máximo do desconto. Juros e multa já vêm preenchidos com o que está configurado na sua conta; você pode mudar antes de salvar.
A Descrição da Movimentação não é um enfeite: ela é a descrição da movimentação financeira que vai ser gerada no financeiro do ERP. A Mensagem é o texto de instrução que acompanha o boleto, para número do pedido, observação de pagamento e coisas assim.
O campo Valor tem um mínimo aceito. Se o valor digitado ficar abaixo dele, o próprio campo mostra em vermelho qual é o mínimo — ajuste o valor pela mensagem que aparecer ali.
O CLIENTE PRECISA ESTAR COMPLETO
O BolePix é emitido em nome do seu cliente, então o cadastro dele precisa estar completo. A conferência acontece na hora em que você escolhe o cliente na busca, e não na hora de salvar. Se algo falta, o sistema mostra o aviso e limpa o campo Cliente — por isso parece que "o cliente sumiu do campo".
A ordem das recusas é sempre esta:
Sem CPF ou CNPJ: "O cliente selecionado não possui documento cadastrado."
Sem e-mail: "O cliente selecionado não possui e-mail cadastrado."
Endereço incompleto: "O cadastro de endereço do cliente selecionado está incompleto."
O endereço é considerado incompleto quando falta CEP, logradouro, bairro, estado ou cidade. Como a checagem é em ordem, corrigir só o documento pode fazer aparecer em seguida a cobrança do e-mail, e depois a do endereço. Complete o cadastro de uma vez. Cadastro de cliente é assunto do ERP e tem fonte própria.
AS DATAS
O vencimento não pode ser anterior a hoje. Se você digitar uma data passada, o sistema avisa que a data de vencimento não pode ser menor que a data atual e limpa o campo.
Se você preencher desconto, o Prazo máximo do desconto passa a ser obrigatório: sem ele, ao salvar, o sistema avisa que é necessário informar o prazo máximo do desconto. Esse prazo também não pode ser anterior a hoje nem posterior ao vencimento, e nos dois casos a data digitada é apagada. É a janela em que o desconto vale: entre hoje e o vencimento.
A COBRANÇA APARECE NO FINANCEIRO DO ERP
Este é o ponto que mais gera dúvida. A cobrança criada dentro do aplicativo também gera a movimentação financeira no ERP, com a descrição que você informou no formulário. Ela aparece no financeiro sem ninguém ter lançado nada lá — foi o BolePix que a criou. Na lista de Boletos existe o botão Ver no financeiro, que leva direto para a movimentação; quando a cobrança não tem movimentação vinculada, o botão fica desabilitado.
DEPOIS DE GERAR
Salvo o BolePix, o sistema avisa que o boleto foi cadastrado com sucesso e volta para a lista. A cobrança nasce pendente — a situação aparece como Criado ou Analisando — e leva um instante para ser registrada no banco. O botão de PDF fica desabilitado enquanto a situação não for Registrado ou Autorizado, e a própria lista vai atualizando a situação sozinha, sem você recarregar a página. Se acabou de gerar e o PDF está apagado, espere na tela. (No painel de detalhes que abre pelo botão Visualizar, o botão Imprimir boleto é mais restrito: só libera em Registrado.)
O botão de cancelar do BolePix só funciona enquanto a cobrança está Registrado ou Autorizado, e o sistema pede confirmação com o nome do pagador. As situações oferecidas no filtro são Criado, Registrado, Recebido e Cancelado.
O ATALHO BOLETO DA TELA INICIAL
Na tela inicial do aplicativo existe o bloco Mais acessados, com quatro atalhos: Boleto (Cobrar), Pix (Receber), Dinheiro (Resgatar) e Extrato (Visualizar). São esses quatro, e só esses.
Atenção a um detalhe: o atalho Boleto abre o formulário de boleto antigo, não o formulário de BolePix da lista. Pior, depois de salvar ele devolve você para a lista, que abre em Bolepix — e a cobrança que acabou de gerar não está lá. Se gerou por ali e não encontra o resultado, troque o filtro Tipo para Boleto e amplie o período antes de concluir que a cobrança não foi criada. Se mesmo assim não aparecer, abra um chamado com a data e o valor. Para gerar um BolePix com certeza, entre na tela de Boletos e use o botão Adicionar de lá.
COBRAR POR PIX DENTRO DO APLICATIVO
O Pix tem tela própria. Na lista de Pix, o botão Receber abre o formulário. São poucos campos: Valor do Pix, a opção "Gerar pagamento no financeiro" (já vem marcada), Cliente e, quando essa opção está marcada, a Descrição da movimentação financeira, obrigatória. É a mesma ligação do BolePix: marcada a opção, o Pix também vira movimentação no financeiro do ERP.
No Pix o cliente é opcional em cobranças menores. A partir de certo valor ele passa a ser exigido, e a mensagem que aparece diz que para valores acima daquele patamar é obrigatório selecionar um cliente com documento cadastrado.
Aqui vale uma diferença importante em relação ao BolePix: no Pix as conferências do cadastro do cliente só acontecem quando você clica em Gerar, não na hora de escolher o cliente. Havendo cliente selecionado, o sistema cobra o que falta, uma mensagem por vez, nesta ordem: documento, CEP, cidade, estado, logradouro e bairro. Cada correção que você faz revela a próxima pendência ao tentar gerar de novo, então vale abrir o cadastro do cliente e completar tudo de uma vez.
Gerado o Pix, a tela mostra o QR Code, o valor e o passo a passo de pagamento, e oferece — enquanto o Pix não é pago — quatro coisas: imprimir o QR Code, enviar o link por e-mail, compartilhar o link por WhatsApp e copiar o código copia e cola (clicar no ícone de copiar ou no próprio campo já copia). O envio por e-mail abre uma janela com os e-mails (dá para informar mais de um separando por vírgula), o campo Responder para, assunto e mensagem, já preenchidos, e o link do Pix; o link vai junto com a mensagem. O WhatsApp abre uma janela com o celular e a mensagem pronta, e leva você para o WhatsApp com o texto montado. Nos dois casos o celular e o e-mail vêm do cadastro do cliente, quando há cliente selecionado. Quando o pagamento chega, a própria tela avisa que o pagamento foi recebido e passa a mostrar os dados da transação.
Depois de gerar, o botão Novo Pix limpa o formulário para a próxima cobrança. Confira a opção "Gerar pagamento no financeiro" nessa segunda cobrança: ela não volta marcada como na primeira vez.
IMPRESSÃO ABRE EM OUTRA ABA, SEM LOGIN
Boleto, BolePix e QR Code do Pix têm cada um o seu endereço de impressão: são três. Eles abrem em outra aba e não pedem login — é justamente por isso que dá para mandar o link para o seu cliente. O link que o botão de imprimir o QR Code abre é o mesmo que segue no e-mail e no WhatsApp. Na impressão do BolePix, o documento pode levar alguns segundos para aparecer, porque a tela fica tentando até o banco devolver o arquivo; se a cobrança foi cancelada, a tela avisa que o boleto foi cancelado.
OS ATALHOS NÃO SOMEM POR FALTA DE PERMISSÃO
Isso resolve uma confusão comum. Os quatro atalhos da tela inicial continuam visíveis mesmo para quem não tem acesso àquela área. O que muda é o que acontece no clique: em vez de abrir, aparece o aviso "Você não possui acesso a esta área!". Ou seja, não adianta procurar um atalho que sumiu; se ele avisa isso, é permissão do usuário. Dentro da lista de Boletos vale o mesmo raciocínio para adicionar, visualizar e cancelar, cada uma com o seu aviso de permissão. Quais permissões liberar e onde elas ficam é assunto da fonte de permissões da Conta Integrada.
O QUE COSTUMA DAR ERRADO
Procurar a lista de boletos antiga. Ela não existe mais separada: o endereço antigo leva para a lista de BolePix, e o boleto velho aparece lá trocando o Tipo para Boleto.
Gerei e não aparece na lista. Quase sempre é filtro. A lista abre no mês atual e no Tipo Bolepix, e no Bolepix o período é o de vencimento: um boleto com vencimento no mês que vem não aparece na tela de hoje. Amplie o período e confira o Tipo.
Gerei pelo atalho Boleto e procurei na lista de BolePix. O atalho abre o formulário antigo. Procure com o Tipo em Boleto.
O cliente é recusado no BolePix. Falta documento, e-mail ou endereço no cadastro dele, nessa ordem. A recusa é ao selecionar o cliente, e o campo é limpo.
No Pix o erro só aparece quando clico em Gerar. É assim mesmo: lá a conferência do cadastro do cliente é no momento de gerar, e vem uma pendência por vez.
O valor não é aceito. O campo Valor tem um mínimo, e a mensagem que aparece embaixo dele informa qual é.
A data do desconto não é aceita. Ela precisa estar entre hoje e o vencimento. E se existe desconto, ela é obrigatória.
O PDF não abre logo depois de gerar. A cobrança ainda não foi registrada. O botão libera sozinho quando a situação vira Registrado ou Autorizado.
Apareceu no financeiro sem eu lançar. É o comportamento normal: a cobrança criada no aplicativo gera a movimentação no ERP.
Clico no atalho e diz que não tenho acesso. É permissão do usuário, não erro do aplicativo.
O QUE NÃO É DESTA FONTE
Cadastro de cliente, forma de pagamento e lançamento financeiro são do ERP e têm fontes próprias. Gerar a cobrança a partir do lançamento do contas a receber é outra fonte. Permissões da Conta Integrada, também. Tarifa, prazo de compensação e condição comercial são do parceiro: não trate por aqui.