Pular para o conteúdo principal

​
Visão geral

Ações em Lote permitem executar estágios do pipeline — normalização Silver ou pontuação Gold — em múltiplos produtos simultaneamente. Em vez de processar produtos um a um, você seleciona um escopo (produtos individuais, uma seleção ou o catálogo inteiro) e aciona a operação uma vez.

​
Selecionando produtos

​
Produto único

Na página de detalhe do produto, use o botão Normalizar ou Analisar no painel do pipeline na barra lateral direita. Isso executa a operação somente naquele produto.

​
Seleção

  1. Na lista de produtos do catálogo, marque as caixas ao lado dos produtos que deseja processar
  2. Uma barra de ação flutuante aparece na parte inferior: X produtos selecionados
  3. Clique em Normalizar ou Analisar na barra de ação

​
Catálogo completo

  1. Na lista de produtos do catálogo, clique em Selecionar Todos (seleciona todos os produtos do catálogo, não apenas a página atual)
  2. Clique em Normalizar ou Analisar na barra de ação
  3. Alternativamente, use o dropdown Ações em Lote → Normalizar Todos ou Analisar Todos

​
Seletor de escopo

O seletor de escopo define o alvo do lote em chamadas de API:
EscopoComportamento
"selection"Processa somente os productIds especificados
"all"Processa todos os produtos no catálogo
Quando scope: "all", o campo productIds é ignorado.

​
Executar Silver (Normalizar)

O Silver normaliza campos: padroniza capitalização, valida URLs, detecta duplicatas, mapeia categorias e marcas.

​
Via UI

  1. Selecione produtos (ou use Selecionar Todos)
  2. Clique em Normalizar
  3. Uma barra de progresso exibe: Normalizado X / Y produtos
  4. Quando concluído, um painel de resultados exibe:
    • Contagem de campos normalizados
    • Duplicatas detectadas
    • URLs de imagens quebradas encontradas

​
Via API

# Normalizar uma seleção
curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/silver" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productIds": ["prod_abc", "prod_def", "prod_ghi"],
    "scope": "selection"
  }'

# Normalizar o catálogo inteiro
curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/silver" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scope": "all"}'

​
Estrutura do resultado Silver

{
  "results": [
    {
      "productId": "prod_abc",
      "status": "success",
      "fieldsNormalized": 4,
      "duplicateOf": null,
      "urlsValidated": 3
    },
    {
      "productId": "prod_def",
      "status": "success",
      "fieldsNormalized": 2,
      "duplicateOf": "prod_xyz",
      "urlsValidated": 1
    },
    {
      "productId": "prod_ghi",
      "status": "error",
      "error": "Marca não encontrada: 'MarcaDesconhecida'"
    }
  ],
  "processed": 3,
  "duration_ms": 1240
}
CampoDescrição
status"success" ou "error"
fieldsNormalizedNúmero de campos que foram transformados
duplicateOfSe uma duplicata foi detectada, o ID do produto original
urlsValidatedNúmero de URLs de imagens/mídia verificadas quanto à acessibilidade

​
Executar Gold (Analisar)

O Gold pontua produtos em uma escala de 0–100 em 7 estágios e produz uma lista de lacunas dos campos que mais melhorariam a pontuação.

​
Via UI

  1. Selecione produtos (ou use Selecionar Todos)
  2. Clique em Analisar
  3. Uma barra de progresso exibe: Analisado X / Y produtos
  4. Quando concluído, cada card de produto exibe um badge de pontuação (0–100)
  5. Clique em qualquer produto para ver o detalhamento completo de lacunas

​
Via API

# Analisar uma seleção
curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/gold" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productIds": ["prod_abc", "prod_def"],
    "scope": "selection"
  }'

# Analisar catálogo inteiro
curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/gold" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scope": "all"}'

​
Estrutura do resultado Gold

{
  "results": [
    {
      "productId": "prod_abc",
      "status": "success",
      "score": 82,
      "gaps": ["secondaryImages", "gtin"],
      "missingFields": ["gtin"]
    },
    {
      "productId": "prod_def",
      "status": "success",
      "score": 41,
      "gaps": ["description", "gtin", "brand", "images"],
      "missingFields": ["description", "gtin"]
    }
  ],
  "catalogSummary": {
    "avgScore": 61.5,
    "scoreDistribution": {
      "excellent": 12,
      "good": 34,
      "warning": 28,
      "poor": 8
    },
    "topGaps": ["gtin", "description", "secondaryImages"]
  }
}
CampoDescrição
scorePontuação de otimização 0–100
gapsCampos ordenados por impacto na pontuação (maior impacto primeiro)
missingFieldsCampos completamente ausentes do produto
catalogSummary.topGapsLacunas mais comuns em todos os produtos
catalogSummary.scoreDistributionContagem por faixa de limite

​
Acompanhamento de progresso

Para catálogos grandes, as operações em lote rodam de forma assíncrona. Acompanhe o progresso via:
  • UI — barra de progresso ao vivo atualizada a cada 2 segundos
  • API — consulte o endpoint de status do job:
curl "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/JOB_ID/status" \
  -H "Authorization: Bearer SUA_API_KEY"

​
Boas práticas

As pontuações Gold dependem de dados normalizados. Sempre execute o Silver primeiro para garantir que marcas e categorias estejam vinculadas antes de pontuar.
O campo catalogSummary.topGaps informa as lacunas mais comuns em todo o catálogo. Enderece-as sistematicamente em vez de produto por produto.
Processar mais de 10.000 produtos pode levar vários minutos. Use a API para acionar jobs em lote a partir de uma tarefa agendada em horários de baixo tráfego.
Após preencher lacunas, execute o Gold apenas nos produtos editados (use scope: "selection" com productIds) em vez do catálogo inteiro.
Last modified on March 18, 2026