Shopify
Administrar produtos, pedidos, clientes e estoque de uma loja Shopify.
O que faz
Gerencie no Shopify produtos e variantes, pedidos, clientes, estoque, coleções e o atendimento de pedidos (fulfillment) feito pelo próprio lojista, usando a Admin GraphQL API 2026-10. Encontre pedidos de atendimento, envie os itens selecionados, atualize o rastreamento e acompanhe os jobs de cancelamento. Continue listas e resultados aninhados com os cursores de paginação retornados. Ativar um produto não o publica nos canais de venda. Os pedidos normalmente cobrem os últimos 60 dias; pedidos m….
Quando usar: Use quando o seu fluxo precisar administrar produtos, pedidos, clientes e estoque de uma loja Shopify.
Exemplo de situação: Consultar um pedido ou executar uma ação comercial durante o atendimento.
Antes de começar
Conexão necessária: OAuth.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Passo a passo
- Adicione Shopify ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Criar produto | Cria produto com o bloco Shopify. |
| Obter produto | Obtém produto com o bloco Shopify. |
| Listar produtos | Lista produtos com o bloco Shopify. |
| Atualizar produto | Atualiza produto com o bloco Shopify. |
| Excluir produto | Exclui produto com o bloco Shopify. |
| Obter pedido | Obtém pedido com o bloco Shopify. |
| Listar pedidos | Lista pedidos com o bloco Shopify. |
| Atualizar pedido | Atualiza pedido com o bloco Shopify. |
| Cancelar pedido | Cancela pedido com o bloco Shopify. |
| Criar cliente | Cria cliente com o bloco Shopify. |
| Obter cliente | Obtém cliente com o bloco Shopify. |
| Listar clientes | Lista clientes com o bloco Shopify. |
| Atualizar cliente | Atualiza cliente com o bloco Shopify. |
| Excluir cliente | Exclui cliente com o bloco Shopify. |
| Listar itens de estoque | Lista itens de estoque com o bloco Shopify. |
| Obter nível de estoque | Obtém nível de estoque com o bloco Shopify. |
| Ajustar estoque | Ajusta estoque com o bloco Shopify. |
| Listar locais | Lista locais com o bloco Shopify. |
| Criar atendimento do pedido | Cria atendimento do pedido com o bloco Shopify. |
| Listar coleções | Lista coleções com o bloco Shopify. |
| Obter coleção | Obtém coleção com o bloco Shopify. |
Campos
Ordenar por
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar produtos
- Opções:
- Padrão do Shopify · Criado em · ID · Estoque total · Tipo de produto · Publicado em · Relevância · Título · Atualizado em · Fornecedor
- Exemplo:
- Padrão do Shopify
Ordenar por
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar pedidos
- Opções:
- Padrão do Shopify · Criado em · Preço total atual · Nome do cliente · Destino · Status financeiro · Status do atendimento · ID · Número do pedido · Número do pedido de compra · Processado em · Relevância · Quantidade total de itens · Preço total · Atualizado em
- Exemplo:
- Padrão do Shopify
Ordenar por
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar clientes
- Opções:
- Padrão do Shopify · Criado em · ID · Local · Nome · Relevância · Atualizado em
- Exemplo:
- Padrão do Shopify
Ordenar por
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar coleções
- Opções:
- Padrão do Shopify · ID · Relevância · Título · Atualizado em
- Exemplo:
- Padrão do Shopify
Ordenar por
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar locais
- Opções:
- Padrão do Shopify · ID · Nome · Relevância
- Exemplo:
- Padrão do Shopify
Inverter ordenação
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Listar produtos, Listar pedidos, Listar clientes, Listar coleções, Listar locais, Listar itens de estoque
- Padrão:
- false
Incluir locais legados
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Listar locais
- Padrão:
- false
Consulta de busca
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Listar locais
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Criar produto · Obter produto · Listar produtos · Atualizar produto · Excluir produto · Obter pedido · Listar pedidos · Atualizar pedido · Cancelar pedido · Criar cliente · Obter cliente · Listar clientes · Atualizar cliente · Excluir cliente · Listar itens de estoque · Obter nível de estoque · Ajustar estoque · Listar locais · Criar atendimento do pedido · Listar coleções · Obter coleção
- Padrão:
- Listar produtos
- Exemplo:
- Criar produto
Conta do Shopify
ObrigatórioSeleciona a conta já conectada que autoriza o acesso ao serviço.
- Exemplo:
- (escolha a conta conectada)
Conta do Shopify
ObrigatórioEm campos adicionaisInforma manualmente a credencial usada pela integração no modo avançado.
Domínio da loja
Detectado automaticamente pelo OAuth ou informe manualmente.
- Exemplo:
- Detectado automaticamente pelo OAuth ou informe manualmente
ID do produto
Obrigatório conforme a operaçãoInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Obter produto, Atualizar produto, Excluir produto
- Exemplo:
- id-do-recurso
Título do produto
Obrigatório conforme a operaçãoInforme o título do produto.
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- Exemplo de atendimento
Descrição (HTML)
Informe a descrição do produto.
- Aparece em:
- Criar produto, Atualizar produto
Tipo de produto
Categoria livre do produto na loja Shopify, usada para organizar e filtrar o catálogo (ex.: Calçados ou Eletrônicos).
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- Calçados, Eletrônicos
Fornecedor
Informe o nome do fornecedor.
- Aparece em:
- Criar produto, Atualizar produto
Tags
Tags do produto na Shopify, separadas por vírgula, usadas para organizar, filtrar e montar coleções automáticas (ex.: verão, promoção, mais-vendidos).
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- tag1, tag2, tag3 (separadas por vírgula)
Status
Escolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar produto, Atualizar produto
- Opções:
- Ativo · Rascunho · Arquivado · Não listado · Usar o padrão / manter como está
- Exemplo:
- Ativo
Consulta de busca
Em campos adicionaisFiltrar produtos (opcional).
- Aparece em:
- Listar produtos
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Consulta de busca
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Listar clientes
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Consulta de busca
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Listar itens de estoque
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Incluir detalhes expandidos
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Listar produtos, Listar pedidos, Atualizar pedido
- Exemplo:
- false
Máximo de resultados
Em campos adicionaisQuantos registros a listagem da Shopify vai trazer: padrão 50 e máximo 250, com limites menores quando os detalhes vêm expandidos (20 produtos ou 10 pedidos).
- Aparece em:
- Listar produtos, Listar pedidos, Listar clientes, Listar itens de estoque, Listar locais, Listar coleções, Obter nível de estoque
- Exemplo:
- Padrão 50, máximo 250; com detalhes expandidos: produtos 20/pedidos 10; pedidos de atendimento 20
ID do pedido
Obrigatório conforme a operaçãoInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Obter pedido, Atualizar pedido, Cancelar pedido
- Exemplo:
- id-do-recurso
Status do pedido
Escolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar pedidos
- Opções:
- Qualquer · Aberto · Fechado · Cancelado
- Padrão:
- Qualquer
Consulta de busca
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Listar pedidos
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Observação do pedido
Informe a observação do pedido.
- Aparece em:
- Atualizar pedido
E-mail do cliente
Informa o destinatário ou endereço de e-mail usado pela operação.
- Aparece em:
- Atualizar pedido
- Exemplo:
- cliente@exemplo.com
Tags do pedido
Tags do pedido na Shopify, separadas por vírgula, úteis para organizar e filtrar pedidos (ex.: atacado, prioridade).
- Aparece em:
- Atualizar pedido
- Exemplo:
- tag1, tag2, tag3 (separadas por vírgula)
Motivo do cancelamento
Obrigatório conforme a operaçãoEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Cancelar pedido
- Opções:
- Solicitação do cliente · Pagamento recusado · Fraude · Problema de estoque · Erro da equipe · Outro
- Padrão:
- Outro
- Exemplo:
- Solicitação do cliente
Observação da equipe
Observação interna sobre este cancelamento.
- Aparece em:
- Cancelar pedido
- Exemplo:
- Observação interna sobre este cancelamento
Devolver ao estoque
Obrigatório conforme a operaçãoAtiva ou desativa este comportamento.
- Aparece em:
- Cancelar pedido
- Padrão:
- false
Notificar o cliente
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Cancelar pedido
- Padrão:
- false
Reembolsar no método de pagamento original
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Cancelar pedido
- Padrão:
- false
ID do cliente
Obrigatório conforme a operaçãoInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Obter cliente, Atualizar cliente, Excluir cliente
- Exemplo:
- id-do-recurso
E-mail
Informa o destinatário ou endereço de e-mail usado pela operação.
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- cliente@exemplo.com
Nome
Informe o nome.
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- Exemplo de atendimento
Sobrenome
Informe o sobrenome.
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- Exemplo de atendimento
Telefone
Identifica a conversa, o canal ou o telefone de destino.
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- +5511999999999
Observação sobre o cliente
Informe uma observação sobre o cliente.
- Aparece em:
- Criar cliente, Atualizar cliente
Tags do cliente
Tags do cliente na Shopify, separadas por vírgula, úteis para segmentar a base (ex.: vip, atacado).
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- vip, atacado (separadas por vírgula)
ID do item de estoque
Obrigatório conforme a operaçãoInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Obter nível de estoque, Ajustar estoque
- Exemplo:
- id-do-recurso
ID do local
Obrigatório conforme a operaçãoInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Obter nível de estoque, Ajustar estoque
- Exemplo:
- id-do-recurso
Variação da quantidade
Obrigatório conforme a operaçãoPositivo para somar, negativo para subtrair.
- Aparece em:
- Ajustar estoque
- Exemplo:
- Positivo para somar, negativo para subtrair
ID do pedido de atendimento
Obrigatório conforme a operaçãoInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- id-do-recurso
Código de rastreamento
Informe o código de rastreamento.
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- 10
Transportadora
Nome da transportadora que vai entregar o pedido, informado junto com o código de rastreio (ex.: Correios).
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- UPS, FedEx, USPS, DHL
URL de rastreamento
Informa o endereço seguro do serviço ou recurso que será acessado.
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- https://api.exemplo.com/v1/recurso
Notificar o cliente
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Criar atendimento do pedido
- Padrão:
- true
Incluir locais inativos
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Listar locais
- Padrão:
- false
ID da coleção
Obrigatório conforme a operaçãoInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Obter coleção
- Exemplo:
- id-do-recurso
Consulta de busca
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Listar coleções
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
Máximo de produtos da coleção
Em campos adicionaisQuantos produtos da coleção trazer junto com ela: padrão 50 e máximo 250.
- Aparece em:
- Obter coleção
- Exemplo:
- Padrão 50, máximo 250
Identificador (handle)
Em campos adicionaisIdentificador do produto usado na URL (handle).
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- Identificador do produto usado na URL (handle)
SEO
Em campos adicionaisObjeto SEOInput com título (title) e descrição (description).
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- { "chave": "valor" }
Categoria
Em campos adicionaisGID da categoria na taxonomia de produtos.
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- GID da categoria na taxonomia de produtos
Sufixo do modelo
Em campos adicionaisSufixo do modelo do tema.
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- Sufixo do modelo do tema
Metacampos
Em campos adicionaisLista de MetafieldInput: namespace, key, type, value ou id.
- Aparece em:
- Criar produto, Atualizar produto, Criar cliente, Atualizar cliente, Atualizar pedido
- Exemplo:
- { "chave": "valor" }
Adicionar às coleções
Em campos adicionaisGIDs das coleções em que o produto será incluído.
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- { "chave": "valor" }
Exige plano de venda
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar produto, Atualizar produto
- Opções:
- Usar o padrão / manter como está · Sim · Não
- Exemplo:
- Usar o padrão / manter como está
Opções do produto
Em campos adicionaisLista de OptionCreateInput com name e values: [{name: "Tamanho", values: [{name: "Pequeno"}]}].
- Aparece em:
- Criar produto
- Exemplo:
- { "chave": "valor" }
Mídia
Em campos adicionaisLista de CreateMediaInput com originalSource, mediaContentType e, opcionalmente, alt.
- Aparece em:
- Criar produto, Atualizar produto
- Exemplo:
- { "chave": "valor" }
Remover das coleções
Em campos adicionaisGIDs das coleções das quais o produto será removido.
- Aparece em:
- Atualizar produto
- Exemplo:
- { "chave": "valor" }
Redirecionar para o novo identificador
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Atualizar produto
- Opções:
- Usar o padrão / manter como está · Sim · Não
- Exemplo:
- Usar o padrão / manter como está
Endereços
Em campos adicionaisLista de MailingAddressInput; substituir endereços foi descontinuado pelo Shopify.
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- Avenida Paulista, 1000, São Paulo - SP
Idioma (locale)
Em campos adicionaisIdioma do cliente, como en.
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- pt-BR
Isento de impostos
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar cliente, Atualizar cliente
- Opções:
- Usar o padrão / manter como está · Sim · Não
- Exemplo:
- Usar o padrão / manter como está
Consentimento de marketing por e-mail
Em campos adicionaisCustomerEmailMarketingConsentInput com marketingState, marketingOptInLevel, consentUpdatedAt.
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- cliente@exemplo.com
Consentimento de marketing por SMS
Em campos adicionaisCustomerSmsMarketingConsentInput com marketingState, marketingOptInLevel, consentUpdatedAt.
- Aparece em:
- Criar cliente, Atualizar cliente
- Exemplo:
- { "chave": "valor" }
Endereço de entrega
Em campos adicionaisObjeto MailingAddressInput com firstName, lastName, address1, address2, city, provinceCode, countryCode, zip e phone.
- Aparece em:
- Atualizar pedido
- Exemplo:
- Avenida Paulista, 1000, São Paulo - SP
Atributos personalizados
Em campos adicionaisAtributos do pedido como uma lista de objetos {key, value}.
- Aparece em:
- Atualizar pedido
- Exemplo:
- { "chave": "valor" }
Número do pedido de compra
Em campos adicionaisNúmero do pedido de compra.
- Aparece em:
- Atualizar pedido
- Exemplo:
- 10
Cursor de paginação
Em campos adicionaisCursor obtido em pageInfo.endCursor.
- Aparece em:
- Listar produtos, Listar pedidos, Listar clientes, Listar itens de estoque, Listar locais, Listar coleções, Obter nível de estoque
- Exemplo:
- Cursor obtido em pageInfo.endCursor
Itens a enviar
Em campos adicionaisInforma dados estruturados ou código no formato exigido pelo campo.
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- { "chave": "valor" }
Origem do envio
Em campos adicionaisInforma dados estruturados ou código no formato exigido pelo campo.
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- Avenida Paulista, 1000, São Paulo - SP
Mensagem do envio
Em campos adicionaisInforma a mensagem que será enviada ou processada.
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Códigos de rastreamento
Em campos adicionaisDefine um valor numérico, quantidade ou limite da operação.
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- { "chave": "valor" }
URLs de rastreamento
Em campos adicionaisInforma dados estruturados ou código no formato exigido pelo campo.
- Aparece em:
- Criar atendimento do pedido
- Exemplo:
- https://api.exemplo.com/v1/recurso
Chave de idempotência
Em campos adicionaisOpcional: reutilize a mesma chave ao tentar de novo este ajuste de estoque.
- Aparece em:
- Ajustar estoque
Motivo do ajuste de estoque
Em campos adicionaisMotivo do ajuste de estoque registrado na Shopify: correction (correção, o padrão), received (mercadoria recebida), damaged (avaria) ou promotion (promoção).
- Aparece em:
- Ajustar estoque
- Exemplo:
- correction (correção, padrão), received (recebido), damaged (danificado) ou promotion (promoção)
Quantidade de estoque
Em campos adicionaisDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Ajustar estoque
- Opções:
- Disponível · Em estoque
- Padrão:
- Disponível
URI do documento de referência
Em campos adicionaisInforma o endereço seguro do serviço ou recurso que será acessado.
- Aparece em:
- Ajustar estoque
- Exemplo:
- https://api.exemplo.com/v1/recurso
URI do documento de lançamento (ledger)
Obrigatório conforme a operaçãoInforma o endereço seguro do serviço ou recurso que será acessado.
- Aparece em:
- Ajustar estoque
- Exemplo:
- https://api.exemplo.com/v1/recurso
Quantidade atual esperada
Em campos adicionaisQuantidade em estoque esperada, opcional, conferida antes de alterar (compare-and-swap).
- Aparece em:
- Ajustar estoque
- Exemplo:
- cliente@exemplo.com
Forma de reembolso
Em campos adicionaisReembolsa somente pelo meio de pagamento original. Deixe vazio para cancelar sem reembolso. Crédito na loja não é suportado por esta ação.
- Aparece em:
- Cancelar pedido
- Exemplo:
- { "chave": "valor" }
Telefone do pedido
Em campos adicionaisIdentifica a conversa, o canal ou o telefone de destino.
- Aparece em:
- Atualizar pedido
- Exemplo:
- +5511999999999
Variantes por página
Em campos adicionaisQuantas variantes do produto, como tamanhos e cores, trazer junto com ele: padrão 50 e máximo 100.
- Aparece em:
- Obter produto
- Exemplo:
- Padrão 50, máximo 100
Cursor de paginação das variantes
Em campos adicionaisCursor obtido em product.variants.pageInfo.endCursor.
- Aparece em:
- Obter produto
- Exemplo:
- Cursor obtido em product.variants.pageInfo.endCursor
Imagens por página
Em campos adicionaisQuantas imagens do produto trazer junto com ele: padrão 20 e máximo 100.
- Aparece em:
- Obter produto
- Exemplo:
- Padrão 20, máximo 100
Cursor de paginação das imagens
Em campos adicionaisCursor obtido em product.images.pageInfo.endCursor.
- Aparece em:
- Obter produto
- Exemplo:
- Cursor obtido em product.images.pageInfo.endCursor
Itens do pedido por página
Em campos adicionaisQuantos itens do pedido trazer junto com ele, até no máximo 50 (o padrão).
- Aparece em:
- Obter pedido
- Exemplo:
- Padrão 50, máximo 50
Cursor de paginação dos itens do pedido
Em campos adicionaisCursor obtido em order.lineItems.pageInfo.endCursor.
- Aparece em:
- Obter pedido
- Exemplo:
- Cursor obtido em order.lineItems.pageInfo.endCursor
Cursor de paginação dos produtos da coleção
Em campos adicionaisCursor obtido em collection.productsPageInfo.endCursor.
- Aparece em:
- Obter coleção
- Exemplo:
- Cursor obtido em collection.productsPageInfo.endCursor
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <shopify.jobResult>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<shopify.jobResult> | json | Resultado do cancelamento (id, done, status, errors, order com id e cancelledAt); acompanhe consultando o job. |
<shopify.job> | json | Job assíncrono (id, done); consulte o job até que ele seja concluído. |
<shopify.fulfillmentOrders> | json | Pedidos de atendimento (id, orderId, status, requestStatus, assignedLocation, supportedActions, lineItems com remainingQuantity e pageInfo). |
<shopify.fulfillmentOrder> | json | Detalhes do pedido de atendimento (id, orderId, status, assignedLocation, supportedActions, lineItems.edges.node e lineItems.pageInfo). |
<shopify.productVariants> | json | Variantes criadas ou atualizadas (id, title, price, compareAtPrice, sku, inventoryItem, selectedOptions). |
<shopify.userErrors> | json | Erros de validação das variantes [{field, message}], incluindo falhas de atualização parcial. |
<shopify.product> | json | Detalhes do produto (id, title, handle, descriptionHtml, vendor, productType, tags, status, variants, images). |
<shopify.products> | json | Lista de produtos com os campos principais e um resumo das mídias. |
<shopify.order> | json | Detalhes do pedido ou resultado do cancelamento, conforme a operação (campos do pedido, cliente, totais, observações, itens ou status do job de cancelamento). |
<shopify.orders> | json | Lista de pedidos com status, totais, cliente e resumo da entrega. |
<shopify.customer> | json | Detalhes do cliente (id, email, name, phone, note, tags, amountSpent, addresses, defaultAddress). |
<shopify.customers> | json | Lista de clientes com dados de contato, tags, valor gasto e endereço padrão. |
<shopify.inventoryItems> | json | Itens de estoque com SKU, status de controle de estoque, detalhes da variante e estoque por local. |
<shopify.inventoryLevel> | json | Níveis de estoque de um item ou resultado de um ajuste de estoque (níveis por local, ou adjustmentGroup e changes). |
<shopify.locations> | json | Locais da loja com id, nome, status de ativo, capacidade de atender pedidos e endereço. |
<shopify.fulfillment> | json | Resultado do atendimento do pedido (id, status, trackingInfo, createdAt, updatedAt, fulfillmentLineItems). |
<shopify.collection> | json | Detalhes da coleção (id, title, handle, descriptionHtml, image, sortOrder, productsCount, products). |
<shopify.collections> | json | Lista de coleções com id, título, identificador (handle), quantidade de produtos, ordenação e imagem. |
<shopify.pageInfo> | json | Informações de paginação (hasNextPage, hasPreviousPage, startCursor, endCursor). |
<shopify.deletedId> | string | ID do recurso excluído. |
Exemplo de uso
Objetivo: Consultar um pedido ou executar uma ação comercial durante o atendimento.
- Operação
- Listar produtos
- Conta do Shopify
- (escolha a conta conectada)
- Domínio da loja
- Detectado automaticamente pelo OAuth ou informe manualmente
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <shopify.jobResult>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Erro de autorização ou permissão (401/403)
- A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- AsaasGerar cobranças Pix, boletos, links e assinaturas, consultar pagamentos e reenviar dados sem duplicar cobranças.
- Bling ERPConsultar estoque, movimentar saldo, administrar pedidos, notas fiscais e clientes no Bling ERP.
- CatálogoMostrar o catálogo ou um produto do WhatsApp Business (Z-API) dentro de um fluxo de conversa.
- Melhor EnvioCotar fretes, comprar, gerar, imprimir e cancelar etiquetas e consultar o rastreamento pelo Melhor Envio.
- NuvemshopConsultar a loja, recuperar carrinhos, criar cupons e administrar produtos, pedidos e clientes na Nuvemshop.
- PIXEnviar pelo WhatsApp (Z-API) um botão que copia a chave PIX.