​

Nova API de Arquivos do tema

• Listar, ler, criar, atualizar e excluir arquivos.
• Mover, renomear e duplicar arquivos.
• Consultar o histórico de versões de um arquivo.
• Buscar um termo no conteúdo dos arquivos.
• Consultar, inicializar e publicar o tema.

​

Novo guia de boas práticas no Editor de Código

​

Prazo de até 14 dias úteis para a análise de apps

​

Novo guia de segurança para parceiros

​

Correções no carrinho, nos filtros e na tag de desconto

• O total e a economia exibidos no carrinho passam a considerar apenas o desconto de promoção, sem misturar cupom, desconto progressivo e kits.
• A linha de desconto de boleto e Pix no carrinho só aparece quando o desconto está configurado e é maior que zero.
• A tag de desconto passa a calcular o percentual a partir dos preços vindos da API, acompanhando o SKU selecionado na página de produto.
• O filtro de preço volta a ser removido quando o range é devolvido ao intervalo cheio, e remover o chip de preço limpa os parâmetros da URL.
• Os placeholders do preview do editor voltam a carregar quando a requisição falha sem resposta do servidor.
• O botão de adicionar ao carrinho volta a funcionar na página de produto, com o addProductsToCart movido para os methods.
• O dropdown de subcategorias passa a ocupar toda a altura do seu container.
• O CNPJ/CPF da loja no rodapé deixa de ser um link sem ação.
• A thumbnail do vídeo do produto volta a respeitar a altura definida, com a correção do atributo height.
• O espaço extra antes do texto de forma de pagamento nos cards de produto foi removido.

​

Novo desconto progressivo “Compre X, Pague Y” documentado na API

• Agora é possível criar descontos do tipo compre X e pague Y (buy_x_pay_y) nas opções do campo discount_type, tanto na criação quanto na busca de descontos.
• Documentamos os campos specifications.price_mode e specifications.tiers[] , incluindo a regra de que min_value representa a quantidade de itens ou o valor da compra, dependendo do entry_condition_type configurado.
• A documentação de descontos também foi atualizada com os possíveis erros relacionados a esses novos campos.

​

Correções na listagem de produtos, filtros, banners e Compre Junto

• As listagens de produto passam a usar CSS grid no lugar de flex, dispensando os divs de clear, o helper tagOrDiv e o JS de mosaico.
• As colunas do grid passam a ser declaradas em um único arquivo, com cada contexto apenas ajustando a custom property --products-grid-columns.
• A coluna de filtros passa a ser identificada pela classe -no-filters, vinda da própria config, em vez de depender da ordem do DOM.
• Os filtros de base, atributos e preço passam a reagir à atualização da URL, mantendo o estado ativo correto na navegação back/forward e em links diretos.
• O scroll ao topo na paginação passa a usar smoothScroll, corrigindo o comportamento no iOS.
• O Banners.vue passa a normalizar os props dimensions e firstBanner quando o backend envia um array vazio, silenciando o warning do Vue.
• Os banners do componente Text Button 2 Banners passam a usar altura automática, preservando o aspect ratio das imagens enviadas.
• Os componentes do Compre Junto foram refatorados para suportar customizações, com ajustes no layout dos combos.
• O asterisco do texto de parcelas foi removido.
• O alinhamento dos produtos no grid do collection box foi corrigido.
• O botão de compra flutuante volta a aparecer, com a inicialização movida de created para mounted.
• As linhas do resumo do carrinho lateral passam a usar a cor de contraste do tema, garantindo legibilidade sobre o fundo do drawer.
• O componente PreviewWarning, que não era utilizado, foi removido.

​

Passa a utilizar a API de preços para exibir o preço dos produtos

• O preço dos produtos passa a ser buscado na API de preços em runtime, em vez de ser renderizado no Twig a partir do payload do produto.
• Os preços dos cards de produto são carregados quando o card entra na viewport.
• O novo mixin prices centraliza a requisição, o estado de carregamento e os valores já formatados usados pelos componentes.
• O tipo de pagamento destacado passa a vir do tema via Vuex, em vez de ser interpolado pelo Twig.
• A página de produto exibe loaders enquanto os preços carregam e refaz a busca quando o SKU selecionado muda.
• O parcelamento e o botão de compra flutuante passam a usar os preços vindos da API.
• Os trackings enviados para a API da Yampi a partir dos templates foram removidos.
• Os filtros da busca deixam de ficar desatualizados, com a remoção do cache das agregações em localStorage.
• A barra de ordenação e filtros continua visível quando um filtro aplicado não retorna produtos.
• O modal de parcelas passa a selecionar o cartão na abertura, e não na criação do componente.
• O contador de visitantes online passa a aguardar a sessão antes de iniciar o websocket.

​

API de frete: tempo de resposta passa a ser de 3 segundos

​

Permissões de aplicativos agora documentadas

• Documentação dos dois níveis de acesso disponíveis: Visualizar (métodos GET) e Gerenciar (GET, POST, PUT, PATCH e DELETE), com explicação de quando usar cada um.
• Detalhamento das ações permitidas por nível em cada um dos 11 módulos disponíveis no Painel de Parceiros: Catálogo, Pedidos, Clientes, Checkout, Promoções, Logística, Configurações, Banners, Conteúdos, Leads e Links de pagamento.
• Passo a passo de como selecionar as permissões no painel antes de salvar o app.
• Orientações sobre o impacto de alterar permissões em apps já publicados, incluindo o ciclo de nova análise e o comportamento para lojistas com o app instalado.
• O link de escopos na documentação de OAuth foi atualizado para apontar diretamente para essa página.

