Integração SAP Business One WooCommerce: documentos, estoque e NF-e

O WooCommerce é o canal mais permissivo desta lista — e é justamente por isso que ele exige mais disciplina do lado do SAP Business One. A REST API não documenta limite de requisição para wc/v3, o que significa que o teto real é a capacidade do servidor onde a loja roda, e não um número publicado.

A autenticação é por Consumer Key e Consumer Secret, geradas no próprio admin em WooCommerce → Settings → Advanced → REST API. Sobre HTTPS elas podem ir por HTTP Basic Auth; sem TLS, a especificação exige OAuth 1.0a one-legged. Produtos vivem em /wp-json/wc/v3/products e as variações em um sub-recurso próprio, /products/{id}/variations.

A diferença estrutural em relação a plataformas como VTEX ou Loja Integrada é que preço e estoque não têm endpoints dedicados: regular_price e stock_quantity são campos do próprio produto ou da variação. Toda alteração de saldo é, na prática, uma atualização de produto — o que torna o envio de deltas e o controle de concorrência responsabilidade inteira da integração. É o cenário em que a fila do lado do ERP importa mais que a velocidade do canal. Conheça os ERPs que integramos.

O que é a integração SAP Business One WooCommerce?

É a conexão automática entre o ERP SAP Business One e o WooCommerce, fazendo os dois sistemas trocarem dados sem intervenção manual.

A divisão de papéis não deveria ser negociável: o SAP Business One é a fonte oficial — controla estoque, preços, faturamento e fiscal. O WooCommerce é canal — apresenta o produto, capta o cliente e registra o pedido.

Por que integrar o SAP Business One exige atenção?

Porque um conector genérico ignora justamente o que faz o ERP funcionar:

• Servidor da loja derrubado pela própria integração. A REST API do WooCommerce não documenta limite de requisições para wc/v3. O teto real é a capacidade do servidor que hospeda a loja — e sem uma fila do lado do ERP, a integração é o próprio ataque.
• Atualizar saldo significa atualizar o produto inteiro. Não há endpoints dedicados: stock_quantity e regular_price são campos do produto ou da variação. Toda mudança de estoque é uma escrita no recurso completo, o que torna o controle de concorrência responsabilidade da integração.
• Variação tratada como produto. As variações vivem em um sub-recurso próprio, /products/{id}/variations. Ignorar isso publica a grade errada ou sobrescreve o produto pai.
• Pedido parado esperando digitação. O cliente já pagou e o pedido ainda não existe no ERP.
• Conciliação manual no fechamento. O que o canal registrou não bate com o que o ERP faturou.

O que a API do WooCommerce permite?

• A REST API autentica por Consumer Key e Consumer Secret, via HTTP Basic sobre HTTPS. Sem TLS, exige OAuth 1.0a.
• As chaves são geradas no próprio admin, em WooCommerce → Configurações → Avançado → REST API.
• Produtos ficam em /wp-json/wc/v3/products e pedidos em /wp-json/wc/v3/orders.
• Aqui preço e estoque são campos do produto (regular_price e stock_quantity), não endpoints separados — diferente de outras plataformas.
• Variações têm endpoint próprio, em /products/{id}/variations, com seus próprios campos de preço e estoque.

Por ser WordPress, a loja divide infraestrutura com o site. Uma sincronização mal dimensionada não degrada só o e-commerce: degrada a página inteira. O ritmo de atualização precisa ser pensado junto com a hospedagem.

Quais problemas surgem sem a integração entre SAP Business One e WooCommerce?

• Venda de produto sem estoque. O canal segue anunciando o que já saiu no ERP por outra via, e o cancelamento vem depois.
• Pedido parado esperando digitação. O cliente já pagou e o pedido ainda não existe no ERP.
• Preço desatualizado. A tabela mudou no ERP e o canal não acompanhou — margem errada ou venda perdida.
• Retrabalho fiscal. Pedido lançado às pressas gera nota com operação errada.
• Conciliação manual no fechamento. O que o canal registrou não bate com o que o ERP faturou.

Quanto custa continuar no manual?

O custo raramente aparece como linha de orçamento, e é por isso que passa despercebido. Ele aparece como uma pessoa dedicada a copiar pedido, como venda perdida por ruptura que não existia no estoque real, e como margem errada em item cujo preço mudou sem o canal acompanhar.

Enquanto o volume é baixo, dá para absorver. O problema é o teto: passado certo número de pedidos por dia, a digitação deixa de ser incômoda e passa a ser o que impede o canal de crescer.

Como funciona a integração ERP SAP Business One WooCommerce?

A Plugar.me opera como uma camada entre o SAP Business One e a API do WooCommerce. Ela traduz os dados de um lado para o outro, orquestra a ordem das operações e trata os erros que aparecem no caminho — porque eles aparecem.

Preço e estoque são campos, não endpoints

Parece detalhe, mas muda o desenho da sincronização. Como preço e estoque vivem dentro do recurso de produto, atualizar só o saldo significa enviar uma atualização de produto. Uma integração ingênua reenvia o cadastro inteiro a cada mudança de estoque — e sobrecarrega a loja à toa. O certo é enviar apenas o campo que mudou.

Como funciona o controle de estoque?

O saldo sai do SAP Business One e atualiza o canal. A pergunta relevante não é apenas “quanto tem”, e sim quanto pode ser vendido ali.

É comum não querer expor todo o saldo: parte está comprometida com pedidos em aberto, parte é de um depósito que não atende o canal. A integração precisa respeitar essa separação.

