> For the complete documentation index, see [llms.txt](https://ajuda.livechat360.com.br/crm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.livechat360.com.br/crm/api-docs/propostas.md).

# Propostas

As propostas comerciais de uma negociação.

| Método | Rota                              | Operação |
| ------ | --------------------------------- | -------- |
| GET    | `…/proposals`, `…/proposals/{id}` | `read`   |
| POST   | `…/proposals`                     | `insert` |
| PUT    | `…/proposals/{id}`                | `update` |

Sem filtros. **Ordenação:** `expires_at`, `created_at` (padrão `-created_at`).

## Escrita

| Campo            | Tipo                    | Observações                                                                                                                 |
| ---------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `title`          | string                  | **obrigatório no POST**                                                                                                     |
| `description`    | string, anulável        |                                                                                                                             |
| `amount`         | número ≥ 0, anulável    | valor da proposta                                                                                                           |
| `expires_at`     | data/hora ISO, anulável | validade                                                                                                                    |
| `attachment_url` | (n/a)                   | somente leitura; anexos são gerenciados pelo recurso de [Arquivos](broken://pages/dc7a8e157387556f554bff77e62de0a519cb626a) |

```bash
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/deals/310/proposals"

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title":"Proposta Comercial - Plano Anual","amount":1500,"expires_at":"2026-07-10T23:59:00Z"}' \
  "https://app-api.atendeserver.com.br/v1/deals/310/proposals"

curl -X PUT -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"amount":1350}' "https://app-api.atendeserver.com.br/v1/deals/310/proposals/12"
```

## Payload

```json
{
  "data": {
    "id": 12,
    "deal_id": 310,
    "title": "Proposta Comercial - Plano Anual",
    "description": "Proposta com 10% de desconto para fechamento até o fim do mês.",
    "amount": 1500,
    "expires_at": "2026-07-10T23:59:00.000Z",
    "attachment_url": "https://static-wp01.atendeserver.com.br/anexos/xy98zw-proposta.pdf",
    "created_at": "2026-06-25T10:00:00.000Z",
    "updated_at": "2026-06-25T10:00:00.000Z"
  }
}
```