Pular para o conteúdo principal

Primeiros Passos

A página Getting Started (/dashboard/getting-started) é o ponto de partida para novas organizações. Ela apresenta uma sequência guiada das tarefas necessárias para começar a cobrar de forma recorrente: cadastrar a empresa, configurar gateways e NF-e, criar planos e produtos, importar clientes e ativar a primeira assinatura.

Cada cartão da página representa um marco do onboarding e mostra o estado da organização em tempo real (concluído, pendente ou bloqueado). O dashboard usa essas mesmas verificações para decidir quando esconder as instruções iniciais e exibir as métricas operacionais.

Etapas sugeridas​

  1. Configurar empresa e dados fiscais — informar CNPJ, regime tributário e endereços em Contas > Empresas.
  2. Conectar um gateway de pagamento — escolher provedor (Kobana, Asaas, Iugu, Pagar.me) em Gateways de Pagamento e definir o gateway padrão por método (cartão, boleto, PIX).
  3. Cadastrar planos e produtos — definir o catálogo em Planos e Produtos, com ciclos, valores em reais e regras de proration.
  4. Habilitar emissão de NF-e (opcional) — selecionar provedor em Nota Fiscal > Configurações, anexar certificado digital e mapear códigos de serviço.
  5. Importar clientes — usar importação CSV em Exportação e Importação > Importações ou cadastrar manualmente.
  6. Criar a primeira assinatura — vincular cliente a um plano em Assinaturas e confirmar o início do ciclo.
  7. Configurar dunning e notificações — em Gestão de Inadimplência e Configurações > Notificações.
  8. Conectar webhooks e API — cadastrar endpoints em Webhooks. A API pública usa o access token da Conta Kobana (Authorization: Bearer), não uma chave gerada aqui.

Captura de tela​

Painel de onboarding com checklist de configuração inicial