Experimentar uma conta de teste com dados de exemplo
Abra a conta de teste da empresa, percorra clientes, leituras e facturas de exemplo e teste pagamentos simulados sem mexer nos registos reais.
Actualizado em
A sandbox é uma conta de testes ligada à da sua empresa e já preenchida com dados de exemplo, para experimentar clientes, leituras, facturação e pagamentos antes de usar dados reais. Quem regista a empresa fica como Proprietário da sandbox.
Antes de começar#
- O plano da empresa tem de incluir Ambientes de teste. Sem essa capacidade, a conta é criada sem sandbox.
- Os colegas convidados depois não entram sozinhos na sandbox: de início, só quem criou a conta tem acesso.
Passo 1: Criar a conta e entrar na sandbox#
- Na página Sandbox do site, clique em "Criar conta e abrir sandbox".
- No ecrã Registar a sua empresa, confirme que aparece o aviso Abrir directamente em Sandbox.
- Preencha Nome da empresa, O seu nome completo, E-mail ou telefone e Palavra-passe, e clique em Criar conta.
- O painel abre dentro da sandbox. Uma faixa no topo lembra que está numa sandbox e que os dados são de teste.
Passo 2: Percorrer os dados de exemplo#
- Abra Clientes. Encontra seis titulares de exemplo, cada um com imóvel, conta, contador instalado e ligação activa.
- Abra Leituras e depois Todas as leituras para ver um mês de leituras nas rotas de exemplo.
- Abra Facturação e depois Facturas. A facturação de exemplo já correu: parte das facturas aparece paga e as restantes ficam em aberto, prontas para testar cobranças.
- Abra Tarifas para ver os preços que calcularam essas facturas.
Passo 3: Alternar entre a sandbox e a conta real#
- Abra o menu A sua conta, no topo da barra lateral.
- Para voltar à conta real, escolha Sair da sandbox.
- Para regressar, escolha Mudar para sandbox e seleccione a sandbox, com o nome da empresa seguido de "Sandbox".
Passo 4: Simular pagamentos e novas leituras#
- Na sandbox, os pagamentos online passam por um conector simulado, que decide o resultado pelos cêntimos do valor: terminado em 02 falha, 05 expira, 09 fica pendente, e 00 ou qualquer outro final confirma. Para gerar um pagamento a partir da linha de comandos, corra
gotactl events trigger invoice.paid, que emite uma factura de exemplo e a paga pelo conector simulado. - Para concluir pagamentos pendentes, corra
gotactl sandbox advance. A opção--outcomeaceitaconfirmed,failedouexpired, e--paymentlimita a acção a um pagamento. - Para gerar também um novo ciclo de leituras, acrescente
--readings:gotactl sandbox advance --readings. Cada contador recebe uma leitura nova, 12,5 m³ acima da anterior.
O que acontece a seguir#
Um pagamento confirmado marca a factura como paga e dispara os webhooks de confirmação, como na conta real. Em Programadores e Chaves de API só pode criar chaves de teste, que nunca funcionam na conta real. Os registos da sandbox são de exemplo e ficam isolados dos dados reais, por isso o que fizer aqui não altera clientes, facturas nem pagamentos da conta real.
Problemas comuns#
- Aparece Já existe uma conta com este e-mail ou telefone. Entre com essa conta. O contacto já tem uma conta. Clique em Entrar e use Mudar para sandbox no menu A sua conta.
- O menu não mostra Mudar para sandbox: o plano não inclui Ambientes de teste, ou não é membro da sandbox. Peça ao Proprietário que reveja o plano ou o acesso.
- Aparece No espaço de testes só se criam chaves de teste. As chaves reais criam-se fora da sandbox: escolha Sair da sandbox e crie-as na conta real.
- O comando
gotactl sandbox advanceé recusado com 403: só funciona numa sandbox. Confirme que a CLI está a usar o contexto da sandbox e não o da conta real.