{"id":5598,"date":"2026-03-17T10:22:30","date_gmt":"2026-03-17T13:22:30","guid":{"rendered":"https:\/\/helpcenter.uappi.com.br\/?post_type=release&#038;p=5598"},"modified":"2026-03-17T10:28:23","modified_gmt":"2026-03-17T13:28:23","slug":"api-20-02-2026","status":"publish","type":"release","link":"https:\/\/helpcenter.uappi.com.br\/en\/release\/api-20-02-2026\/","title":{"rendered":"Release API &#8211; 20\/02\/2026"},"content":{"rendered":"<p>Esta release re\u00fane melhorias e novos recursos disponibilizados na API da Uappi, com foco em performance, padroniza\u00e7\u00e3o de comportamentos e amplia\u00e7\u00e3o de possibilidades de integra\u00e7\u00e3o.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Pagamentos<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Nova rota de consulta de transa\u00e7\u00e3o<\/strong><\/h3>\n\n\n\n<p>Disponibilizada rota que centraliza todas as informa\u00e7\u00f5es de pagamento de um pedido, incluindo dados de request e response retornados pelo gateway.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> a rota \u00e9 exclusivamente de consulta e n\u00e3o altera o status da transa\u00e7\u00e3o. O retorno depende das informa\u00e7\u00f5es armazenadas a partir do gateway.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Pedidos<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Filtro por dados do cliente<\/strong><\/h3>\n\n\n\n<p>A rota de listagem de pedidos agora permite filtragem por ID ou e-mail do cliente.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> se o filtro n\u00e3o for enviado, o comportamento da listagem permanece inalterado.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Motivo de indisponibilidade no c\u00e1lculo de frete<\/strong><\/h3>\n\n\n\n<p>Inclu\u00eddo campo com o motivo da indisponibilidade quando nenhuma op\u00e7\u00e3o de frete \u00e9 retornada.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> o detalhamento depende da configura\u00e7\u00e3o da loja e da rota utilizada.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Rota de logout dedicada<\/strong><\/h3>\n\n\n\n<p>Nova rota para logout que encerra a autentica\u00e7\u00e3o sem limpar os demais dados da sess\u00e3o, como o carrinho.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> a preserva\u00e7\u00e3o dos dados depende da implementa\u00e7\u00e3o do front-end.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Indica\u00e7\u00e3o de brinde no pedido<\/strong><\/h3>\n\n\n\n<p>Inclu\u00eddo campo booleano brinde na consulta de pedidos para identificar itens promocionais.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> a identifica\u00e7\u00e3o depende da configura\u00e7\u00e3o correta da promo\u00e7\u00e3o.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Consulta de pedidos V2 (melhoria de performance)<\/strong><\/h3>\n\n\n\n<p>Disponibilizada nova vers\u00e3o 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.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> recomenda-se validar o retorno antes de substituir integralmente a vers\u00e3o anterior na integra\u00e7\u00e3o.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Produtos e Busca<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Ajuste na prioridade de ordena\u00e7\u00e3o<\/strong><\/h3>\n\n\n\n<p>Corre\u00e7\u00e3o de conflito entre ordena\u00e7\u00e3o padr\u00e3o da plataforma e ordena\u00e7\u00e3o por score. Agora:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ordena\u00e7\u00f5es autom\u00e1ticas s\u00e3o mutuamente exclusivas.<br><\/li>\n\n\n\n<li>A ordena\u00e7\u00e3o enviada explicitamente na requisi\u00e7\u00e3o tem prioridade m\u00e1xima.<br><\/li>\n<\/ul>\n\n\n\n<p><strong>Importante:<\/strong> regras de aumento de score s\u00f3 produzem efeito quando a ordena\u00e7\u00e3o por score estiver ativa.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Ordena\u00e7\u00e3o por pre\u00e7o com regras din\u00e2micas<\/strong><\/h3>\n\n\n\n<p>A ordena\u00e7\u00e3o por pre\u00e7o passa a considerar o valor final exibido ao cliente, incluindo regras din\u00e2micas como pre\u00e7o agendado e regras por canal.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> por envolver rec\u00e1lculo em tempo de execu\u00e7\u00e3o, pode haver impacto de performance em categorias com grande volume de produtos.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Padroniza\u00e7\u00e3o do desconto \u00e0 vista<\/strong><\/h3>\n\n\n\n<p>Alinhado comportamento entre painel e API: quando o desconto \u00e0 vista n\u00e3o \u00e9 informado, o valor passa a ser salvo como zero.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> para aplicar desconto, o valor deve ser enviado explicitamente na requisi\u00e7\u00e3o.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Cupons<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Segmenta\u00e7\u00e3o por lista de e-mails<\/strong><\/h3>\n\n\n\n<p>Implementada possibilidade de segmentar cupons por lista expl\u00edcita de e-mails, al\u00e9m da segmenta\u00e7\u00e3o por limite de compras.<\/p>\n\n\n\n<p>\u00c9 poss\u00edvel utilizar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>apenas limite de compras;<\/li>\n\n\n\n<li>apenas lista de e-mails;<\/li>\n\n\n\n<li>combina\u00e7\u00e3o das duas regras;<\/li>\n<\/ul>\n\n\n\n<p><strong>Importante:<\/strong> para ativar a segmenta\u00e7\u00e3o, o campo \u201ctodos os clientes\u201d deve estar como falso. A configura\u00e7\u00e3o da lista de e-mails \u00e9 realizada via API.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Avalia\u00e7\u00f5es<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Rotas para importa\u00e7\u00e3o de avalia\u00e7\u00f5es<\/strong><\/h3>\n\n\n\n<p>Criadas rotas para cadastro e consulta de avalia\u00e7\u00f5es de produto e loja, incluindo:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>cadastro individual ou em lote;<\/li>\n\n\n\n<li>datas retroativas;<\/li>\n\n\n\n<li>filtros por SKU ou ID;<\/li>\n<\/ul>\n\n\n\n<p>Para avalia\u00e7\u00f5es de loja, \u00e9 obrigat\u00f3rio informar identificador de pedido.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> a valida\u00e7\u00e3o por pedido evita m\u00faltiplas avalia\u00e7\u00f5es indevidas.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Marketplace<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Consulta de status de produto<\/strong><\/h3>\n\n\n\n<p>Disponibilizada rota GET para consultar o status atual de um produto no marketplace, incluindo hist\u00f3rico de altera\u00e7\u00f5es.<\/p>\n\n\n\n<p>A consulta pode ser feita a qualquer momento, independentemente de fila de processamento.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> o retorno depende da integra\u00e7\u00e3o ativa com o marketplace.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Internacionaliza\u00e7\u00e3o<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Campo \u201cpa\u00eds\u201d no endere\u00e7o de faturamento<\/strong><\/h3>\n\n\n\n<p>O campo pa\u00eds passa a estar dispon\u00edvel tamb\u00e9m no endere\u00e7o de faturamento, al\u00e9m do endere\u00e7o de entrega.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> a obrigatoriedade do campo depende da configura\u00e7\u00e3o da loja e do fluxo de checkout.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Promo\u00e7\u00f5es<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Listagem de brindes habilitados<\/strong><\/h3>\n\n\n\n<p>Criada rota para listar todos os brindes habilitados na loja, retornando dados como identificador, nome, canais de venda e regras de segmenta\u00e7\u00e3o.<\/p>\n\n\n\n<p><strong>Importante:<\/strong> a listagem \u00e9 informativa e n\u00e3o substitui a rota de valida\u00e7\u00e3o de elegibilidade de brinde no contexto do carrinho.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>D\u00favidas?<\/strong><\/h2>\n\n\n\n<p>Acesse mais conte\u00fados sobre a plataforma em nossa <a href=\"https:\/\/helpcenter.uappi.com.br\/en\/\">Central de Ajuda<\/a>!<\/p>","protected":false},"featured_media":0,"template":"","meta":{"_acf_changed":false},"categoria_release":[30,31,33],"plataforma":[361,5],"class_list":["post-5598","release","type-release","status-publish","hentry","categoria_release-atualizado","categoria_release-consertado","categoria_release-melhorado","plataforma-todos","plataforma-uappi-v2"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.2 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Release API - 20\/02\/2026 &#8211; Uappi Helpcenter<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/helpcenter.uappi.com.br\/en\/release\/api-20-02-2026\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Release API - 20\/02\/2026 &#8211; Uappi Helpcenter\" \/>\n<meta property=\"og:description\" content=\"Esta release re\u00fane melhorias e novos recursos disponibilizados na API da Uappi, com foco em performance, padroniza\u00e7\u00e3o de comportamentos e amplia\u00e7\u00e3o de possibilidades de integra\u00e7\u00e3o. Pagamentos Nova rota de consulta de transa\u00e7\u00e3o Disponibilizada rota que centraliza todas as informa\u00e7\u00f5es de pagamento de um pedido, incluindo dados de request e response retornados pelo gateway. Importante: a [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/helpcenter.uappi.com.br\/en\/release\/api-20-02-2026\/\" \/>\n<meta property=\"og:site_name\" content=\"Uappi Helpcenter\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-17T13:28:23+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/\",\"url\":\"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/\",\"name\":\"Release API - 20\/02\/2026 &#8211; Uappi Helpcenter\",\"isPartOf\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#website\"},\"datePublished\":\"2026-03-17T13:22:30+00:00\",\"dateModified\":\"2026-03-17T13:28:23+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/helpcenter.uappi.com.br\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Releases\",\"item\":\"https:\/\/helpcenter.uappi.com.br\/releases\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Release API &#8211; 20\/02\/2026\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#website\",\"url\":\"https:\/\/helpcenter.uappi.com.br\/\",\"name\":\"Uappi Helpcenter\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/helpcenter.uappi.com.br\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#organization\",\"name\":\"Uappi Helpcenter\",\"url\":\"https:\/\/helpcenter.uappi.com.br\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2025\/04\/logo-helpcenter.svg\",\"contentUrl\":\"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2025\/04\/logo-helpcenter.svg\",\"caption\":\"Uappi Helpcenter\"},\"image\":{\"@id\":\"https:\/\/helpcenter.uappi.com.br\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Release API - 20\/02\/2026 &#8211; Uappi Helpcenter","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/helpcenter.uappi.com.br\/en\/release\/api-20-02-2026\/","og_locale":"en_US","og_type":"article","og_title":"Release API - 20\/02\/2026 &#8211; Uappi Helpcenter","og_description":"Esta release re\u00fane melhorias e novos recursos disponibilizados na API da Uappi, com foco em performance, padroniza\u00e7\u00e3o de comportamentos e amplia\u00e7\u00e3o de possibilidades de integra\u00e7\u00e3o. Pagamentos Nova rota de consulta de transa\u00e7\u00e3o Disponibilizada rota que centraliza todas as informa\u00e7\u00f5es de pagamento de um pedido, incluindo dados de request e response retornados pelo gateway. Importante: a [&hellip;]","og_url":"https:\/\/helpcenter.uappi.com.br\/en\/release\/api-20-02-2026\/","og_site_name":"Uappi Helpcenter","article_modified_time":"2026-03-17T13:28:23+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/","url":"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/","name":"Release API - 20\/02\/2026 &#8211; Uappi Helpcenter","isPartOf":{"@id":"https:\/\/helpcenter.uappi.com.br\/#website"},"datePublished":"2026-03-17T13:22:30+00:00","dateModified":"2026-03-17T13:28:23+00:00","breadcrumb":{"@id":"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/helpcenter.uappi.com.br\/release\/api-20-02-2026\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/helpcenter.uappi.com.br\/"},{"@type":"ListItem","position":2,"name":"Releases","item":"https:\/\/helpcenter.uappi.com.br\/releases\/"},{"@type":"ListItem","position":3,"name":"Release API &#8211; 20\/02\/2026"}]},{"@type":"WebSite","@id":"https:\/\/helpcenter.uappi.com.br\/#website","url":"https:\/\/helpcenter.uappi.com.br\/","name":"Uappi Helpcenter","description":"","publisher":{"@id":"https:\/\/helpcenter.uappi.com.br\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/helpcenter.uappi.com.br\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/helpcenter.uappi.com.br\/#organization","name":"Uappi Helpcenter","url":"https:\/\/helpcenter.uappi.com.br\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/helpcenter.uappi.com.br\/#\/schema\/logo\/image\/","url":"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2025\/04\/logo-helpcenter.svg","contentUrl":"https:\/\/helpcenter.uappi.com.br\/wp-content\/uploads\/2025\/04\/logo-helpcenter.svg","caption":"Uappi Helpcenter"},"image":{"@id":"https:\/\/helpcenter.uappi.com.br\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/release\/5598","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/release"}],"about":[{"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/types\/release"}],"wp:attachment":[{"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/media?parent=5598"}],"wp:term":[{"taxonomy":"categoria_release","embeddable":true,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/categoria_release?post=5598"},{"taxonomy":"plataforma","embeddable":true,"href":"https:\/\/helpcenter.uappi.com.br\/en\/wp-json\/wp\/v2\/plataforma?post=5598"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}