Como stock_quantity é campo do produto e da variação, e não recurso separado, cada atualização de saldo reescreve o registro inteiro. Isso muda o desenho: a integração precisa enviar deltas, agrupar alterações e serializar as escritas do mesmo SKU, senão duas atualizações próximas se sobrepõem e o saldo publicado deixa de refletir o SAP Business One.

Como funciona o faturamento e a emissão de notas fiscais?

A nota nasce no SAP Business One. É a regra que separa uma integração ERP First de um conector qualquer.

O pedido segue a cadeia de documentos da empresa e a NF-e é emitida com a operação fiscal correta, dentro do ERP. O canal recebe a informação do documento emitido; ele não substitui essa etapa. Seu fiscal continua sendo um só.

O WooCommerce não emite documento fiscal brasileiro — quando existe emissão, ela vem de um plugin de terceiro, e é justamente aí que costuma nascer a duplicidade. No modelo ERP First esse plugin fica de fora do fluxo: a NF-e é emitida no ERP, na operação fiscal correta, e a loja apenas exibe o documento ao comprador.

Qual é o fluxo completo, do clique à nota fiscal?

1. O cliente compra no WooCommerce.
2. A integração captura o pedido e o cria no SAP Business One, na operação correta.
3. O estoque é baixado no ERP e o saldo do canal é atualizado.
4. O pedido segue o fluxo interno de separação e conferência.
5. O faturamento é executado no SAP Business One e a NF-e é emitida.
6. Número da nota e rastreio voltam para o canal.
7. O painel da Plugar.me registra cada etapa em log, para auditoria.

Preciso desenvolver essa integração do zero?

Não existe conector nativo entre o SAP Business One e o WooCommerce. Os dois lados têm interface; ninguém fez a ponte por você. E a ponte não é só transporte de dados: é mapear a estrutura do ERP, respeitar os limites do canal e tratar o que falha.

O que costuma ser subestimado no desenvolvimento interno não é construir. É manter: o canal muda regra de API, muda exigência de cadastro, muda comportamento. Quem construiu internamente assume essa fila para sempre.

Quais os benefícios para distribuidoras, importadoras e indústrias?

• Volume sem headcount proporcional. Dobrar pedidos não significa dobrar gente digitando.
• Menos cancelamento. O saldo publicado passa a refletir o estoque real.
• Margem sob controle. O preço do canal sai da política definida no ERP.
• Fiscal em um lugar só. A nota nasce no SAP Business One, com a operação correta.
• Fechamento sem conciliação manual. O que aconteceu no canal está registrado no ERP.
• Rastreabilidade. Log de cada etapa, para quando algo precisar ser auditado.

Para quais empresas essa integração é indicada?

• Empresas que rodam SAP Business One e querem canal digital sem trocar de ERP.
• Operações com mais de um depósito, onde estoque e faturamento não são triviais.
• Negócios que precisam de fiscal correto por obrigação, não por preferência.

Se o volume é baixo e não há complexidade fiscal, o manual ainda se sustenta. A conta vira quando o volume cresce ou quando o erro passa a custar reputação.

Por que escolher uma integração ERP First para o SAP Business One?

Porque a alternativa é deixar o canal ditar a operação. Existe um modelo comum em que a plataforma vira o centro: o catálogo passa a viver nela, o pedido é tratado nela e o ERP recebe um resumo depois. Para quem investiu em SAP Business One, isso é inversão de comando.

• Estoque, preço e cadastro têm uma origem: o SAP Business One.
• A nota fiscal nasce no ERP, com a operação da sua empresa.
• O canal é canal — importante, mas não dono do dado.
• Se amanhã você abrir outro canal, a fonte da verdade não muda.

Como a Plugar.me realiza a integração SAP Business One WooCommerce?

A operação roda 100% em nuvem: não é preciso subir servidor nem manter estrutura adicional na sua infraestrutura.

1. Diagnóstico. Entender como o seu SAP Business One está configurado e o que a operação exige.
2. Mapeamento e setup. Definir de onde sai cada dado, qual operação o pedido do WooCommerce deve usar e qual saldo o canal enxerga.
3. Go-live assistido. Acompanhamento nos primeiros ciclos, quando os casos de exceção aparecem, com painel de logs para auditar cada etapa.

Conclusão: vale a pena integrar o SAP Business One ao WooCommerce?

Vale quando o WooCommerce deixa de ser teste e passa a ser canal. A partir daí, digitação manual não é economia: é o teto do canal e a origem dos erros que custam tempo e margem.

A integração bem feita não muda a forma como a sua empresa opera. Faz o contrário: garante que o canal se encaixe na operação que já existe no SAP Business One, em vez de obrigar a operação a se contorcer para caber no canal.

Quer avaliar como ficaria no seu cenário? Fale com a equipe da Plugar.me e conte como o seu SAP Business One está estruturado hoje: volume, estrutura de estoque e como funciona o seu faturamento.

Luan Carvalho

Luan Carvalho é fundador e CTO da Plugar.me, empresa especializada em integração de ERP com marketplaces e plataformas de e-commerce. Atua no desenvolvimento de soluções para automação de pedidos, estoque, preços, faturamento e documentos fiscais, ajudando empresas a escalarem suas operações com estabilidade, segurança e alto desempenho. Ao longo de sua trajetória, participa da implementação de integrações entre ERPs como SAP Business One, Protheus, WinThor, Consinco e Sankhya, conectando-os aos principais marketplaces e plataformas do mercado.