Ambiente de testes da Envia.com

O ambiente de testes da Envia.com é um espaço seguro onde você pode experimentar todas as funções da plataforma sem afetar suas operações reais. É ideal para se familiarizar com o sistema antes de começar a enviar pacotes com dinheiro real.

Para que serve?

Teste a cotação, a geração e o cancelamento de etiquetas sem custos adicionais.
Conecte e verifique suas lojas ecommerce antes de ativá-las em produção.
Permita que sua equipe pratique e conheça a plataforma.
Certifique-se de que tudo funcione corretamente antes de lançar suas operações.

Diferenças entre o ambiente de testes e a produção

Ambiente de testes	Ambiente de produção
Dados fictícios	Dados reais
Sem custos reais	Cobranças no seu saldo
Para experimentação	Para operações reais

Acessar o ambiente de testes

Entre na sua conta da Envia.com
No menu lateral, clique em Desenvolvedores > Ambiente de testes.
Será aberta uma nova aba em accounts-sandbox.envia.com com a tela de início de sessão do ambiente de testes.
Crie sua conta de testes com um novo usuário e senha, ou entre se já tiver uma.
Depois de entrar, você estará em shipping-test.envia.com, o dashboard do ambiente de testes.

As credenciais da sua conta de produção não funcionam no ambiente de testes. Mesmo acessando a partir da sua conta real, você deve se cadastrar separadamente.

Obter o token da API para testes

Se você for testar a integração com a API da Envia, precisa gerar um token específico dentro do ambiente de testes.

Entre em **shipping-test.envia.com** (sua conta de testes).
Vá para Desenvolvedores > Acesso de API.
Clique em Adicionar para gerar um novo token.
Copie o token e use-o nas suas chamadas aos endpoints do sandbox.

Use este token somente com as URLs do sandbox. Se você usá-lo com as URLs de produção, receberá um erro de autenticação, e vice-versa.

Limitações do ambiente de testes

O sandbox replica a experiência de produção, mas com algumas diferenças importantes:

As etiquetas geradas não são reais e não têm rastreamento com as transportadoras.
Os pagamentos e as recargas de saldo não são processados; o saldo no sandbox é fictício.
Algumas integrações com transportadoras podem se comportar de forma diferente ou não estar disponíveis em testes.
Os dados do sandbox (endereços, pacotes, histórico) são independentes e não são sincronizados com a sua conta de produção.

Passar para produção

Quando você tiver validado seus fluxos no sandbox, o próximo passo é operar em produção.

Entre na sua conta de produção em shipping.envia.com.
Se você precisar de um token da API, gere-o em Desenvolvedores > Acesso de API a partir da sua conta de produção.
Se você tiver uma integração com a API, substitua as URLs.
Substitua o token do sandbox pelo token de produção.

Certifique-se de que sua conta de produção esteja verificada antes de gerar etiquetas reais. Consulte o artigo Verificar conta se tiver passos pendentes.

Perguntas frequentes

Posso usar minha conta de produção para fazer testes? Não é recomendável. As etiquetas geradas em produção são reais e geram cobranças. Use sempre o sandbox para testes e desenvolvimento.

O saldo que tenho em produção está disponível no sandbox? Não. O saldo, os endereços, os pacotes e o histórico são completamente independentes entre os dois ambientes.

Preciso verificar minha conta no sandbox? Não. No ambiente de testes você pode operar sem passar pelo processo de verificação de identidade que se aplica em produção.

As transportadoras disponíveis no sandbox são as mesmas da produção? Na maior parte, sim, embora algumas transportadoras possam ter disponibilidade limitada ou comportamento diferente no ambiente de testes.

Posso ter acesso ao sandbox e à produção ao mesmo tempo? Sim. São contas independentes e você pode ter sessão ativa nas duas em navegadores ou abas diferentes.

É obrigatório usar o ambiente de testes? Não, mas recomendamos para reduzir erros antes de operar em produção, especialmente se você for conectar uma loja ecommerce ou integrar a API.