Antes de começar

Um e-mail de acesso à suíte ou uma solicitação de cadastro.

Passo a passo

1. 01

   Use o CalebePay para criar e consultar cobranças, acompanhar repasses, administrar empresas e integrar pagamentos ao seu sistema.

2. 02

   Use o CalebeShop para montar a vitrine, cadastrar produtos, controlar estoque e organizar as vendas da loja.

3. 03

   Entre nos painéis com as credenciais da sua conta Calebe. Se houver verificação em duas etapas, conclua-a em cada acesso.

4. 04

   No Shop, confira a empresa vinculada. Uma organização pode ter uma loja nesta versão; o comprador da vitrine tem uma conta separada.

5. 05

   Abra Configurações no Shop para verificar o ambiente e os meios de pagamento. O checkout da venda é processado pelo Pay.

6. 06

   Consulte o pedido no Shop e a cobrança correspondente no Pay quando precisar investigar um pagamento.

Detalhes importantes

• Criar uma loja ou uma conta interna não habilita recebimentos reais automaticamente. Cadastro financeiro, subconta, regras e autorização do Pay continuam necessários.
• O acesso entre os domínios exige login em cada painel. O compartilhamento da identidade não significa entrada automática no outro site.

Antes de começar

Conta Calebe ativa e empresa vinculada quando o perfil for de tenant.

Passo a passo

1. 01

   Confira a empresa e o perfil da sua conta. Um tenant é a organização que recebe e organiza as cobranças.

2. 02

   O superadministrador opera a plataforma; a leitura global consulta todas as empresas. Perfis de tenant consultam a própria empresa e seus descendentes permitidos.

3. 03

   Os perfis Administrador do tenant, Somente leitura e Desenvolvedor são pontos de partida. As permissões dos perfis podem ser ajustadas por quem administra perfis.

4. 04

   Para emitir uma cobrança, sua conta precisa de permissão de criação de cobranças; para alterar estoque e a loja, precisa de administração do Shop.

5. 05

   Se faltar uma tela ou ação, peça ao responsável pelos acessos para revisar o perfil em Perfis e permissões e o vínculo em Usuários.

6. 06

   Ao receber aviso de mudança de perfil, retorne à tela inicial e confira o novo menu. Algumas mudanças de acesso encerram sessões e exigem novo login.

Detalhes importantes

• As instruções administrativas desta central descrevem recursos que podem não estar disponíveis no seu perfil. Ler um guia não concede acesso.
• Uma empresa suspensa ou com um nível superior suspenso pode impedir ações, mesmo com a permissão correta.

Antes de começar

Conta criada pelo administrador e acesso ao e-mail cadastrado.

Passo a passo

1. 01

   Se recebeu um convite, abra o e-mail mais recente e selecione Definir minha senha. O link vale por 24 horas e só pode ser usado uma vez.

2. 02

   Defina uma senha de 12 a 72 bytes e conclua o formulário. Letras acentuadas podem ocupar mais de um byte.

3. 03

   Abra app.calebepay.com.br e informe o e-mail de acesso e a senha definida.

4. 04

   Se a conta exigir verificação em duas etapas, escolha o método oferecido e informe o código.

5. 05

   Confira a empresa e o ambiente no topo antes de emitir ou consultar cobranças.

6. 06

   Se o administrador definiu uma senha inicial manual, use-a no login. Nesse caso não há convite automático.

Se algo não funcionar

Antes de começar

Acesso ao e-mail da conta.

Passo a passo

1. 01

   No login, selecione Esqueci minha senha.

2. 02

   Informe o e-mail cadastrado e envie a solicitação. A mensagem de resposta é genérica por segurança.

3. 03

   Abra o e-mail mais recente e use o link antes de completar 24 horas.

4. 04

   Defina a nova senha e volte ao login. A redefinição não entra no painel automaticamente.

5. 05

   Entre novamente nos aparelhos usados: concluir a troca de senha encerra sessões anteriores.

6. 06

   Se precisar de ajuda administrativa, peça o reenvio em Usuários → Enviar link por e-mail ou Reenviar link. Há intervalo mínimo de 60 segundos entre reenvios administrativos.

Detalhes importantes

• Redefinir a senha preserva a exigência de MFA. A perda do autenticador deve ser resolvida com o administrador.

Antes de começar

Método de MFA definido para sua conta e acesso ao e-mail cadastrado.

Passo a passo

1. 01

   Entre com e-mail e senha. Se houver exigência de MFA, o painel abrirá a etapa de verificação.

2. 02

   Selecione e-mail ou aplicativo, conforme as opções autorizadas para sua conta.

3. 03

   Para e-mail, solicite o código e informe os seis dígitos recebidos. O código vale por cinco minutos, dentro do prazo do desafio.

4. 04

   Para cadastrar o aplicativo pela primeira vez, confirme antes o e-mail, leia o QR code no autenticador e informe o código gerado pelo aplicativo.

5. 05

   Nos acessos seguintes, use o código atual do aplicativo ou o e-mail, quando permitido.

6. 06

   Se perdeu o aparelho, peça ao administrador Usuários → Editar usuário → Redefinir aplicativo autenticador. Cadastre o novo fator no próximo acesso.

Se algo não funcionar

Antes de começar

Sessão aberta no portal.

Passo a passo

1. 01

   Use o menu lateral para abrir uma área. Os grupos podem ser recolhidos na administração da plataforma.

2. 02

   Use a busca de navegação para encontrar a tela por nome ou assunto, como Pix, taxas ou clientes.

3. 03

   Quando houver seletor de empresa no topo, escolha o tenant ou o conjunto permitido. O filtro aparece apenas nas telas que usam essa seleção.

4. 04

   Confira o interruptor Modo de teste: produção e teste têm listas e totais separados nas áreas financeiras.

5. 05

   Nas tabelas que oferecem ferramentas, use busca, filtros por coluna, ordenação e agrupamento. Observe o resumo e a paginação antes de comparar valores.

6. 06

   Use a visita guiada disponível na interface para conhecer os atalhos. Para instruções de uma tarefa, abra esta central pelo ícone de ajuda.

Detalhes importantes

• Filtros de empresa não mudam telas globais como configurações, deploys e analytics do site.
• Totais, filtros e subtotais de uma tabela consideram somente os registros carregados. Uma busca na central procura também dentro do passo a passo dos artigos.

Antes de começar

Uma tela com tabela que ofereça as ferramentas de análise.

Passo a passo

1. 01

   Selecione primeiro o período, empresa, ambiente e página da tela para carregar os registros desejados.

2. 02

   Clique no título de uma coluna para ordenar em ordem crescente; clique novamente para decrescente e mais uma vez para voltar à ordem original.

3. 03

   Selecione Filtros por coluna e preencha o campo desejado. Em texto, use um trecho ou =valor para correspondência exata.

4. 04

   Em números e valores, use comparações como >=100,00. Em datas, use o formato indicado, como >=01/09/2026.

5. 05

   Escolha Agrupar e subtotalizar para separar os registros pelo valor de uma coluna.

6. 06

   Nas colunas numéricas, escolha a operação de resumo disponível e confira Total filtrado, Total carregado e subtotais.

7. 07

   Use Limpar ajustes para remover filtros, ordenação, agrupamento e operações selecionadas. No celular, use os seletores de ordenação e resumo apresentados.

Detalhes importantes

• Os controles não buscam automaticamente páginas ainda não carregadas. O contador mostra quantos registros fazem parte da análise.

Antes de começar

Portal autenticado e aplicativo CalebePay instalado e configurado para o mesmo ambiente.

Passo a passo

1. 01

   No menu da sua conta no portal, selecione Entrar no app com QR code.

2. 02

   Abra o leitor no app e leia o QR code. Se necessário, digite o código curto exibido pelo portal.

3. 03

   O app mostra um número de dois dígitos. No portal, escolha exatamente o número que aparece no seu celular.

4. 04

   Se o pedido não foi seu, selecione Não fui eu. Um número incorreto também recusa a tentativa.

5. 05

   Depois da aprovação, confirme que o app abriu sua conta e empresa.

6. 06

   Na aba Aparelhos conectados do diálogo, ou em Conta no app, revise as sessões e use Desconectar nas que não reconhece.

Detalhes importantes

• O QR vale por três minutos e é renovado enquanto a janela permanece aberta. Ler o QR sem a aprovação no portal não concede acesso.
• A sessão do portal dura oito horas. A sessão do app se renova com o uso, dentro do limite de 90 dias; depois disso pede novo login.

Antes de começar

App instalado, sessão válida e permissão de notificações do aparelho.

Passo a passo

1. 01

   Entre no app com e-mail e senha ou pelo QR do portal.

2. 02

   Use as áreas do app para consultar transações, emitir cobranças e administrar os recursos permitidos pelo seu perfil.

3. 03

   Autorize notificações no sistema do celular quando solicitado.

4. 04

   Abra Conta → O que você recebe e escolha se quer avisos de todas as cobranças visíveis, só da sua empresa, de empresas selecionadas ou nenhum.

5. 05

   Ajuste também os avisos de cadastros, falhas e comunicados disponíveis para seu perfil.

6. 06

   Ao tocar em um aviso, confira a cobrança ou ocorrência na plataforma. Avisos de teste têm identificação de teste.

Detalhes importantes

• Avisos não ampliam a visibilidade da conta. Eventos operacionais da plataforma são destinados aos perfis globais autorizados.

Se algo não funcionar

Antes de começar

Empresa ativa e permissão para criar cobranças. Para produção, método e recebimentos habilitados.

Passo a passo

1. 01

   Abra Transações e confira a empresa que receberá o pagamento.

2. 02

   Para conhecer o fluxo, ative Modo de teste. Para cobrar um cliente de verdade, confira que está em produção e que o método está habilitado.

3. 03

   Selecione Nova cobrança e escolha Pix, boleto, cartão ou Checkout.

4. 04

   Informe o valor e uma referência do seu sistema, como PED-1001. A referência ajuda a localizar a tentativa depois.

5. 05

   Preencha descrição, condições, pagador e centro de custo quando aplicável. Confira o endereço completado pelo CEP e informe o número.

6. 06

   Revise a prévia de taxas e divisão, quando exibida, e os canais de envio disponíveis.

7. 07

   Confirme uma vez e aguarde o resultado. Copie o código ou link gerado; depois acompanhe a situação em Transações.

Se algo não funcionar

Antes de começar

Método Pix disponível para a empresa.

Passo a passo

1. 01

   Abra Nova cobrança e escolha Pix.

2. 02

   Confirme Quem recebe, valor, referência e descrição.

3. 03

   Defina a validade oferecida pelo formulário e confira a data e o horário de expiração.

4. 04

   Selecione um cliente cadastrado ou informe o pagador. No Pix direto, campos em branco podem ser completados pelo pagador padrão da empresa.

5. 05

   Revise as taxas e confirme a emissão uma vez.

6. 06

   No resultado ou no detalhe em Transações, copie o Pix copia e cola, mostre o QR code ou compartilhe o link disponível.

7. 07

   Acompanhe até a situação Pago. Use a atualização do detalhe quando precisar consultar a situação no provedor.

Detalhes importantes

• Um Pix não pago pode expirar automaticamente. Um pagamento confirmado após a expiração ainda pode atualizar a cobrança para Pago.
• Se o provedor não responder à conciliação, a cobrança pode permanecer pendente. O tempo transcorrido sozinho não comprova pagamento.

Antes de começar

Boleto habilitado e dados completos e válidos do pagador.

Passo a passo

1. 01

   Abra Nova cobrança e selecione Boleto.

2. 02

   Informe valor, referência, descrição e vencimento permitido pelo formulário.

