Adicionar item de linha ao pedido
A ação Adicionar item de linha ao pedido adiciona uma variante do produto ao pedido que inicia o workflow. Essa ação pode ser usada para adicionar uma variante do produto, gratuita ou paga, pela qual você pretende cobrar.
A ação Adicionar item de linha ao pedido é executada após a conclusão do checkout. Portanto, os clientes só saberão do item de linha se visualizarem o pedido.
Nesta página
Campos
A ação Adicionar item de linha ao pedido contém os seguintes campos.
| Campo | Descrição |
|---|---|
| Variante do produto | Obrigatório. Clique no botão Procurar neste campo para selecionar uma variante do produto na loja.Este campo também aceita um GID da variante do produto inserido manualmente para identificar o produto que será adicionado ao pedido. O formato do GID é gid://shopify/ProductVariant/, seguido do número de ID da variante.Por exemplo, ao visitar a página de uma variante no admin da Shopify, o URL na barra de endereços do navegador é https://admin.shopify.com/store/shopname/products/1234567/variants/36485954240671. O ID da variante é 36485954240671, e o GID da variante do produto é gid://shopify/ProductVariant/36485954240671. |
| Quantidade | Obrigatório. A quantidade de produto que o workflow adiciona a um pedido. A quantidade precisa ser maior que zero. Este campo é compatível com Liquid. Qualquer código Liquid precisa ser avaliado como um número. Caso contrário, ocorrerá um erro de tempo de execução. |
| Permitir variantes duplicadas | Quando essa opção está marcada, o workflow adiciona a quantidade da variante ao pedido, mesmo que a variante já faça parte do pedido. |
| Adicionar gratuitamente | Aplica um desconto de 100% ao item de linha. |
| Enviar atualizações do pedido por e-mail para o cliente | Quando essa opção está marcada, o workflow notifica o cliente sobre todas as alterações no pedido, incluindo pagamentos adicionais. |
| Nota no cronograma do pedido | Quando um texto é inserido, o workflow o adiciona como uma nota no cronograma do pedido. |
Acionadores
A ação Adicionar item de linha ao pedido tem um campo oculto adicionado pelo acionador. Esse campo, ID do pedido, identifica o pedido ao qual os itens de linha devem ser adicionados. O ID do pedido é definido por padrão e não pode ser alterado.
A ação Adicionar item de linha ao pedido pode ser usada em workflows que tenham uma ação "Obter dados do pedido" ou quaisquer acionadores que contenham um pedido, como:
- Pedido cancelado
- Pedido criado
- Pedido processado
- Pedido pago
- Risco do pedido analisado
- Transação do pedido criada
- Processamento de pedido criado
- Evento de processamento de pedido criado
- Reembolso criado
- Transação de pagamento criada
Limitações
Essa ação adiciona um item de linha sem considerar o estoque. Para adicionar um item de linha somente se o produto estiver em estoque, inclua uma condição antes da ação para verificar o estoque da variante a ser adicionada.
Detalhes da API
Para saber mais, consulte a mutação orderEditAddVariant.