> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clubfix.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeiros Passos

> Da autenticação ao seu primeiro contrato em menos de 15 minutos

## Visão geral

O **Webservice de Parceiros ClubFix** é uma API REST que permite a parceiros habilitados:

* Cotar e contratar proteções para dispositivos (smartphones, notebooks, tablets)
* Gerenciar clientes e seus contratos
* Processar ou notificar pagamentos
* Acompanhar o ciclo de vida de assinaturas e planos anuais

<Note>
  Para utilizar esta API você precisa ser um parceiro habilitado. Solicite suas credenciais ao time de suporte ClubFix.
</Note>

***

## 1. Autenticar

Todas as requisições exigem um token Bearer. Obtenha-o com suas credenciais de parceiro:

```bash theme={null}
curl -X POST "https://homolog.clubfix.com.br/webservice/auth/login" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"email": "seu@email.com", "password": "suasenha"}'
```

**Resposta:**

```json theme={null}
{
  "token": "eyJ0eXAiOiJKV1Q...",
  "token_type": "Bearer"
}
```

Use o `token` retornado no header `Authorization: Bearer {token}` em todas as chamadas seguintes.

***

## 2. Localizar o dispositivo

Antes de cotar, você precisa do ID do modelo do dispositivo:

```bash theme={null}
# Listar marcas
curl -X GET "https://homolog.clubfix.com.br/webservice/brands" \
  -H "Authorization: Bearer {token}"

# Listar modelos de uma marca
curl -X GET "https://homolog.clubfix.com.br/webservice/models?brand_id=1" \
  -H "Authorization: Bearer {token}"
```

Guarde o `id` do modelo — você vai usá-lo na cotação.

***

## 3. Escolher o produto

ClubFix oferece dois tipos de produto:

| Produto         | Duração                    | Ideal para                         |
| --------------- | -------------------------- | ---------------------------------- |
| **Plano Anual** | 12 meses (pagamento único) | Contratações pontuais, loja física |
| **Assinatura**  | Mensal recorrente          | Plataformas digitais, e-commerce   |

***

## 4. Cotar

<Tabs>
  <Tab title="Plano Anual">
    ```bash theme={null}
    curl -X GET "https://homolog.clubfix.com.br/webservice/annual-plans/quote?model_id=42" \
      -H "Authorization: Bearer {token}"
    ```

    Resposta inclui `premium` (prêmio anual) e `lmi` (limite máximo de indenização).
  </Tab>

  <Tab title="Assinatura">
    ```bash theme={null}
    curl -X GET "https://homolog.clubfix.com.br/webservice/quotation?model_id=42" \
      -H "Authorization: Bearer {token}"
    ```

    Retorna todos os planos disponíveis com `monthly_premium` e `lmi` para cada um.
  </Tab>
</Tabs>

***

## 5. Contratar

<Tabs>
  <Tab title="Plano Anual">
    ```bash theme={null}
    curl -X POST "https://homolog.clubfix.com.br/webservice/annual-plans" \
      -H "Authorization: Bearer {token}" \
      -H "Content-Type: application/json" \
      -d '{
        "model_id": 42,
        "customer_document": "123.456.789-00"
      }'
    ```
  </Tab>

  <Tab title="Assinatura">
    ```bash theme={null}
    curl -X POST "https://homolog.clubfix.com.br/webservice/subscriptions" \
      -H "Authorization: Bearer {token}" \
      -H "Content-Type: application/json" \
      -d '{
        "model_id": 42,
        "customer_document": "123.456.789-00",
        "plan_id": 7
      }'
    ```
  </Tab>
</Tabs>

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Fluxo Completo — Assinatura" icon="repeat" href="/api-reference/guides/fluxo-assinatura">
    Sequência end-to-end: cotação → contratação → parcelas → ativação
  </Card>

  <Card title="Fluxo Completo — Plano Anual" icon="calendar" href="/api-reference/guides/fluxo-plano-anual">
    Sequência end-to-end: cotação → contratação → pagamento → ativação
  </Card>

  <Card title="Controle de LMI" icon="shield" href="/api-reference/subscriptions/quotation/index">
    Como usar o campo `maxima` para personalizar o limite de cobertura
  </Card>

  <Card title="Roadmap" icon="map" href="/api-reference/roadmap">
    SDKs para Node.js e PHP, conector n8n e próximas integrações
  </Card>
</CardGroup>