Introdução

O Sandbox é um ambiente de testes onde você pode criar pedidos e notas fictícios e testar suas integrações. Dessa forma você consegue ter mais segurança na hora de virar a chave para produção.

👍

Você pode criar uma conta de Sandbox aqui:

https://sandbox.asaas.com/

É só seguir com o fluxo normal como se fosse criar uma conta no Asaas, em seguida realizar a ativação do Base e após finalizar gerar uma API Key única para sua conta de Sandbox.

O sistema é uma cópia idêntica do Base ERP. Se for testar a emissão de NF-e, certifique-se de configurar seu ambiente de comunicação com a Sefaz para homologação.

No canto superior direito, acesse o menu do usuário, Configurações, e clique em Unidade de Negócio:

Clique sobre a sua empresa. Na aba Nota Fiscal Eletrônica, selecione o Ambiente Homologação (Produção é somente para emissões reais com a Sefaz).

🚧

Atenção

O envio e recebimento de notificações de email e SMS funcionam normalmente em Sandbox. Portanto, você não deve criar clientes com emails e celulares reais ou números aleatórios como (51) 9999-9999. Para testar o recebimento de notificações você pode utilizar os seus próprios emails e celulares.

Ambiente de desenvolvimento e testes

❗️

Importante

O Sandbox é um ambiente separado do ambiente de produção, as alterações feitas na sua conta de Sandbox não são replicadas na de produção. O ambiente de Sandbox foi criado para testar o desenvolvimento e verificar se tudo está funcionando corretamente para depois utilizar a chave de API de produção na sua integração.

É altamente recomendável que você use o Sandbox para todos os seus testes. Para tal, você deve primeiramente criar uma conta no ambiente Sandbox. Após a criação da conta, poderá realizar a criação de sua chave de API em Sandbox e substituir a URL da API em suas chamadas, conforme as descritas abaixo:

Teste suas chamadas

Você consegue fazer chamadas de API e testar sua integração direto na nossa documentação. Siga estes passos:

• Acesse: https://docs.baseerp.com.br/reference
• Vá até o menu Referência
• Selecione o endpoint que você deseja testar (na imagem, selecionamos Listar pedidos)
• Informe a chave de API gerada em Sandbox em "Credentials"
• Clique em "Try It!"
• Logo abaixo, no painel "Response" você visualizará o retorno da sua chamada.

❗️

ATENÇÃO: Para testar os endpoints direto nesta documentação você precisa de uma chave de API de Sandbox

Caso seja utilizada a chave de produção, obterá o erro 401 Unauthorized.

Todos os endpoints da documentação apontam para nosso Sandbox, o ambiente de testes do Asaas. Antes de começar você deve criar uma conta de testes e usar sua chave de API para testes.