Vender online exige precisão em tempo real. Um dos maiores gargalos de e-commerces em crescimento é a quebra de estoque, que ocorre quando um cliente compra no site um produto que já esgotou no estoque físico ou no ERP. Esse problema gera frustração, cancelamentos de pedidos e prejudica a reputação da marca. Tentar resolver isso fazendo consultas constantes e síncronas diretamente no banco de dados do WooCommerce a cada acesso pode sobrecarregar o seu servidor e causar quedas de serviço nos momentos de maior pico de acessos.
## O Gargalo Técnico da Sincronização Síncrona
Muitas integrações legadas tentam atualizar o estoque do WooCommerce disparando requisições HTTP síncronas para cada alteração de produto. Quando o ERP envia uma carga de dados com centenas de SKUs de uma só vez, o servidor web atinge o limite de memória (memory_limit) e o tempo limite de execução do PHP (max_execution_time), resultando no erro 502 Bad Gateway e na interrupção do serviço de vendas.
## A Solução Eficiente: Action Scheduler e WooCommerce REST API
A forma correta de resolver esse problema dentro do ecossistema WordPress é utilizando uma arquitetura orientada a eventos com processamento assíncrono. Isso garante que a atualização ocorra em segundo plano, sem afetar a navegação do usuário.
### 1. Criação de Endpoint Customizado na WP REST API
Em vez de fazer o WooCommerce consultar o ERP de tempos em tempos (polling), configuramos o ERP para notificar o WooCommerce apenas quando houver alteração real de estoque. Para isso, criamos um endpoint customizado:
“`php
add_action(‘rest_api_init’, function () {
register_rest_route(‘custom-api/v1’, ‘/estoque’, array(
‘methods’ => ‘POST’,
‘callback’ => ‘registrar_fila_atualizacao_estoque’,
‘permission_callback’ => ‘validar_token_integracao’,
));
});
“`
### 2. Enfileiramento com o Action Scheduler nativo
Em implementações que realizo para e-commerces com alto volume de vendas, evito processar a atualização imediatamente dentro da chamada da API. Em vez disso, utilizo a biblioteca Action Scheduler (nativa do WooCommerce) para criar uma fila de processamento assíncrono:
“`php
function registrar_fila_atualizacao_estoque(WP_REST_Request $request) {
$dados = $request->get_json_params();
$sku = sanitize_text_field($dados[‘sku’]);
$quant = intval($dados[‘quantidade’]);
// Enfileira a tarefa para execução em segundo plano
as_enqueue_async_action(‘atualizar_estoque_produto_job’, array(‘sku’ => $sku, ‘quantidade’ => $quant));
return new WP_REST_Response(array(‘status’ => ‘enfileirado’), 202);
}
“`
### 3. Execução Segura via WooCommerce CRUD
No hook de execução do job agendado, utilizamos a API de CRUD nativa do WooCommerce. Isso garante a execução de todos os hooks internos do sistema, como o envio de e-mails de alerta de estoque baixo e a limpeza de transientes de cache:
“`php
add_action(‘atualizar_estoque_produto_job’, ‘processar_atualizacao_estoque_job’, 10, 2);
function processar_atualizacao_estoque_job($sku, $quantidade) {
$product_id = wc_get_product_id_by_sku($sku);
if ($product_id) {
$product = wc_get_product($product_id);
$product->set_stock_quantity($quantidade);
$product->save();
}
}
“`
## O Fluxo Inteligente do Processo
1. **Evento no ERP**: O sistema de gestão detecta a venda física e envia o novo saldo de estoque.
2. **Recepção Rápida**: O WooCommerce recebe a requisição, valida a segurança e enfileira a tarefa instantaneamente, liberando a conexão com o ERP em milissegundos.
3. **Processamento Assíncrono**: O Action Scheduler consome a fila em lotes controlados em segundo plano, preservando os recursos de processamento do servidor web.
4. **Atualização do Catálogo**: O cliente final visualiza o estoque correto no checkout sem sofrer com lentidão na página.
## Otimize a Integração da sua Loja Virtual
Desenvolver integrações robustas que respeitam os limites de hardware do seu servidor é fundamental para escalar um e-commerce sem dores de cabeça. Se a sua loja virtual apresenta travamentos durante a sincronização de produtos ou se você enfrenta problemas constantes de divergência de estoque, o desenvolvimento sob medida é o caminho mais seguro. Entre em contato para avaliarmos o seu cenário atual e estruturarmos uma consultoria técnica focada em performance e estabilidade.
