Skip to main content
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.

​
Atualizações

  • Ajuste de link de redirecionamento
  • Documentação de mais etapas em Parceiros do produto que querem operar com garantias - Oferta leilão

​
Criação do documento

Criação inicial do documento

​
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.
Ambos os modelos coexistirão temporariamente, sendo que o fluxo atual será descontinuado futuramente, com previsão para 23/07.

​
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)
  • 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
  2. Não fazer lance quando a solicitação for com garantia
  3. Atualizar corpo da requisição de envio de lance – Documentação
  4. Atualizar response da requisição de envio de lance – Documentação
  5. Mapear novos campos campos no webhook de fim de leilão – Documentação

​
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
  2. Atualizar corpo da requisição de envio de lance – Documentação
  3. Atualizar response da requisição de envio de lance – Documentação
  4. Mapear novos campos campos no webhook de fim de leilão – Documentação
  5. Atualizar corpo da requisição de gerar contrato – Documentação

​
Oferta ativa

  1. Adaptar-se ao novo modelo de autorização e consulta de dados – Documentação
  2. Desenvolver nova API de consulta de saldo – Documentação
  3. Atualizar corpo da requisição de gerar contrato – Documentação

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