Iugu no financeiro do ERP: forma de pagamento, gerar cobrança e as mensagens do recebimento
O QUE VOCÊ ENCONTRA AQUI
Como a Iugu aparece dentro do financeiro do ERP: onde fica o vínculo, o que muda na forma de pagamento vinculada, as frases exatas que o sistema mostra no recebimento e o que impede a emissão. Cadastro de forma de pagamento, conta bancária, lançamento, baixa e conciliação são conceito do ERP e estão no conteúdo do Financeiro. O roteiro comum de ligar um meio de pagamento e o funcionamento geral do Pix estão na pasta Meios de pagamento. Aqui fica só o que muda por ser Iugu.
O VÍNCULO É O CAMPO BANCO DA FORMA DE PAGAMENTO
Toda integração de cobrança do ERP é identificada por um campo da forma de pagamento chamado banco. Quando a forma de pagamento é da Iugu, é esse campo que guarda a identificação da integração. É esse vínculo, e só ele, que faz o ERP tratar o lançamento como integrado, chamar a Iugu na hora de gerar a cobrança e aplicar as regras descritas abaixo. Se o campo estiver vazio, o sistema responde que a forma de pagamento não está vinculada a integração. Como o campo é único, uma forma de pagamento fica vinculada a uma integração por vez.
A LISTA DE BANCOS DA FORMA DE PAGAMENTO É FECHADA E NÃO TEM IUGU
Na tela de forma de pagamento, a lista de bancos oferecida é fechada e tem exatamente dez opções: Banco do Brasil, Santander, Caixa Econômica, Itaú, HSBC, Bradesco, Sicoob, Sicredi, Banco do nordeste e Banrisul. Iugu não está nessa lista e não vai aparecer.
Ou seja: o vínculo com a Iugu não nasce, não se troca e não se desfaz pela tela de forma de pagamento. Ele é gerenciado pela própria integração, no aplicativo da Iugu dentro do ERP. Tanto é assim que, quando a forma já está vinculada a uma integração, o ERP descarta o campo banco e a marcação de gerar boleto que a edição enviar — o que estiver gravado permanece.
O QUE MUDA NA FORMA DE PAGAMENTO DEPOIS DE VINCULADA
Na listagem de formas de pagamento, a forma vinculada passa a trazer o logotipo da integração e o link para o aplicativo da Iugu. Ao editá-la, o ERP mostra: Algumas configurações devem ser realizadas através do aplicativo da Iugu, clique aqui para gerenciar esta integração. Isso não é erro nem pendência: parte dos parâmetros da cobrança vive no aplicativo da Iugu, não na tela da forma de pagamento.
Ao consultar a forma, o nome da integração aparece como Iugu. Já o campo de banco, quando a forma está marcada como boleto, é traduzido pela lista fechada de dez bancos e volta com traços. Traço ali não quer dizer vínculo perdido: o vínculo continua gravado no campo banco.
NO RECEBIMENTO, A PALAVRA É COBRANÇA, NÃO REMESSA
A Iugu é integração online. O ERP não gera remessa nem arquivo CNAB para ela. Não existe remessa para a Iugu: o que existe é gerar cobrança.
Os textos que o sistema mostra num recebimento cuja forma de pagamento é da Iugu são estes:
Deseja gerar a cobrança na Iugu? — confirmação antes de gerar.
Gerar cobrança na Iugu — quando a cobrança ainda não foi gerada.
Cobrança ainda não gerada na Iugu — enquanto não houver cobrança gerada com sucesso. Aparece tanto antes da primeira tentativa quanto depois de uma tentativa que deu erro.
Cobrança gerada na Iugu — depois de gerada, seguido da data em que foi gerada.
Ocorreu um erro ao gerar a cobrança na Iugu — quando a última tentativa falhou e o sistema não guardou um motivo específico.
Se a forma de pagamento estiver marcada como Pix, os rótulos passam a falar em Pix: Deseja gerar o Pix na Iugu?, Gerar pix na Iugu, Pix ainda não gerado na Iugu, Pix gerado na Iugu. O texto de erro é a exceção: ele continua dizendo cobrança mesmo numa forma de Pix.
Atenção ao Pix. A emissão pela Iugu funciona pelo caminho da cobrança e do boleto. O pedido de gerar Pix por uma forma de pagamento da Iugu não tem tratamento próprio no ERP: o sistema valida tudo, não chama a Iugu e devolve resposta vazia. Como resposta vazia é lida como sucesso, a tela chega a mostrar Pix gerado com sucesso! sem que nada tenha sido gerado. O sinal certo é o próprio lançamento: depois da tentativa ele continua como Pix ainda não gerado na Iugu. Ou seja, hoje não é possível gerar Pix pela Iugu no ERP.
O estado fica gravado no próprio lançamento e só tem três valores: não gerada, gerada e erro. Ele é atualizado a cada tentativa: deu certo, vira gerada com a data de hoje; falhou, vira erro.
O QUE BARRA A EMISSÃO, COM A MENSAGEM DE CADA CASO
O ERP valida antes de chamar a Iugu, nesta ordem, e cada bloqueio tem sua mensagem.
Lançamento sem forma de pagamento, ou com forma que não está marcada como boleto nem como cartão: Este lançamento não está vinculado a uma forma de pagamento válida!
Plano sem o recurso da integração: O seu plano atual não lhe permite utilizar a integração com a Iugu. Por favor, contrate outro plano!
Usuário sem a permissão de imprimir boleto: Você não tem permissão para acessar esta área!
Lançamento já baixado: Este lançamento já foi pago!
A validação de permissão é por lançamento e usa a permissão de imprimir boleto do financeiro. Um operador sem essa permissão vê a terceira mensagem mesmo com tudo o mais certo.
FORA DO LOGIN, A MENSAGEM É OUTRA
O ERP considera logado quem acessa com usuário da mesma empresa do lançamento. Quando o boleto é aberto pelo link enviado ao cliente, sem esse login, as três primeiras checagens acima devolvem sempre a mesma frase: Este lançamento não está disponível!
A exceção é o lançamento já baixado: aí a resposta é Este lançamento já foi pago!, com ou sem login.
Por isso o cliente final costuma relatar uma mensagem genérica enquanto o operador, logado, vê o motivo detalhado. Para saber o motivo real, repita a emissão logado no ERP: a mensagem específica vai aparecer.
ONDE ESTÁ O MOTIVO REAL DO ERRO
Quando a integração recusa a cobrança, o ERP grava a mensagem devolvida como observação do lançamento (evento gerar cobrança) e passa a mostrar essa observação no lugar do texto genérico de erro. É o primeiro lugar a olhar: ali está o motivo real, vindo da Iugu, e não do ERP. Só quando não há observação gravada é que aparece Ocorreu um erro ao gerar a cobrança na Iugu.
AGRUPAMENTO
Antes de montar o agrupamento, o ERP olha a forma de pagamento de cada lançamento selecionado. Sendo forma de integração, ele pergunta à própria Iugu se aquele lançamento já tem transação registrada. Se tiver, recusa a operação com: O recebimento de número X possui integração com a Iugu, por isso não é possível agrupar. X é o código do recebimento. Em pagamentos, a mesma frase troca recebimento por pagamento.
Repare no que barra: não é a forma de pagamento ser da Iugu, é já existir cobrança registrada para aquele lançamento. Recebimento com forma da Iugu e sem cobrança gerada entra no agrupamento normalmente. As demais recusas (situações diferentes ou já confirmada, clientes, pedidos, compras ou notas fiscais diferentes, lojas diferentes, menos de duas movimentações selecionadas) são regra geral do Financeiro e valem para qualquer forma de pagamento.
EDITAR UM RECEBIMENTO QUE JÁ TEM COBRANÇA GERADA
Ao abrir a edição de um recebimento cuja forma de pagamento é da Iugu, o ERP consulta a integração antes de mostrar o formulário. Se já houver transação para aquele lançamento, ele pergunta: Você deseja gerar uma nova cobrança na Iugu com os dados atualizados? Respondendo que sim, a transação anterior é removida na hora, e o lançamento volta a aparecer como cobrança ainda não gerada até você gerar de novo. Respondendo que não, o lançamento muda no ERP e a cobrança que já foi para a Iugu continua como estava.
É a explicação para a queixa clássica: corrigi o valor (ou o vencimento) e o boleto do meu cliente continuou com o valor antigo. A cobrança que está na mão do cliente é a que foi gerada; mudar o lançamento no ERP não a reescreve. A mesma consulta acontece no agrupamento.
O QUE COSTUMA DAR ERRADO
Parou do nada, sem ninguém mexer. Quase sempre é uma das quatro validações acima, e a mais comum é o plano ou a permissão do usuário que mudou. Se as quatro passam, o motivo está na observação do lançamento, e ele vem da Iugu — credencial revogada ou reemitida no portal da Iugu é causa clássica. A chave da Iugu não deve ser enviada por chamado; se ela for exposta, gere outra no portal da Iugu e cadastre no aplicativo.
O lançamento está baixado e aparece como Cobrança gerada na Iugu, mas nunca foi gerada. É esperado: na listagem, todo lançamento baixado é exibido como gerado.
Trocaram a forma de pagamento do lançamento e ele voltou a Cobrança ainda não gerada na Iugu. Também é esperado: mudar a forma de pagamento de um lançamento limpa o estado e a data da cobrança.
Selecionou vários boletos e só um saiu. Na emissão em lote, ao encontrar o primeiro lançamento com integração o processo devolve o resultado daquele lançamento e encerra. Com Iugu, emita um a um.
Clicou duas vezes e ficou lento. Se a emissão do mesmo lançamento for pedida de novo em menos de quinze segundos, o ERP espera quinze segundos antes de chamar a Iugu de novo. É trava contra cobrança duplicada, não travamento.
Estornar remessa não desfaz nada na Iugu. Essa ação exige a permissão de exportar remessa (sem ela a resposta é Você não possui permissão para realizar esta ação!), só funciona sobre lançamento cujo estado seja gerada, apenas devolve o lançamento para não gerada dentro do ERP e responde Remessa estornada com sucesso!. O cancelamento da cobrança em si é assunto do aplicativo da Iugu.
O QUE NÃO ENTRA AQUI
Prazo de crédito, taxa, tarifa e condição comercial são da Iugu. Configuração da conta, credenciais e parâmetros de cobrança ficam no aplicativo da Iugu. Como funciona lançamento, baixa, conta bancária e conciliação é conteúdo do Financeiro do ERP.