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

# Tour do painel

> Cada tela do painel do vendedor, para que serve e quem usa.

O painel em [dashboard.caratuva.com](https://dashboard.caratuva.com) é sua cabine de operação. Ele é organizado em torno do trabalho do dia a dia para receber: onboarding, faturamento, aprovações, repasses e reconciliação.

A barra lateral tem: **Invoices** (Faturas), **Payout** (Repasses), **Notifications** (Notificações), **Developers** (Desenvolvedores), **Enable production** (Habilitar produção) e — para usuários de operações — **Admin**.

## Login

Entre com seu e-mail corporativo — enviamos um magic link (expira em 15 minutos), sem senha para gerenciar. As sessões duram 12 horas. Faça logout pelo botão no cabeçalho do painel.

O primeiro usuário de uma organização é um **admin**. O modelo de papéis é: **admin** (acesso total — chaves de API, repasses, faturas), **treasurer** (cria e aprova faturas, gerencia o destino de repasse), **viewer** (somente leitura) e **ops** (ferramentas operacionais, incluindo a tela Admin). Convidar colegas e atribuir papéis ainda não é self-service no painel — entre em contato com o suporte se precisar de mais usuários na sua organização.

## Seletor de modo

Toda tela traz um indicador de modo no topo. O modo **Teste** roda o fluxo inteiro contra uma instância de pagamento sandbox — KYB e KYC do comprador são aprovados automaticamente e nenhum dinheiro real se move. O modo **Produção** (live) opera sobre trilhos reais; ele é destravado assim que a Caratuva aprova sua **Solicitação de Acesso à Produção** (veja [Habilitar produção](#habilitar-producao-ir-para-producao)), após o que você completa o KYB de produção. Trocar de modo é um único clique. Contas novas começam em teste.

Recomendamos fortemente rodar o primeiro fluxo de ponta a ponta no modo teste antes de ir para produção. Veja [Modos teste e produção](/pt-BR/environments) para o que cada modo cobre.

## Faturas

A área de faturas é onde a maior parte do trabalho acontece.

### Lista

`/invoices` mostra todas as faturas da sua organização. Clique em qualquer linha para abrir o detalhe da fatura, ou use a ação **Duplicate** (Duplicar) por linha para iniciar um pedido recorrente.

### Detalhe

A página de detalhe mostra o cabeçalho da fatura, o comprador, os itens e uma **linha do tempo** que atualiza ao vivo conforme o pagamento avança pelo ciclo de vida:

```
draft → awaiting_approval → approved
      → awaiting_buyer
      → buyer_kyc_pending → buyer_kyc_approved
      → fx_quoted
      → on_ramp_pending → fiat_received
      → offramp_pending
      → settled
```

`settled` é o estado terminal de sucesso. Os outros estados terminais — `expired`, `cancelled` e `buyer_kyc_rejected` — são exibidos com o motivo. `on_ramp_failed` e `offramp_failed` são falhas em andamento que podem ser repetidas.

Pelo detalhe você pode, dependendo do estado da fatura:

* Editar a fatura (enquanto estiver em `draft` ou `awaiting_approval`).
* Aprovar a fatura (um colega diferente do criador, quando a aprovação é exigida).
* Convidar o comprador, ou reenviar o e-mail de convite caso o original tenha sido perdido.
* Copiar o link público de pagamento para enviar pelo seu próprio canal.
* Reatribuir o comprador (útil quando um fluxo de KYC fica travado — o novo comprador começa com um estado limpo).
* Cancelar a fatura (válido somente antes de o comprador fundar o on-ramp).
* Duplicar a fatura para um pedido recorrente.

### Nova fatura

`/invoices/new` é um formulário passo a passo para criar uma fatura. Você também pode clonar uma fatura existente com `?from=<invoiceId>` para pré-preencher comprador e itens — útil para pedidos recorrentes.

Veja [Faturamento](/pt-BR/invoicing) para o fluxo completo, incluindo aprovações e regras de cancelamento.

## Repasses

`/payout` (barra lateral: **Payout**) roda toda a configuração de repasse como um único fluxo:

1. **Aceitar os termos de serviço do nosso parceiro de liquidação** — um redirecionamento único para a página hospedada do parceiro e de volta.
2. **Verificar sua empresa (KYB)** — seu envio, status atual e o que ainda nos falta. Veja [Onboarding](/pt-BR/onboarding).
3. **Registrar sua chave PIX** — uma única chave PIX na conta bancária brasileira que recebe cada liquidação (nosso parceiro de liquidação detecta automaticamente o tipo da chave). Ela precisa corresponder à entidade verificada legalmente. Veja [Repasses](/pt-BR/payouts).

## Desenvolvedores

`/developers` reúne a superfície de integração para o time de engenharia.

* **Chaves de API** (`/developers/api-keys`) — emita e revogue credenciais servidor-a-servidor. O segredo em texto plano aparece exatamente uma vez na criação; copie-o imediatamente para o cofre de senhas.
* **Webhooks** (`/developers/webhooks`) — cadastre URLs que devem receber eventos do ciclo de vida, veja tentativas recentes de entrega e gire segredos de assinatura.

Ambas as telas estão documentadas em detalhe na [Referência da API](/pt-BR/api-reference/introduction).

## Habilitar produção (ir para produção)

`/go-live` (barra lateral: **Enable production**) é a solicitação self-service de acesso à produção. Envie sua razão social, CNPJ, e-mail de contato comercial, volume mensal esperado e corredores. Assim que a Caratuva aprovar, a opção **Produção** é destravada no seletor de modo; você então troca para Produção e completa o KYB de produção na página de Repasses. Veja [Modos teste e produção](/pt-BR/environments).

## Notificações

`/notifications` (barra lateral: **Notifications**) é um **log de entrega** somente leitura — toda mensagem que esta organização disparou, com seu canal, template, destinatário, status e referência. Filtre por canal, status e período. Útil para verificar se os convites ao comprador realmente saíram e para responder "o cliente recebeu o link?".

O sino no cabeçalho é uma caixa de entrada separada, por usuário (alimentada pela Courier), mostrando seus alertas não lidos. Não há configurações de preferência de notificação por usuário hoje.

## Admin (somente operações)

Usuários com o papel **ops** ganham um item **Admin** na barra lateral (`/admin/production-access`) para revisar e aprovar solicitações de acesso à produção das organizações. Ele não fica visível para outros papéis.

## Relatórios

Resumos de preços de transferência (JSON, CSV, PDF) estão disponíveis via API (`GET /v1/reports/transfer-pricing`), ainda não como uma tela do painel. Fale com nosso time se precisar de um corte específico para o seu fechamento contábil trimestral.

## Para onde ir

* [Onboarding](/pt-BR/onboarding) — complete o checklist de KYB.
* [Faturamento](/pt-BR/invoicing) — ciclo de vida da fatura e aprovações.
* [Repasses](/pt-BR/payouts) — registre seu destino PIX.
* [Notificações](/pt-BR/notifications) — o log de entrega e a caixa de entrada no produto.
