> ## 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.

# Atualizações sobre garantias e fluxo de autorização

Prezados,

Durante o processo de descoberta e definição do escopo da solução de garantias, foi identificada a necessidade de integração com uma nova API para consulta de saldo do FGTS. Essa API exige, como pré-requisito, a coleta do termo de autorização para consulta de dados.

O fluxo atual de autorização já possuía uma atividade em backlog para revisão, uma vez que apresentava duas limitações principais:

* **Compliance:** ausência de evidências da autorização pelo parceiro;
* **Usabilidade:** baixa visibilidade do ciclo de vida das autorizações enviadas pelos parceiros.

Diante disso, e considerando a dependência da nova API, optou-se por evoluir o fluxo de autorização como pré-requisito para todas as consultas de dados. Embora a squad tenha implementado essa melhoria, a solução inicial não previa versionamento, o que exigiria a adesão obrigatória de todos os parceiros ao novo fluxo.

Após alinhamentos com os parceiros, identificou-se inviabilidade de adaptação dentro do prazo de 18/06. Em conjunto, as áreas de Produto e Engenharia definiram a introdução de versionamento, permitindo a coexistência entre o modelo atual e o novo. Assim, parceiros que optarem por permanecer no fluxo atual não serão impactados, porém não poderão consumir a nova API de consulta de saldo do FGTS. A seguir, detalhamos os cenários e fluxos relacionados ao uso de garantias.

<Accordion title="Histórico de atualizações">
  <Update label="17/06/2026">
    ## Atualizações

    * Ajuste de link de redirecionamento
    * Documentação de mais etapas em Parceiros do produto que querem operar com garantias - Oferta leilão
  </Update>

  <Update label="17/06/2026">
    ## Criação do documento

    Criação inicial do documento
  </Update>
</Accordion>

## Fluxos de autorização e consulta de dados

Conforme mencionado, há uma nova API para consulta de saldo do FGTS, o que demandou a revisão do fluxo de autorização e consulta de dados.

<Warning>
  Ambos os modelos coexistirão temporariamente, sendo que o fluxo atual será descontinuado futuramente, com previsão para 23/07.
</Warning>

### Fluxo atual

* Permanece disponível para possibilitar a transição dos parceiros;
* Será descontinuado futuramente (previsão: 23/07);
* Não permite consulta de saldo do FGTS para garantia.

### Fluxo novo

* Fluxo e APIs documentados em: [Autorização e consulta de dados (V2)](/e-consignado/casos-de-uso/autorizacao-e-consulta-de-dados)
* Respostas síncronas;
* Disponível em homologação;
* Datas de produção:
  * 18/06 22h00 - APIs de autorização, consulta de lista de vínculos e consulta de dados de vínculo;
  * 23/06 06h00 - API de consulta de saldo;
* Permite consulta de saldo do FGTS para garantia.

## Parceiros do produto que não querem operar com garantias

### Oferta leilão

Mesmo sem operar com garantias, é necessário realizar algumas adaptações:

1. Mapear novos campos no webhook de novas solicitações – [Documentação](/e-consignado/leilao/novas-soliciatacoes-leilao-copied-1)
2. Não fazer lance quando a solicitação for com garantia
3. Atualizar corpo da requisição de envio de lance – [Documentação](/e-consignado/leilao/emissao-de-contrato-1)
4. Atualizar response da requisição de envio de lance – [Documentação](/e-consignado/leilao/Lance-para-solicitacao-em-leilao)
5. Mapear novos campos campos no webhook de fim de leilão – [Documentação](/e-consignado/leilao/Lance-para-solicitacao-em-leilao)

### Oferta ativa

Não é necessária adaptação.

## Parceiros do produto que querem operar com garantias

Separando os desenvolvimentos necessários para os parceiros em áreas:

### Oferta leilão

1. Mapear novos campos no webhook de novas solicitações – [Documentação](/e-consignado/leilao/novas-soliciatacoes-leilao-copied-1)
2. Atualizar corpo da requisição de envio de lance – [Documentação](/e-consignado/leilao/Lance-para-solicitacao-em-leilao)
3. Atualizar response da requisição de envio de lance – [Documentação](/e-consignado/leilao/Lance-para-solicitacao-em-leilao)
4. Mapear novos campos campos no webhook de fim de leilão – [Documentação](/e-consignado/leilao/Lance-para-solicitacao-em-leilao)
5. Atualizar corpo da requisição de gerar contrato – [Documentação](/e-consignado/leilao/emissao-de-contrato-1)

### Oferta ativa

1. Adaptar-se ao novo modelo de autorização e consulta de dados – [Documentação](/e-consignado/casos-de-uso/autorizacao-e-consulta-de-dados)
2. Desenvolver nova API de consulta de saldo – [Documentação](/e-consignado/casos-de-uso/consulta-de-saldo-disponivel-para-garantias-do-fgts)
3. Atualizar corpo da requisição de gerar contrato – [Documentação](/e-consignado/contratacao-ativa/emissao-de-contrato)

### Campos de garantia na CCB

Há um entendimento do jurídico da BMP de que não é necessária a inclusão dos valores de garantia na CCB, uma vez que ainda não houve publicação oficial pelo MTE sobre o tema. Assim que houver a publicação da normativa pelo MTE, será realizado o desenvolvimento necessário para inclusão dos campos de garantia na CCB.

### Comprovante de averbação

Embora os valores de garantia ainda não estejam presentes na CCB, o comprovante de averbação — já utilizado pelos parceiros — passará a incluir essas informações.