Consulta da CCB

Como consultar a Cédula de Crédito Bancário (CCB)

Na CCB estão identificadas as partes envolvidas (tomador, beneficiário, correspondente e credor) e descritas as características e condições da operação (modalidade, valor líquido do crédito, carência, taxas, quantidade, data de vencimento e valor das parcelas, etc). O documento - gerado após a verificação da conformidade da proposta - deve ser disponibilizado ao consumidor que solicitou a proposta de crédito para que analise seu conteúdo até a data limite de expiração da mesma.

Para baixar a CCB primeiramente é necessário consultar seus detalhes utilizando o identificador interno ou externo da proposta, conforme exemplo abaixo.

curl --location --request GET 'https://<instance-url>.btcore.app/credit/proposals/6171be607c6a67000891cdc6/ccb' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <oauth_bearer_token>'

A propriedade ccb_unsigned do objeto JSON retornado na resposta da consulta (ver exemplo abaixo) contém a URL por meio da qual é possível baixar a CCB digital não assinada. Importante observar que a URL retornada é gerada no momento da consulta e expira em 12 horas.

{
    "event": "ccb",
    "id": "6185bd00ffed6e000961e072",
    "ccb_number": "614614012",
    "ccb_unsigned": "https://parati-files.s3.amazonaws.com/sandbox/5d2f425a73f3840006cda9b2/ccb/unsigned/6185bd00ffed6e000961e072.pdf?AWSAccessKeyId=ASIAWA7LQUTB4J5GJP3D&Signature=LNZi0ErNaHV37AWalMTt6WTA%2BaA%3D&x-amz-security-token=IQoJb3JpZ2luX2VjENf%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJHMEUCIQCsGPlYpHhZpsPIW55ex7ukQSVwsaXSO%2BGH8HT3%2BHAxjQIgD73yvCUuDx0dKBwLG4c7Q0L05tU2HYNKC8huqBwkg4IqkQIIgP%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARACGgw0MTQ0MjEzOTQ2MjciDECBn%2FbP5xcQgNznZSrlAX1o0WUkAhxVf1lvsUEvJPzvVNby%2BcYuEA3UdrwoK3m78fFAqIxnNfD9ORfm0OZDx3ueY%2BoPyx%2BgQ%2BAqueqNnrQeOOhEnL4LOqi6hL%2FxCGlnOr3gYzvaWua5jzUNmWHXCsYIZVt7fy9%2BJBldom9PjgeTOlMuQhvxCSJ6xRT2c%2BrA3Bi3t8SmfmtVRGPQb9NzazEYxi%2BpuP9v0X6cJ6CiMfNKwYBUg7e9ghCdxrymEVHpOHAdEBQwHGdbBGJaiHZXW3K2Tmh4EfFiySbYk9qjDDAbkbMSSzIOrtF9iEO51uurpVPcb%2FUwjvCWjAY6mgGwIoU5yH8WXizCp28BJrvHF8SOYzQb0Ywic13lmad8oBI%2FAnEVTCWLDphLO0ocsTVKpo5pbUQdLZKh8ipoGfXzUEP7oNhfkHaOfE5j%2FiUiZBroR0dSpJy1yYAZFCTeG1pLegR65zePx6BNhoPBC8fo%2BX23eKWuPFnHh7p%2BRnqWjZ9%2FGTgd03Xg5OgBxSyy5aHrEAoGdatIAC6K&Expires=1636158732"
}

Abaixo são detalhadas as propriedades do objeto JSON retornado na resposta do endpoint de consulta da CCB.

CampoRequeridoTipoDescrição
eventsimTextoNome do recurso
idsimTextoIdentificador interno da proposta de empréstimo (chave primária do banco de dados)
ccb_numbersimTextoIdentificador único da CCB
ccb_unsignedsimTextoURL do arquivo da CCB digital sem a assinatura
ccb_endoresednãoTextoURL do arquivo da CCB digital assinado