Iugu: o aplicativo, a integração por loja e o formulário de conexão

A IUGU TEM APLICATIVO PRÓPRIO
A Iugu não é só uma linha na tela de Integrações do ERP. Ela é um aplicativo próprio, com tela inicial própria e cadastro de integrações próprio. Isso muda o suporte: quase tudo o que o cliente reclama da Iugu acontece dentro desse aplicativo, não na tela geral de Integrações.

A tela inicial do aplicativo tem barra de título "Iugu" e dois cards, só isso: Recebimentos e Integrações — este último leva ao cadastro da conexão com a Iugu. Quando o aplicativo está em período de demonstração, aparece acima dos cards uma faixa dizendo que a versão de demonstração deste aplicativo expira (hoje, amanhã, em tantos dias) ou já expirou, com um link para contratar. A faixa nasce amarela e fica vermelha quando o vencimento está a cinco dias ou menos.

Repare em uma coisa que evita confusão: o que é realmente do aplicativo Iugu é a tela inicial e o cadastro de integrações. Recebimentos, lançamento, baixa, conta bancária e cadastro de cliente continuam sendo do ERP e se respondem pelo conteúdo do ERP, não por aqui.

O card Recebimentos tem um defeito conhecido: o endereço para onde ele aponta não é o mesmo da tela de recebimentos do aplicativo, e por isso ele cai em "Página não encontrada". A tela existe — ela é a lista de recebimentos do Financeiro do ERP, filtrada e com alguns recursos desligados, e está descrita na fonte sobre o que o aplicativo faz. Não é integração com defeito, chave errada, permissão nem plano. Enquanto não for corrigido, use os recebimentos pelo Financeiro do próprio ERP e registre o chamado.

A INTEGRAÇÃO É POR LOJA
Este é o ponto que mais gera chamado. A conexão com a Iugu não é uma chave única da empresa: cada integração é um registro, cada registro está ligado a uma forma de pagamento, e o conjunto vale para a loja em que foi cadastrado. Quem tem duas lojas precisa cadastrar a integração em cada uma.

Por isso existe a tela de apresentação da Iugu, com o botão "Adicionar integração". Quando a loja não tem nenhuma integração cadastrada, o sistema avisa: "Esta loja não está integrada a Iugu.". Esse aviso não é erro de sistema nem chave errada. Ele está dizendo, literalmente, que a loja em que você está agora não tem registro. Confira a loja selecionada antes de qualquer outra coisa e use o botão "Adicionar integração" — a tela de adicionar abre mesmo com a loja ainda sem integração.

OS CAMPOS DO FORMULÁRIO
No formulário do aplicativo a lista de campos é fechada. São seis, e não existe nenhum outro:

Forma de pagamento - obrigatório. É uma lista pronta, montada pelo sistema. Você escolhe qual forma de pagamento vai passar pela Iugu.
API Key - obrigatório. É a chave que você gera no portal da Iugu. O sistema não gera essa chave.
Juros de multa (%) - lista de escolha. A ajuda do campo diz: "O percentual máximo autorizado é de 2%, de acordo artigo 52, parágrafo primeiro do Código de Defesa do Consumidor, Lei 8.078/90."
Juros de mora (%) - lista de escolha. A ajuda do campo diz: "Aplicar 1% de juros máximo ao mês, esse percentual será cobrado proporcionalmente aos dias de atraso."
Dias para saque - obrigatório. Já vem preenchido com 2.
Tarifa (R$) - a ajuda do campo diz: "Taxa cobrada pelo Iugu (ex: taxa por boleto pago). Obs.: Este valor será lançado somente em recebimentos confirmados." Ou seja, esse valor não é lançado antecipadamente: ele entra quando o recebimento é confirmado.

Multa e mora começam em 0,00. Se você não mexer, fica sem multa e sem juros.

O QUE VOCÊ VÊ DEPOIS DE CADASTRAR
A listagem de integrações mostra as colunas Forma de pagamento, Juros de multa (%), Juros de mora (%), Dias para saque e Tarifa (R$), com as ações Visualizar, Editar e Deletar. Tem campo de busca e o botão Adicionar, porque a mesma loja pode ter mais de uma integração, cada uma na sua forma de pagamento.

