**TL;DR.** Migrar do WooCommerce para o Ordiko substitui sua pilha de WordPress + hospedagem + plugins por um SaaS gerenciado. Planeje a importação do catálogo (1–3 horas), mapeamento de redirecionamentos (1 hora) e mudança de DNS. Feito corretamente, o SEO se recupera em 1–4 semanas e o custo operacional cai 30–80%.

## Por que os comerciantes do WooCommerce migram

- TCO. Hospedagem + plugins + manutenção frequentemente excedem a taxa fixa do Ordiko.
- Desempenho. A proliferação de plugins prejudica os Core Web Vitals; INP especialmente.
- Segurança. O WordPress é o CMS mais atacado da internet.
- Schema 2026. Alcançar `hasMerchantReturnPolicy` no WooCommerce requer Yoast Premium + configuração manual ou módulos personalizados.
- Prontidão para busca por IA. O WooCommerce não possui llms.txt nativo ou gêmeos em Markdown.

## Passo 1: Audite sua superfície do WooCommerce

Inventário do catálogo:

```bash
# WP-CLI no servidor de produção (comandos somente leitura)
wp post list --post_type=product --format=csv > products_inventory.csv
wp term list product_cat --format=csv > categories.csv
wp option get yoast_seo_settings > yoast.json
```

Inventário de SEO:

- Título e descrição meta do Yoast/Rank Math por post (exportar via plugin).
- Sitemap atual (`/sitemap_index.xml`).
- Plugin multilíngue ativo (WPML, Polylang ou nenhum) e seu mapeamento de localidade.
- Plugin de assinatura ativo (WooCommerce Subscriptions, MemberPress) se houver.
- Tipos de post personalizados vinculados ao comércio (depoimentos, lookbooks).

Base de desempenho:

