Asaas no ERP: o que é da Asaas, o que é do ERP e onde ela aparece
A Asaas é um serviço financeiro de fora do ERP. Antes de qualquer configuração, vale entender onde termina o sistema e onde começa a Asaas — é essa confusão que gera a maior parte dos atendimentos. Veja abaixo a visão geral; no fim estão os outros assuntos da Asaas.
O QUE É DA ASAAS E O QUE É DO ERP
No sistema a Asaas está registrada como integração bancária por API e é uma integração externa. Na prática: emitir a cobrança e dar a baixa não acontecem dentro deste ERP. Quem conversa com a Asaas é um serviço de cobrança separado, que roda fora do sistema principal.
O que o ERP faz é o vínculo e o disparo. Ele guarda qual forma de pagamento aponta para a Asaas — é o campo "banco" da forma de pagamento — e, na hora de gerar o boleto ou o Pix daquela cobrança, chama o serviço externo passando essa movimentação. A resposta que aparece na tela é a resposta que o serviço devolveu.
Isso muda o atendimento. Quando a cobrança não sai, o problema está no vínculo (que é do ERP) ou na conta e na resposta da Asaas (que não são). Peça sempre a mensagem exata que apareceu.
O roteiro de ligar uma integração bancária, gerar a chave na Asaas e criar a forma de pagamento é o mesmo das demais integrações bancárias, feito na tela de Meios de pagamento.
O QUE O ERP FAZ PASSAR PELA ASAAS
Dentro do ERP existem dois caminhos que chegam à Asaas: a emissão do boleto e a geração do Pix da cobrança. Os dois são entregues ao serviço de cobrança externo — o ERP não monta nem um nem outro. O que a sua conta Asaas libera, e em que condições, é assunto da Asaas.
A integração pressupõe conta na Asaas: a conta e as chaves são criadas e validadas no portal dela, não por aqui.
LIBERAÇÃO: PLANO E LOJA
A Asaas é um aplicativo à parte e o acesso depende do plano. A validação é feita por loja — a Asaas pode estar liberada numa loja e não em outra da mesma empresa.
Sem liberação, ao emitir o boleto ou gerar o Pix o sistema devolve uma mensagem de plano. São dois textos parecidos, e os dois apontam para a mesma coisa.
Quando o cliente diz "aparece numa loja e na outra não", comece pela liberação daquela loja, não pela permissão do usuário. Deixe a permissão do usuário por último.
DENTRO DO APLICATIVO ASAAS, VÁRIAS TELAS SÃO AS DO PRÓPRIO SISTEMA
Este é o detalhe que mais confunde: várias telas abertas dentro da Asaas não pertencem ao aplicativo, são as telas do sistema principal. Entram nessa lista, entre outras: Usuários, Grupos de usuários, Permissões, Lojas, Notificações, Planos, Ajuda, cadastro e busca de clientes, busca de fornecedores e transportadoras e os logs de usuário. As buscas de forma de pagamento, conta bancária, centro de custo e categoria financeira são as do Financeiro.
Ou seja: a tela de Usuários aberta dentro da Asaas é a mesma tela de Usuários do ERP. O usuário que você criar ali é o usuário do sistema, não um usuário separado da Asaas. O mesmo vale para a tela de Permissões: ela é a do sistema, e o que muda é que o sistema sabe que você a abriu pela Asaas e monta a lista de itens daquele módulo. É por isso que as permissões da Asaas não aparecem na lista de permissões aberta por fora.
QUEM RESPONDE CADA PARTE
As chamadas da Asaas se dividem em três donos, e isso ajuda a separar o defeito:
Buscar e alterar a forma de pagamento vinculada à Asaas — é do Financeiro do próprio ERP.
Validar transação, remover transação e zerar o vínculo da forma de pagamento — é do serviço de cobrança externo.
As telas reaproveitadas acima — são do sistema principal.
ONDE A ASAAS APARECE NO ERP
Em Financeiro, Gestão de Cobranças, Meios de pagamento, a Asaas é um card na lista, com a imagem e a descrição dela. No card você vê dois selos: um diz Ativo ou Inativo; o outro diz "Emissão e baixa automática". Esse segundo selo separa as integrações por API dos bancos que trabalham por arquivo — nesses, o selo diz "Arquivo de remessa e retorno".
O card fica Ativo quando existe uma forma de pagamento com a Asaas vinculada. Enquanto não existir, ele fica Inativo.
Quando o card está Inativo, o botão é Habilitar. Quando está Ativo, o botão é Gerenciar. Nos dois casos, para a Asaas, o botão leva você para o aplicativo Asaas, dentro do sistema. A Asaas não é cadastrada por dentro dessa tela: a rotina de habilitar ali, que abre uma forma de pagamento de boleto para preencher, serve aos bancos de remessa e retorno.
O QUE COSTUMA DAR ERRADO
"Cliquei em Habilitar na Asaas e ele me jogou para outra tela." É o comportamento certo. Para integração por API o botão redireciona para o aplicativo, porque a configuração é lá, não naquele formulário.
"O card da Asaas está como Inativo." O card lê o vínculo, não a conexão. Sem uma forma de pagamento apontando para a Asaas, ele fica Inativo mesmo com a conta conectada. E, quando a empresa tem mais de uma loja, essa leitura considera a loja em que você está: a conta bancária da forma de pagamento precisa estar ligada àquela loja. Por isso o mesmo card pode aparecer Ativo numa loja e Inativo em outra.
"A forma de pagamento que eu quero não aparece para vincular." Uma forma de pagamento pertence a uma integração só, então a que já está em uso em outra fica de fora da lista. Só que essa não é a causa mais comum: a que mais confunde é o tipo da forma. Não feche o diagnóstico por aqui — a explicação inteira está no vínculo da forma de pagamento com a Asaas.
"Não tem botão de desabilitar a Asaas." Não tem mesmo. O menu com Editar, Visualizar e Desabilitar só aparece nos bancos de remessa e retorno. Desfazer o vínculo da Asaas é acionado pelo aplicativo, e não por esse menu.
"Contratei e não aparece no menu." Confira nesta ordem: o plano da empresa cobre a Asaas e a liberação alcança aquela loja. Só então trate como permissão de usuário.
"A Asaas fica dentro do sistema ou é outro site?" As duas coisas. O aplicativo é uma área do próprio sistema, e o botão do card te leva para lá. Mas a conta, as chaves e a execução das cobranças são da Asaas, no portal dela.
OS OUTROS ASSUNTOS DA ASAAS
Vínculo da forma de pagamento, por que ela some da lista, o que o salvamento zera e como desvincular ou trocar.
Boleto e Pix que não saem, cada mensagem com a causa, a ordem em que o sistema valida, impressão em lote e link de pagamento.
Onde ficam as permissões do Asaas, o que cada bloco governa e as travas que ficam no Financeiro.