Developer Docs
Boas práticas
Recomendações de idempotência, reconciliação, logging e rollout para integrar a API pública da Infiny com menos retrabalho e menos risco operacional.
Nesta página
Modelagem
A criação de pedido já se comporta como um ponto de idempotência operacional. Seu integrador precisa respeitar isso desde o início.
- Garanta unicidade de orderId por seller ou company_document.
- Considere a resposta de pedido já cadastrado como colisão de idempotência, não como falha transitória.
- Armazene tracking_code, orderId e company_document juntos para conciliação posterior.
Operação
A melhor leitura do ciclo operacional é simples: webhook para atualização assíncrona, tracking para conferência e suporte.
- Não faça polling agressivo de tracking se o webhook já estiver configurado.
- Use o tracking para reconciliar pedidos sem atualização recente.
- Guarde o payload bruto do webhook para auditoria e atendimento.
- Monitore crescimento de pedidos sem callback para detectar incidentes cedo.
Rollout
Como a integração conversa com a operação real, o rollout precisa ser controlado e observável desde o primeiro pedido.
- Comece com sellers e pedidos controlados.
- Valide cobertura, criação, tracking e webhook antes de ampliar volume.
- Acompanhe 400, 401, 404 e 422 de perto no início da operação.
- Só depois da estabilidade inicial amplie sellers, canais e regiões.
Integração boa é integração previsível
Suporte
Precisa validar um fluxo específico?
Se você estiver homologando uma integração ou precisar conferir um comportamento da API pública atual, fale com a equipe da Infiny antes de subir volume real.