> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Comprovantes de averbação e cancelamento

> Serviços para impressão dos arquivos dos comprovantes de averbação e cancelamento das operações de crédito consignado.

## Comprovantes de Averbação e Cancelamento

Esta seção descreve os serviços disponíveis para **obtenção e impressão dos comprovantes de averbação e cancelamento** das operações de crédito consignado. Ambos os documentos são **gerados automaticamente** após o recebimento, pelo sistema BMP, do **código de averbação ou cancelamento** retornado pela DATAPREV.\
O sistema aguarda o retorno da DATAPREV para iniciar a geração do documento, que passa a ficar disponível **em poucos segundos** após a confirmação da operação. Os comprovantes podem ser acessados:

* Via **API**, conforme os endpoints descritos abaixo; ou
* Pelo **Portal Partner**, na aba **Documentos** da proposta.

> **Disponibilidade:**\
> Os documentos ficam disponíveis para consulta via API por um período de **90 (noventa) dias**.

***

## Conteúdo do Documento

Os comprovantes de averbação e cancelamento possuem a seguinte estrutura de informações:

| Campo                   | Descrição                                                                 |
| ----------------------- | ------------------------------------------------------------------------- |
| Código da operação      | Código retornado pela DATAPREV                                            |
| Data e hora da operação | Data e hora em que a operação foi efetuada (formato: DD/MM/AAAA HH:MM:SS) |
| Empresa                 | BMP Sociedade de Crédito Direto S/A                                       |
| CNPJ                    | 34.337.707/0001-00                                                        |
| Emitente                | Nome do emitente da operação                                              |
| CPF                     | CPF do emitente da operação                                               |
| Data de emissão da CCB  | Data e hora da criação da proposta (formato: DD/MM/AAAA HH:MM:SS)         |
| Nº da CCB               | Número da Cédula de Crédito Bancário                                      |
| Valor solicitado        | Valor solicitado pelo cliente                                             |
| Valor IOF               | Valor do IOF da operação                                                  |
| Valor outras despesas   | Outros custos vinculados à operação (ex.: seguro), quando aplicável       |
| Valor total financiado  | Valor total financiado da operação                                        |
| Valor total da dívida   | Valor total da dívida da operação                                         |
| Taxa de juros aplicada  | Taxa de juros aplicada na operação                                        |
| Tabela de parcelas      | Número da parcela, data de vencimento e valor da parcela                  |

***

## Comprovante de Averbação

### Endpoint

**GET** `/contrato/comprovante-averbacao`

### Parâmetros

| Parâmetro        | Tipo   | Obrigatório | Descrição                 |
| ---------------- | ------ | ----------- | ------------------------- |
| `NumeroContrato` | string | Sim         | Número da CCB da operação |

<AccordionGroup>
  <Accordion title="Exemplo de Requisição">
    ```bash theme={null}
    curl --location --globoff --request GET 'https://econsignadotrabalhador.moneyp.dev.br/contrato/comprovante-averbacao?NumeroContrato={numeroCCB}' \
    --header 'Authorization: Bearer {token}'
    ```
  </Accordion>

  <Accordion title="Exemplo de retorno">
    ```json theme={null}
    {
    "CodigoRequisicao": "b1d12beb-2496-4748-a9e1-7a49983a84b9",
    "Origem": "/comprovante-averbacao",
    "Conteudo": {
    	"NumeroContrato": "5218013",
    	"NomeArquivo": "5218013_comprovante_averbacao",
    	"Extensao": "pdf",
    	"ConteudoBase64": "ConteudoBase64"
    },
    "Erros": []
    }
    ```
  </Accordion>
</AccordionGroup>

***

## Comprovante de Cancelamento

### Endpoint

**GET** `/contrato/comprovante-cancelamento`

### Parâmetros

| Parâmetro        | Tipo   | Obrigatório | Descrição                 |
| ---------------- | ------ | ----------- | ------------------------- |
| `NumeroContrato` | string | Sim         | Número da CCB da operação |

<AccordionGroup>
  <Accordion title="Exemplo de Requisição">
    ```bash theme={null}
    curl --location --request GET 'https://econsignadotrabalhador.moneyp.dev.br/contrato/comprovante-cancelamento?NumeroContrato={numeroCCB}' \ --header 'Authorization: Bearer {token}'
    ```
  </Accordion>

  <Accordion title="Exemplo de retorno">
    ```json theme={null}
    {
    "CodigoRequisicao": "b1d12beb-2496-4748-a9e1-7a49983a84b9",
    "Origem": "/comprovante-cancelamento",
    "Conteudo": {
    	"NumeroContrato": "5218013",
    	"NomeArquivo": "5218013_comprovante_cancelamento",
    	"Extensao": "pdf",
    	"ConteudoBase64": "ConteudoBase64"
    },
    "Erros": []
    }
    ```
  </Accordion>
</AccordionGroup>

## Considerações Técnicas

* Os comprovantes são gerados **somente após a confirmação** da averbação ou cancelamento pela DATAPREV;
* O campo `ConteudoBase64` contém o arquivo do comprovante em formato **PDF**, codificado em Base64;
* É responsabilidade do parceiro realizar a **decodificação e armazenamento**, se necessário;
* Após o período de 90 dias, os documentos **não estarão mais disponíveis via API**.