Manter o estoque atualizado entre um sistema ERP externo e uma loja virtual é um dos maiores desafios de e-commerces em crescimento. Quando ocorrem picos de vendas, requisições síncronas e diretas à API do WooCommerce podem sobrecarregar o banco de dados MySQL, resultando em lentidão no checkout, carrinhos abandonados e perda de vendas. O erro comum é tentar processar centenas de atualizações de produtos em tempo real durante a navegação do usuário.
Para resolver esse problema de forma escalável dentro do ecossistema WordPress, a melhor abordagem é o processamento assíncrono. Em vez de usar requisições diretas que bloqueiam a execução do servidor, utilizamos a biblioteca nativa do WordPress chamada Action Scheduler (a mesma ferramenta robusta que gerencia o WooCommerce Subscriptions).
Por meio de ganchos (hooks) personalizados, podemos interceptar os payloads de estoque enviados pelo ERP e enfileirar as tarefas de atualização para processamento em segundo plano. O exemplo abaixo demonstra como registrar uma ação agendada de forma eficiente:
addaction(‘webhookerpestoquerecebido’, ‘enfileiraratualizacaoestoque’, 10, 2);
function enfileiraratualizacaoestoque($productid, $novoestoque) {
asenqueueasyncaction(‘atualizarestoqueprodutobackground’, array(‘productid’ => $productid, ‘estoque’ => $novo_estoque));
}
addaction(‘atualizarestoqueprodutobackground’, ‘processaratualizacaoestoquebg’);
function processaratualizacaoestoquebg($productid, $estoque) {
$product = wcgetproduct($productid);
if ($product) {
$product->setstockquantity($estoque);
$product->save();
}
}
Essa arquitetura garante que a API do WordPress responda instantaneamente com o status HTTP 202 (Accepted) para o ERP, liberando a conexão de rede rapidamente, enquanto o Action Scheduler processa a fila de alterações de forma controlada nos bastidores.
Em implementações que realizo, costumo configurar o Action Scheduler para rodar diretamente via cron do sistema operacional (WP-CLI cron) no servidor, em vez de depender do cron padrão baseado em visitas (wp-cron.php). Isso reduz o tempo de resposta do servidor a quase zero e evita picos de uso de CPU.
O processo inteligente de integração segue este fluxo:
- O ERP faz o disparo de alteração de estoque para um endpoint customizado da REST API do WooCommerce.
- O WordPress valida a segurança da requisição e enfileira a tarefa imediatamente no Action Scheduler.
- O servidor processa os lotes em segundo plano em pequenos intervalos distribuídos.
- Eventuais erros de sincronização são registrados utilizando a classe nativa WC_Logger para auditoria sem interromper a operação.
Se você possui uma loja WooCommerce que enfrenta problemas de lentidão ou quedas de servidor durante a integração com ERPs e deseja implementar uma arquitetura de alta performance sob medida para o seu negócio, entre em contato para agendarmos uma consultoria técnica.
