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.

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.

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

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)