Consultar Propostas

GET/proposals/{id}

Esse endpoint permite que um originador autenticado consulte os dados de uma proposta existente, informando o id da proposta.

---

Nome	Tipo	Descrição	Obrigatório
id	string	Identificador da Proposta	Sim

Response

200 - Success

{
  "id": "0196253f-14a7-74cb-a350-d8e948584be2",
  "overwriteId": "01966431-bb9a-727f-91f4-bc1f6e10bd46",
  "totalValue": 1000,
  "liquidValue": 743,
  "discountedValue": 104,
  "fixedTac": 150,
  "variableTac": 3,
  "totalTac": 153,
  "averageDaysInAdvance": 39,
  "status": "CREATED",
  "assignor": {
    "name": "Cristiano Ronaldo",
    "document": "12345678901"
  }
  "receivables": [
    {
      "id": "0196253f-14a7-74cb-a350-df60c42a58e6",
      "proposalId": "0196253f-14a7-74cb-a350-df60c42a58e6",
      "externalId": 101,
      "description": "REC001",
      "dueDate": "2025-05-15T00:00:00.000Z",
      "originalValue": 1000,
      "totalAssetBacking": 1000,
      "liquidTotalValue": 896,
      "discountedValue": 104,
      "defaultTax": 8,
      "variableTac": 3,
      "floatingDays": 2,
      "qtdDaysAdvanced": 39,
      "percentageTotalEffectiveCost": 0,
      "paymentDay": "2025-05-15T00:00:00.000Z",
      "expirationDate": "2025-04-11T23:59:59.999Z",
      "status": "CREATED"
    }
  ]
}

Observação

O campo "overwriteId" é o ID correspondente à nova proposta criada, que contém os recebíveis da proposta consultada.

Quando uma nova proposta for aprovada antes de o cedente responder à proposta anterior, ela incluirá tanto os recebíveis enviados anteriormente quanto os novos, e a proposta aprovada anteriormente será automaticamente cancelada.

400 - Bad Request

{
  "message": "Validation error",
  "errors": [
    {
      "field": "document",
      "message": "This field is required in body."
    },
    {
      "field": "email",
      "message": "This field is required in body."
    }
  ]
}

401 - Unauthorized

{
  "message": "Invalid credentials"
}

404 - Not Found

{
  "statusCode": 404,
  "message": "TProposta não encontrada"
}