WooCommerce
A integração com o WooCommerce conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 31 parâmetros distribuídos em 4 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis em Configurar parâmetros.
Categoria no catálogo do idworks: E-commerce.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Erros mais comuns
- "cURL Error: HTTP/2 stream … PROTOCOL_ERROR" — falha de conexão com a loja
- "Operation timed out after 15000 milliseconds" — loja sem responder
Referência rápida
O que é a integração WooCommerce?
É a conexão entre o canal WooCommerce e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é E-commerce), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → WooCommerce.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por WooCommerce e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Verificar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
4 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| ConsumerKey | Senha | (sem descrição cadastrada) |
| ConsumerSecret | Senha | (sem descrição cadastrada) |
| EndPoint | Texto | Endereço da loja, deve iniciar com HTTPS |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
Integração de Vendas
10 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Status pedido para integração (woocommerce) | Texto | pending, processing, on-hold, completed, cancelled, refunded, failed and trash. Default is pending. |
| Status pedido após integração (woocommerce) | Texto | Código do status na plataforma woocommerce para atualizar o pedido após importação |
| Status pedido enviado (woocommerce) | Texto | Código do status na plataforma woocommerce para atualizar o pedido após enviado |
| Status pedido entregue (woocommerce) | Texto | Código do status na plataforma woocommerce para atualizar o pedido após entrega realizada |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| Detalhar forma de pagamento | Sim/Não | Importar o detalhe da forma de pagamento utilizado pelo cliente, como cartão de crédito, boleto e etc. Exige realizar o DE/PARA de todas as formas |
| Enviar url de tracking após emitir NF | Sim/Não | Ative para enviar a url de tracking após a emissão da nota fiscal |
| Fechar pedido automaticamente | Sim/Não | Quando marcado, o idworks fecha o pedido integrado do canal de vendas através do hub. Se desmarcado, o pedido quando integrado permanece com o status de aberto para atualização manual. |
Integração de Produtos
16 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Atualizar saldo estoque | Sim/Não | Ative se quiser que a idworks atualize o saldo de estoque na integração. |
| Atualizar marca | Sim/Não | Ative se quiser enviar atualização de marca na integração |
| Atualizar categoria | Sim/Não | Ative se quiser enviar a atualização de categoria na integração |
| Atualizar imagem | Sim/Não | Ative se quiser enviar a atualização de imagem na integração |
| Atualizar preço | Sim/Não | Ative se quiser enviar a atualização de preço na integração |
| Atualizar produto | Sim/Não | Ative se quiser enviar a atualização de produto na integração |
| Atualizar SKU | Sim/Não | Ative se quiser enviar a atualização de SKU na integração |
| Criar oferta | Sim/Não | Ative se quiser criar a oferta automaticamente, se cadastro do SKU existir no marketplace |
| Valor de ajuste no preço | Decimal | Valor em R$ fixo a ser somado ao preço por (base) para compor o preço de venda. |
| Incluir dados adicionais items | Sim/Não | Ative se quiser incluir dados adicionais items |
| Chave dados adicionais | Texto | Informe a chave (key) dos dados adicionais do item |
| Indice dados adicionais | Inteiro | Informe o indice dos dados adicionais que deseja integrar |
| ID do atributo da marca | Texto | Colocar o ID do atributo da marca para que seja enviado essa informação para a plataforma |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| Armazéns para somar quantidade | Lista múltipla | Selecionar os armazéns que deve somar a quantidade para enviar aos canais de venda. Caso não seja preenchido, será enviado a quantidade do armazém que esta no de/para |
| Percentual disponibilidade de estoque | % | Valor base para utilizar do estoque em percentual. Ex. se tiver 100 unidades disponíveis e o percentual for 80% será enviado 80 para o canal |
Pedido
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Emitir nota fiscal após pedido conferido | Sim/Não | Ao ativar, a emissão da nota será coloca em uma fila após o pedido ter sido marcado como conferido (botão na aba info. adicionais) |
"cURL Error: HTTP/2 stream … PROTOCOL_ERROR" — falha de conexão com a loja
Mensagem "cURL Error: HTTP/2 stream 1 was not closed cleanly: PROTOCOL_ERROR (err 1)", geralmente repetida várias vezes em sequência. Não é erro do idworks nem da WooCommerce propriamente dita — é uma falha no transporte (a conexão HTTP/2 entre o idworks e o servidor da sua loja) que interrompeu a troca de dados no meio do caminho. As três causas mais comuns:
- Hospedagem da loja com sobrecarga ou instabilidade — o servidor que hospeda o WordPress + WooCommerce (cPanel, Hostinger, Hostgator, Locaweb, AWS, etc.) ficou sem CPU/memória, ou está em manutenção. É a causa mais frequente — lojas em planos compartilhados sofrem com isso em picos.
- CDN ou WAF (Cloudflare, Sucuri, BunnyCDN) bloqueando — algum filtro do CDN identificou o tráfego do idworks como suspeito e cortou a conexão no meio. Pode acontecer depois de mudança de IP do servidor do idworks ou aumento brusco do volume de chamadas.
- Versão de PHP / OpenSSL desatualizada na hospedagem que não suporta bem HTTP/2 com TLS recente — incompatibilidade do canal entre os dois lados.
O erro se repete em vários SKUs ao mesmo tempo (sintoma de problema no canal, não no produto).
Como resolver:
- Acesse a sua loja WooCommerce pelo navegador. Se ela está lenta, caindo ou exibe erro 5xx, o problema está confirmado na hospedagem.
- Acione o suporte da hospedagem com os horários em que o erro apareceu e peça revisão de CPU/memória, logs de erro do servidor e estado do PHP.
- Se você usa Cloudflare ou outro CDN, entre no painel e procure por bloqueios recentes do IP do idworks. Adicione o IP nas exceções de WAF (whitelist) se for o caso.
- Aguarde a hospedagem voltar e refaça a sincronização — o idworks tenta de novo automaticamente, mas você pode forçar pelo Hub → Anúncios → Sincronizar.
- Se acontece com frequência (mais de uma vez por semana), considere migrar para uma hospedagem com plano mais robusto, ou habilitar cache/CDN bem configurado.
Esse erro é distinto do timeout (que tem mensagem diferente — veja abaixo). O PROTOCOL_ERROR significa que a conexão chegou a abrir mas caiu no meio; o timeout significa que nem respondeu.
"Operation timed out after 15000 milliseconds" — loja sem responder
Mensagem "cURL Error: Operation timed out after 15001 milliseconds with 0 bytes received" (o valor pode variar — 15.000, 15.001, 30.000 ms). O idworks abriu a conexão com a loja WooCommerce, esperou até 15 segundos (o tempo máximo configurado), e nada veio do outro lado. A chamada foi cortada para não travar o resto da fila.
A causa é praticamente sempre lentidão extrema do servidor que hospeda o WordPress + WooCommerce:
- Pico de tráfego (campanha, promoção, ataque) ocupando todo o servidor.
- Plugin pesado consumindo o tempo do PHP (sobretudo plugins de SEO, segurança, ou variações com cálculo complexo).
- Banco de dados sem otimização (índices faltando, tabelas com milhões de pedidos antigos).
- Plano de hospedagem compartilhada sendo afetado por outro site no mesmo servidor.
As operações mais afetadas costumam ser as de listagem de pedidos e atualização de estoque em massa — o WooCommerce naturalmente leva mais tempo nessas consultas.
Como resolver:
- Confira a velocidade da sua loja em uma ferramenta de medição de performance de sites. Se o tempo de resposta passa de 3 segundos, é sinal de hospedagem fraca para integração.
- Acione o suporte da hospedagem para revisar performance do banco — pedido para limpar pedidos antigos, otimizar tabelas e aumentar limite de memória do PHP (mínimo 512 MB para lojas com integração).
- Desative temporariamente plugins pesados (segurança extra, monitoria, SEO) e veja se o timeout desaparece. Reative um a um para achar o culpado.
- Se a operação acontece sempre no mesmo horário (madrugada do início do mês, por exemplo), pode ser backup automático travando o servidor. Combine com a hospedagem para mudar a janela.
- Para lojas com mais de 5.000 pedidos/mês, considere migrar para plano dedicado ou cloud com PHP-FPM bem dimensionado.
O timeout é um sintoma da loja, não do idworks. Aumentar o tempo de espera só atrasaria todos os outros canais sem resolver o problema raiz.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |