Um pedido do WooCommerce pode conter vários produtos, mas muitos fluxos de trabalho precisam desses produtos separadamente. Talvez você queira uma linha de planilha por item, um registro de CRM por produto ou dados mais limpos para relatórios.
Em vez de mapear line_items[0], line_items[1], e assim por diante manualmente, você pode percorrer todo o itens_da_linha organizar e processar cada produto automaticamente. Este guia mostra como fazer isso no Bit Flows usando um iterador.
Mapear o WooCommerce itens_da_linha insira o array no Iterador Bit Flows e, em seguida, conecte a ação que você deseja executar em seguida.
O Iterador processa cada item de linha separadamente, de modo que um pedido com vários produtos pode criar linhas separadas no Planilhas Google, registros de CRM, mensagens ou outras ações sem mapeamento manual.
Percorrer os itens de um pedido do WooCommerce significa executar a mesma ação uma vez para cada linha de produto distinta em um pedido. Um pedido contendo duas camisetas e uma caneca de café tem dois itens de pedido, portanto o loop é executado duas vezes. A quantidade da camiseta é 2, mas ela continua sendo uma linha, a menos que você adicione intencionalmente outro loop baseado em quantidade.
| Item de linha | Quantidade | Iterador executado |
| Camiseta | 2 | 1 |
| Caneca de café | 1 | 1 |
| Total | 3 unidades | execuções de itens de linha |
Esta distinção importa porque um loop de itens de pedido responde “Quantas linhas de produtos diferentes existem no pedido?” Ele não responde “Quantas unidades no total foram compradas?” O WooCommerce fornece a quantidade dentro de cada item para que a próxima ação ainda possa ver que duas camisetas foram encomendadas.
Prepare estes itens antes de criar o fluxo de trabalho:
O fluxo de trabalho recomendado usa três nós: o WooCommerce inicia o fluxo, o Iterator divide a matriz line_items em itens atuais e o Google Planilhas adiciona uma linha para cada item atual. Você não precisa de um Agente de IA, Roteador ou Analisador JSON para uma resposta estruturada normal do WooCommerce.
No Bit Flows, crie um novo fluxo e adicione o WooCommerce como gatilho; em seguida, selecione “Ao criar um novo pedido”. Isso inicia o fluxo de trabalho sempre que o WooCommerce criar um novo pedido.
Antes de ir mais além, decida quando o fluxo deve ser executado. O gatilho "Ao Criar Novo Pedido" é disparado no momento em que um pedido é criado, o que, para a maioria dos checkouts, ocorre enquanto o pedido ainda está aguardando pagamento.
Abra o acionador e clique Ouça Resposta. O Bit Flows ficará à espera do próximo comando por cerca de três minutos.
Enquanto estiver ouvindo, abra sua loja em uma aba separada e faça um pedido de teste. Adicione pelo menos dois produtos diferentes ao carrinho, prossiga pelo processo de finalização de compra e conclua o pedido. Usar vários produtos ajudará você a ver como o loop lida com e processa mais de um item no mesmo pedido.
Quando o pedido é recebido, o Bit Flows captura a resposta. Você verá os dados do pedido, incluindo o id_do_pedido e um objeto de pedido que contém os detalhes de cobrança, totais e o itens_da_linha vetor.
Clique no ícone de mais após o gatilho e adicione a ferramenta Iterator. No campo Array, mapeie o pedido itens_da_linha do gatilho do WooCommerce. Mapeie line_items, não line_items[0].
Após um teste, expanda a saída do Iterador e você verá os campos para os produtos: product_id, product_name, quantity, subtotal, total, product_sku, product_unit_price, e muito mais. Estes são os campos que você enviará para a planilha. Use os exatos nomes dos campos mostrados na sua própria resposta capturada, já que eles podem variar dependendo da configuração da loja.
No Google Planilhas, crie uma planilha e adicione uma linha de cabeçalho. Use os campos que você deseja rastrear aqui, como detalhes do pedido, informações do cliente, detalhes do produto, informações de pagamento e status do pedido.
Após o Iterator, adicione o Google Sheets e escolha Adicionar Linha.
Para conectar o Google Sheets ao Bit Flows, acesse Console do Google Cloud, habilite a API do Google Drive e a API do Google Sheets, configure a tela de consentimento do OAuth e crie um aplicativo web OAuth usando a Origem JavaScript Autorizada e o URI de redirecionamento fornecidos pela Bit Flows. Em seguida, copie o ID do cliente e o segredo do cliente gerados e cole-os nos campos de conexão da Bit Flows. Para a configuração completa, siga as instruções do guia de integração oficial do Google Sheets.
Selecione sua conexão do Google, a planilha e a guia da planilha. Em seguida, mapeie cada coluna. Mantenha a divisão clara. Os campos em nível de pedido vêm do gatilho do WooCommerce e os campos em nível de produto vêm do Iterator:
Para Nome do Cliente, use Entrada Mista para que você possa combinar dois campos em uma coluna, como billing_first_name e billing_last_name. Misturar Entrada permite colocar texto estático e mais de um valor em um único campo de destino, enquanto o mapeamento normal passa um valor.
Mapeie o Total do Pedido para o total do pedido proveniente do gatilho, e não para o total de um item de linha. Cada linha do mesmo pedido mostrará o valor total do pedido. Esse valor se repete em cada linha de produto por design, portanto, trate-o como um rótulo, e não como um número a ser somado. Se preferir a receita por produto, adicione uma coluna Total da Linha e mapeie-a para o total do item atual do Iterador, que já contabiliza a quantidade.
Execute o fluxo e, em seguida, faça um pedido de teste com vários produtos diferentes para provar que o loop funciona.
O Iterator processa cada produto nessa ordem, e Adicionar Linha escreve uma linha por produto. Um pedido com três produtos produz três linhas, cada uma com seu próprio nome de produto, quantidade e preço, enquanto os campos do nível do pedido permanecem os mesmos em todas essas linhas.
Esse é o objetivo principal do loop: um único pedido com vários produtos se transforma em registros de produtos separados e utilizáveis, sem nunca selecionar line_items[0], line_items[1] e assim por diante manualmente.
Mapeando line_items[0] em vez de line_items. Isso envia apenas o primeiro produto para a planilha. Mapeie a matriz line_items completa para o Iterador para que cada produto seja processado.
Esperando uma linha por unidade. Uma quantidade de 3 ainda é um único item de linha e uma linha. Se você realmente precisar de uma linha por unidade, você adicionaria um segundo loop baseado na quantidade, que a maioria das lojas não precisa.
O Total do Pedido está exibindo o número errado. Se a coluna Total do Pedido mostrar o preço do primeiro produto, ou o mesmo valor pequeno em cada linha de um pedido grande, ela foi mapeada para o total de um item de linha em vez do total geral do pedido. Mapeie-a para o total geral do pedido do gatilho. Para receita por produto, adicione uma coluna Total da Linha mapeada para o total do item atual do Iterador.
Usando o gatilho de criação para uma planilha de vendas pagas. O gatilho "New Order Create" é disparado antes do pagamento, portanto, a planilha pode ser preenchida com pedidos pendentes ou abandonados. Use "Order Status Set" para "Processing" ou "Completed" quando quiser apenas pedidos pagos.
O Iterador é uma ferramenta que processa uma lista um item de cada vez. Você fornece a matriz de itens do pedido (line_items array) e ele executa a próxima ação uma vez para cada produto nessa matriz. Como ele entrega a próxima etapa um produto de cada vez, você pode mapear os campos desse produto diretamente para uma linha de planilha.
Um esclarecimento que evita confusão depois: o Iterador é executado uma vez por linha de produto, não uma vez por unidade. Se um cliente comprar três do mesmo telefone, isso ainda é um item de pedido e uma linha, com quantidade 3. Ele não cria três linhas.
Uma vez que o Iterator for mapeado para o WooCommerce itens_da_linha array, o restante do fluxo de trabalho se torna muito mais fácil de gerenciar. Você pode enviar cada produto para o Google Sheets ou qualquer outra ação conectada, mantendo os detalhes do pedido relacionados a ele.
Isso é especialmente útil quando sua automação precisa de dados estruturados em nível de produto em vez de um pedido do WooCommerce agrupado.
Os itens de linha de pedido do WooCommerce são as linhas de produtos distintas dentro de um pedido, com campos como ID do produto, ID da variação, quantidade, subtotal, imposto e total.
Use o Bit Flows: adicione um gatilho do WooCommerce, passe o array de itens de linha do pedido para um Iterator e, em seguida, adicione uma ação; ela será executada uma vez por produto, sem precisar de PHP.
Ele cria uma linha por linha de produto, não por unidade, portanto, uma quantidade de três ainda é um único item de linha com um valor de quantidade de três.
Use Em Novo Pedido Criado para capturar cada pedido na criação, ou Status do Pedido Definido como Processando ou Concluído quando você quiser apenas registrar pedidos pagos.
Sim, após o Iterator, é possível adicionar qualquer ação Bit Flows; assim, o mesmo loop pode criar registros no CRM, enviar e-mails ou publicar mensagens, uma por produto.
Não, quando line_items chega como uma matriz estruturada, você só precisa do Iterador, já que o JSON Parser é para texto JSON bruto e um Agente de IA é desnecessário para mapeamento fixo.
Sim, o gatilho do WooCommerce, o Iterator e a ação do Google Sheet estão todos incluídos no plano gratuito do Bit Flows; portanto, o fluxo de trabalho é executado sem a necessidade de um upgrade pago.
PT 
EN 
DE 
ES 
NL 
IT 
JA