​

Reestruturação da documentação do Editor de Código

• Nova página Buscar e substituir com tutorial completo dos recursos de busca e substituição em arquivos.
• Boas práticas de Twig, Vue e SASS consolidadas na página de Tecnologias.
• Páginas de Erros, Versionamento, Publicação e Pastas e Arquivos padronizadas no mesmo formato estrutural.
• Reordenação do grupo “Começando” pelo fluxo de leitura do dev: Primeiras edições → Pastas e Arquivos → Tecnologias → Buscar e substituir → Erros → Versionamento → Publicação.
• Renomeação da seção “Template Página” para Referência.

​

Limites por módulo na documentação de Rate-limit

​

Documentação do comportamento de sanitização de campos de texto

• Os campos name, description e outros campos de texto nos endpoints de Produtos, Marcas, Categorias, Pedidos, Leads, Banners e Brindes agora informam explicitamente que os valores podem ser sanitizados e normalizados antes de serem persistidos.
• Esses endpoints passam a retornar 422 Unprocessable Entity quando o valor enviado resulta em um campo inválido após a sanitização — por exemplo, quando o valor fica vazio após a normalização.
• O código 422 foi adicionado à seção de retornos HTTP da FAQ.

​

Atualização na documentação do Tema do Editor de código

• Componentes reorganizados por categoria: os componentes que ficavam em lista plana foram movidos para subpastas — Cabeçalho e Carrinho, Categoria e Busca, Formulários, Interface, Produto, Rodapé e Seções
• Mixins documentados: 12 mixins com descrição de uso, propriedades e exemplos
• Plugins documentados: 5 plugins com descrição de uso e exemplos
• Estado global (store) documentado: 8 módulos Vuex com estado, getters, actions e mutations
• Variáveis CSS reorganizadas: divididas em 4 arquivos temáticos — paleta, seções, tema e tipografia

​

Atualização nos endpoints de Pedidos e Busca

• Renomeação de parâmetro: O parâmetro customer_cpf foi renomeado para customer_document no endpoint de listar pedidos. A mudança se alinha com a maneira que a API funciona atualmente.
• Filtros adicionados à documentação: Incluímos os parâmetros de filtros na documentação de busca de pedidos, facilitando consultas mais precisas por diferentes critérios.

​

Novo endpoint: criar redirects 301 em massa

​

Atualização na documentação do Editor de código

​

Conteúdo sobre Rate-limit

​

Correção na documentação de dúvidas do produto

​

Documentação de extrato e saldo de cashback

​

Documentação do endpoint de Busca está disponível

​

Documentação de Clientes atualizada

• O campo birthday foi adicionado aos atributos aceitos no payload
• Agora está explícito que o envio de birthday é obrigatório quando o campo Data de nascimento estiver ativo no checkout da loja
• Exemplos de response foram adicionados aos dois endpoints, seguindo o padrão das demais documentações da API

​

Correção nos campos de data da documentação

​

Novo rate-limit nos endpoints de imagens de SKU

​

Limite de registros por página em Listar pedidos

​

Esclarecimento sobre o endpoint de Cotação de Frete

​

Filtros e includes documentados + novo filtro shopify_order_id

​

Rate-limit adicionado ao endpoint de OrderTracking

​

Correção na documentação de Link de Pagamento

​

Navegação da documentação simplificada

​

Mensagem dos endpoints PUT atualizada

• Os campos obrigatórios do endpoint precisam estar presentes no payload
• Campos opcionais não enviados serão mantidos com o valor atual

​

Correções na documentação de BatchUpdate, Kits e Etiquetas

• Atualização em massa (BatchUpdate): ajustes para refletir o comportamento correto da API
• Kits: informações do payload corrigidas
• Etiquetas: informações do payload corrigidas

​

Correção no payload de Criar Cashbacks

​

Correções na documentação de SKUs e Notas Fiscais

​

Nova orientação sobre conteúdo na Loja de Aplicativos

​

Atualização de terminologia: “Parceiro tech”

​

Novo endpoint de Upsell + correções em Marcas e Looks

​

Documentação nova no ar!

​

Nova seção: Desconto, incluindo o Compre X Leve Y diretamente via API da Yampi

​

Você vai encontrar:

• Exemplos práticos de criação de descontos.
• Explicações sobre limites de uso por pedido e condições específicas.
• Detalhes sobre campos importantes, obrigatórios e suas descrições.
• Tudo isso pensado para facilitar a integração e dar mais autonomia ao desenvolver para o nosso ecossistema.
• Todas ações suportadas neste endpoint.

​

Correções e melhorias na documentação

• Removida a seção de Filas, cujo conteúdo foi descontinuado
• Corrigido o tipo do atributo plataform.external_id para string na documentação de Frete por API
• Adicionada a referência da documentação do OAuth 2.0 na seção de criação de aplicativos
• Clientes: removidos os atributos password e password_confirmation dos payloads dos endpoints de clientes

​

Remoção da página de estatísticas de carrinhos abandonados

​

Melhoria no conteúdo sobre URL de Redirecionamento