3. 03

   Preencha nome, CPF/CNPJ, e-mail, telefone com DDD e endereço completo do pagador. Confira o número após a consulta do CEP.

4. 04

   Revise a prévia e confirme a emissão. Se houver recusa, corrija o campo indicado antes de uma nova tentativa.

5. 05

   Abra o detalhe e use o PDF ou a linha digitável para entregar o boleto ao pagador.

6. 06

   Em boletos reais com Pix acoplado, o PDF e a página mostram um QR code e copia e cola do mesmo valor, válidos até o fim do dia do vencimento.

7. 07

   Acompanhe a confirmação em Transações. O detalhe informa se a quitação ocorreu pelo boleto ou pelo Pix.

Detalhes importantes

• O boleto real não expira apenas pelo relógio da plataforma: a situação é conferida com o provedor.
• Se os dois meios forem pagos, a plataforma identifica duplicidade e tenta estornar o Pix automaticamente. Uma falha de estorno exige acompanhamento operacional; não prometa conclusão antes da confirmação.

Antes de começar

Cartão habilitado para o tenant e autorização do pagador para a cobrança.

Passo a passo

1. 01

   Abra Nova cobrança e escolha Cartão de crédito.

2. 02

   Informe empresa, valor, referência, descrição e dados completos do pagador e endereço.

3. 03

   Preencha os dados do cartão no formulário e escolha as parcelas disponíveis. O limite da plataforma é de até 12, sujeito ao contrato do provedor.

4. 04

   Confira o valor, as taxas e as parcelas com o pagador e confirme uma vez. A cobrança é enviada nesse momento.

5. 05

   Aguarde a resposta e abra o detalhe em Transações.

6. 06

   Trate Pago como captura confirmada. Autorizado é pré-autorização, e não confirmação de captura; contestação e chargeback precisam de análise.

7. 07

   Se a conexão cair, localize a tentativa pela referência antes de cobrar novamente. Os dados do cartão são descartados após o envio.

Detalhes importantes

• Não envie número, validade, CVV ou token em chamados, prints ou logs.
• Esta emissão avulsa não oferece captura posterior nem solicitação de estorno pelo painel. Para débito em ciclos, use a assinatura por cartão.

Antes de começar

Permissão de criação de cobranças e cadastro completo do pagador.

Passo a passo

1. 01

   Abra Nova cobrança e escolha Checkout.

2. 02

   Informe Quem recebe, valor, referência, descrição e vencimento do link.

3. 03

   Preencha os dados completos do pagador e confirme os métodos oferecidos para a empresa.

4. 04

   Revise e crie o link. Nesse momento ainda não é criada a cobrança no provedor.

5. 05

   Copie a URL no resultado ou envie pelo canal autorizado da empresa.

6. 06

   O pagador abre a página e escolhe Pix, boleto ou cartão entre as opções disponíveis. A escolha gera a cobrança correspondente.

7. 07

   Acompanhe o link e a transação gerada. O boleto vence na data do link; o Pix respeita a validade apresentada, limitada também ao vencimento.

Detalhes importantes

• Criar o link não comprova pagamento. O recebedor só deve considerar a confirmação da cobrança.
• Um link em modo de teste mantém as operações no ambiente de teste.

Antes de começar

Permissão de leitura de cobranças; ações de atualização dependem do perfil.

Passo a passo

1. 01

   Abra Transações e confira produção ou Modo de teste.

2. 02

   Selecione a empresa quando o filtro estiver disponível e ajuste período, busca, situação e método oferecidos na tela.

3. 03

   Busque pela referência do seu sistema ou pelo identificador da cobrança.

4. 04

   Abra o registro para consultar valor, situação, pagador, taxas, split, códigos de pagamento e histórico permitido.

5. 05

   Use a ação de atualização ou verificação disponível no detalhe para conferir o provedor. Uma consulta local apenas mostra o estado já registrado.

6. 06

   Se houver permissão e opção de reemissão, revise os dados da nova cobrança antes de confirmar. Reemissão cria outra tentativa; não cancela automaticamente a anterior.

7. 07

   Para uma divergência, registre o identificador e a referência e siga o guia de diagnóstico ou abra um chamado.

Detalhes importantes

• Pendente aguarda pagamento; Processando indica tentativa em andamento; Resultado incerto exige conciliação; Pago confirma recebimento; Expirado, Falhou, Estornado e estados do cartão têm efeitos diferentes.
• Uma captura de tela ou comprovante enviado pelo pagador não substitui a confirmação autoritativa da plataforma.

Antes de começar

Referência, valor e empresa da tentativa original.

Passo a passo

1. 01

   Mantenha os dados da tentativa e leia o aviso do formulário. Ele pode travar os campos enquanto o resultado é investigado.

2. 02

   Use Ver o resultado da tentativa ou Procurar em Transações, conforme a ação exibida.

3. 03

   Confira se já existe cobrança com a referência, o valor e o tenant esperados.

4. 04

   Se existe, acompanhe o detalhe e a conciliação. Não emita outra para resolver um estado Processando ou Resultado incerto.

5. 05

   Para Pix e boleto, use somente o reenvio oferecido pela tentativa original: ele conserva a mesma chave de idempotência e os mesmos dados.

6. 06

   Para cartão, consulte o resultado primeiro; o formulário não guarda o instrumento para reenvio.

7. 07

   Se a tentativa local estiver ilegível, confira os registros e peça análise antes de descartar a tentativa guardada e iniciar outra.

Detalhes importantes

• Repetir o mesmo pedido com a mesma chave e o mesmo conteúdo reaproveita a tentativa. Mudar conteúdo com a mesma chave é recusado.
• Descartar um rascunho no navegador não cancela uma cobrança já enviada ao provedor.

Antes de começar

Empresa e permissão para emitir; para API, chave de teste.

Passo a passo

1. 01

   No portal, ative Modo de teste antes de abrir Nova cobrança.

2. 02

   Preencha os dados normalmente. A validação e as tarifas também são aplicadas às cobranças de teste.

3. 03

   Confira o selo de teste no resultado e em Transações.

4. 04

   Abra o detalhe e use Simular pagamento ou Simular expiração, quando disponível para seu perfil.

5. 05

   Confira os totais no ambiente de teste e, para integrações, as entregas dos webhooks de teste.

6. 06

   Na API, crie e use uma chave cp_test_. Ela determina o ambiente e só acessa transações de teste.

7. 07

   Volte à produção quando terminar. Não entregue códigos simulados como uma cobrança pagável.

Detalhes importantes

• O sandbox CalebePay é local e independente do sandbox do provedor. O sandbox cadastral de subcontas é outro assunto e não é garantido por uma chave de teste.
• Uma chave de produção não vira chave de teste por mudar o interruptor do portal.

Antes de começar

Permissão de envio, contato do cliente e canal habilitado para a empresa.

Passo a passo

1. 01

   Preencha ou selecione o cliente, incluindo e-mail e telefone com DDD.

2. 02

   Ao criar a cobrança, marque os canais que deseja usar entre os autorizados para a empresa.

3. 03

   Depois da criação, abra o detalhe da cobrança ou checkout para conferir a prévia da mensagem e o contato.

4. 04

   Use a ação de envio disponível e confira o registro no histórico.

5. 05

   Leia a situação de cada entrega; aceitação pelo serviço não garante leitura pelo cliente.

6. 06

   Se houver falha, revise contato e canal com a operação. Antes de repetir um envio de resultado incerto, confira se o destinatário já recebeu.

Se algo não funcionar

Antes de começar

Identificador e referência da cobrança; comprovante pode ajudar na análise.

Passo a passo

1. 01

   Abra a cobrança no tenant e ambiente corretos e confira valor, método, vencimento e situação.

2. 02

   Se estiver pendente, use a atualização disponível e aguarde a consulta. Boleto e conciliação podem depender do retorno do provedor.

3. 03

   Se estiver expirada, confira a data e se houve confirmação posterior. Uma cobrança expirada não é comprovante de estorno.

4. 04

   Se estiver recusada, leia a mensagem sanitizada e revise o dado indicado ou a configuração do método.

5. 05

   Para cartão, diferencie Autorizado, Pago, Contestado e Chargeback antes de liberar a venda.

6. 06

   Para boleto com dois pagamentos, acompanhe a identificação de duplicidade e a conclusão do estorno do Pix com a operação.

7. 07

   Se continuar divergente, abra chamado com empresa, referência, ID, horário e mensagem de erro. A equipe autorizada pode consultar o Monitor de integrações.

Antes de começar

Empresa ativa, permissão de gestão de assinaturas e pagador completo.

Passo a passo

1. 01

   Abra Assinaturas → Nova assinatura e confirme o tenant e o ambiente.

2. 02

   Informe nome da assinatura, descrição de cada cobrança e valor por ciclo.

3. 03

   Escolha Boleto ou Pix comum. Pix comum gera um link para o pagador escolher pagar; não é débito automático no banco.

4. 04

   Defina primeiro vencimento e recorrência: mensal, bimestral, trimestral, semestral ou anual, conforme as opções do formulário.

5. 05

   Informe quantos dias antes do vencimento os próximos ciclos serão emitidos, dentro do limite indicado.

6. 06

   Preencha os dados e endereço do pagador e selecione Criar assinatura.

7. 07

   Confira o primeiro ciclo em Ciclos. Boleto e link de Pix são emitidos na criação; as próximas emissões seguem o calendário.

Detalhes importantes

• O dia do primeiro vencimento se repete; em meses menores vale o último dia do mês.
• Emitido não significa pago. Cada cobrança tem seu próprio estado em Transações e nos webhooks.

Antes de começar

Conta e provedor compatíveis e habilitados; dados completos do pagador.

Passo a passo

1. 01

   Abra Nova assinatura e selecione Pix Automático.

2. 02

   Informe nome, descrição e valor fixo por ciclo.

3. 03

   Defina o primeiro vencimento ao menos dois dias à frente e uma recorrência oferecida. A opção bimestral não está disponível para Pix Automático.

4. 04

   Defina antecedência de emissão entre dois e dez dias e complete os dados do pagador.

5. 05

   Selecione Criar e pedir autorização e entregue ao pagador o link ou código de autorização disponível.

6. 06

   O pagador deve aprovar no aplicativo do banco em até 24 horas. Consulte Autorizações de Pix Automático e atualize a situação quando necessário.

7. 07

   Depois da aprovação, acompanhe os débitos agendados e a confirmação de cada ciclo. Pendente pode significar débito agendado, sem pagamento confirmado.

Detalhes importantes

• A autorização não cobra imediatamente. Não há retentativa automática de débito por falta de saldo nessa modalidade.
• Trocar a regra ou a subconta não transfere uma autorização existente. Se a conta de origem mudou, peça análise da operação.

Antes de começar

Cartão disponível para o tenant e consentimento do pagador para o débito recorrente.

Passo a passo

1. 01

   Abra Assinaturas → Nova assinatura e escolha o tenant.

2. 02

   Selecione Cartão de crédito quando a consulta de métodos oferecer essa opção.

3. 03

   Informe nome, descrição, valor por ciclo, primeiro vencimento e recorrência.

4. 04

   Preencha o cartão e marque a confirmação de que o pagador autorizou o débito desse valor em cada ciclo até o cancelamento.

5. 05

   Complete os dados e endereço do pagador e confirme Criar assinatura.

6. 06

   A plataforma cadastra o cartão no provedor e guarda somente o token protegido para os próximos débitos.

7. 07

   Confira os ciclos: o débito ocorre no vencimento de cada ciclo, e a confirmação aparece na transação correspondente.

Detalhes importantes

