Antes de ir para produção
Antes de liberar sua integração para o ambiente de produção, todos os testes devem ser feitos em sandbox.
Esse ambiente é seguro e isolado, ideal para:
- Garantir que sua integração funcione corretamente sem impactar dados reais (pedidos, clientes, produtos etc).
- Simular fluxos de uso, como envio de pedidos ou cadastro de clientes.
- Validar que tudo está pronto antes de “ir pra produção”.
Testar no sandbox é uma forma de prevenir erros e garantir uma transição tranquila para seu cliente.
Etapas para homologação
- Finalize os testes usando os recursos disponíveis no menu de homologação beta.
- Envie as evidências (prints, vídeos ou exemplos das requisições realizadas). Avise a pessoa que
está te acompanhando nesse projeto, se não houver, chame alguém no chat de atendimento da plataforma. - Com tudo validado, agendaremos uma reunião de homologação. Caso contrário, sinalizaremos.
O que acontece na reunião de homologação?
Durante a reunião de homologação, alguns aspectos técnicos são avaliados com mais atenção. Entre eles, dois são
considerados critérios essenciais para aprovação da sua integração:
- Tratamento de throttling: sua aplicação deve identificar corretamente o erro 429 (Too Many Requests), aguardar o
tempo informado no retorno da API e reenviar a requisição após esse intervalo. - Leitura correta da paginação: ao utilizar filtros como
alterado_apos, sua aplicação deve percorrer todas as
páginas da resposta até que todos os registros sejam coletados. Ignorar páginas adicionais pode causar perda de dados,
e esse ponto será verificado em detalhes durante a homologação.
A validação correta desses dois itens demonstra que sua integração está tecnicamente preparada para operar com segurança
e estabilidade no ambiente de produção.
❗Por isso, reserve um tempinho na agenda, prepare o ambiente sandbox e use fones de ouvido com bom áudio. 😉
Critérios importantes para aprovação
Um dos requisitos para aprovação é a implementação correta do controle de throttling. E se você utilizar GETs, eles
deverão fazer uso do alterado_apos com a implementação da paginação.
Se estiver tudo certo com esses dois critérios, é um dos principais sinais de que sua integração está pronta para ir
ao ar!
| Critério | Funciona sem tratar (em sandbox)? | Obrigatório (em produção)? |
|---|---|---|
| Throttling (erro 429) | Sim, pode não ocorrer pela quantidade baixa de requisições | Obrigatório ✅ |
Paginação (alterado_apos) | Sim, pode não ocorrer pela quantidade baixa de registros | Obrigatório ✅ |
Importante: A não implementação desses critérios, a serem validados em reunião, acarretará em reprovação automática e necessidade de reagendamento.