Skip to main content
A Spedy disponibiliza dois ambientes com a mesma superfície de API: um para testes (sandbox) e um para operação real (produção).
O sandbox é uma conta separada da de produção. Você precisa fazer um novo cadastro diretamente no ambiente de sandbox e escolher o Plano Desenvolvedor. As chaves de API e o cadastro de empresas de produção não funcionam no sandbox, e vice-versa.

​
O que muda entre os ambientes

  • Base URL: cada ambiente tem seu próprio host (tabela acima).
  • Conta e chaves de API: o sandbox tem uma conta própria (cadastro à parte, Plano Desenvolvedor), com sua própria empresa titular e suas próprias chaves. Uma chave de sandbox não funciona em produção, e vice-versa.
  • Certificado digital: o sandbox exige um certificado digital A1 válido, assim como produção — é ele que assina os documentos.
  • Efeitos fiscais: dependem do ambiente configurado em cada modelo de nota (veja abaixo). Não é uma regra única para todo o sandbox.

​
Efeitos fiscais por modelo

Cada modelo de nota tem seu próprio ambiente de emissão, definido no campo environmentType das configurações da empresa. Os ambientes disponíveis e o padrão dentro do sandbox variam por modelo:
  • Simulação e Homologação — sem validade fiscal: a Spedy (Simulação) ou a própria SEFAZ/prefeitura (Homologação) processam a nota apenas para teste.
  • Produção — documento real, com validade fiscal, mesmo que emitido a partir do sandbox.
Atente-se ao environmentType de cada modelo. É possível configurar um modelo como Produção dentro do sandbox — e, nesse caso, a nota emitida terá validade fiscal real. Confira o ambiente antes de rodar seus testes.
Há a intenção de, no futuro, desabilitar o ambiente de Produção dentro do sandbox — mas isso ainda não está implementado.

​
Como testar

  1. Faça um novo cadastro no sandbox e escolha o Plano Desenvolvedor. A empresa titular da conta de sandbox é criada nesse momento, e a chave dela fica disponível no backoffice do sandbox. Veja Autenticação.
  2. Envie um certificado digital A1 válido para a empresa que vai emitir.
  3. Confirme o environmentType de cada modelo que você vai testar (por padrão, NFS-e em Simulação e NF-e/NFC-e em Homologação).
  4. Emita notas de teste seguindo o guia de primeiros passos.
  5. Configure um webhook apontando para um endpoint de teste (ex.: um serviço como webhook.site durante o desenvolvimento) para validar o recebimento de eventos. Veja Webhooks: visão geral.
Use o sandbox para validar toda a integração — cadastro, emissão, cancelamento, correção e webhooks — antes de seguir o checklist de produção e trocar para o ambiente real.