• O cartão recorrente difere da cobrança avulsa: na assinatura, o token protegido é guardado para os ciclos futuros.
• Se o método não aparece, confira disponibilidade para o tenant. A troca de tenant limpa os dados do cartão no formulário.

Antes de começar

Permissão de leitura de assinaturas.

Passo a passo

1. 01

   Abra Assinaturas e encontre o registro no tenant e ambiente corretos.

2. 02

   Confira valor, recorrência, próximo vencimento, estado da assinatura e eventual erro.

3. 03

   Selecione Ciclos para abrir o histórico.

4. 04

   Em cada linha, compare data de vencimento, situação do ciclo e situação da cobrança.

5. 05

   Abra ou copie o Link do pagador quando houver. Um link sem escolha do pagador ainda pode não ter uma transação.

6. 06

   Se um ciclo estiver não cobrado, leia o motivo: vencimento passado, autorização encerrada ou janela de agendamento perdida são exemplos.

7. 07

   Se houver erro de configuração, peça correção à operação e atualize a lista. Um ciclo passado não é emitido retroativamente por retomar a assinatura.

Antes de começar

Gestão de assinaturas; exclusão exige permissão específica.

Passo a passo

1. 01

   Abra a assinatura e consulte seus ciclos antes de alterar o estado.

2. 02

   Use Pausar para interromper a emissão de novos ciclos. Cobranças já emitidas continuam valendo.

3. 03

   Use Retomar para continuar o calendário. Ciclos vencidos durante a pausa ficam como não cobrados.

4. 04

   Use Cancelar e leia a confirmação. A assinatura cancelada não pode ser reativada.

5. 05

   No Pix Automático, confira também a autorização. Cancelar a assinatura não revoga automaticamente o consentimento; use Revogar autorização quando esse for o objetivo.

6. 06

   A revogação impede novos agendamentos por aquele consentimento e não estorna débitos já feitos.

7. 07

   Se Excluir estiver disponível, leia os requisitos e a confirmação específica. Não use exclusão como forma de estornar uma cobrança.

Detalhes importantes

• Uma autorização encerrada impede retomar a assinatura de Pix Automático. Operações em andamento ou incertas podem impedir a revogação até a conciliação.

Antes de começar

Permissão de leitura do painel.

Passo a passo

1. 01

   Abra Visão geral e confira o ambiente: os indicadores financeiros usam produção por padrão.

2. 02

   Selecione o tenant ou a operação permitida no topo.

3. 03

   Ajuste o período apresentado e compare os indicadores com o mesmo intervalo.

4. 04

   Consulte as cobranças por situação e os gráficos de volume disponíveis.

5. 05

   Abra Transações para investigar os registros que compõem os números.

6. 06

   Para saber quando o dinheiro é repassado, consulte Conta e seu extrato; volume cobrado não é saldo disponível.

Antes de começar

Leitura de clientes; cadastro e edição exigem gestão de clientes.

Passo a passo

1. 01

   Abra Clientes cadastrados e escolha a empresa quando aplicável.

2. 02

   Use a ação de novo cliente e informe nome, CPF/CNPJ, e-mail, telefone e endereço.

3. 03

   Digite o CEP e revise os campos preenchidos; complete número e complemento.

4. 04

   Confira os dados e salve. Use a busca para evitar criar o mesmo contato novamente.

5. 05

   Abra a edição do cliente para corrigir contatos ou endereço e salve as alterações.

6. 06

   Em Nova cobrança, use a seleção rápida de cliente para preencher os dados e confira-os antes da emissão.

Detalhes importantes

• Editar a agenda não reescreve o pagador de cobranças antigas: o histórico mantém os dados da emissão.
• A agenda Pay e os contatos comerciais do Shop atendem fluxos distintos. Confira em qual produto está editando.

Antes de começar

Acesso à empresa e permissão para alterar sua configuração.

Passo a passo

1. 01

   Abra Empresa e selecione o tenant correto.

2. 02

   Abra a seção Pagador padrão disponível no seu perfil.

3. 03

   Confira ou informe os dados de nome, documento e contatos apresentados.

4. 04

   Revise o preenchimento e salve a configuração.

5. 05

   Ao emitir Pix direto sem dados completos do pagador, confira os dados que a plataforma utiliza.

6. 06

   Para identificar um cliente específico, selecione o cliente cadastrado ou preencha explicitamente a cobrança.

Detalhes importantes

• Boleto e checkout exigem cadastro completo do pagador no fluxo de emissão; não devem ser tratados como Pix sem pagador.

Antes de começar

Leitura de cobranças; criação e edição exigem gestão de centros de custo.

Passo a passo

1. 01

   Abra Centros de custo e escolha o tenant.

2. 02

   Use a ação de cadastro e preencha os campos de identificação oferecidos, como nome e código.

3. 03

   Salve e confirme que o centro aparece entre as opções da empresa.

4. 04

   Em Nova cobrança, escolha o centro de custo antes da emissão.

5. 05

   Use o filtro por centro nas áreas que o oferecem para consultar e comparar as cobranças classificadas.

6. 06

   Ao editar ou desativar um centro, confira o histórico: registros anteriores preservam a classificação da emissão.

Antes de começar

Permissão de leitura da conta e tenant selecionado quando necessário.

Passo a passo

1. 01

   Abra Conta e confira a empresa e o período exibidos.

2. 02

   Leia as descrições dos cartões de saldo e valores em repasse para entender o que compõe cada total.

3. 03

   Consulte a programação e a situação dos repasses apresentados.

4. 04

   Selecione Ver extrato na data desejada para abrir os lançamentos daquele repasse.

5. 05

   Abra a referência de uma transação no extrato para conferir cobrança, taxas e valor líquido.

6. 06

   Confira a conta bancária cadastrada para recebimentos e compare qualquer divergência com o detalhe financeiro.

Detalhes importantes

• O calendário e os valores de repasse dependem das condições financeiras da conta e do provedor. Não confunda valor bruto das vendas com líquido disponível.
• Para trocar a conta bancária, siga a atualização cadastral e a verificação exigida pela operação.

Antes de começar

Acesso à conta do tenant e vínculo financeiro disponível.

Passo a passo

1. 01

   Abra Conta → Saldo e repasses e selecione o período.

2. 02

   Na lista Repasses para a conta bancária, confira data, valor e taxas.

3. 03

   Programado indica previsão; Transferido indica a situação informada pelo provedor.

4. 04

   Abra Ver extrato para consultar os lançamentos do repasse.

5. 05

   Em Conta bancária, confira o banco, a agência e a conta de destino.

6. 06

   Se o prazo ou valor divergir, reúna data, tenant e lançamento e peça análise à operação.

Detalhes importantes

• A tela Conta atual consulta repasses automáticos e não oferece um formulário de transferência manual.
• Novas subcontas são criadas com repasse semanal às sextas-feiras; a condição vigente da conta e o retorno do provedor determinam a programação efetiva.

Antes de começar

Acesso à empresa ou à cobrança; edição das taxas exige permissão própria.

Passo a passo

1. 01

   Abra Empresa → Taxas para consultar o que a empresa paga em cada método.

2. 02

   Confira os valores e as datas de início: uma taxa futura só vale a partir da vigência.

3. 03

   Para cartão, confira também a faixa ou a quantidade de parcelas quando houver tarifas específicas.

4. 04

   Antes de emitir, leia a prévia de taxas e divisão no formulário.

5. 05

   Depois da emissão, abra o detalhe para ver os valores e destinatários preservados na cobrança.

6. 06

   Se precisar alterar adicionais da hierarquia, siga o guia de gestão de taxas e confira as novas vigências antes de salvar.

Detalhes importantes

• A divisão considera a árvore de tenants: cada nível remunera seu superior, e a raiz remunera a matriz.
• Alterações posteriores não recalculam taxas de cobranças antigas. A tarifa do provedor e a tarifa CalebePay têm configurações distintas.

Antes de começar

Permissão de leitura de empresa; envio exige gestão de empresa.

Passo a passo

1. 01

   Abra Empresa e selecione a organização quando houver essa opção.

2. 02

   Consulte as abas disponíveis para seu perfil: documentos, taxas, cadastro e pagador padrão.

3. 03

   Em Documentos, confira os tipos exigidos, a versão atual e a situação da análise.

4. 04

   Envie uma nova versão pelo controle do tipo de documento correspondente, respeitando os limites mostrados.

5. 05

   Acompanhe a análise e leia o motivo se a versão for recusada.

6. 06

   Quando uma nova versão for aprovada, confira qual documento passou a valer. Versões anteriores permanecem no histórico permitido.

Detalhes importantes

• Enviar uma versão não a aprova automaticamente. A versão vigente depende da análise da CalebePay.
• A consulta de CNPJ e CEP é um auxílio de preenchimento; revise os dados retornados antes de salvar.

Antes de começar

Gestão de tenants; as opções dependem do seu escopo e perfil.

Passo a passo

1. 01

   Abra Tenants e consulte a árvore existente antes de cadastrar.

2. 02

   Use o cadastro de tenant e informe nome, identificador, tipo e dados solicitados.

3. 03

   Escolha o nível superior correto. Uma software house pode organizar estabelecimentos; tipos personalizados seguem o escopo configurado.

4. 04

   Revise a árvore e salve. Depois abra o detalhe do tenant para conferir cadastro e situação.

5. 05

   Para corrigir uma organização, use Editar tenant e altere apenas os campos necessários.

6. 06

   Ao alterar o nível superior ou tipo, confira o impacto na visibilidade, taxas e acesso dos usuários.

7. 07

   Use os controles de status e exclusão somente depois de ler suas confirmações e impedimentos.

Detalhes importantes

• Um filho não herda automaticamente o vínculo financeiro da subconta do pai.
• Suspender um nível superior afeta o acesso da árvore. Exclusão tem requisitos próprios e não deve ser usada como cancelamento de pagamentos.

Antes de começar

Permissão de gestão de subtenants, empresa superior ativa e configuração financeira da operação.

Passo a passo

1. 01

   Abra Tenants e selecione Cadastrar subtenant.

2. 02

   Preencha o cadastro empresarial e bancário exigido pelo formulário. Use a consulta de CNPJ e CEP como auxílio e revise o resultado.

3. 03

   Confira nome e identificador sugerido da nova empresa.

4. 04

   Selecione Validar cadastro e corrija os campos apontados.

5. 05

   Revise o resumo e selecione Criar tenant e subconta em produção, quando o fluxo estiver autorizado.

6. 06

   Aguarde e confira o resultado do cadastro e da solicitação financeira.

7. 07

   Se houver retorno incerto, use Acompanhar cadastros e Atualizar resultados ou Retomar envio da tentativa original.

Detalhes importantes

• Modo de teste de cobranças não autoriza criar subcontas reais por esse fluxo.
• Cadastro de tenant, vínculo financeiro e habilitação para receber têm situações independentes. Não trate o resumo local como aprovação financeira remota.

Antes de começar

Permissão de subtenants e arquivo .xlsx no modelo oferecido.

Passo a passo

1. 01

   Abra Tenants → Importar Excel → Baixar modelo Excel.

2. 02

   Preencha a aba Cadastros com os dados exigidos e mantenha as colunas do modelo.

3. 03

   Escolha o arquivo .xlsx de até 2 MB no formulário.

4. 04

   Leia os erros por linha. Nenhum cadastro é enviado antes de a planilha estar validada.

5. 05

   Corrija o arquivo e selecione-o novamente até o resumo apresentar os dados corretos.

6. 06

   Confirme Importar cadastros e acompanhe os resultados por linha.

7. 07

   Use Acompanhar cadastros para voltar ao lote, Atualizar resultados para reler a situação e Continuar cadastros quando restarem linhas pendentes.

