Embedded Files
A integração do PlusCom com a API de Cobrança da Cresol permite enviar e acompanhar títulos de cobrança diretamente pelo sistema, sem a necessidade de gerar arquivos de remessa para as operações já homologadas.
Por meio da integração, o PlusCom poderá, conforme os serviços habilitados pela Cresol:
emitir títulos de cobrança;
consultar títulos;
obter o boleto em PDF;
solicitar alteração do vencimento;
solicitar a baixa de títulos;
consultar ocorrências e retornos da cobrança.
Importante: as regras, credenciais, serviços disponíveis e procedimentos de ativação podem ser alterados pela Cresol. Antes de configurar o ambiente de produção, confirme as informações com sua agência, cooperativa, gerente de relacionamento ou suporte da Cresol.
Este manual considera a documentação oficial consultada e a implementação atual do PlusCom. Em caso de divergência, prevalecem as orientações mais recentes fornecidas pela Cresol.
Antes de começar
Para utilizar a integração, a empresa precisa possuir:
conta-corrente ativa na Cresol;
serviço de cobrança bancária contratado;
carteira ou convênio de cobrança autorizado;
acesso à API de Cobrança habilitado para a conta;
login e senha fornecidos ou liberados pela Cresol;
autorização para utilização do ambiente de produção.
A contratação da cobrança bancária não significa, necessariamente, que o acesso à API já esteja habilitado. Confirme expressamente com a Cresol se a API foi liberada para a conta e para o convênio que será utilizado.
A documentação consultada não confirma a existência de um portal de autoatendimento no qual o cooperado possa criar sozinho as credenciais da API. Por isso, o login, a senha e o procedimento de ativação devem ser solicitados ou confirmados diretamente com a Cresol.
Ambientes de homologação e produção
A integração pode utilizar dois ambientes diferentes.
Homologação
O ambiente de homologação é destinado aos testes iniciais da integração. Os títulos enviados nesse ambiente não devem ser considerados cobranças bancárias reais.
Na documentação consultada, a autenticação de homologação utiliza:
um login fornecido pela Cresol;
o CPF ou CNPJ como senha, conforme a orientação recebida para o acesso.
A Cresol poderá alterar essa regra ou fornecer credenciais específicas. Confirme com o suporte antes de iniciar os testes.
A existência do ambiente de homologação não garante que todas as operações possam ser simuladas para qualquer conta. Confirme com a Cresol se emissão, consulta, PDF, alteração, baixa e ocorrências estão disponíveis no ambiente liberado para sua empresa.
Produção
O ambiente de produção realiza operações bancárias reais.
Para esse ambiente, deve ser utilizada a senha de acesso liberada ou configurada durante o processo de ativação da integração com a Cresol. Não utilize automaticamente o CPF ou CNPJ como senha de produção sem uma orientação expressa do banco.
Não altere para produção enquanto os testes não estiverem concluídos e a Cresol não tiver confirmado a liberação do convênio.
Como preencher as credenciais no PlusCom
Na integração atual do PlusCom, preencha os campos da seguinte maneira:
ID do Cliente → Login ou usuário fornecido pela Cresol
Chave Secreta do Cliente → Senha de acesso da Cresol
Chave de Aplicativo → Não é utilizada pela integração atual; deixe em branco
Ambiente → Homologação ou Produção
No ambiente de homologação, a documentação atualmente consultada informa o uso do CPF ou CNPJ como senha. No ambiente de produção, utilize a senha de acesso liberada ou configurada pela Cresol.
Atenção: a API utiliza outros parâmetros técnicos de autenticação definidos pela própria Cresol. Esses parâmetros fazem parte do protocolo da integração e não são credenciais que o usuário deve criar ou preencher no PlusCom.
Não copie para os campos de credenciais valores técnicos encontrados em exemplos da documentação.
Configurando a conta-corrente
Clique aqui para saber como configrar a conta-corrente no PlusCom.
Configurando a carteira de cobrança
Depois de configurar a conta-corrente, confira o cadastro da conta de cobrança utilizada para emitir os títulos.
se a carteira está vinculada à conta-corrente correta;
se o banco informado é a Cresol;
se o tipo de integração está configurado para API;
se o convênio ou carteira corresponde ao contrato de cobrança;
Juros e multa
Quando houver juros ou multa configurados no título, o PlusCom enviará essas informações para a Cresol conforme as regras da integração.
Na configuração atual:
os juros podem ser enviados como percentual;
a multa pode ser enviada como percentual;
quando não houver cobrança, os valores devem permanecer zerados ou não informados.
Boleto híbrido e QR Code Pix
A documentação e os retornos atualmente disponíveis não confirmam, por si só, que o boleto híbrido esteja contratado e habilitado para a conta.
Além disso, a integração atual da Cresol no PlusCom não envia uma chave Pix nem uma solicitação específica para inclusão de QR Code.
Por esse motivo:
deixe a opção genérica de Boleto Híbrido Pix desativada;
não informe uma chave Pix na configuração da Cresol;
somente habilite essa modalidade após receber orientação formal da Cresol e do suporte do PlusCom.
A ausência de QR Code no retorno não significa necessariamente que o boleto deixou de ser emitido. Não repita o envio apenas porque o QR Code não foi retornado.
Cuidados em caso de falha no envio
Uma interrupção de internet, demora excessiva ou erro temporário pode acontecer depois que a Cresol já tiver recebido o título.
Nessa situação, o PlusCom poderá indicar que o resultado do envio é indeterminado.
Isso significa que ainda não é possível afirmar se o título foi criado ou não.
Não envie o mesmo título novamente sem antes consultá-lo ou conciliá-lo.
O reenvio sem consulta pode gerar cobranças duplicadas. Sempre verifique o título no PlusCom e, quando necessário, confirme a situação com a Cresol.
Consulta de ocorrências e liquidação
As ocorrências informadas pela API representam eventos bancários relacionados aos títulos, como entrada, alteração, baixa, rejeição ou pagamento.
Nem toda ocorrência representa uma liquidação financeira definitiva.
O PlusCom somente deve realizar a baixa financeira automática quando o código da ocorrência e a regra de processamento estiverem devidamente confirmados. Até que essa validação esteja concluída, confira os retornos antes de concluir a liquidação das parcelas.
Uma solicitação de baixa também não deve ser confundida com baixa financeira:
solicitação de baixa: pedido enviado ao banco para retirar o título da cobrança;
baixa financeira: registro, no PlusCom, de que o valor foi efetivamente recebido.
Problemas mais comuns
O teste de conexão foi recusado
Verifique:
se o ambiente está correto;
se o login foi informado no campo ID do Cliente;
se a senha foi informada no campo Chave Secreta do Cliente;
se não existem espaços nas credenciais;
se a API está habilitada para a conta;
se a senha utilizada corresponde ao ambiente selecionado.
A conexão funciona, mas o título é rejeitado
Confira:
CPF ou CNPJ do pagador;
nome e endereço completo;
CEP, município e estado;
data de vencimento;
valor do título;
Nosso Número;
espécie configurada;
conta, carteira e convênio;
regras de juros e multa.
A consulta ou o PDF não funciona em homologação
A operação pode não estar disponível ou não ter sido liberada para o ambiente utilizado. Confirme com a Cresol quais serviços podem ser testados com as suas credenciais.
O boleto foi emitido sem QR Code
A emissão sem QR Code não indica, necessariamente, erro. O boleto híbrido depende de disponibilidade, contratação e habilitação específicas. Não reenvie o título por esse motivo.
O envio ficou com resultado indeterminado
Não faça um novo envio imediatamente. Consulte o título e realize a conciliação antes de autorizar qualquer reprocessamento.
Informações que devem ser confirmadas com a Cresol
Antes de entrar em produção, solicite uma confirmação formal dos seguintes pontos:
A API de Cobrança está habilitada para a conta e para o convênio?
Qual login deve ser utilizado em produção?
Como é criada, liberada ou redefinida a senha de produção?
A homologação ainda utiliza CPF ou CNPJ como senha?
O CPF ou CNPJ deve ser informado com ou sem pontuação?
Quais operações estão disponíveis em homologação?
Qual espécie deve ser utilizada para os títulos da empresa?
Como deve ser formado ou controlado o Nosso Número?
O boleto híbrido com QR Code Pix está disponível para o contrato?
É necessário algum dado adicional para habilitar o boleto híbrido?
Quais ocorrências autorizam a baixa financeira?
Existe alguma credencial adicional ou chave de aplicativo na versão atual da API?
É necessária uma aprovação de homologação antes da liberação da produção?
Segurança das credenciais
O login e a senha permitem que o PlusCom acesse serviços bancários da empresa. Essas informações devem ser tratadas como confidenciais.
Nunca envie credenciais por mensagens abertas, e-mail comum ou aplicativos de conversa. A própria Cresol orienta que senhas e dados de acesso não sejam compartilhados em contatos não solicitados. Utilize somente os canais oficiais da cooperativa. Consulte também as orientações de segurança da Cresol.
Documentação oficial
A referência técnica utilizada nesta integração está disponível no Guia de Referência da API Boletos Cresol.
A Cresol poderá atualizar o guia, os ambientes, as credenciais ou os serviços oferecidos. Consulte a documentação oficial e confirme as condições com sua agência ou cooperativa antes de realizar alterações na configuração de produção.
Page updated
Google Sites
Report abuse