Gerenciamento de Catálogos

​

Criando um catálogo

curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalogs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Primavera 2026",
    "description": "Coleção sazonal para Primavera 2026"
  }'

​

Fluxo de trabalho de publicação

​

Publicar um catálogo

curl -X POST ".../catalogs/{catalogId}/publish" \
  -H "Authorization: Bearer YOUR_API_KEY"

​

Bifurcar para edição

curl -X POST ".../catalogs/{catalogId}/fork" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name": "Primavera 2026 — Revisão QA"}'

​

Mesclar mudanças de volta

curl -X POST ".../catalogs/{catalogId}/merge" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"targetCatalogId": "PARENT_CATALOG_ID"}'

​

Ações em lote

• Normalizar (Silver) — mapeamento de campos, detecção de duplicatas, validação de URLs de imagem para uma seleção ou catálogo inteiro
• Analisar (Gold) — scoring de otimização em 7 estágios da rubrica, produz pontuação + lista de gaps por produto

# Lote Silver — normalizar catálogo inteiro
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/silver" \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -d '{"scope": "all"}'

# Lote Gold — pontuar catálogo inteiro
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/gold" \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -d '{"scope": "all"}'

​

Configurações do pipeline

• Mapeamentos de campos Silver — mapear nomes de colunas de origem para campos do schema Alana
• Pesos de scoring Gold — ajustar pesos por estágio da rubrica (identidade, conteúdo, mídia, etc.)
• Auto-trigger — executar Silver automaticamente após Bronze, ou Gold após Silver

​

Rastreamento da evolução do score

​

Estatísticas do catálogo

• Total de produtos — quantos produtos estão no catálogo
• Contagem pronta para feed — produtos que passam em todas as regras de validação
• Pontuação média de otimização — pontuação média de qualidade em todos os produtos
• Distribuição de scores — breakdown por faixas excelente/bom/atenção/ruim
• Última publicação — quando o catálogo foi publicado pela última vez