Critérios de homologação

Pré-requisitos

Requisitos funcionais obrigatórios

1. Criar promoções

• Requisição retorna HTTP 202 (Accepted)
• Resposta inclui campos aggregationId e message
• aggregationId é único e válido para rastreamento

{
  "aggregationId": "abc123-xyz789",
  "message": "We have successfully received your request to create promotions"
}

2. Consultar status de promoções

• Retorna HTTP 200 com lista de promoções
• Suporta paginação com offset e limit
• Suporta filtros por ean, status, promotionType
• Status são válidos

3. Gerenciar ciclo de vida de promoções

• Entender os diferentes estados de promoção: PROCESSING, SCHEDULED, ACTIVE, DUPLICATE, FINISHING, FINISHED, ERROR
• Tratar assincronismo adequadamente (não assumir sucesso no 202)
• Lidar com erros e implementar retry quando apropriado
• Respeitar prazos de transição de status

4. Validar descontos em pedidos

• Consultar pedidos reais para validar desconto
• Interpretar a estrutura de benefícios em GET /orders/{id}/virtual-bag
• Identificar descontos usando sponsorships[].liability

Requisitos não-funcionais obrigatórios

Autenticação e tokens

• Renovação de token: Implementar renovação de token OAuth2 somente quando:
  • Estiver prestes a expirar (ex: 5 minutos antes)
  • Imediatamente após uma resposta 401
  • Não renovar em toda requisição (impacta performance e pode disparar rate limits)

Respeitar Rate Limit

• Respeitar todos os status HTTP 429
• Implementar backoff exponencial para retries
• Não fazer requisições paralelas em massa

Validação local

• Avalie a integração completa, não apenas chamadas isoladas
• Valide dados localmente antes de enviar
• Implemente logging para troubleshooting

Requisitos de conta

Checklist de preparação

• ✅ ID da loja de teste (UUID válido)
• ✅ Nome/razão social da loja de teste
• ✅ Acesso a internet estável durante toda a sessão (recomendado: 10 Mbps ou superior)
• ✅ Computador com webcam e microfone funcionais (necessário para validação remota)

• ✅ Aplicação completamente integrada com o módulo Promotion
• ✅ Endpoints POST, GET implementados e testados localmente
• ✅ Tratamento de erros implementado para todos os códigos de erro documentados
• ✅ Renovação de token implementada corretamente
• ✅ Rate limiting tratado (backoff exponencial)

• ✅ Testes internos de criação de promoções realizados
• ✅ Testes de consulta de status realizados
• ✅ Testes de validação de aplicação de desconto em pedidos reais
• ✅ Testes de ciclo de vida completo (criação → ACTIVE → aplicação em pedido)
• ✅ Testes de tratamento de erros (erros 400, 401, 429, etc.)
• ✅ Logs e documentação interna completos

• ✅ Documentação interna sobre como criar promoções
• ✅ Documentação sobre como consultar status
• ✅ Plano de suporte para pós-produção

Como solicitar homologação

Passo 1: Preparar a solicitação

• ID da loja de teste
• Nome da loja de teste
• Descrição breve da sua integração (ex: sistema de gestão de promoções)
• Informações de contato (email e telefone do responsável)

Passo 2: Abrir ticket de homologação

1. Acesse Suporte - Área de Chamados
2. Selecione a categoria "Homologação" ou "Homologação do Promotion"
3. Preencha o formulário com:
   • Título: "Solicitação de Homologação - Módulo Promotion"
   • Descrição: Breve resumo da integração
   • Dados da loja de teste
   • Informações de contato

Passo 3: Aguardar confirmação

• Confirmar recebimento da solicitação
• Agendar a data e hora da homologação
• Compartilhar credenciais de teste, se necessário
• Esclarecer dúvidas técnicas

Processo de homologação

Detalhes da sessão

O que será testado

Funcionalidades principais

1. Criação de promoção (tipo PERCENTAGE)
   • Enviar requisição POST com dados válidos
   • Validar resposta 202 com aggregationId
2. Consulta de status
   • Usar aggregationId retornado para consultar status
   • Validar transição de PROCESSING → ACTIVE
3. Validação de aplicação
   • Verificar se desconto aparece em pedido real
   • Consultar benefício em GET /orders/{id}/virtual-bag
4. Tratamento de erros
   • Testar comportamento com dados inválidos (formato de data, EAN incorreto)
   • Validar se a aplicação lida com erros 400, 401, 429 corretamente
5. Outros tipos de promoção
   • Testar LXPY e PERCENTAGE_PER_X_UNITS
   • Validar campos específicos de cada tipo

Aspectos técnicos

• Renovação de token funciona corretamente
• Rate limiting é respeitado (implementa backoff)
• Aplicação não faz requisições desnecessárias
• Logs estão disponíveis para troubleshooting

Aspectos de negócio

• Equipe compreende o ciclo de vida de promoções
• Equipe sabe como cancelar/remover promoções
• Plano de suporte está documentado

Resultados possíveis

✅ Aprovado

• Resultado: Você receberá email de confirmação no mesmo dia
• Acesso: Seu aplicativo será liberado para usar em ambiente de produção
• Status: Você poderá gerenciar promoções em tempo real
• Próximo passo: Contatar suporte se tiver dúvidas operacionais

❌ Reprovado

• Documentação: O analista documentará exatamente quais requisitos não foram atendidos
• Detalhes: Você receberá sugestões técnicas para correção
• Próxima tentativa: Você poderá agendar nova homologação após 15 dias da tentativa anterior
• Importante: Valide as correções internamente antes de agendar a próxima sessão

Intervalo mínimo entre tentativas

1. Implementar todas as correções sugeridas
2. Testar internamente a integração completa
3. Validar que os requisitos não atendidos foram corrigidos
4. Atualizar documentação e plano de suporte

Próximos passos

• Endpoints — Consulte sempre que tiver dúvidas
• Erros e troubleshooting — Para troubleshooting
• Contatar suporte — Para problemas em produção

• Introdução — Visão geral e quick start
• Como funciona — Reset, processamento assíncrono
• Endpoints — Referência técnica completa