A API Key não aparece na listagem nem na tela de Visualizar — foi retirada de propósito, por segurança. Se você não tem mais a sua chave em mãos, não peça para o suporte lê-la: gere outra no portal da Iugu e atualize a integração. A tela de Editar abre o mesmo formulário com os dados gravados; o campo API Key continua lá e é obrigatório, então, se ele aparecer em branco, informe uma chave válida antes de salvar.

A tela de Visualizar mostra os mesmos cinco campos e mais quem cadastrou a integração, a data de cadastro e a data da última alteração. É por ali que você descobre quem mexeu e quando.

Deletar pede confirmação, citando a forma de pagamento da integração que será removida.

POR QUE ELE TE JOGA DE VOLTA PARA INTEGRAÇÕES
Queixa clássica: "cadastrei e toda hora volta para a tela de Integrações". O mecanismo é este. Antes de abrir qualquer tela do aplicativo, o sistema pergunta se aquela loja tem integração. Se a resposta vier negativa, a navegação é interrompida e você é devolvido para a tela de Integrações com o aviso "Esta loja não está integrada a Iugu.". E, se a lista de integrações daquela loja voltar vazia, o aplicativo manda você para a tela inicial — que também consulta e devolve. É esse vaivém que dá a sensação de laço.

Ficam de fora dessa checagem, de propósito, só a tela de login, a lista de Integrações, a tela de adicionar integração e as telas de Planos — para você conseguir entrar, cadastrar a integração e contratar o aplicativo mesmo sem registro na loja. As telas de editar e visualizar integração passam pela checagem normalmente.

Traduzindo: não é a tela travando nem sessão caindo. É o aplicativo dizendo que a loja atual continua sem integração. Cadastre a integração na loja certa e o vaivém para.

O QUE COSTUMA DAR ERRADO
Você cadastrou, mas em outra loja. Sintoma: aviso de loja não integrada e o vaivém acima. Troque a loja e confira a listagem.
A forma de pagamento que você quer não aparece na lista. A lista é montada pelo sistema. Confira o cadastro dessa forma de pagamento e as integrações já criadas nesta loja; se continuar sem aparecer, registre o chamado.
Chave inválida ou revogada no portal da Iugu. O cadastro grava, mas as operações falham. Gere outra chave no portal e edite a integração.
Forma de pagamento sem vínculo com a integração. Ao imprimir o boleto, o financeiro devolve "Forma de pagamento ... não vinculada a integração!". O caminho é o cadastro da forma de pagamento.
Demonstração vencida. Se a faixa da tela inicial diz que a demonstração deste aplicativo expirou, o assunto é contratação do aplicativo, e não configuração da integração.

NÃO CONFUNDA COM O BOLETO DA SUA ASSINATURA
O boleto da assinatura do próprio ERP também é emitido pela Iugu, pela conta da Iugu do próprio sistema — não pela sua chave. Quando o cliente abre o boleto do sistema e vê o nome Iugu, ele acha que é a integração dele. Não é. São duas coisas separadas: uma é a cobrança do sistema para você; a outra é a sua integração, que você cadastra no aplicativo da Iugu para cobrar os seus clientes. Mexer na tela de Integrações não altera em nada o boleto da assinatura, e cancelar a integração não cancela nada da sua mensalidade. Se a dúvida traz mensagens do tipo "Este boleto já foi pago!" ou "Você não colocou o seu endereço. Por favor, gere outro boleto!" (o mesmo vale para telefone e e-mail), o assunto é plano, não integração.

ONDE ESTÁ O RESTO
O passo a passo comum a qualquer meio de pagamento e o funcionamento geral do Pix estão no conteúdo de Meios de pagamento. O índice geral de integrações, o vínculo com a loja e o efeito de remover uma integração estão no conteúdo raiz de Integrações. O que a Iugu faz no financeiro — gerar a cobrança, as mensagens do recebimento e o que barra a emissão — está na fonte do financeiro. Acesso e permissões do módulo estão no conteúdo específico de acesso. Aqui ficou só o que é da Iugu.