Pular para o conteúdo principal

Cora (403)

Yago Xavier
Atualizado

Dicas de cadastro para contas e convênios do Banco Cora pela GUI ou API

Via Inteface do PlugBoleto

Abaixo separamos algumas dicas para auxiliar no cadastro de um conta e convênio de determinados bancos.

Lembrando que não são regras, são apenas algumas dicas para facilitar na integração, porém, é muito importante que os dados do cedente (número da conta, agência, CNAB,...) sejam sempre confirmados com o banco, para evitar problemas na emissão dos boletos.

 

Conta Corrente

Campo Dica
Código Banco Neste campo deverá ser informado o código do banco de acordo com a FEBRABAN.
Para o Cora deverá ser informado o valor 403.
Tipo Campo referente ao TIPO da conta.
Valores aceitos, Corrente ou Poupança
Agência No campo agência pode ser informado o número da agência da conta.
Este campo é composto por 4 dígitos, o campo referente ao DV da agência pode ficar vazio.
Dica de preenchimento, 1234.
Número Campo referente ao número da conta.
Campo composto por 6 dígitos mais um DV.
Dica de preenchimento, 123456-7.
Código Beneficiário Neste campo pode ser informado o número da conta.
Exemplo de preenchimento, 123456. De 1 a 7 dígitos.

 

Convênio

Campo Dica
Número Convênio Neste campo pode ser informado a agência mais o número da conta com o DV.
Exemplo de preenchimento, 12341234567.
Descrição Convênio Este campo é obrigatório porém não tem validação, e pode ser informado um texto livre como Convênio Cora.
Carteira Para o banco Cora, estão disponíveis a carteira:
09 - Cobrança com registro
Espécie Espécie do Titulo Ex: R$.
Padrão CNAB Laytout adotado pelo banco.
Valor aceito: 240 ou 400.
Registro Instantâneo Marque como true, clique aqui para continuar com a habilitação.

 

Via API

Para realizar o cadastramento de contas e convênios para utilização do Cora existem alguns passos extras que precisam ser executados. Para isso, basta seguir os passos abaixo:

 

1. Criar Nova Conta

Primeiramente é necessário criar uma conta do Cora para utilização do banco e APIs. 

Homologação:

POST
https://homologacao.plugboleto.com.br/api/v1/cedentes/contas

Produção:

POST
https://plugboleto.com.br/api/v1/cedentes/contas

Body:

{
    "ContaCodigoBanco": "403",
    "ContaAgencia": "0000",
    "ContaAgenciaDV": "0",
    "ContaNumero": "00000",
    "ContaNumeroDV": "0",
    "ContaTipo": "CORRENTE",
    "ContaCodigoBeneficiario": "000000"
}

 

2. Criar Novo Convênio

Para criar um convênio, basta informar os campos  "convenioapiid" , "convenioapisecret". Além das demais informações básicas do convênio citadas anteriormente.

Homologação:

POST
https://homologacao.plugboleto.com.br/api/v1/cedentes/contas/convenios

Produção:

POST
https://plugboleto.com.br/api/v1/cedentes/contas/convenios

Body:

{
  "convenioespecie": "R$",
  "convenioreiniciardiariamente": true,
  "convenionossonumeroconciliarbanco": true,
  "convenioconsultafrancesa": false,
  "baixarapenasboletoregistrado": false,
  "somaroutrosacrescimosretorno": false,
  "conveniobaixartransferidoparadesconto": false,
  "gerarNumeroRepetidoRemessa": false,
  "adicionadiavencimentofinalsemana": true,
  "conveniocarteira": "0",
  "convenionumero": "0000",
  "conveniodescricao": "0",
  "conveniopadraocnab": "240",
  "convenioregistroinstantaneo": true,
  "convenioconsultaws": true,
  "conta": "00000",
  "carteiracodigo": null,
  "convenionossonumerobanco": false,
  "convenioapiid": "0000",
  "convenioapisecret": "00000"
}

 

3. Gerar Código de Autorização:

Para autorizar os dados no Cora e utilizar as APIs, precisamos gerar um código de autorização.

Homologação:

POST
https://homologacao.plugboleto.com.br/api/v1/oauth2/connect

Produção:

POST
https://plugboleto.com.br/api/v1/oauth2/connect

Body (produção e homologação):

{
    "convenioId": "", //Identificador numérico disponível após o cadastro do convênio
    "apiId": "client-id-fornecido-pelo-banco"
}

Response:

{
    "_status": "sucesso",
    "_dados": {
        "oauth2_url": "https://api.stage.cora.com.br/oauth/authorize?client_id=app-client-id-fornecido-pelo-banco&response_type=code&redirect_uri=https://plugboleto.com.br/api/v1/authorization/callback&scope=invoice&state=identificador",
        "ambiente": "sandbox"
    }
}

A API retornará um link que deverá ser acessado via navegador. O ambiente de desenvolvedor será disponibilizado para que possa seguir com a criação do código (lembre-se, uma conta desenvolvedora deve existir para que consiga acessar o ambiente).

Assim que seguir em frente, será redirecionado para a URL cadastrada anteriormente informando se houve sucesso ou falha em sua autorização.

Assim que tiver sucesso, uma requisição de autenticação será enviada ao banco para obtermos o access_token e refresh_token. O refresh token tem uma duração de 1 dia e, toda vez que é utilizado, tem sua duração redefinida para 1 dia.

Portanto, esses dados são cruciais para garantir as emissões sem a necessidade de refazer os fluxos anteriores, evitando acionamentos aos clientes finais para autenticação.

Em caso de falha ao autenticar no banco, será exibida uma mensagem de erro na interface informando que ocorreu algum problema.

 

Atenção

No ambiente de homologação o Token não é atualizado automaticamente. O token possui duração de apenas 24 horas. Portanto, para continuar utilizando o produto em homologação, deverá repetir o processo 2 e 4 deste manual para obter novas credenciais.

No ambiente de produção, o token é atualizado diariamente.

Consulte nossa documentação para saber quais campos utilizados para inclusão de boletos.  

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.