# Obter Negócio do Pipeline

> Retorna os detalhes de um negócio do pipeline de CRM pelo seu ID, incluindo seus relacionamentos e produtos vinculados.

`GET https://crm.wavups.com/api/v1/account-crm-pipeline-deal/{id}`

Página: https://crm.wavups.com/docs/api/negocios-pipeline/obter

## Requisição

`GET https://crm.wavups.com/api/v1/account-crm-pipeline-deal/{id}`

- `Token` (string, obrigatório, header):
  Seu token de autenticação.

- `id` (string, obrigatório, path):
  ID do negócio a ser consultado.

---

## Resposta

Retorna o objeto completo do negócio com todos os relacionamentos e produtos vinculados.

- `id` (string):
  Identificador único do negócio.

- `stageId` (string):
  ID do estágio vinculado.

- `leadId` (string | null):
  ID do lead vinculado.

- `dealOwner` (string | null):
  ID do usuário responsável.

- `title` (string):
  Título do negócio.

- `description` (string | null):
  Descrição detalhada do negócio.

- `value` (number | null):
  Valor total estimado do negócio.

- `status` (string):
  Status do negócio (ex: `open`, `won`, `lost`).

- `type` (string | null):
  Tipo do negócio.

- `nextAction` (string | null):
  Próxima ação prevista.

- `source` (string | null):
  Origem do negócio.

- `customFields` (object):
  Campos personalizados preenchidos do negócio, pela chave do campo (só os do pipeline do negócio). Seleção traz o **nome** da opção e seleção múltipla uma lista de nomes. Sem valores, vem `{}`.

- `probability` (number):
  Probabilidade de fechamento em percentual.

- `order` (number):
  Posição de ordenação.

- `expectedClose` (string | null):
  Data prevista de fechamento (ISO 8601).

- `wonAt` (string | null):
  Data do ganho (ISO 8601). Preenchida quando o negócio é ganho.

- `lostAt` (string | null):
  Data da perda (ISO 8601). Preenchida quando o negócio é perdido.

- `currency` (string):
  Moeda do valor: código ISO 4217 de 3 letras (ex: `BRL`, `USD`, `EUR`). Negócio sem moeda gravada vem como `BRL`. O `value` está sempre nessa moeda.

- `lossReasonId` (string | null):
  Motivo da perda escolhido na plataforma (só em negócios perdidos).

- `lossNote` (string | null):
  Observação da perda (só em negócios perdidos).

- `createdAt` (string):
  Data de criação (ISO 8601).

- `AccountCRMLead` (object | null):
  Dados do lead associado ao negócio.

- `AccountUser` (object | null):
  Dados do responsável pelo negócio.

- `AccountCRMPipelineStage` (object):
  Dados do estágio do pipeline.

- `accountCRMPipelineDealProductAssignments` (array):
  Produtos vinculados ao negócio.

---

## Exemplos

### Exemplo de requisição

```bash GET /api/v1/account-crm-pipeline-deal/{id}
curl --request GET \
  --url 'https://crm.wavups.com/api/v1/account-crm-pipeline-deal/cmsnopzzl002l01ukfjsxp80a' \
  --header 'Token: SEU_TOKEN_DE_API'
```

### Exemplo de resposta

```json 200
{
  "id": "cmsnopzzl002l01ukfjsxp80a",
  "stageId": "cmkfy4kdk0009y0c1qx9fgumt",
  "leadId": "cmsncjkqw0bzx0hll2lv5i34a",
  "dealOwner": "cmuser0012345",
  "title": "Gabriel Cerrini (GC)",
  "description": "Proposta de consultoria e software",
  "value": 1350.0,
  "status": "open",
  "type": "Serviço",
  "nextAction": "Apresentar proposta comercial",
  "source": "whatsapp",
  "probability": 70,
  "order": 0,
  "expectedClose": "2026-09-15T00:00:00.000Z",
  "wonAt": null,
  "lostAt": null,
  "currency": "BRL",
  "lossReasonId": null,
  "lossNote": null,
  "createdAt": "2026-08-10T20:29:21.393Z",
  "AccountCRMLead": {
  "id": "cmsncjkqw0bzx0hll2lv5i34a",
  "name": "Gabriel Cerrini (GC)",
  "email": "gabriel@email.com",
  "phone": "+5511999998888"
  },
  "AccountUser": {
  "id": "cmuser0012345",
  "User": {
  "name": "Vendedor Proativia",
  "email": "vendedor@empresa.com"
  }
  },
  "AccountCRMPipelineStage": {
  "id": "cmkfy4kdk0009y0c1qx9fgumt",
  "name": "1ºContato",
  "pipelineId": "cmkfy4k700008y0c1phx38422"
  },
  "accountCRMPipelineDealProductAssignments": [
  {
  "id": "cpassign001",
  "accountProductId": "cmprod001",
  "quantity": 1,
  "discount": 10,
  "discountType": "PERCENTAGE",
  "totalPrice": 1350.0,
  "createdAt": "2026-08-10T20:29:21.400Z",
  "AccountProduct": {
  "id": "cmprod001",
  "name": "Plano Anual Consultoria",
  "price": 1500.0,
  "description": "Consultoria continuada para vendas"
  }
  }
  ]
}
```

```json 404
{
  "error": "Account CRM pipeline deal not found"
}
```

```json 500
{
  "error": "Error to get account CRM pipeline deal"
}
```