> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.
# Marketplace Hub
> Publique catálogos no marketplace B2B, descubra conteúdo de outras marcas e assine atualizações ao vivo de catálogos.
## Visão geral
O **Marketplace Hub** é uma exchange de conteúdo B2B onde proprietários de workspace podem publicar catálogos para outras empresas descobrirem, clonarem ou assinarem. Funciona tanto como canal de distribuição (perspectiva do publicador) quanto como ferramenta de sourcing de conteúdo (perspectiva do consumidor).
***
## Perspectiva do publicador
Como publicador, você expõe seu catálogo ao ecossistema do marketplace — seja gratuitamente ou mediante cobrança.
### Publicando um catálogo
1. Certifique-se de que seu catálogo completou pelo menos o estágio Silver do pipeline
2. Navegue até o catálogo → aba **Marketplace**
3. Configure visibilidade, precificação e categoria
4. Clique em **Publicar no Hub**
Após publicado, seu catálogo aparece no feed de navegação do Hub e é pesquisável por nome, categoria e tags.
### Modelos de precificação
| Modelo | Descrição |
| --------------------- | ------------------------------------------------------------------------------ |
| **Gratuito** | O catálogo pode ser clonado e assinado sem custo |
| **Pago (via Stripe)** | Consumidores pagam uma taxa única ou recorrente gerenciada via Stripe Checkout |
O acesso a catálogos pagos é controlado no nível da API — o status da assinatura é verificado em cada operação de clone e assinatura.
### Versionamento de catálogos
Cada vez que você atualiza um catálogo publicado (adiciona produtos, executa Silver/Gold, edita metadados), uma nova **versão** é criada automaticamente. Versões são snapshots imutáveis.
| Campo de versão | Descrição |
| --------------- | ---------------------------------------------------- |
| `version` | Inteiro auto-incrementado (v1, v2, v3…) |
| `createdAt` | Timestamp da versão |
| `changeCount` | Número de produtos adicionados/atualizados/removidos |
| `publishedBy` | Membro que acionou a publicação |
Assinantes recebem uma notificação quando uma nova versão está disponível e podem escolher sincronizar no momento que for conveniente.
### Analytics do publicador
Acompanhe o desempenho do catálogo na aba **Analytics** ou via API:
* **Visualizações** — quantas vezes o preview do catálogo foi aberto
* **Clones** — total de cópias únicas realizadas
* **Assinantes ativos** — workspaces com assinaturas ativas
* **Receita** — total coletado (para catálogos pagos)
Consulte a [API de Analytics do Publicador](/api-reference/hub/publisher-analytics) para detalhes.
### Despublicar / retirar do ar
Para remover um catálogo do Hub:
1. Navegue até o catálogo → aba **Marketplace**
2. Clique em **Despublicar**
Despublicar remove o catálogo do feed de navegação imediatamente. Assinantes existentes mantêm seus dados locais, mas param de receber notificações de novas versões. Sincronizações pendentes são canceladas.
Despublicar não exclui os dados dos assinantes. Workspaces que já clonaram seu catálogo mantêm sua cópia local.
***
## Perspectiva do consumidor
Como consumidor, você navega pelo Hub para descobrir catálogos, visualizar produtos e clonar ou assinar.
### Navegar e descobrir
A página de navegação do Hub suporta:
* **Pesquisa** por palavra-chave (nome do catálogo, marca, descrição)
* **Filtro** por categoria, preço (gratuito/pago), pontuação mínima
* **Ordenação** por: Popular, Recente, Pontuação de Otimização
Cada card de catálogo exibe: nome, publicador, contagem de produtos, categoria, pontuação média e contagem de assinantes.
### Preview sem compromisso
Todo catálogo publicado oferece um **preview** dos primeiros 10 produtos mais estatísticas agregadas (total, pontuação média, principais categorias, principais marcas) — sem necessidade de clone. Use o preview para avaliar a adequação antes de assinar.
### Clone — cópia única
**Clone** cria um snapshot local do catálogo no seu workspace. Não estabelece uma conexão contínua.
* Todos os produtos são copiados para um novo catálogo no seu workspace
* Você pode editar, enriquecer e redistribuir livremente
* Sem sincronização — você não receberá atualizações futuras do publicador
### Assinar — sincronização ao vivo
**Assinar** cria um link ao vivo entre seu workspace e o catálogo do publicador. Quando o publicador lança uma nova versão, você é notificado e pode sincronizar.
#### Estratégias de sincronização
| Estratégia | Comportamento |
| ---------- | ----------------------------------------------------------------- |
| `auto` | Novas versões são aplicadas automaticamente ao seu catálogo local |
| `manual` | Você revisa e aprova cada sincronização via UI ou API |
#### Estratégias de resolução de conflitos
Quando um produto sincronizado tem edições locais que conflitam com atualizações do publicador, a estratégia de resolução de conflitos determina o resultado:
| Estratégia | Comportamento |
| --------------- | ------------------------------------------------------------------------------------------------- |
| `keep_local` | Suas edições locais sempre prevalecem; alterações do publicador são descartadas para aquele campo |
| `accept_remote` | Alterações do publicador sempre prevalecem; suas edições locais são sobrescritas |
| `manual_review` | Conflitos são enfileirados para resolução manual — nenhum lado vence automaticamente |
Use `manual_review` para catálogos de alto valor onde as edições locais representam trabalho significativo (descrições personalizadas, ajustes de preço). Use `accept_remote` para feeds de fornecedores brutos onde o publicador é o dono dos dados.
***
## Fluxo de resolução de conflitos
```mermaid theme={null}
graph TD
A["Publicador lança v5"] --> B["Assinante recebe notificação"]
B --> C{Estratégia de sync?}
C -- auto --> D["Aplica v5 imediatamente"]
C -- manual --> E["Enfileirado para revisão"]
D --> F{Conflitos?}
E --> F
F -- keep_local --> G["Edições locais preservadas"]
F -- accept_remote --> H["Dados do publicador prevalecem"]
F -- manual_review --> I["Fila de conflitos\n(resolução via UI ou API)"]
```
***
## Modelo de versionamento de catálogos
```mermaid theme={null}
graph LR
P1["v1 (publicado)"] --> P2["v2 (publicado)"]
P2 --> P3["v3 (publicado)"]
P3 --> P4["v4 (atual)"]
P4 --> S1["Assinante A\n(na v3)"]
P4 --> S2["Assinante B\n(na v4, auto-sync)"]
P4 --> S3["Assinante C\n(na v2, manual)"]
```
Cada assinante pode estar em uma versão diferente. A sincronização sempre avança — não é possível voltar a uma versão anterior do publicador.
***
## Controle de acesso
| Ação | Quem pode fazer |
| -------------------- | ---------------------------------- |
| Publicar catálogo | Proprietário ou admin do workspace |
| Definir precificação | Somente proprietário do workspace |
| Ver analytics | Proprietário ou admin do workspace |
| Despublicar | Somente proprietário do workspace |
| Clonar/assinar | Qualquer workspace autenticado |
| Preview | Qualquer pessoa (público) |
***
## Boas práticas
Os consumidores julgam a qualidade do catálogo pelos dados normalizados. Publique após o Silver (e idealmente o Gold) para maximizar a descoberta e conversão de assinantes.
Cada salvamento em um catálogo publicado cria uma nova versão e notifica os assinantes. Agrupe suas edições e publique uma vez, em vez de fazer muitas pequenas alterações.
Defina `keep_local` quando sua equipe downstream adiciona descrições ou preços personalizados. Defina `accept_remote` para feeds de fornecedores que você usa verbatim.
Muitas visualizações com poucos clones indicam uma incompatibilidade entre os metadados do catálogo e o conteúdo. Melhore seu título, descrição e tags de categoria.