Esta release reúne melhorias e novos recursos disponibilizados na API da Uappi, com foco em performance, padronização de comportamentos e ampliação de possibilidades de integração.
Disponibilizada rota que centraliza todas as informações de pagamento de um pedido, incluindo dados de request e response retornados pelo gateway.
Importante: a rota é exclusivamente de consulta e não altera o status da transação. O retorno depende das informações armazenadas a partir do gateway.
A rota de listagem de pedidos agora permite filtragem por ID ou e-mail do cliente.
Importante: se o filtro não for enviado, o comportamento da listagem permanece inalterado.
Incluído campo com o motivo da indisponibilidade quando nenhuma opção de frete é retornada.
Importante: o detalhamento depende da configuração da loja e da rota utilizada.
Nova rota para logout que encerra a autenticação sem limpar os demais dados da sessão, como o carrinho.
Importante: a preservação dos dados depende da implementação do front-end.
Incluído campo booleano brinde na consulta de pedidos para identificar itens promocionais.
Importante: a identificação depende da configuração correta da promoção.
Disponibilizada nova versão da rota de pedidos com carregamento antecipado de dados (eager loading), reduzindo a quantidade de consultas ao banco e melhorando o tempo de resposta em grandes bases.
Importante: recomenda-se validar o retorno antes de substituir integralmente a versão anterior na integração.
Correção de conflito entre ordenação padrão da plataforma e ordenação por score. Agora:
Importante: regras de aumento de score só produzem efeito quando a ordenação por score estiver ativa.
A ordenação por preço passa a considerar o valor final exibido ao cliente, incluindo regras dinâmicas como preço agendado e regras por canal.
Importante: por envolver recálculo em tempo de execução, pode haver impacto de performance em categorias com grande volume de produtos.
Alinhado comportamento entre painel e API: quando o desconto à vista não é informado, o valor passa a ser salvo como zero.
Importante: para aplicar desconto, o valor deve ser enviado explicitamente na requisição.
Implementada possibilidade de segmentar cupons por lista explícita de e-mails, além da segmentação por limite de compras.
É possível utilizar:
Importante: para ativar a segmentação, o campo “todos os clientes” deve estar como falso. A configuração da lista de e-mails é realizada via API.
Criadas rotas para cadastro e consulta de avaliações de produto e loja, incluindo:
Para avaliações de loja, é obrigatório informar identificador de pedido.
Importante: a validação por pedido evita múltiplas avaliações indevidas.
Disponibilizada rota GET para consultar o status atual de um produto no marketplace, incluindo histórico de alterações.
A consulta pode ser feita a qualquer momento, independentemente de fila de processamento.
Importante: o retorno depende da integração ativa com o marketplace.
O campo país passa a estar disponível também no endereço de faturamento, além do endereço de entrega.
Importante: a obrigatoriedade do campo depende da configuração da loja e do fluxo de checkout.
Criada rota para listar todos os brindes habilitados na loja, retornando dados como identificador, nome, canais de venda e regras de segmentação.
Importante: a listagem é informativa e não substitui a rota de validação de elegibilidade de brinde no contexto do carrinho.
Acesse mais conteúdos sobre a plataforma em nossa Central de Ajuda!
EN 
PT_BR 
