Ambiente de desenvolvimento — dados de demonstração

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#

  1. Na página Sandbox do site, clique em "Criar conta e abrir sandbox".
  2. No ecrã Registar a sua empresa, confirme que aparece o aviso Abrir directamente em Sandbox.
  3. Preencha Nome da empresa, O seu nome completo, E-mail ou telefone e Palavra-passe, e clique em Criar conta.
  4. 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#

  1. Abra Clientes. Encontra seis titulares de exemplo, cada um com imóvel, conta, contador instalado e ligação activa.
  2. Abra Leituras e depois Todas as leituras para ver um mês de leituras nas rotas de exemplo.
  3. 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.
  4. Abra Tarifas para ver os preços que calcularam essas facturas.

Passo 3: Alternar entre a sandbox e a conta real#

  1. Abra o menu A sua conta, no topo da barra lateral.
  2. Para voltar à conta real, escolha Sair da sandbox.
  3. 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#

  1. 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.
  2. Para concluir pagamentos pendentes, corra gotactl sandbox advance. A opção --outcome aceita confirmed, failed ou expired, e --payment limita a acção a um pagamento.
  3. 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.

Artigos relacionados#

Comece hoje. Configure a sua empresa em minutos.