Detalhes importantes

• Uma falha parcial não exige reenviar um novo lote inteiro. Retome o lote original para preservar a idempotência.
• Não preencha dados bancários ou documentos fictícios em uma importação de produção.

Antes de começar

Permissão para trazer subtenants e empresa ativa.

Passo a passo

1. 01

   Na área de tenants, abra a opção de link de cadastro de cliente disponível para sua empresa.

2. 02

   Confira a empresa responsável e o endereço mostrado.

3. 03

   Copie o link e entregue ao cliente pelo canal escolhido.

4. 04

   O cliente preenche os passos do cadastro público e envia os documentos solicitados.

5. 05

   Acompanhe a solicitação na área de cadastros permitida para seu perfil.

6. 06

   Depois da revisão, siga o fluxo de conversão ou onboarding apropriado. O envio do formulário não habilita recebimentos automaticamente.

Antes de começar

Dados cadastrais, contatos e documentos pedidos no formulário.

Passo a passo

1. 01

   Abra Comece agora no site CalebePay ou o link enviado pela sua operação.

2. 02

   Preencha as etapas de cadastro da empresa, responsável, contatos e dados bancários apresentados.

3. 03

   Use consultas auxiliares quando disponíveis e confira o preenchimento antes de continuar.

4. 04

   Anexe os documentos exigidos, observando formatos e limites de arquivo mostrados.

5. 05

   Revise o resumo e selecione Enviar cadastro. Aguarde a confirmação antes de reenviar.

6. 06

   Se interrompeu o preenchimento e recebeu um link de retomada, abra o e-mail mais recente para continuar o rascunho.

7. 07

   Aguarde a análise. A equipe pode pedir correção ou complemento antes da habilitação.

Detalhes importantes

• Enviar cadastro não cria automaticamente todas as condições de acesso ou pagamento. A análise e a conversão seguem as regras da operação.

Antes de começar

Permissões de leitura e gestão de cadastros do site; conversão exige acesso administrativo apropriado.

Passo a passo

1. 01

   Abra Cadastros do site e localize a solicitação.

2. 02

   Abra o detalhe e revise dados empresariais, contato, banco, origem e documentos.

3. 03

   Registre a situação e a análise de acordo com as opções da tela. Para cadastros incompletos, use a retomada por e-mail quando disponível.

4. 04

   Ao converter, confira o tenant superior, o provedor e os dados que serão enviados para criar a subconta.

5. 05

   Leia a revisão e confirme a conversão uma vez.

6. 06

   Acompanhe o resultado de criação do tenant e da subconta; em retorno incerto, consulte a tentativa antes de repetir.

7. 07

   Após a conversão, configure usuários e regras de pagamento pelos fluxos correspondentes.

Detalhes importantes

• A conversão não cria usuários nem regras de pagamento por si só. Um resultado incerto não deve ser tratado como recusa definitiva.
• Exclusão de solicitação exige permissão própria e leitura da confirmação da tela.

Antes de começar

Permissão para consultar ou alterar cadastro bancário da empresa.

Passo a passo

1. 01

   Abra Empresa → Cadastro, ou o detalhe do tenant com acesso administrativo.

2. 02

   Confira banco, agência, conta, tipo e titular nos campos apresentados.

3. 03

   Use a edição bancária quando disponível para seu perfil e preencha os dados da conta correta.

4. 04

   Revise a identificação do titular e os requisitos mostrados antes de salvar.

5. 05

   Confira a resposta da atualização e a situação da sincronização com a subconta do provedor.

6. 06

   Se sua tela orientar a troca por atendimento, envie o comprovante em Empresa → Documentos e abra um chamado para a verificação financeira.

Detalhes importantes

• Uma edição local ou envio de comprovante não garante que o provedor já aprovou a conta nova. Confira o resultado da sincronização.

Antes de começar

Gestão de taxas ou de taxas de subtenants, conforme o nível da empresa.

Passo a passo

1. 01

   Abra a edição de taxas do tenant ou de seus subtenants disponível para seu perfil.

2. 02

   Escolha o método: Pix, boleto ou cartão.

3. 03

   Informe os valores solicitados e a data de início. Confira se está definindo adicional do nível ou configuração da subconta.

4. 04

   No cartão, revise o alcance por parcelas quando disponível: taxa geral e taxas específicas podem ter condições distintas.

5. 05

   Leia a prévia e confira a soma da hierarquia antes de salvar.

6. 06

   Use a ação de sincronização financeira oferecida quando necessário e confira seu resultado.

7. 07

   Faça uma nova prévia de cobrança para verificar a vigência esperada. O histórico de cobranças anteriores mantém suas taxas originais.

Detalhes importantes

• Configurar uma vigência futura não muda cobranças já emitidas. Uma falha de sincronização deve ser acompanhada antes de considerar a configuração remota aplicada.

Antes de começar

Gestão de usuários; os perfis atribuíveis dependem das permissões do gestor.

Passo a passo

1. 01

   Abra Usuários → Novo usuário e informe nome e e-mail de acesso.

2. 02

   Escolha um perfil disponível. Perfis de tenant exigem empresa; perfis de plataforma ficam sem tenant.

3. 03

   No primeiro acesso, mantenha o convite por e-mail ou escolha Definir uma senha inicial manualmente.

4. 04

   Configure a exigência de verificação em duas etapas conforme as opções oferecidas.

5. 05

   Revise e salve. Para convite, confira a situação do envio e peça à pessoa que use o e-mail mais recente.

6. 06

   Para alterações, abra Editar usuário e ajuste os campos necessários. Mudanças de e-mail, acesso, senha ou status podem revogar sessões.

7. 07

   Para bloquear acesso, use o status de suspensão e confira o efeito. Reativar não recupera sessões ou convites revogados.

Detalhes importantes

• O gestor só pode atribuir perfis cujas permissões também possui. Não pode suspender a própria conta nem mudar seu próprio perfil ou tenant.
• Criar sem senha exige uma integração de e-mail padrão habilitada. Editar o usuário não envia convite automaticamente.

Antes de começar

Gestão de perfis; leitura também pode estar disponível a gestores de usuários.

Passo a passo

1. 01

   Abra Perfis e permissões e consulte os perfis e suas quantidades de usuários.

2. 02

   Crie um perfil ou abra um perfil editável.

3. 03

   Informe nome, descrição e escopo de plataforma ou tenant conforme as opções permitidas.

4. 04

   Selecione as permissões necessárias por grupo: leitura, criação, gestão e ações especiais são separadas.

5. 05

   Salve e confira a lista final. Para administrar a loja, inclua a permissão de administração do Shop em um perfil de tenant.

6. 06

   Em Usuários, atribua o perfil à pessoa e confira o tenant quando exigido.

7. 07

   Para excluir um perfil personalizado, mova primeiro os usuários vinculados e leia a confirmação.

Detalhes importantes

• O perfil Super admin é travado e possui o catálogo inteiro. Perfis do sistema não podem ser excluídos.
• Um perfil com usuários não pode mudar livremente de escopo nem ser excluído. Alterar um perfil não amplia os escopos de chaves de API já emitidas.

Antes de começar

Permissão de revisão de documentos e acesso ao tenant.

Passo a passo

1. 01

   Abra a empresa ou o detalhe do tenant e consulte Documentos.

2. 02

   Localize o tipo e a versão pendente de análise.

3. 03

   Abra o documento e confira titularidade, legibilidade e os requisitos da operação.

4. 04

   Use a ação de aprovação ou recusa disponível e registre a justificativa solicitada.

5. 05

   Confira a situação e qual versão ficou vigente após a análise.

6. 06

   Se precisar de correção, oriente o cliente a enviar uma nova versão do mesmo tipo; preserve o histórico anterior.

Antes de começar

Leitura e criação de chaves; revogação tem permissão específica.

Passo a passo

1. 01

   Abra Chaves de API → Criar chave.

2. 02

   Confirme o tenant e escolha o modo de teste ou produção.

3. 03

   Selecione os escopos necessários entre os permitidos pelo seu perfil.

4. 04

   Confirme a criação e copie o segredo para um armazenamento seguro no servidor. Ele aparece uma única vez.

5. 05

   Use cp_test_ para teste e cp_live_ para produção. Chaves antigas cp_key_ continuam de produção.

6. 06

   Mantenha a chave fora de navegador, repositório, e-mail e chamado de suporte.

7. 07

   Para substituir uma chave, configure a nova integração, confirme o funcionamento e revogue a antiga quando tiver autorização para essa ação.

Detalhes importantes

• A chave não pode conceder mais do que o emissor pode fazer. Perfis restritos podem criar chaves com acesso limitado a cobranças.
• Uma chave revogada não deve ser reutilizada. Não é possível recuperar o segredo pela listagem.

Antes de começar

Chave de teste com os escopos da operação e integração no servidor.

Passo a passo

1. 01

   Abra Documentação e escolha o exemplo de Pix, boleto, cartão, checkout ou assinatura apropriado.

2. 02

   Configure a URL da API e autenticação Bearer com a chave de teste no servidor.

3. 03

   Use os corpos e nomes de campo do guia e do OpenAPI. Na API, valores monetários são inteiros em centavos.

4. 04

   Envie uma chave Idempotency-Key única por tentativa de criação e preserve-a em reenvios do mesmo conteúdo.

5. 05

   Crie a cobrança e guarde o identificador, a referência e o ambiente retornados.

6. 06

   Consulte a transação, teste pagamento ou expiração em sandbox e configure um endpoint de webhook de teste.

7. 07

   Trate validações, limites de frequência e resultados incertos. Só migre para produção após validar as configurações financeiras e trocar explicitamente a chave.

Detalhes importantes

• Os exemplos em várias linguagens, o SDK e o contrato completo permanecem na documentação técnica. Use-os como referência exata dos endpoints.
• Uma lista com chave consulta o próprio tenant por padrão; inclusão de descendentes depende do parâmetro e do contrato da rota.

Antes de começar

Chave com os escopos específicos e autorização do emissor.

Passo a passo

1. 01

   Abra o guia Tudo o que dá para fazer pela API na documentação técnica.

2. 02

   Escolha a seção de subtenants ou centros de custo e confira os campos obrigatórios.

3. 03

   Crie uma chave com os escopos apropriados ao fluxo permitido; escopos de criação de cobranças não bastam para cadastros administrativos.

4. 04

   Valide documentos, banco e vínculos antes de enviar uma solicitação cadastral.

5. 05

   Preserve a idempotência da tentativa e guarde IDs e resultado de cada etapa.

6. 06

   Consulte o histórico ou o recurso criado antes de repetir uma solicitação com retorno incerto.

Detalhes importantes

• Teste de cobrança não equivale a ambiente cadastral isolado do provedor. Confira o contrato do fluxo antes de cadastrar uma empresa real.

Antes de começar

Gestão de webhooks e endpoint do seu sistema preparado para receber eventos.

Passo a passo

1. 01

   Abra Webhooks e selecione o tenant quando necessário.

2. 02

   Crie um endpoint com a URL HTTPS do seu servidor, ambiente e eventos oferecidos.

3. 03

   Guarde o segredo e implemente a verificação de assinatura conforme a documentação.

4. 04

   Responda rapidamente e processe o evento de forma idempotente pelo identificador, pois uma entrega pode ser repetida.

5. 05

   Em teste, simule uma mudança de cobrança e confira a lista de entregas.

6. 06

   Abra uma entrega para consultar resultado, tentativas e mensagem de erro permitida.

7. 07

   Para trocar o segredo, alterar ou desativar o endpoint, use as ações da tela e coordene a atualização do servidor receptor.

