> 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/empresas.md).

# Empresas

As empresas (pessoas jurídicas) vinculáveis a contatos e negociações.

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

O payload inclui os contadores `deal_count` (negociações ativas) e `lead_count` (contatos vinculados).

## Filtros

| Parâmetro                         | Comportamento                                                        |
| --------------------------------- | -------------------------------------------------------------------- |
| `name`                            | exato (sem diferenciar maiúsculas); `name__contains` para parcial    |
| `cnpj`                            | exato, com ou sem máscara                                            |
| `owner_id`                        | inteiro ou lista separada por vírgula (usuário responsável)          |
| `segment`                         | exato (sem diferenciar maiúsculas); `segment__contains` para parcial |
| `created_at__gte/__lte/__gt/__lt` | comparação ISO 8601                                                  |

**Ordenação:** `name`, `created_at` (padrão `-created_at`).

```bash
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/companies?segment__contains=concession&sort=name"
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/companies?cnpj=12.345.678/0001-90"
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/companies/87"
```

## Payload

```json
{
  "data": {
    "id": 87,
    "name": "Auto360 Veículos",
    "cnpj": "12.345.678/0001-90",
    "owner_id": 3,
    "segment": "Concessionária",
    "observations": "Cliente desde 2023, sempre fecha no fim do mês.",
    "follower_ids": [3, 12],
    "deal_count": 14,
    "lead_count": 32,
    "created_at": "2023-05-02T10:00:00.000Z",
    "updated_at": "2026-06-20T16:30:00.000Z"
  }
}
```

## Escrita

| Campo                     | Tipo              | Observações                                                                   |
| ------------------------- | ----------------- | ----------------------------------------------------------------------------- |
| `name`                    | string            | **obrigatório no POST**; não anulável                                         |
| `cnpj`                    | string            | **obrigatório no POST**; validado e único na conta; **imutável no PUT** (422) |
| `owner_id`                | inteiro, anulável | deve ser um usuário da conta                                                  |
| `segment`, `observations` | string, anulável  |                                                                               |
| `follower_ids`            | inteiro\[]        | **substitui** o conjunto de seguidores; todos devem ser usuários da conta     |

```bash
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name":"Auto360 Veículos","cnpj":"12.345.678/0001-90","segment":"Concessionária","owner_id":3}' \
  "https://app-api.atendeserver.com.br/v1/companies"

curl -X PUT -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"observations":"Fecha sempre no fim do mês.","follower_ids":[3,12]}' \
  "https://app-api.atendeserver.com.br/v1/companies/87"
```