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

# Primeiros passos

> Do token à primeira venda registrada, em três chamadas.

<Steps>
  <Step title="Confirme o que o token alcança">
    ```bash theme={null}
    curl https://app.metricaas.com.br/v1/me \
      -H "Authorization: Bearer $METRICAAS_TOKEN"
    ```

    Olhe `client.name` (é a empresa certa?), `mode` (`write` se você vai registrar
    venda) e `scopes` (o token vê todos os canais?).
  </Step>

  <Step title="Ache o lead">
    ```bash theme={null}
    curl "https://app.metricaas.com.br/v1/leads?stage=Novo%20Lead&limit=5" \
      -H "Authorization: Bearer $METRICAAS_TOKEN"
    ```

    Guarde o `id`. É ele que a venda referencia.
  </Step>

  <Step title="Registre a venda">
    ```bash theme={null}
    curl -X POST https://app.metricaas.com.br/v1/sales \
      -H "Authorization: Bearer $METRICAAS_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "lead_id": "3df0cc9b-7627-4450-bb54-8a2cd9303fa2",
        "value": 67.00,
        "sold_at": "2026-08-07T11:49:12-03:00",
        "external_source": "hotmart",
        "external_id": "HP2346486658"
      }'
    ```

    O lead vai para a etapa de ganho e a receita aparece no painel.
  </Step>
</Steps>

## Os dois erros que todo mundo comete na primeira vez

<AccordionGroup>
  <Accordion title="422 em sold_at — 'ISO 8601 COM offset'">
    Você mandou `2026-08-07T11:49:12`. Falta o fuso.

    O Metricaas grava em UTC. Sem offset não existe resposta certa: `00:52` pode
    ser 00:52 em São Paulo ou 21:52 do dia anterior. A API recusa em vez de
    adivinhar — porque adivinhar errado joga a venda para outro dia, às vezes
    outra semana, e ninguém percebe até o relatório não bater.

    Correto: `2026-08-07T11:49:12-03:00`.
  </Accordion>

  <Accordion title="A venda entrou mas o painel não mudou">
    Quase sempre é escopo. Chame `GET /v1/me`: se `scopes.channels` não inclui o
    canal daquele lead, o token registrou a venda mas não a enxerga de volta.

    Também vale conferir o período selecionado no painel — `sold_at` é a data da
    **compra**, então uma venda de 31/07 lançada hoje aparece em julho, não hoje.
    É o comportamento correto, e costuma surpreender na primeira vez.
  </Accordion>
</AccordionGroup>