- Execute [PageSpeed Insights](https://pagespeed.web.dev) na página inicial, PLP, PDP. Salve os números de LCP/INP/CLS.

## Passo 2: Exporte o catálogo do WooCommerce

O exportador CSV padrão do WooCommerce lida com a maioria dos casos:

1. WP Admin → Produtos → Exportar.
2. Escolha: "Todos os produtos", "Exportar todas as colunas".
3. Baixe `wc-product-export.csv`.

Para produtos variáveis com muitas variações, também exporte via WC Admin → Produtos → defina a visualização como "Todos", filtre por `variation`, e então exporte.

Para taxonomias (categorias, marcas, atributos), use WP-CLI:

```bash
wp wc product_category list --format=csv > categories_export.csv
wp wc product_attribute list --format=csv > attributes.csv
```

Para mídias, sincronize `/wp-content/uploads/` via SFTP.

## Passo 3: Provisione sua loja Ordiko

1. Inscreva-se em [ordiko.shop](https://ordiko.shop).
2. Crie uma loja: escolha um slug (usado para o subdomínio padrão).
3. Configure localidades (subconjunto de 8 suportadas).
4. Escolha um tema inicial.
5. Conecte seu domínio personalizado (você mudará o DNS no Passo 9).

## Passo 4: Importe produtos e categorias

No painel do Ordiko:

1. **Configurações → Importar → WooCommerce**.
2. Faça o upload de `wc-product-export.csv` e seu arquivo de mídia (zip de `/wp-content/uploads/`).
3. O importador:
   - Mapeia produtos variáveis do Woo para variantes do Ordiko.
   - Preserva slugs.
   - Importa categorias como taxonomias do Ordiko, preservando a hierarquia pai-filho.
   - Importa imagens de produtos, derivando `alt` dos nomes dos arquivos (melhore depois com o gerador de texto alternativo de IA).
4. Monitore o progresso em tempo real; grandes importações (10k+ produtos) são executadas como trabalhos em segundo plano do Trigger.dev e notificam ao término.

## Passo 5: Configure redirecionamentos

As convenções de URL do WooCommerce → Ordiko:

| WooCommerce              | Ordiko                |
| ------------------------ | --------------------- |
| `/product/{slug}`        | `/products/{slug}`    |
| `/product-category/{slug}` | `/categories/{slug}` |
| `/product-tag/{slug}`    | `/tags/{slug}`        |
| `/?p=123` (legado)       | `/products/{slug}` (baseado em pesquisa) |

Configure 301s curinga em `/seo/redirects`:

```csv
from,to,status
/product/(.*),/products/$1,301
/product-category/(.*),/categories/$1,301
/product-tag/(.*),/tags/$1,301
```

Para SKUs deletados, escreva entradas 410. A camada de caminhos ausentes do Ordiko transforma isso em páginas HTTP 410 com recomendações baseadas em similaridade vetorial.

## Passo 6: Replicando configurações do plugin de SEO

Yoast/Rank Math exportam seus títulos e descrições meta por post no CSV de produtos (as colunas do Yoast são `yoast_wpseo_title` e `yoast_wpseo_metadesc`). O importador do Ordiko lê isso no editor de SEO por entidade.

Os campos do schema de Produto 2026 são configurados uma vez no nível da loja:

1. **Configurações → SEO → Política de Retorno** (veja [o guia de migração do Shopify](/guides/migrate-from-shopify-to-ordiko) para referência de campos).
2. **Configurações → SEO → Políticas de Envio**.
3. **Configurações → SEO → Política de Rastreio de IA**.

Esses são renderizados automaticamente em cada PDP.

## Passo 7: Espelhe hreflang

Se você usou WPML ou Polylang:

1. Exporte o mapeamento de localidades (WPML → Ferramentas → Exportar → XLIFF, ou Polylang → Configurações → Exportar).
2. Ative as localidades correspondentes no Ordiko.
3. Use `availableLocales` por entidade para sinalizar traduções parciais.

## Passo 8: Execute em paralelo e QA

Execute o Ordiko em um subdomínio (por exemplo, `new.example.com`) enquanto o WooCommerce continua no domínio de produção. Lista de verificação de QA:

- [ ] A página inicial é renderizada corretamente.
- [ ] As páginas de categoria mostram produtos paginados.
- [ ] PDP é renderizada com imagens, preço, variantes e schema corretos (teste com [Rich Results Test](https://search.google.com/test/rich-results)).
- [ ] A busca retorna resultados relevantes.
- [ ] O carrinho e o checkout funcionam de ponta a ponta com um pagamento de teste.
- [ ] O login da conta + histórico de pedidos carrega.
- [ ] Multi-localidade: cada localidade é renderizada corretamente com hreflang apropriado.

## Passo 9: Mudança de DNS

1. Reduza o TTL em seus registros DNS existentes 24 horas antes da mudança (TTL = 300 segundos).
2. No momento da mudança, altere os registros A ou CNAME para apontar para o Ordiko.
3. Dentro de 1 hora após a propagação:
   - Envie `/sitemap.xml` no Google Search Console.
   - Envie no Bing Webmaster Tools.
   - Envie no Yandex Webmaster.

## Passo 10: Monitore e recupere

Por 72 horas:

| Superfície                                | O que fazer                          |
| ------------------------------------------ | ----------------------------------- |
| GSC Páginas → Excluídas                   | Adicione 301s para quaisquer 404s inesperados    |
| GSC Desempenho → Cliques                  | Confirme que a queda ≤ 15% e então a recuperação     |
| Bing Webmaster → IndexNow                  | Pings registrados                        |
| Ordiko → SEO → Web Vitals                  | LCP/INP/CLS verde                   |
| Ordiko → SEO → Eventos de Revalidação     | Sem erros                           |

## FAQ

**Quais plugins do WooCommerce não terão equivalentes diretos no Ordiko?**
O Ordiko oferece assinaturas, multi-moeda, envio avançado, reservas (básicas), cartões-presente, recuperação de carrinho abandonado e SEO como recursos principais. Extensões do WooCommerce para nichos incomuns (LearnDash para LMS, BookingPress para agendamentos) não têm equivalentes diretos e podem exigir integrações externas ou mudanças de fluxo de trabalho.

**Posso manter meu blog WordPress após migrar o comércio para o Ordiko?**
Sim — muitos comerciantes mantêm o WordPress como um CMS de conteúdo em /blog (subdiretório ou subdomínio) enquanto o Ordiko cuida do comércio. Configure seu DNS para direcionar /blog/* para o WordPress e tudo o mais para o Ordiko. A desvantagem: você mantém duas pilhas. Alternativamente, migre postagens de blog para a coleção de conteúdo baseada em MDX do Ordiko para uma única plataforma.

**Como faço para lidar com produtos variáveis do WooCommerce?**
O importador do Ordiko mapeia produtos variáveis do WooCommerce para variantes do Ordiko com a mesma estrutura de atributos (tamanho, cor, material, etc.). Cada variação se torna uma variante do Ordiko com seu próprio SKU, preço, inventário e imagens opcionais.

**Vou perder as credenciais de login dos clientes?**
Os registros de clientes são importados via CSV com senhas hash. Os clientes recebem um e-mail de redefinição de senha na próxima tentativa de login (WP e Ordiko usam esquemas de hash de senha diferentes). Pontos de fidelidade, crédito de loja e dados de plugins de recompensas exigem mapeamento personalizado.