Detalhes importantes

• Não confirme uma venda usando apenas dados enviados pelo comprador. Verifique o evento e consulte o estado autoritativo quando necessário.
• Webhooks de teste são destinados aos endpoints de teste. Uma falha do receptor não desfaz o pagamento.

Antes de começar

Permissão de gestão de provedores e credenciais da conta financeira.

Passo a passo

1. 01

   Abra Provedores e crie ou edite a conexão apropriada.

2. 02

   Confira nome, tipo, ambiente e se a conta é marketplace.

3. 03

   Configure as credenciais pelos campos privados da tela. Segredos não devem ser copiados para chamados ou logs.

4. 04

   Habilite individualmente os métodos desejados: Pix, boleto e cartão.

5. 05

   Revise taxas padrão e dados de recebedor apresentados para a conta.

6. 06

   Salve e confira a situação da conexão. Para marketplace, crie o vínculo exato de subconta do tenant.

7. 07

   Configure a regra de cada método e confira também o controle de pagamentos em produção.

Detalhes importantes

• Ambiente do provedor e sandbox CalebePay são diferentes. Pix real depende da configuração de produção; não use o simulador como comprovante de homologação real.
• Salvar configuração não garante autenticação remota ou habilitação financeira de todos os métodos.

Antes de começar

Gestão de subcontas e acesso ao provedor marketplace.

Passo a passo

1. 01

   Abra Subcontas e escolha tenant e provedor corretos.

2. 02

   Use criação para um novo cadastro ou importação para uma conta já existente, conforme as opções da tela.

3. 03

   Preencha e revise dados empresariais, contato, endereço, banco e configuração de métodos.

4. 04

   Confirme a solicitação uma vez e acompanhe o resultado. Para retorno incerto, consulte e concilie a conta original antes de repetir.

5. 05

   Use consulta remota e atualização cadastral quando necessário e confira a resposta sanitizada.

6. 06

   Habilite ou desabilite o vínculo local conforme a operação. O tenant exato precisa ter vínculo ativo, mesmo que o pai já possua uma subconta.

7. 07

   Para excluir um vínculo, leia os requisitos da ação e confirme o impacto antes de executar.

Detalhes importantes

• Habilitar o vínculo local não altera automaticamente o estado financeiro remoto. A conta usada numa cobrança antiga permanece registrada nela.

Se algo não funcionar

Antes de começar

Gestão de regras, provedor com método habilitado e subconta quando exigida.

Passo a passo

1. 01

   Abra Regras de roteamento → Nova regra.

2. 02

   Escolha o tenant e o método da cobrança.

3. 03

   Selecione um provedor compatível e confira seu ambiente.

4. 04

   Defina prioridade e estado conforme os campos oferecidos.

5. 05

   Salve e revise as regras concorrentes para evitar uma seleção diferente da esperada.

6. 06

   No tenant, confira a disponibilidade do método em Nova cobrança.

7. 07

   Para produção, valide o controle global e a autorização financeira antes da emissão.

Detalhes importantes

• As regras são por método: configurar Pix não habilita automaticamente boleto ou cartão.
• Cobranças do sandbox CalebePay não usam regras financeiras nem chamam o provedor real.

Antes de começar

Gestão das configurações de pagamento e autorização operacional para movimentação real.

Passo a passo

1. 01

   Abra Provedores → Pagamentos em produção.

2. 02

   Leia a configuração efetiva salva: ela é aplicada às cobranças e não é redefinida por reiniciar a API.

3. 03

   Confira a habilitação global e se a operação está limitada a uma cobrança exata ou liberada sem escopo.

4. 04

   Para uma operação restrita, revise tenant, provedor, método, valor, referência e chave idempotente exigidos pelo escopo.

5. 05

   Revise as condições e salve somente a autorização que a operação aprovou.

6. 06

   Confira também métodos, subconta e regras do tenant: a liberação global sozinha não configura a cobrança.

7. 07

   Acompanhe emissão e consulta remota. Fechar a liberação não cancela uma chamada já enviada.

Detalhes importantes

• A central explica o controle; ela não concede autorização para movimentação financeira.
• Falha de leitura da configuração pode bloquear emissão e refresh remotos. Consultas locais continuam mostrando o que já foi registrado.

Antes de começar

Conta autenticada para chamados reais.

Passo a passo

1. 01

   Abra Ajuda e suporte no painel para conversar com o assistente.

2. 02

   Descreva a tarefa ou o problema sem incluir senhas, chaves de API ou dados de cartão.

3. 03

   Use os links oferecidos pelo assistente ou consulte um artigo desta central.

4. 04

   Para atendimento humano, selecione Abrir chamado e preencha assunto, tipo, categoria e descrição.

5. 05

   Informe os contatos e escolha os canais de resposta disponíveis.

6. 06

   Após a criação, guarde o protocolo e abra Meus chamados.

7. 07

   Abra o chamado para consultar o histórico e enviar complemento. Se estiver encerrado e precisar de outra análise, abra um novo chamado.

Detalhes importantes

• Inclua empresa, referência, identificador, horário e erro para casos de pagamento. No modo de demonstração não são criados chamados reais.

Antes de começar

Leitura de suporte; atendimento e configuração exigem gestão de suporte.

Passo a passo

1. 01

   Abra Central de suporte e use filtros de situação e busca para localizar chamados.

2. 02

   Abra a conversa e leia contexto, tipo, categoria, contatos e mensagens anteriores.

3. 03

   Com permissão de gestão, ajuste status, tipo e categoria conforme o atendimento.

4. 04

   Responda pelo formulário. A resposta é registrada e enviada aos canais escolhidos pelo cliente.

5. 05

   Confira Entregas de e-mail e WhatsApp para identificar falhas ou resultado incerto.

6. 06

   Use Tentar envio novamente somente depois de conferir o caso. Um resultado incerto pode ter sido entregue e exige confirmação de possível duplicidade.

7. 07

   Nas configurações do suporte, revise catálogo, integrações e assistente conforme as opções da tela.

Antes de começar

Leitura de notificações; publicação e marcação têm permissões próprias.

Passo a passo

1. 01

   Abra o sino no topo e consulte os avisos disponíveis para sua conta.

2. 02

   Abra a central de notificações para consultar o conteúdo completo.

3. 03

   Use a marcação de leitura quando ela estiver disponível.

4. 04

   Com permissão de envio, crie um comunicado e selecione o público ou tenant conforme o formulário.

5. 05

   Revise título, mensagem e destino antes de publicar.

6. 06

   Confira o aviso na central e as notificações push aplicáveis aos destinatários.

Detalhes importantes

• A marcação de leitura pode valer para todos que veem a notificação. Por isso alguns perfis apenas consultam.
• Preferências push do app são pessoais e não mudam as permissões de leitura do painel.

Antes de começar

Gestão de integrações e credenciais autorizadas dos serviços.

Passo a passo

1. 01

   Abra Configurações gerais e selecione o tipo de conexão.

2. 02

   Cadastre e-mail por SMTP ou Resend, WhatsApp pelo conector oferecido, armazenamento por MinIO/S3 ou IA conforme as opções disponíveis.

3. 03

   Preencha os campos de servidor, remetente, modelo ou bucket pedidos pelo formulário e informe credenciais em campos privados.

4. 04

   Salve, habilite a conexão e escolha um padrão para o canal quando ele precisar ser usado pela plataforma.

5. 05

   Execute o teste de conexão ou envio disponível com um destinatário controlado e autorizado.

6. 06

   Confira o resultado. Salvar ou aceitar o teste local não garante a entrega de todas as mensagens futuras.

7. 07

   Para a IA de temas do Shop, habilite uma conexão de IA padrão no Pay. A IA de fotos possui configuração própria na administração do Shop.

Detalhes importantes

• Convites, recuperação de senha e códigos de comprador dependem do e-mail padrão. WhatsApp Meta/Twilio pode exigir templates aprovados.
• Novos documentos usam armazenamento privado. Não publique credenciais nem altere chaves de criptografia como se fossem parâmetros comuns.

Antes de começar

Gestão do canal e de cadastros pelo WhatsApp; número autorizado da operação.

Passo a passo

1. 01

   Em Configurações gerais, abra a conexão de WhatsApp apropriada.

2. 02

   Se o conector usa pareamento por QR, gere o código e vincule-o pelo recurso de aparelhos conectados do WhatsApp autorizado.

3. 03

   Confira a situação da conexão e escolha o padrão quando o fluxo exigir.

4. 04

   Abra Cadastros pelo WhatsApp para consultar conversas e cadastros em andamento.

5. 05

   Selecione a conversa, confira os dados coletados e os campos ainda necessários.

6. 06

   Use as ações de revisão, acompanhamento e configuração oferecidas antes de continuar a habilitação do cliente.

7. 07

   Se o canal desconectar, revise a situação e faça novo pareamento conforme a tela.

Detalhes importantes

• Não trate informações coletadas em conversa como aprovação financeira. A conclusão do onboarding depende das validações e revisões correspondentes.

Antes de começar

Gestão de integrações e canal padrão habilitado.

Passo a passo

1. 01

   Abra Configurações gerais → Avisos de cadastro.

2. 02

   Escolha e-mail e/ou WhatsApp e preencha os destinatários autorizados da equipe.

3. 03

   Confira a lista: há até 50 destinatários por canal.

4. 04

   Revise os templates quando o conector exigir aprovação prévia.

5. 05

   Ative os canais desejados e salve.

6. 06

   Acompanhe os próximos cadastros no Monitor de notificações para conferir entregas e falhas.

Detalhes importantes

• Os avisos só começam depois da configuração e ativação. Essa lista não substitui o e-mail pessoal usado para convite de usuários.

Antes de começar

Leitura das configurações de pagamento; alterações exigem gestão.

Passo a passo

1. 01

   Abra Validações da API e consulte as regras efetivas.

2. 02

   Leia as opções de documento, telefone, DDD e dados do pagador que a tela oferece.

3. 03

   Altere somente as regras aprovadas para a operação e revise o alcance.

4. 04

   Salve e confira o retorno da configuração.

5. 05

   Valide uma requisição de teste com dados representativos antes de orientar a integração a usar a nova regra.

6. 06

   Se um cadastro continuar recusado, leia o campo e a mensagem retornados pela API.

Detalhes importantes

• Alterar uma validação local não remove exigências contratuais do provedor nem transforma dados inválidos em cadastro financeiro aprovado.

Antes de começar

Leitura do monitor; corpo completo depende de permissão adicional.

Passo a passo

1. 01

   Abra Monitor de integrações e ajuste período, tenant, ambiente e filtros disponíveis.

2. 02

   Localize a cobrança pelo ID, referência, caminho ou ocorrência correspondente.

3. 03

   Abra a chamada e compare direção, método, horário, status HTTP, duração e identificador de requisição.

4. 04

   Com permissão, consulte request e response mascarados para identificar validação ou recusa do provedor.

5. 05

   Diferencie falha de autenticação, erro de entrada, indisponibilidade e resultado incerto.

6. 06

   Registre o ID de requisição e a mensagem sanitizada no chamado; confira a transação antes de repetir uma emissão.

Detalhes importantes

• Credenciais são mascaradas; dados de cartão não ficam no corpo dessas chamadas. Retenção depende da configuração, normalmente 30 dias.
• Permissão do monitor não concede automaticamente visibilidade de todos os dados de clientes.

Antes de começar

Acesso ao monitor e permissão da ação de reenvio quando oferecida.

Passo a passo

1. 01

   Abra Monitor de notificações e filtre canal, período ou situação disponíveis.

2. 02

   Abra o registro e confira destinatário, origem, integração, tentativas e mensagem de erro.

