# WooCommerce

Loja WooCommerce no seu WordPress: produtos, pedidos, clientes, frete, impostos e relatórios, também via MCP.

Fonte: https://ardumaker.com/pt/docs/woocommerce/

- Categoria: Servidores e infraestrutura
- Estado: Disponível
- Requisitos: Um site [WordPress](https://ardumaker.com/pt/docs/wordpress) instalado como app; O plugin WooCommerce ativo (instalado com `extras` ou como plugin)
- Ferramentas MCP (Só leem): `ver_reportes_tienda_wordpress`, `listar_sitios_wordpress`
- Ferramentas MCP (Escrevem ou modificam): `instalar_app`
- Ferramentas MCP (Destrutivas): `editar_tienda_wordpress`, `editar_integraciones_wordpress`, `controlar_extensiones_wordpress`

## O que permite fazer?

O WooCommerce é uma variante de um site WordPress: a ArduMaker o instala ao criar o site e depois permite operar a loja inteira com wp-cli (`wp wc`, o CLI do WooCommerce sobre sua API REST), como o admin do site.

- Produtos e variações, categorias, tags, atributos e seus termos, e estoque.
- Pedidos, notas de pedido e reembolsos.
- Clientes e cupons.
- Zonas de frete com seus métodos e locais, impostos e classes de imposto.
- Gateways de pagamento e ajustes `woocommerce_*`.
- Relatórios de vendas e produtos mais vendidos.
- Webhooks do WooCommerce para outros sistemas.

## Quando convém usar?

- Uma loja própria no seu servidor, sem comissões de plataforma de loja.
- Carregar ou atualizar catálogo e estoque a partir de um agente de IA.
- Consultar vendas do mês sem entrar no painel do WordPress.

## Como funciona na ArduMaker?

Ao criar o site com `config.extras` incluindo `woocommerce`, no passo `configurar` o plugin `woocommerce` é instalado e ativado a partir do wordpress.org; se o Elementor não foi pedido, o tema `storefront` também é ativado, e são criadas as páginas de loja, carrinho, finalizar compra e minha conta. Repetir não duplica nada. Um site trazido de um backup não recebe variantes: traz seus próprios plugins.

Cada operação sobre a loja é `wp wc` com um recurso e uma ação (`listar`, `ver`, `crear`, `editar`, `eliminar`). `data.id` identifica o objeto, `data.parent` o objeto do qual depende (produto de uma variação, pedido de um reembolso ou nota, zona de um método, atributo de um termo) e `data.fields` os campos da API do WooCommerce.

## O que muda realmente?

As mudanças ficam no banco do site (`wp<id>`), igual a se fossem feitas pelo painel do WooCommerce. O estoque é um campo do produto (`stock_quantity`, `manage_stock`); o recurso `inventario` o lista para todos.

> **PELIGRO:** Reembolsar e apagar pedem `confirmed: true`: movem dinheiro ou não têm volta.

## Esquema

**Uma operação de loja**

```text
Agente ou painel (`editar_tienda_wordpress`)
  ↓
Backend da ArduMaker (permissões e montagem do comando)
  ↓
Agente do VPS (`wp wc …` como o usuário do site)
  ↓
WooCommerce (banco `wp<id>`)
```

## Resultado esperado

Cada chamada devolve o que o WooCommerce respondeu (o produto, o pedido, a lista). `ver_reportes_tienda_wordpress` devolve, para o período (por padrão o mês atual, até 1000 pedidos), pedidos, itens, receita, descontos, frete e impostos dos pedidos pagos ou em andamento, ou os produtos mais vendidos por quantidade.

## Erros e resolução

- `wordpress_comando_fallido` (422): `wp wc` respondeu com erro; a mensagem traz a saída cortada para corrigir o pedido.
- O estoque usa o esquema antigo do `wp wc`: `in_stock`, não `stock_status`.
- Um ajuste precisa se chamar `woocommerce_<nome>`.
- Se a variante não pôde ser instalada ao criar o site, a operação falha `wordpress_variantes_no_instaladas` e pode ser repetida.

## Relação com MCP

A loja é operada pelo domínio [/mcp/wordpress](https://ardumaker.com/pt/mcp/wordpress) (referência geral em [/mcp/docs](https://ardumaker.com/pt/mcp/docs)):

- Leitura: `ver_reportes_tienda_wordpress` (`sales` ou `top_sellers`, com `period` ou `date_min`/`date_max`).
- Escrita (marcada destrutiva porque inclui reembolsos e exclusões): `editar_tienda_wordpress` com `resource` e `action`.
- Webhooks: `editar_integraciones_wordpress` (`listar_webhooks`, `crear_webhook` com nome, tópico, URL de entrega e segredo, `eliminar_webhook`).
- Instalar a loja: `instalar_app` com `app_type: wordpress` e `config.extras: ["woocommerce"]`, ou `controlar_extensiones_wordpress` para adicionar o plugin a um site existente.

É preciso poder alterar o site: um agente autorizado como somente leitura não vê `editar_tienda_wordpress`.

## Funcionalidades relacionadas

- [WordPress](https://ardumaker.com/pt/docs/wordpress/)
- [Elementor](https://ardumaker.com/pt/docs/elementor/)
- [MySQL](https://ardumaker.com/pt/docs/mysql/)
- [Cópias de segurança](https://ardumaker.com/pt/docs/backups/)