[Ordenação de Produtos] - Configure a ordem dos produtos por categoria, também via integração API
Atualizado em
Mantenha a vitrine organizada do jeito que faz sentido pro seu negócio, direto pelo seu sistema.
O que mudou
Até agora, a ordem de exibição dos produtos dentro de uma categoria só podia ser ajustada manualmente no painel administrativo, arrastando os produtos na tela, no menu "Catálogo > Categoria > Ordenar Produtos".
Agora, se você integra a Flexy com um ERP ou outro sistema, também é possível definir essa ordem por lá. A posição de cada produto dentro da categoria fica sincronizada entre a integração, o painel e a vitrine da loja.
Por que isso importa: — Se você já define prioridades comerciais no seu ERP — como destacar lançamentos, produtos em campanha ou giro de estoque — agora essa lógica pode valer direto na vitrine, sem precisar reorganizar manualmente no painel toda vez que algo mudar.
Onde você vai perceber
Painel administrativo: o arrastar-e-soltar na ordenação de produtos por categoria continua funcionando normalmente.
Vitrine da loja: os produtos passam a aparecer na ordem definida, seja ela feita no painel ou enviada pela integração.
Como funciona
Ao atualizar um produto pela integração, agora dá para informar em qual posição ele deve aparecer dentro de cada categoria em que está.
Se a posição não for enviada, o produto mantém a ordenação que já existia — nada muda para quem não usa essa opção.
Dá para atualizar a posição de um produto em algumas categorias, sem afetar as demais.
Um mesmo produto pode ter posições diferentes em categorias diferentes.
Melhores práticas
Antes de usar
Alinhe com quem cuida da integração/ERP se faz sentido migrar a priorização de produtos para lá, em vez de manter no painel.
Ao definir as posições
Evite enviar a mesma posição para dois produtos na mesma categoria, para não gerar inconsistência na ordenação.
Perguntas frequentes
Preciso migrar toda a ordenação para a integração?
Não. É opcional. Quem não enviar essa informação continua com o comportamento atual, sem nenhuma mudança.
Isso substitui o arrastar-e-soltar no painel?
Não. As duas formas continuam funcionando e ficam sincronizadas entre si.
Um produto pode ter uma posição em uma categoria e outra posição em outra categoria?
Sim. A posição é sempre definida por produto dentro de cada categoria, então elas são independentes.
O que acontece se duas atualizações informarem a mesma posição?
O sistema trata a inconsistência automaticamente para manter a listagem organizada. Recomendamos sempre enviar posições únicas para evitar surpresas.
Precisa de ajuda? — Fale com a gente pelo suporte@flexy.com.br.
Informações Técnicas
Conteúdo para quem vai implementar a integração (time técnico / ERP).
Documentação: https://flexy.api.flexy.com.br/platform/api/docs
Endpoint
PUT /platform/api/categories/sort/{categoryReferenceCode}
O parâmetro de URL referenceCodeStore deve ser usado somente para lojas de shopping.
Parâmetros aceitos no payload
Parâmetro · Tipo · Obrigatório · Descrição
productReferenceCode · string · Sim · Código de referência do produto.
sortOrder · integer · Sim · Posição desejada para o produto na categoria. Deve ser >= 1 e único no payload.
Suporta payload parcial: produtos não informados preservam a ordem relativa anterior e preenchem as posições restantes.
Exemplo de requisição
PUT /platform/api/categories/sort/categoryReferenceCode?token=******&referenceCodeStore=store-flexy HTTP/1.1 Host: https://flexy.api.flexy.com.br Content-Type: application/json [ { "productReferenceCode": "fronha", "sortOrder": 1 }, { "productReferenceCode": "travesseiro", "sortOrder": 2 }, { "productReferenceCode": "coberta", "sortOrder": 3 } ]
Exemplo de resposta
HTTP/1.1 200 OK Content-Type: application/json [ { "productReferenceCode": "fronha", "sortOrder": 1 }, { "productReferenceCode": "travesseiro", "sortOrder": 2 }, { "productReferenceCode": "coberta", "sortOrder": 3 }, { "productReferenceCode": "edredom", "sortOrder": 4 }, { "productReferenceCode": "cama", "sortOrder": 5 } ]
A documentação completa, com todos os parâmetros e exemplos, está disponível na documentação da API Flexy.
Página da documentação da API Flexy para o endpoint de ordenação de produtos em uma categoria. (https://flexy.api.flexy.com.br/platform/api/docs)