3. 03

   Pendente aguarda processamento; Enviando indica tentativa em curso; Enviado indica aceitação pelo serviço.

4. 04

   Para Bloqueado, confira se há conexão padrão habilitada. Para Falhou, corrija a causa conhecida.

5. 05

   Para Resultado incerto, consulte o serviço ou destinatário antes de repetir: a mensagem pode ter sido entregue.

6. 06

   Use a ação de reenvio disponível e acompanhe o novo resultado.

Antes de começar

Permissão de leitura de logs.

Passo a passo

1. 01

   Abra Logs de atividade e ajuste o tenant ou período quando disponível.

2. 02

   Busque a ação, recurso ou usuário relacionado ao caso.

3. 03

   Abra os detalhes oferecidos para consultar data, responsável e metadados permitidos.

4. 04

   Compare o evento com o estado atual do recurso e com o horário da ocorrência.

5. 05

   Para investigar comunicação com um serviço externo, consulte também o Monitor de integrações ou de notificações.

6. 06

   Inclua o identificador e o horário do evento no atendimento quando precisar de análise.

Antes de começar

Permissão de analytics do site.

Passo a passo

1. 01

   Abra Monitoramento → Analytics do site e escolha período e comparação.

2. 02

   Consulte a visão geral e o tempo real para identificar visitas recentes.

3. 03

   Na aquisição, compare canais e origens, incluindo tráfego de assistentes de IA quando classificado.

4. 04

   Abra páginas e eventos para entender navegação e eventos-chave.

5. 05

   Use o funil de cadastro para localizar perdas entre etapas; confira retenção, tecnologia e geografia quando disponíveis.

6. 06

   Consulte Core Web Vitals para avaliar a experiência real dos visitantes e compare com o período escolhido.

7. 07

   Use Campanhas e Mapa de calor para aprofundar uma origem ou página específica.

Detalhes importantes

• A medição do site não usa cookies, não guarda IP e não registra o texto digitado pelos visitantes. Dados agregados não são histórico individual de cada pessoa.
• Eventos registrados e filtros ativos determinam os números; não compare períodos diferentes sem ajustar a seleção.

Antes de começar

Leitura de campanhas; criação e gestão dependem de permissões específicas.

Passo a passo

1. 01

   Abra Campanhas e consulte as campanhas existentes.

2. 02

   Use a criação disponível e informe nome, destino e dados de origem, mídia e campanha pedidos.

3. 03

   Revise a URL gerada para garantir que leva à página correta.

4. 04

   Copie e use o link nos canais da campanha.

5. 05

   Volte à tela para conferir os resultados do período disponível.

6. 06

   Compare a aquisição no Analytics do site e os cadastros com a origem registrada.

Detalhes importantes

• Criar um link não publica uma campanha em redes sociais nem envia mensagens. A distribuição do link é uma ação separada da sua equipe.

Antes de começar

Permissão de analytics do site.

Passo a passo

1. 01

   Abra Mapa de calor e selecione página, período e dispositivo.

2. 02

   Confira a largura da prévia para comparar a mesma experiência desktop ou celular.

3. 03

   Escolha a camada de cliques, movimento, rolagem ou atenção disponível.

4. 04

   Use as camadas de cliques de raiva e cliques mortos para localizar pontos de possível dificuldade.

5. 05

   Compare os resultados com visitas e conversões do mesmo período no Analytics.

6. 06

   Se não houver dados, revise filtros e volume de visitas antes de concluir que a página não recebe interação.

Detalhes importantes

• Mapa de calor tem retenção menor que analytics, normalmente 90 dias. A visualização não captura o conteúdo digitado em formulários.

Antes de começar

Permissão de leitura de deploys e ambiente com histórico configurado.

Passo a passo

1. 01

   Abra Deploys e confira a release ativa.

2. 02

   Consulte data, commit, repositório e identificação da versão.

3. 03

   Leia a classificação: Rastreável liga o pacote ao commit; Árvore suja informa alterações fora do commit; Sem manifesto indica falta do registro.

4. 04

   Se houver Manifesto ilegível ou histórico indisponível, peça à operação para conferir configuração e permissões do servidor.

5. 05

   Ao abrir um chamado sobre comportamento após atualização, informe release e commit mostrados.

Detalhes importantes

• A tela é de consulta. Publicar ou reverter uma versão é um procedimento operacional fora desse painel.

Antes de começar

Permissão de leitura da saúde do servidor.

Passo a passo

1. 01

   Abra Saúde do servidor e confira a atualização mais recente.

2. 02

   Consulte os indicadores de CPU, memória, disco e tempo de atividade disponíveis.

3. 03

   Confira as situações de API, banco, Redis e dependências apresentadas.

4. 04

   Compare um alerta com o horário das falhas de integração ou das requisições dos usuários.

5. 05

   Se houver indisponibilidade ou tendência de esgotamento, registre o indicador e o horário e acione a operação.

6. 06

   Atualize a consulta para confirmar recuperação após a intervenção.

Detalhes importantes

• A tela de saúde não comprova aprovação financeira de um provedor nem confirma um pagamento individual.

Antes de começar

E-mail, dados de cadastro e um endereço de loja disponível.

Passo a passo

1. 01

   Abra Criar minha loja no site ou app.calebeshop.com.br/cadastro.

2. 02

   Preencha o formulário com os dados do responsável e da loja.

3. 03

   Escolha o endereço: letras minúsculas, números e hífens, com três a 48 caracteres e início e fim alfanuméricos.

4. 04

   Revise nome, endereço e credenciais e confirme a criação.

5. 05

   Aguarde a ativação da conta. Se houver falha transitória, retome com o mesmo endereço e credenciais, sem criar outra tentativa com dados diferentes.

6. 06

   Entre no painel e cadastre produtos, categorias e estoque.

7. 07

   Personalize o tema, confira fretes e políticas e publique a loja quando estiver pronta.

Detalhes importantes

• Uma organização possui uma loja nesta versão. Abrir a loja cria ou vincula a identidade interna CalebePay e não habilita recebimentos reais automaticamente.

Antes de começar

Conta ativa e permissão de administração do Shop para criar ou alterar a loja.

Passo a passo

1. 01

   Abra o painel Shop e entre com e-mail e senha da sua conta Calebe.

2. 02

   Conclua o MFA se sua conta exigir.

3. 03

   Se a empresa já tem loja, o painel abre a operação vinculada.

4. 04

   Se aparecer a preparação da loja, informe nome e endereço e selecione Criar loja com minha conta Calebe.

5. 05

   Confira a empresa associada e o modo de pagamento depois da criação.

6. 06

   Se entrar com leitura, consulte os dados permitidos. Para alterar a loja, peça revisão da permissão de administração do Shop no perfil Pay.

Detalhes importantes

• Estabelecimento, Software house, Plataforma e tipos personalizados podem usar a organização existente quando o acesso permite. A empresa e os níveis superiores precisam estar ativos.
• Super admin entra na administração global do Shop, sem precisar vincular uma loja própria.

Antes de começar

Loja criada e acesso com permissão de administração.

Passo a passo

1. 01

   Em Visão geral, confira as etapas de preparação e os indicadores.

2. 02

   Cadastre Categorias e Produtos com descrição, preço, variações e fotos.

3. 03

   Informe estoque inicial ou registre compras e ajustes em Estoque.

4. 04

   Em Fretes e entregas, configure origem, embalagem e opções de entrega.

5. 05

   Em Aparência e IA, escolha um modelo, revise a prévia e publique o tema.

6. 06

   Em Configurações, informe contatos e políticas e confira o ambiente de pagamentos.

7. 07

   Publique a loja e faça uma compra de teste para conferir sacola, frete e acompanhamento do pedido.

8. 08

   Somente após habilitação financeira no Pay, mude o Shop explicitamente para produção.

Detalhes importantes

• Vendas em produção mostra pagamentos reais confirmados; Pedidos recebidos inclui os pedidos da loja; Atenção ao estoque destaca variações com menos de cinco unidades.

Antes de começar

Administração do Shop.

Passo a passo

1. 01

   Abra Configurações.

2. 02

   Em Identidade e contato, revise nome da loja, e-mail, telefone e endereço.

3. 03

   Confira o rótulo e o valor do frete fixo em Entrega e pagamentos, quando essa opção estiver em uso.

4. 04

   Em Políticas da loja, escreva as orientações de trocas e devoluções e a política de privacidade aplicáveis ao negócio.

5. 05

   Revise o ambiente e os métodos de pagamento conforme o guia específico.

6. 06

   Selecione Salvar configurações e abra Ver loja para conferir a apresentação.

Detalhes importantes

• As políticas precisam refletir sua operação real. A central não substitui a definição das condições comerciais do lojista.

Antes de começar

Administração do Shop e configuração financeira da empresa no Pay para recebimentos reais.

Passo a passo

1. 01

   Abra Configurações → Entrega e pagamentos.

2. 02

   Confira a conta CalebePay conectada à loja.

3. 03

   Escolha Teste — pagamentos simulados para validar os fluxos sem receber dinheiro.

4. 04

   Marque Pix, Boleto e/ou Cartão de crédito conforme as opções desejadas e salve.

5. 05

   Faça um pedido de teste e confira o link de pagamento e a conciliação do pedido.

6. 06

   Antes da produção, valide no Pay cadastro, subconta, método, regra e autorização de pagamentos reais.

7. 07

   Mude para Produção — pagamentos reais de forma explícita e salve. Confira o ambiente nos novos pedidos.

Detalhes importantes

• Alterar o modo não transforma pedidos de teste anteriores em vendas reais.
• Não marque um pedido como pago por ter criado um checkout: a confirmação vem do Pay.

Antes de começar

Administração do Shop, catálogo preparado e tema disponível.

Passo a passo

1. 01

   Em Aparência e IA, abra a Prévia do tema que deseja usar.

2. 02

   Confira desktop e celular, imagens, textos e produtos. Prévia não permite comprar.

3. 03

   Na Biblioteca de temas, selecione Publicar na versão desejada.

4. 04

   Abra Configurações e marque Loja publicada e disponível para visitantes.

5. 05

   Salve e abra Visitar minha loja no subdomínio CalebeShop.

6. 06

   Confira catálogo, variantes, sacola e políticas. Domínios próprios só funcionam depois de verificados e com loja publicada.

7. 07

   Para retirar a vitrine do ar, desmarque a publicação em Configurações e salve. Continue acompanhando pedidos já existentes.

Se algo não funcionar

Antes de começar

Loja criada; categorias são opcionais, mas ajudam a organizar a vitrine.

Passo a passo

1. 01

   Abra Produtos → Adicionar produto.

2. 02

   Informe nome e endereço do produto, escolha categoria e escreva a descrição.

3. 03

   Escolha Rascunho para preparar, Ativo para exibir na loja publicada ou Arquivado para retirar da venda.

4. 04

   Adicione fotos, escolha a capa e confira a ordem da galeria.

5. 05

   Em cada variação, preencha nome, SKU único, custo, preço de venda e preço anterior quando aplicável.

6. 06

   Informe estoque inicial, peso em gramas e embalagem em centímetros. Para variações já salvas, o estoque é ajustado em Estoque.

7. 07

   Marque quais variações estão ativas e selecione Salvar produto.

8. 08

   Busque por nome ou SKU para localizar e editar posteriormente; confira o resultado na vitrine.

Detalhes importantes

• Preço anterior é referência de apresentação e não substitui o preço de venda.
• Custos de compra são dados da operação e não são mostrados ao comprador. Produtos rascunho ou arquivados não entram na vitrine ativa.

Antes de começar

