Guide

Resolvendo pendências

Este recurso permite a reapresentação de propostas que estejam com status pendente por inconsistências nos dados enviados anteriormente, como problemas com informações bancárias ou documentos inválidos.

Endpoint

  • URL: https://bff.v8sistema.com/fgts/proposal/{id}/solvePendency

  • Método: POST

  • Autenticação: Requer token JWT válido.

  • Path Parameter:

  • id: identificador da proposta a ser reapresentada.

Tipos de Pendência

A seguir estão os possíveis tipos de pendência e como solucioná-las:

1. Reapresentação de Dados Bancários (TED)

Body da Requisição

{
  "type": "ted_refusal",
  "data": {
    "bankId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "bankAccountNumber": "123456",
    "bankAccountBranch": "0001",
    "bankAccountDigit": "2",
    "bankAccountType": "checking_account"
  }
}

Observações

  • Utilize o bankId obtido via endpoint /banks.

  • bankAccountType aceita os valores:

  • checking_account: Conta Corrente

  • saving_account: Conta Poupança

2. Reapresentação de Chave PIX

Body da Requisição

{
  "type": "pix_refusal",
  "data": {
    "pix": "chave_pix_cliente"
  }
}

Regras para a Chave PIX

  • CPF: enviar sem pontuação.

  • Telefone: usar formato internacional com DDI. Ex: +5511999999999.

  • Chave Aleatória: deve estar no formato UUID.

  • Recomenda-se sempre solicitar ao cliente uma nova chave aleatória ao reapresentar este tipo de pendência.

3. Reapresentação de Documento

Etapa 1 – Upload de Documentos

  • URL: https://bff.v8sistema.com/file/upload/fgts_proposal

  • Método: POST

  • Formato: multipart/form-data

Podem ser enviados um ou dois arquivos.
Formatos aceitos: .jpg, .png, .pdf

Exemplo de Resposta

[
  {
    "key": "fb7383ae-cf82-4fb7-9de2-b1a6998f64d1frente_rg.png",
    "originalFilename": "frente_rg.png"
  },
  {
    "key": "fb4883ae-cf72-4fb7-9de2-b1a6998f64d1verso_rg.png",
    "originalFilename": "verso_rg.png"
  }
]

Etapa 2 – Enviar os Documentos via Endpoint de Pendência

{
  "type": "invalid_document",
  "data": {
    "documents": [
      {
        "type": "501",
        "key": "fb7383ae-cf82-4fb7-9de2-b1a6998f64d1frente_rg.png"
      },
      {
        "type": "502",
        "key": "fb4883ae-cf72-4fb7-9de2-b1a6998f64d1verso_rg.png"
      }
    ]
  }
}

Códigos de Tipo de Documento

Os documentos devem conter o código correto correspondente ao tipo de imagem enviada:

  • 501: Frente RG

  • 502: Verso RG

  • 4: CNH

  • 600: Outros Frente

  • 601: Outros Verso

Documentos Aceitos

  • RG (Registro Geral)

  • CNH (Carteira Nacional de Habilitação)

  • Carteira de Trabalho (Física)

  • Coren (Conselho de Enfermagem)

  • RNE (Registro Nacional de Estrangeiros)

  • Carteira da OAB (Ordem dos Advogados do Brasil)