Entendendo a API REST do WooCommerce
A API REST do WooCommerce é como um conjunto de “canais” padronizados que permite que os proprietários de lojas conectem sua loja WooCommerce a outros aplicativos e serviços.
Aqui está uma explicação simples de como funciona:
-
Ela atua como uma ponte entre sua loja WooCommerce e aplicativos externos, permitindo que eles se comuniquem e compartilhem dados.
-
A API funciona enviando solicitações para endpoints específicos - pense neles como "canais" para diferentes tipos de dados da loja. Por exemplo, existem endpoints para produtos, pedidos e clientes.
-
Os aplicativos externos podem usar esses endpoints para:
- Obter informações (como buscar uma lista de produtos)
- Adicionar novos dados (como criar um novo pedido)
- Atualizar informações existentes (como alterar o preço de um produto)
- Excluir dados (como remover um produto desatualizado)
Em vez de depender de ganchos e filtros PHP (como muitos plugins tradicionais do WordPress fazem), ela funciona enviando e recebendo dados em um formato estruturado e previsível, conhecido como JSON.
Visualizando os Dados JSON no PDV
Para ajudar você a entender o que o PDV está “vendo”, incluímos uma visualização JSON em muitas partes da interface. Por exemplo, quando você edita o meta do pedido ou um item da linha do carrinho no PDV, você verá uma aba JSON (como na captura de tela abaixo).

Visualizando os dados JSON para um item da linha no PDV
O navegador também inclui um Inspecionador de Rede, uma ferramenta que permite monitorar os dados sendo enviados e recebidos entre seu navegador e o servidor, incluindo dados JSON.

Inspecionador de Rede no navegador
Por Que Alguns Plugins Não Funcionam no PDV?
O WCPOS baixa os dados de produtos, pedidos e clientes da sua loja WooCommerce através da API REST. Ele então mantém uma cópia local desses dados para que possa continuar funcionando mesmo se sua conexão com a internet for instável. Essa abordagem torna o PDV mais rápido e confiável em um ambiente de checkout movimentado.
No entanto, isso significa que nosso PDV não “vê” as mudanças que acontecem dinamicamente em seu site em tempo real. Por exemplo:
| Tipo de Plugin | Por Que Não Funciona |
|---|---|
| Precificação Dinâmica | Se outro plugin em sua loja calcular um preço exclusivo para cada cliente logado, o PDV não verá automaticamente esse preço personalizado. |
| Complementos de Produto | Se outro plugin em sua loja adicionar dados extras de produto, o PDV não verá automaticamente esses dados. O PDV apenas obtém os dados que são expostos através da API REST. |
Próximos Passos
Para um mergulho técnico mais profundo, confira a documentação oficial da API REST do WooCommerce: https://woocommerce.github.io/woocommerce-rest-api-docs/