> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Emita a CCB > Faça o Lender emitir a CCB ou emita você mesmo, e depois registre a CCB assinada na proposta de empréstimo. A CCB (*Cédula de Crédito Bancário*) evidencia o contrato de crédito de um empréstimo direto. A versão do produto diz quem a emite: o Lender gera o PDF, ou a sua instituição gera. ## Escolha quem emite a CCB *** Uma versão de produto declara `terms.creditInstrumentMode` quando você [a cria](https://docs.lerian.studio/pt/products/lender/define-a-loan-product.md). O valor é `lender_emitted` (o padrão) ou `client_issued`. Uma versão nunca muda, então outro emissor exige uma versão nova. | Tópico | `lender_emitted` | `client_issued` | | - | - | - | | Quem gera o PDF | O Lender, a partir do template de documento publicado do produto | Sua instituição | | O que você registra depois | A CCB assinada, apontando a CCB que o Lender emitiu | A CCB assinada, com o digest do documento que a sua instituição emitiu | | O que o Lender recusa | Emissão em uma proposta que não está aprovada | Qualquer emissão: `LENDER-0601` | ## O Lender emite a CCB *** **1. Publique um template de documento** O produto precisa de um template publicado antes de o Lender emitir. [Crie um rascunho](https://docs.lerian.studio/pt/reference/products/lender/create-document-template-draft.md) com `POST /api/v1/loan-products/{productId}/document-templates` e [publique-o](https://docs.lerian.studio/pt/reference/products/lender/publish-document-template.md). Publicar uma nova versão substitui a ativa. Sem template ativo, a emissão responde `LENDER-0616`. **2. Aprove a proposta e emita antes da liberação** O Lender só emite para uma proposta `approved`. Uma proposta que já foi desembolsada responde `LENDER-0602`, então emita entre a aprovação e a [liberação](https://docs.lerian.studio/pt/products/lender/originate-a-loan.md#record-a-release-your-institution-made). **3. Emita a CCB** [`POST /api/v1/loan-applications/{applicationId}/credit-instruments`](https://docs.lerian.studio/pt/reference/products/lender/issue-credit-instrument) recebe `idempotencyKey` no corpo, não em um cabeçalho, e um bloco `parties` com nomes e documentos do emissor e do credor, os locais de emissão e de pagamento e qualquer outro campo que o template declare. A mesma chave devolve a mesma CCB, com `X-Idempotency-Replayed: true`. A mesma chave com outro bloco `parties` é recusada. **4. Liste e baixe** [`GET .../credit-instruments`](https://docs.lerian.studio/pt/reference/products/lender/list-credit-instruments) lista as emissões, da mais nova para a mais antiga. Uma emissão anterior traz `supersededByInstrumentId`. O bloco `issuance` diz se a proposta pode ter uma CCB emitida agora (`canEmit`) e, quando não pode, o código que a emissão devolveria (`refusalCode`). [`GET .../credit-instruments/{instrumentId}/download`](https://docs.lerian.studio/pt/reference/products/lender/download-credit-instrument) devolve o PDF que o Lender guarda. ## Sua instituição emite a CCB *** Em uma versão `client_issued`, o Lender não emite CCB. `POST .../credit-instruments` responde `LENDER-0601`, e a lista mostra `canEmit: false` com o mesmo `refusalCode`. Gere o documento e colete a assinatura por conta própria, e depois [registre a CCB assinada](#record-the-signed-ccb). Guarde o digest do documento como ele estava antes da assinatura: o registro é recusado com `LENDER-0608` quando `originalDocumentDigest` falta ou quando `creditInstrumentId`, que aponta uma CCB emitida pelo Lender, é enviado. ## Registre a CCB assinada *** Registre a CCB assinada depois que as partes assinarem, em uma proposta `approved` ou `disbursed`, nos dois modos. [`POST /api/v1/loan-applications/{applicationId}/signed-credit-instrument`](https://docs.lerian.studio/pt/reference/products/lender/record-signed-credit-instrument) recebe: | Campo | O que enviar | | - | - | | `document` | O PDF assinado em base64, com o alfabeto padrão, de até 20 MiB decodificado. | | `signedDocumentDigest` | O sha-256, em hexadecimal, do documento decodificado. O Lender calcula o dele e recusa a divergência com `LENDER-0605`. | | `creditInstrumentId` | Só em `lender_emitted`: o `id` da CCB que o Lender emitiu para esta proposta. Obrigatório nesse modo e recusado em `client_issued`. Sem ele, ou com o id da CCB de outra proposta, o Lender responde `LENDER-0607`. | | `originalDocumentDigest` | O sha-256, em hexadecimal, do documento que foi assinado. Obrigatório em `client_issued`. Em `lender_emitted` é opcional, e o Lender o confere com a CCB dele. | | `signedAt` | Quando a assinatura foi concluída. No máximo 5 minutos depois do relógio do Lender, para absorver um provedor de assinatura com o relógio adiantado. | | `evidenceRef` | Sua referência à evidência da assinatura, com até 1.024 bytes. | | `signatories` | Todas as partes que assinaram, de 1 a 20. Cada uma tem `role` (até 64), `name` (até 256), `taxId` (até 32) e `signedAt`, que não pode ser posterior ao `signedAt` do instrumento. O Lender guarda nome e documento e nunca os devolve. | Esta rota não recebe o cabeçalho `X-Idempotency`. Enviar o mesmo documento de novo devolve o registro mais novo, com `X-Idempotency-Replayed: true`, e ignora qualquer metadado que difira no reenvio: ele não atualiza o registro. ## Troque a CCB assinada *** Um documento diferente é recusado com `LENDER-0604`, a menos que seja uma troca. Para trocar, leia o registro mais novo e envie o documento novo com `supersedes` igual ao `id` desse registro e um `replacementReason` de uma linha, com até 500 caracteres. Os dois vão juntos. O registro trocado continua no histórico, e vale o mais novo. Um documento que já pertence a um registro anterior não pode voltar como troca: o Lender responde `LENDER-0613`. Para voltar a esse conteúdo, envie um arquivo novo, como uma nova exportação, cujos bytes sejam diferentes. ## Leia e baixe *** [`GET /api/v1/loan-applications/{applicationId}/signed-credit-instrument`](https://docs.lerian.studio/pt/reference/products/lender/get-signed-credit-instrument) devolve o registro mais novo. `custodian` diz quem guarda o PDF: `lender` ou `integrator`. [`GET .../signed-credit-instrument/download`](https://docs.lerian.studio/pt/reference/products/lender/download-signed-credit-instrument) entrega o PDF que o Lender guarda. Para um registro cujo custodian é `integrator`, ele responde `LENDER-0614`: o PDF fica com o integrador, e o `signedDocumentDigest` da leitura confere os bytes dele. ## Recusas *** | Código | Status | O que significa | O que fazer | | - | - | - | - | | `LENDER-0601` | `422` | A versão do produto deixa a CCB para a instituição, então o Lender não emite uma. | Emita você mesmo e registre a CCB assinada. Para o Lender emitir, registre a proposta em uma versão `lender_emitted`. | | `LENDER-0602` | `409` | A proposta não está aprovada, então o Lender não pode emitir a CCB dela. | Aprove a proposta e emita de novo. | | `LENDER-0604` | `409` | A proposta já tem uma CCB assinada, e o pedido enviou um documento diferente sem apontar o registro que ele troca. | Troque com `supersedes` e `replacementReason`, ou reenvie os mesmos bytes. | | `LENDER-0605` | `422` | `signedDocumentDigest` não é o sha-256 que o Lender calculou sobre o documento. | Calcule o hash sobre os bytes exatos que você codifica em `document`. | | `LENDER-0607` | `422` | O Lender emitiu a CCB desta proposta, e o pedido não a aponta. | Envie o `id` da CCB que foi assinada, tirado da lista. | | `LENDER-0608` | `422` | A instituição emite a CCB: `creditInstrumentId` foi enviado, ou falta `originalDocumentDigest`. | Remova `creditInstrumentId` e envie `originalDocumentDigest`. | | `LENDER-0613` | `409` | O documento já pertence a um registro anterior. | Envie um arquivo novo, de bytes diferentes. | | `LENDER-0614` | `409` | A CCB assinada mais nova está com o integrador. | Busque o PDF com o integrador. | | `LENDER-0616` | `422` | O produto não tem template de documento ativo. | Publique um template e emita de novo. | A página de referência de cada operação lista as outras recusas dela: as páginas de [emissão](https://docs.lerian.studio/pt/reference/products/lender/issue-credit-instrument.md), de [registro](https://docs.lerian.studio/pt/reference/products/lender/record-signed-credit-instrument.md), de [leitura](https://docs.lerian.studio/pt/reference/products/lender/get-signed-credit-instrument.md) e de [download](https://docs.lerian.studio/pt/reference/products/lender/download-signed-credit-instrument.md), e as de [criação](https://docs.lerian.studio/pt/reference/products/lender/create-document-template-draft.md) e de [publicação](https://docs.lerian.studio/pt/reference/products/lender/publish-document-template.md) do template. ## No console *** O console mostra a CCB de cada proposta em **Instrumentos de crédito**: veja [Instrumentos de crédito](https://docs.lerian.studio/pt/products/lender/console/credit.md#credit-instruments). ## Próximos passos *** > [card] [Origine um empréstimo](https://docs.lerian.studio/pt/products/lender/originate-a-loan.md) > > Leve uma proposta do envio até a liberação. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.