Novo produto em edição e SKUs exclusivos na loja.

Passo a passo

1. 01

   No novo produto, preencha o nome e os valores da variação base.

2. 02

   Em Gerar grade de variações, escreva opções como Cor: Preto, Azul; Tamanho: P, M, G.

3. 03

   Use até três opções e separe os valores por vírgula.

4. 04

   Selecione Gerar combinações. O limite é de 200 combinações.

5. 05

   Revise todas as linhas geradas: a grade copia custo e preço da base e gera nomes e SKUs.

6. 06

   Ajuste preço, estoque inicial, peso, medidas e status de cada variação.

7. 07

   Salve o produto. Em produtos existentes, use Adicionar variação e edite as linhas disponíveis; a geração da grade é oferecida na criação.

Detalhes importantes

• Gerar combinações recompõe as variações ainda não salvas. Revise as linhas antes de perder ajustes do rascunho.
• Uma variação desativada não deve ser confundida com variação sem estoque.

Antes de começar

Administração do Shop.

Passo a passo

1. 01

   Abra Categorias → Nova categoria.

2. 02

   Informe nome, endereço, descrição e ordem de exibição.

3. 03

   Salve e vincule os produtos pela edição de Produtos.

4. 04

   No editor visual, use categorias nas seções de coleções ou catálogo quando apropriado.

5. 05

   Para corrigir nome ou ordem, selecione Editar na categoria e salve.

6. 06

   Antes de Excluir, mova os produtos vinculados para outra categoria ou retire o vínculo. Leia a confirmação.

Antes de começar

Administração do Shop e armazenamento configurado para uploads.

Passo a passo

1. 01

   Abra um produto em edição e localize Fotos do produto.

2. 02

   Envie uma ou várias fotos pelo controle de upload.

3. 03

   Use JPEG, PNG ou WebP de até 8 MB, com no máximo 6.000 pixels por lado e 12 megapixels.

4. 04

   Aguarde a conclusão dos uploads antes de salvar o produto.

5. 05

   Escolha a capa e reorganize a galeria; cada produto aceita até 12 fotos.

6. 06

   Para reaproveitar uma imagem, abra a biblioteca e selecione a foto desejada.

7. 07

   Remova da galeria o que não deve aparecer e selecione Salvar produto para registrar a composição.

Detalhes importantes

• Remover da galeria preserva o arquivo na biblioteca. Um upload não publica sozinho o produto.
• Links de imagens legados continuam compatíveis. Se o armazenamento estiver indisponível, peça diagnóstico ao superadministrador.

Antes de começar

Referência na biblioteca, IA de fotos habilitada pelo superadministrador e limite diário disponível.

Passo a passo

1. 01

   Na edição do produto, abra a geração por IA em Fotos do produto.

2. 02

   Selecione uma foto enviada como referência e confira se mostra bem o produto.

3. 03

   Escolha até três vistas: três quartos, detalhe/textura e estúdio, conforme a interface.

4. 04

   Preencha orientações adicionais coerentes com o produto e revise a solicitação.

5. 05

   Confirme a geração uma vez e acompanhe o estado da fila.

6. 06

   Quando terminar, revise cada resultado: cor, textura, forma e detalhes comerciais.

7. 07

   Inclua explicitamente as fotos aprovadas na galeria, reorganize a capa e salve o produto.

Detalhes importantes

• Há no máximo uma solicitação ativa por loja e um limite de fotos em 24 horas. A geração usa o provedor configurado e pode consumir créditos.
• Vistas novas não garantem reconstruir detalhes de uma face oculta. Verifique fidelidade antes de publicar.
• Falhas não são repetidas automaticamente para evitar cobranças duplicadas. Confira a causa antes de criar uma nova solicitação.

Antes de começar

Acesso à loja e produtos com variações cadastradas.

Passo a passo

1. 01

   Abra Estoque e consulte a posição por produto e SKU.

2. 02

   Físico é a quantidade em estoque; Reservado é a quantidade comprometida por pedidos; Disponível é físico menos reservado.

3. 03

   Confira custo unitário e valor em estoque para acompanhar o investimento.

4. 04

   Consulte Histórico de movimentações para entender entradas, saídas e seus motivos.

5. 05

   Abra Pedidos para localizar reservas ligadas a vendas ainda pendentes.

6. 06

   Se o pagamento for confirmado, a baixa de estoque ocorre uma única vez. Uma situação incerta pode manter a reserva até a conciliação.

Detalhes importantes

• Um pedido reserva estoque antes de confirmar pagamento. Reembolso não repõe estoque automaticamente.
• Não retire por ajuste unidades que já estão reservadas. Resolva o pedido e a conciliação primeiro.

Antes de começar

Administração do Shop e variação cadastrada.

Passo a passo

1. 01

   Abra Estoque → Ajustar estoque.

2. 02

   Escolha produto e variação pelo SKU.

3. 03

   Informe quantidade positiva para adicionar ou negativa para retirar.

4. 04

   Escreva um motivo claro com pelo menos cinco caracteres.

5. 05

   Revise se a retirada preserva as unidades reservadas.

6. 06

   Selecione Salvar e confira a posição e o histórico da movimentação.

Se algo não funcionar

Antes de começar

Administração do Shop para salvar; leitura para consultar.

Passo a passo

1. 01

   Abra Fornecedores e use o cadastro de novo fornecedor.

2. 02

   Informe nome, CPF/CNPJ, e-mail, telefone e endereço nos campos apresentados.

3. 03

   Para CNPJ numérico, use a consulta cadastral quando disponível e revise o retorno.

4. 04

   Complete o CEP para auxiliar o endereço e informe número e complemento.

5. 05

   Salve e confira o fornecedor na lista.

6. 06

   Use a edição para corrigir os dados e selecione o fornecedor ao registrar uma compra.

Detalhes importantes

• Falha de consulta externa permite preenchimento manual. O retorno da consulta não substitui a conferência do cadastro.

Antes de começar

Administração do Shop e variações cadastradas.

Passo a passo

1. 01

   Abra Compras → Registrar compra.

2. 02

   Informe Nota fiscal / referência e a data da compra.

3. 03

   Selecione fornecedor quando houver e adicione observações pertinentes.

4. 04

   Em cada item, escolha a variação, quantidade recebida e custo unitário em reais.

5. 05

   Use Adicionar item para incluir outras variações.

6. 06

   Revise os valores e selecione Confirmar recebimento uma vez.

7. 07

   Confira Ver itens no registro e as entradas em Estoque. O recebimento atualiza o custo médio ponderado.

Detalhes importantes

• A referência impede recebimentos duplicados. Use a referência original para investigar um retorno incerto.
• O campo de nota fiscal é uma referência do recebimento; ele não emite documento fiscal.

Antes de começar

Acesso à loja; alterações exigem administração do Shop.

Passo a passo

1. 01

   Abra Pedidos e localize a venda pela data, identificação e cliente.

2. 02

   Confira os selos de pagamento e ambiente, a situação da entrega e o total.

3. 03

   Abra o número do pedido para consultar cliente, endereço, itens, frete e canal de venda.

4. 04

   Use Abrir pagamento para consultar o checkout quando houver.

5. 05

   Para acompanhar a entrega de um pedido pago, use o fluxo de expedição.

6. 06

   Para divergência no pagamento, siga o guia de atualização e confira também a cobrança no Pay.

Detalhes importantes

• Cliente, preços, canal e entrega mantêm os dados do momento da venda. Alterar o cadastro depois não reescreve pedidos antigos.

Antes de começar

Administração do Shop, produtos ativos e estoque disponível.

Passo a passo

1. 01

   Abra Pedidos → Criar pedido.

2. 02

   Selecione um cliente cadastrado ou use o novo cadastro dentro do pedido.

3. 03

   Confira contatos e endereço e escolha o canal de venda.

4. 04

   Selecione variações, quantidades e confira os valores do catálogo.

5. 05

   Aplique cupom quando houver e escolha frete fixo, retirada ou cotação válida.

6. 06

   Adicione observação interna e revise itens, desconto, frete e total.

7. 07

   Confirme uma vez e abra o link de pagamento gerado.

8. 08

   Acompanhe pagamento e reserva em Pedidos; criar o pedido não marca a venda como paga.

Detalhes importantes

• Preços e disponibilidade são recalculados no servidor. Cotações vencidas ou alteradas são recusadas.
• Uma observação interna não é exibida no histórico do comprador.

Antes de começar

Acesso ao pedido; atualização manual exige administração do Shop.

Passo a passo

1. 01

   Abra Pedidos e confira o ambiente da venda.

2. 02

   Use Atualizar pagamento na linha quando houver permissão.

3. 03

   Abra o detalhe para consultar a situação e o link do checkout original.

4. 04

   Aguarde a conciliação automática, que consulta o Pay periodicamente, normalmente a cada 30 segundos.

5. 05

   Quando Pago for confirmado, confira a baixa do estoque e prossiga para expedição.

6. 06

   Se estiver incerto, preserve a reserva e investigue a cobrança no Pay antes de emitir outro pedido.

7. 07

   Em recusa definitiva ou expiração sem transação, a reserva pode ser liberada conforme o fluxo; confira o estado efetivo.

Detalhes importantes

• Atualizar consulta a situação; não recebe dinheiro nem marca manualmente como pago.
• Reembolso não repõe automaticamente o estoque e o Shop não oferece todo o fluxo de cancelamento, devolução e estorno nesta versão.

Antes de começar

Administração do Shop e pedido Pago ainda não entregue.

Passo a passo

1. 01

   Abra Pedidos e selecione um pedido com pagamento confirmado.

2. 02

   Confira itens e endereço do comprador antes de preparar o volume.

3. 03

   No detalhe, selecione Enviado quando despachar.

4. 04

   Informe o Código de rastreio disponível e use Atualizar entrega.

5. 05

   Depois da conclusão, volte ao pedido e selecione Entregue.

6. 06

   Confira a situação na lista e o histórico apresentado ao comprador em Minha conta.

Detalhes importantes

• Registrar rastreio não compra etiqueta nem envia a mercadoria. A expedição física é responsabilidade da loja.
• Pedidos pendentes não devem ser liberados para expedição só porque há comprovante externo.

Antes de começar

Leitura da loja; cadastro e edição exigem administração do Shop.

Passo a passo

1. 01

   Abra Clientes e consulte os contatos existentes antes de criar outro.

2. 02

   Use o novo cadastro e informe nome, documento, e-mail, telefone e endereço.

3. 03

   Confira consultas de CNPJ ou CEP e complete os campos restantes.

4. 04

   Salve e use a edição para corrigir os dados quando necessário.

5. 05

   Ao criar um pedido assistido, selecione o cliente para preencher a venda.

6. 06

   Consulte o histórico de vendas e contatos oferecido no painel para apoiar o atendimento.

Detalhes importantes

• Clientes também aparecem a partir de compras na vitrine. O histórico do pedido preserva o e-mail e os dados originais.
• O comprador entra em Minha conta por código de e-mail; esse acesso é separado do usuário administrativo Calebe.

Antes de começar

Administração do Shop.

Passo a passo

1. 01

   Abra Cupons → Novo cupom.

2. 02

   Informe o código com pelo menos três caracteres; o formulário usa maiúsculas.

3. 03

   Escolha Percentual ou Valor fixo e preencha o desconto.

4. 04

   Defina Pedido mínimo em reais e Válido até quando houver prazo.

5. 05

   Marque Cupom ativo e salve.

6. 06

   Aplique o código em uma sacola ou pedido compatível e confira o total recalculado.

7. 07

   Para alterar ou encerrar a oferta, abra a edição e ajuste as condições ou desative o cupom.

Se algo não funcionar

