> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spedy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambiente de testes

> Como usar o ambiente de testes (sandbox) da Spedy.

A Spedy disponibiliza dois ambientes com a mesma superfície de API: um para
testes (sandbox) e um para operação real (produção).

| Ambiente | Base URL                              | Uso                                    |
| -------- | ------------------------------------- | -------------------------------------- |
| Sandbox  | `https://sandbox-api.spedy.com.br/v1` | Desenvolvimento e testes de integração |
| Produção | `https://api.spedy.com.br/v1`         | Operação real                          |

<Warning>
  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.
</Warning>

## 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](/pages/guides/configuracao-inicial) 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](/pages/guides/configuracao-inicial). Os ambientes disponíveis e o
padrão dentro do sandbox variam por modelo:

| Modelo | Ambientes disponíveis            | Padrão no sandbox |
| ------ | -------------------------------- | ----------------- |
| NFS-e  | Simulação, Homologação, Produção | **Simulação**     |
| NF-e   | Homologação, Produção            | **Homologação**   |
| NFC-e  | Homologação, Produção            | **Homologação**   |

* **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.

<Warning>
  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.
</Warning>

<Note>
  Há a intenção de, no futuro, desabilitar o ambiente de Produção dentro do
  sandbox — mas isso **ainda não está implementado**.
</Note>

## 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](/pages/start/autenticacao).
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](/pages/start/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](/pages/webhooks/visao-geral).

<Tip>
  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](/pages/start/go-live) e trocar para o ambiente real.
</Tip>