Aprenda a ligar a sua loja WooCommerce à aplicação RO App para importar automaticamente ordens, produtos e clientes. Depois de configurado, todos os novos dados são sincronizados em tempo real, tornando a gestão de ordens rápida e simples.
⭐ Esta integração está disponível a partir do plano de subscrição All-in-One.
Passo 1. Prepare as credenciais da API WooCommerce
1. No seu perfil WooCommerce, aceda a WooCommerce > Settings > Advanced > REST API.
2. Clique em Add key.
3. Preencha o campo:
Description – adicione o nome da chave (por exemplo, RO App),
User – escolha o utilizador para o qual está a criar a chave,
Permissions – escolha a opção Read/Write.
4. Clique em Generate API key.
5. Copie e salve a Consumer key e o Consumer secret, pois eles são exibidos apenas uma vez. Você precisará deles para conectar a sua loja ao RO App.
Tenha em atenção que, ao integrar com o WooCommerce, é importante ter em conta que podem ser configuradas restrições de acesso com base em endereços IP ou geolocalização (geobloqueio) no próprio site. Saiba mais sobre como configurar uma lista de endereços IP autorizados no WooCommerce.
Passo 2. Ligue a sua loja WooCommerce à RO App
1. Vá para Configurações > E-commerce Connect.
2. Clique em + Loja e marque a caixa de seleção integração habilitada.
3. No campo Fonte, selecione WooCommerce.
4. Preencha todos os campos obrigatórios:
Nome — nome da loja;
URL do site — link para o seu site WooCommerce (por exemplo, https://shopname.com/)
Consumer key — cole a chave do consumidor (Consumer key) que criou no seu perfil WooCommerce;
Consumer secret — cole o segredo do consumidor (Consumer secret);
Localizações — selecione as localizações onde as encomendas do WooCommerce serão criadas;
Tipo — selecione o tipo de encomenda que será definido para as encomendas importadas do WooCommerce;
💡 Dica
Crie um tipo de encomenda especial apenas para encomendas do WooCommerce e configure os campos necessários nele.
Também pode definir valores predefinidos para esses campos. Se a plataforma não fornecer um valor para um campo específico ao importar ordens de serviço, esse campo será preenchido automaticamente com o valor especificado no editor de formulários.
Gerentes — selecione os funcionários que serão designados como gerentes para as ordens importadas.
Observação: para que a integração funcione corretamente, os funcionários designados pelos gerentes para essas ordens devem ter o direito Exibir funcionário na lista de gerentes ativado.
Identificar produtos por — selecione o parâmetro (nome, SKU ou ID do produto) pelo qual os produtos da plataforma serão identificados quando forem atualizados nas ordens do RO App. Isso é necessário para evitar a duplicação de produtos.
5. Clique em Continue.
Passo 3. Corresponda os status e importe os seus dados
Nesta etapa, precisa corresponder os status do WooCommerce com os status correspondentes no RO App.
Passo 4. Mapear de impostos
A coluna «WooCommerce impostos» apresenta os impostos configurados na sua conta do WooCommerce. Lista os respetivos nomes e taxas de imposto.
No WooCommerce, pode configurar os impostos no seu painel, na página WooCommerce > Configurações > Impostos >, no separador Taxas Padrão. Também pode adicionar outras classes de impostos (grupos) e atribuir as taxas de imposto correspondentes a esses grupos. O WooCommerce transfere todas as taxas existentes na sua conta.
A coluna «RO App impostos» apresenta os códigos dos impostos ativados no RO App. Se, após o mapeamento, um imposto for desativado no RO App, deixará de ser aplicado às ordens de serviço.
No RO App, pode adicionar e configurar impostos na página Configurações > Finanças. Para garantir que os impostos são aplicados corretamente, deve mapear corretamente o seu tipo — incluído ou adicionado.
O tipo é determinado pelo facto de a taxa de imposto no WooCommerce estar marcada como «Composta»:
Impostos compostos do WooCommerce — mapeie-os para impostos exclusivos na RO App;
Impostos não compostos do WooCommerce — mapeie-os para impostos inclusos no RO App.
O indicador «Composto» é configurado separadamente para cada taxa de imposto na página WooCommerce → Configurações → Impostos (na coluna «Composto»), em vez de ser definido para toda a loja de uma só vez. Por conseguinte, podem coexistir simultaneamente taxas compostas e não compostas numa única conta do WooCommerce — tal como os impostos inclusos e os impostos exclusivos podem ser aplicados simultaneamente no RO App.
Se os impostos forem mapeados incorretamente (por exemplo, um imposto composto no WooCommerce com um imposto inclusivo na RO App), o montante do imposto na ordem de serviço será calculado incorretamente.
Se já tiver ordens de serviço ativas (não concluídas) sincronizadas e tiver configurado o mapeamento de impostos posteriormente, atualize manualmente os dados nessas ordens de serviço. Após a atualização, os impostos serão aplicados às mesmas. Nas novas ordens de serviço sincronizadas após o mapeamento de impostos, os impostos serão aplicados automaticamente.
Como os impostos são calculados no WooCommerce
Para além do tipo de taxa de imposto (com impostos incluídos/excluídos), existe outra configuração que afeta o montante do imposto e o total da encomenda — Preços inseridos com imposto (WooCommerce → Configurações → Impostos). Esta configuração determina o significado do preço que introduz na ficha do produto:
Sim, os valores serão introduzidos com impostos — o preço que introduz é o preço final e já inclui todos os impostos. O WooCommerce calcula o preço líquido do produto a partir desse valor, e os impostos são simplesmente apresentados em linhas separadas — o total da ordem de serviço é igual ao preço que introduziu.
Não, os valores serão introduzidos sem impostos — o preço que introduzir é o preço base líquido do produto (excluindo impostos). Todos os impostos são calculados e adicionados a esse valor, pelo que o total da ordem de serviço será superior ao preço que introduziu para o produto.
Importante: Estas configurações afetam apenas o cálculo de montantes no WooCommerce e não afetam a forma como os tipos de imposto são mapeados na RO App — para o mapeamento, baseie-se sempre exclusivamente no atributo «Composto» para uma taxa de imposto específica.
Tenha em atenção este caso especial: se tiver várias taxas compostas configuradas ao mesmo tempo, o WooCommerce calcula-as sequencialmente — na ordem especificada na coluna «Prioridade» na página «Taxas Padrão». Cada taxa composta subsequente é aplicada ao montante total, incluindo a taxa anterior, em vez de ser aplicada ao preço líquido do produto.
Passo 5. Importar dados
Depois de corresponder todos os valores, certifique-se de que tudo está correto e clique no botão Salvar e importar ordens.
Depois disso, será realizada uma importação única de ordens, produtos e clientes do WooCommerce para o RO App. O processo pode demorar algum tempo, dependendo do número de ordens a serem importadas. Graças à sincronização adicional, todas as novas ordens da plataforma WooCommerce serão automaticamente enviadas para o RO App, e os dados em todas as ordens importadas serão atualizados a cada minuto.
Observação: todas as ordens criadas nos últimos 2 meses serão importadas, exceto as ordens com os status Completed, Cancelled, Refunded, Failed, Trash.
Como editar e eliminar uma integração
Para editar as configurações de integração, abra a integração desejada, faça as alterações e salve as configurações.
Para eliminar uma integração com uma loja, abra-a, clique no botão Eliminar e confirme a ação.