Antes de começar

Administração do Shop para criar ou alterar.

Passo a passo

1. 01

   Abra Canais de venda e consulte Site, App e Loja física, criados por padrão.

2. 02

   Adicione um canal para uma origem relevante da operação.

3. 03

   Informe o nome e salve o estado apropriado.

4. 04

   Na criação do pedido assistido, escolha o canal usado na venda.

5. 05

   Consulte o canal no detalhe e na lista de pedidos.

6. 06

   Renomeie ou desative canais quando necessário; o nome original continua preservado no histórico dos pedidos.

Antes de começar

CEP de origem e dados de embalagem reais.

Passo a passo

1. 01

   Abra Fretes e entregas.

2. 02

   Informe CEP de origem e os campos de peso e embalagem padrão da loja.

3. 03

   Configure as opções de frete fixo e retirada conforme os controles disponíveis.

4. 04

   Informe rótulo e valor apropriados; zero pode representar entrega gratuita ou retirada, conforme a opção configurada.

5. 05

   Revise peso e dimensões de cada variação em Produtos. Dados específicos prevalecem sobre os padrões.

6. 06

   Salve e use o simulador com um CEP de destino e itens representativos.

7. 07

   Confira a sacola e um pedido assistido para validar quais opções são oferecidas.

Detalhes importantes

• Se desabilitar frete fixo, o pedido pode exigir cotação válida para concluir. Evite remover a única opção antes de configurar uma transportadora.
• Peso e medidas incorretos podem gerar preços incompatíveis com o envio real.

Antes de começar

Conta Melhor Envio e token autorizado para cálculo de fretes.

Passo a passo

1. 01

   Em Fretes e entregas, abra a conexão Melhor Envio.

2. 02

   Escolha Homologação / sandbox ou Produção conforme a conta e o uso pretendido.

3. 03

   Informe o e-mail de contato técnico.

4. 04

   Preencha o token com permissão de cálculo de frete e os códigos de serviços opcionais.

5. 05

   Marque Ativar consulta de fretes e selecione Salvar conexão.

6. 06

   Confira origem, pesos e medidas e execute uma cotação no simulador.

7. 07

   Valide o retorno com sua conta antes de oferecer a conexão em vendas reais.

Detalhes importantes

• O token já salvo é preservado se o campo de credencial ficar em branco na edição.
• Loja com pagamento real não usa cotação de homologação. A conexão faz cálculo; não compra nem emite etiqueta.

Antes de começar

Acesso CWS com APIs de preço e prazo liberadas e serviços contratados.

Passo a passo

1. 01

   Em Fretes e entregas, abra a conexão Correios.

2. 02

   Escolha ambiente e informe usuário CWS e código de acesso à API.

3. 03

   Preencha cartão de postagem e, quando necessário, contrato e regional/DR.

4. 04

   Informe os códigos de serviço separados por vírgula, até seis serviços.

5. 05

   Marque Ativar consulta de fretes e selecione Salvar conexão.

6. 06

   Revise CEP de origem e medidas e execute a cotação de teste pelo simulador.

7. 07

   Homologue o retorno com a conta real antes de liberar para compradores.

Detalhes importantes

• O conector agrupa os itens em um volume, somando alturas e pesos. Pedidos acima dos limites precisam de divisão operacional.
• Não há otimização multivolume nem compra de etiquetas nessa entrega.

Antes de começar

Opção fixa habilitada ou conexão válida, origem e itens cadastrados.

Passo a passo

1. 01

   Abra o simulador em Fretes e entregas e informe CEP de destino.

2. 02

   Selecione produtos, variações e quantidades do cenário que deseja validar.

3. 03

   Solicite a cotação e compare opções, preços, prazos e avisos.

4. 04

   Se não houver retorno, confira credenciais, ambiente, CEP de origem e destino e peso e medidas.

5. 05

   Na sacola ou pedido assistido, selecione uma cotação válida. Ela dura 15 minutos e está ligada aos itens, CEP, preços e configurações.

6. 06

   Ao alterar CEP, itens ou quantidade, refaça a consulta; a cotação anterior pode deixar de valer.

7. 07

   Se a transportadora estiver indisponível, use uma opção alternativa habilitada ou resolva a configuração antes de concluir.

Detalhes importantes

• A consulta de CEP pode preencher o endereço, mas você ainda deve informar número e complemento. Falhas na consulta permitem preenchimento manual.
• Na sacola, a consulta automática pode selecionar a opção disponível de menor valor. Confira a seleção antes de pagar.

Antes de começar

Loja criada e administração do Shop para alterar.

Passo a passo

1. 01

   Abra Aparência e IA e confira os modelos nativos disponíveis.

2. 02

   Escolha Atelier, Galeria ou Studio conforme a direção visual desejada.

3. 03

   Use Personalizar este modelo para abrir uma base no editor.

4. 04

   Na Biblioteca de temas, abra Prévia para comparar versões existentes.

5. 05

   Personalize e salve o rascunho, depois selecione Publicar na versão que deve ir para a vitrine.

6. 06

   Para remover uma versão fora de uso, selecione Excluir e leia a confirmação. Publique outro tema antes de excluir o atual.

Detalhes importantes

• Excluir tema é uma remoção lógica e não oferece restauração pelo painel nesta versão. Imagens utilizadas em outros produtos ou versões são preservadas.

Antes de começar

Tema disponível e administração do Shop.

Passo a passo

1. 01

   Abra Aparência e IA → Abrir editor visual, ou Personalizar em uma versão.

2. 02

   Ajuste cores, fontes de títulos e textos, botões, espaçamento e logo.

3. 03

   Revise posição da marca, cabeçalho fixo, faixa de aviso, links e rodapé.

4. 04

   Adicione e organize seções: campanha, catálogo, produtos, coleções, imagem e texto, manifesto, serviços ou vídeo.

5. 05

   Personalize títulos, textos, chamadas, imagens desktop e celular, altura, alinhamento e enquadramento.

6. 06

   Escolha produtos e categorias das vitrines e defina colunas por dispositivo e proporção das fotos.

7. 07

   Confira as prévias desktop e celular e selecione Salvar rascunho.

8. 08

   Volte à Biblioteca de temas e selecione Publicar para aplicar essa versão à loja.

Detalhes importantes

• Há até 20 seções; um catálogo precisa permanecer visível. Salvar rascunho e visualizar não publicam nem permitem comprar na prévia.
• O editor usa produtos e imagens da loja. Confira o catálogo real ao montar uma seção.

Antes de começar

Administração do Shop e tema em edição.

Passo a passo

1. 01

   No editor visual, selecione a seção que deseja ilustrar.

2. 02

   Escolha uma imagem existente da biblioteca ou envie PNG, JPEG ou GIF de até 5 MB e 6.000 pixels por lado.

3. 03

   Quando preferir URL externa, use um endereço HTTPS válido e que você tenha autorização para utilizar.

4. 04

   Configure uma imagem específica para celular quando a composição exigir.

5. 05

   Ajuste enquadramento, proporção e modo de ajuste e compare a prévia nos dois dispositivos.

6. 06

   Para vídeo, use uma URL HTTPS direta do arquivo. O player usa controles e não reproduz automaticamente.

7. 07

   Salve o rascunho e publique a versão para colocar a mídia na vitrine.

Detalhes importantes

• Não há upload de vídeo nem incorporação de players externos pelo editor nessa versão.
• Limites de imagem de temas diferem dos uploads de fotos de produto.

Antes de começar

Administração do Shop e IA padrão habilitada no CalebePay.

Passo a passo

1. 01

   Abra Aparência e IA e localize Uma ideia vira uma loja.

2. 02

   Escreva uma direção criativa de dez a 4.000 caracteres: público, estilo, cores, hierarquia e destaques.

3. 03

   Use descrições concretas, como campanhas amplas, cores naturais e foco em uma coleção.

4. 04

   Selecione Criar com IA e aguarde o resultado.

5. 05

   Abra o rascunho criado e confira produtos, categorias, imagens e textos.

6. 06

   Faça ajustes no editor visual e confira as prévias.

7. 07

   Publique a versão aprovada pela Biblioteca de temas.

Detalhes importantes

• Sem conexão de IA padrão habilitada no Pay, o serviço fica indisponível. Essa conexão é diferente da IA de fotos do Shop.
• A geração não executa código arbitrário nem publica automaticamente. O catálogo enviado à IA não inclui custos ou dados de clientes.

Antes de começar

Administração do Shop e ZIP de um tema autorizado de até 10 MB.

Passo a passo

1. 01

   Abra Aparência e IA → Importar tema ZIP.

2. 02

   Selecione um ZIP de tema Shopify com layout/theme.liquid ou Nuvemshop com layouts/layout.tpl.

3. 03

   Aguarde a validação do pacote e a importação dos elementos reconhecidos.

4. 04

   Leia Resultado da importação e as observações de compatibilidade da versão criada.

5. 05

   Abra o tema no editor nativo e revise as cores, textos e imagens aproveitados.

6. 06

   Reconstrua as seções necessárias com os componentes nativos e confira a prévia.

7. 07

   Publique somente depois da revisão da composição e do catálogo.

Detalhes importantes

• Liquid/Twig, scripts, apps, CSS externo e layouts originais não são reproduzidos integralmente. A importação não promete uma cópia exata do tema.
• O pacote aceita até 30 MB descompactados e 1.000 arquivos; caminhos inseguros, duplicados e múltiplos temas são recusados.
• A seleção de imagens importadas tem limites próprios: até 12 imagens de 2 MB e 6.000 pixels por lado.

Antes de começar

Administração do Shop e acesso ao DNS de um domínio que você controla.

Passo a passo

1. 01

   Abra Domínios → Conectar domínio.

2. 02

   Informe o nome, como www.suamarca.com.br, sem https e sem barras.

3. 03

   Selecione Adicionar domínio e copie os registros apresentados.

4. 04

   No provedor de DNS, configure o TXT de verificação exatamente como mostrado e o CNAME para o destino informado pela loja.

5. 05

   Para domínio raiz, use ALIAS/ANAME ou os endereços do destino conforme o provedor de DNS permitir.

6. 06

   Aguarde a propagação e selecione Verificar DNS no painel.

7. 07

   Com domínio verificado e loja publicada, acesse o endereço. O HTTPS é provisionado no primeiro acesso autorizado.

8. 08

   Para remover o vínculo, selecione Desconectar e confira também os apontamentos de DNS no seu provedor.

Se algo não funcionar

Antes de começar

Loja publicada, itens disponíveis e dados válidos do comprador.

Passo a passo

1. 01

   Abra a loja pelo endereço oficial e encontre o produto por busca ou categoria.

2. 02

   Abra o produto, confira descrição, fotos, preço e escolha a variação correta.

3. 03

   Adicione à sacola e ajuste as quantidades conforme a disponibilidade.

4. 04

   Informe os dados de contato e entrega. Complete oito dígitos do CEP para consultar endereço e frete; revise número e complemento.

5. 05

   Confira a opção de entrega, o prazo, o cupom quando houver e o total.

6. 06

   Conclua o pedido e abra a página de pagamento CalebePay.

7. 07

   Escolha um método disponível e siga as instruções de Pix, boleto ou cartão.

8. 08

   Guarde a identificação do pedido e consulte Minha conta ou fale com a loja para acompanhar.

Detalhes importantes

• Itens, preços e estoque são conferidos novamente no servidor. A sacola não garante reserva até criar o pedido.
• Em uma loja de demonstração com modo de teste, o checkout é identificado e não movimenta dinheiro.

Antes de começar

Acesso ao e-mail usado nas compras e envio de e-mail habilitado pela loja.