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)