Saltar para o conteúdo
Tejobit

Comércio

Integração WooCommerce

Liga a loja WooCommerce à faturação, aos pagamentos portugueses e às transportadoras, por webhooks e REST API.

Pedir esta integração Ver todas as integrações

Visão geral

WooCommerce

O WooCommerce é a loja online mais comum entre pequenos negócios portugueses, por correr sobre WordPress e ter um plugin para quase tudo. O preço disso é uma loja lenta, plugins em conflito e atualizações que partem a faturação na pior altura.

A Tejobit tira esse trabalho de dentro do WordPress. A ligação ouve os webhooks do WooCommerce, como order.created e order.updated, e usa a REST API para ler e atualizar encomendas, clientes e produtos. A faturação, o envio e o stock passam a ser tratados fora da loja, num serviço que não depende das atualizações dos plugins.

Quando a encomenda passa a «Em processamento», a fatura é emitida; quando a etiqueta é criada, o número de seguimento volta para a encomenda e segue no email ao cliente.

Casos de uso

Para que serve

  • Loja de cosmética natural que emite a fatura no Moloni quando a encomenda fica paga
  • Garrafeira online que pede a etiqueta CTT e envia o seguimento ao cliente
  • Marca de roupa com stock partilhado entre loja física e WooCommerce
  • Loja que gera referências Multibanco no checkout e só avança depois do callback
  • Negócio que quer as encomendas também numa folha para a equipa do armazém
IN

O que a ligação escuta

  • Webhook order.created quando entra uma encomenda
  • order.updated nas mudanças de estado (em processamento, concluída, reembolsada)
  • product.updated para alterações de preço ou stock
  • Confirmação de pagamento vinda do gateway
OUT

O que a ligação faz

  • Emitir fatura ou fatura-recibo no programa de faturação, com o NIF do checkout
  • Criar a expedição na transportadora e guardar o número de seguimento na encomenda
  • Atualizar o estado da encomenda pela REST API
  • Sincronizar stock com outro canal ou com o armazém
  • Criar notas de crédito em reembolsos

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Chaves da REST API do WooCommerce (consumer key e secret) com permissão de leitura e escrita
  • Um campo de NIF no checkout, se a loja ainda não o tiver
  • Regras de estados: quando se fatura e quando se expede
  • Acesso à conta do programa de faturação e da transportadora

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • Os webhooks do WooCommerce dependem do cron do WordPress e podem atrasar em alojamentos fracos
  • Plugins que alteram encomendas ou o checkout podem mudar o formato dos dados e exigir ajustes
  • A loja precisa de HTTPS e de a REST API não estar bloqueada por plugins de segurança

Perguntas frequentes

Antes de começar

Porque não usar um plugin de faturação?

Os plugins funcionam até deixarem de funcionar, normalmente depois de uma atualização. Com a ligação fora do WordPress, a loja fica mais leve e a faturação não para por causa de um conflito.

A ligação funciona com HPOS?

Sim. A ligação usa a REST API e os webhooks, que funcionam da mesma forma com o armazenamento de encomendas de alto desempenho.

E se um webhook falhar?

O WooCommerce desativa webhooks que falham muitas vezes seguidas. A ligação faz também uma verificação periódica pela REST API, para apanhar qualquer encomenda que tenha escapado.

Posso faturar só encomendas pagas?

Sim. A regra de faturação é definida pelo estado: por exemplo, só ao passar a «Em processamento» ou a «Concluída».

Integrações relacionadas

Ver todas as integrações

Ativar a integração WooCommerce?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com