Nuvemshop

Consultar a loja, recuperar carrinhos, criar cupons e administrar produtos, pedidos e clientes na Nuvemshop.

Integrações e ferramentasComércio e pagamentosConexão: Conexão do workspace ou do canal

O que faz

Opere sua loja Nuvemshop: consulte a loja, recupere carrinhos abandonados, crie cupons e gerencie produtos, pedidos e clientes.

Quando usar: Use quando o seu fluxo precisar consultar a loja, recuperar carrinhos, criar cupons e administrar produtos, pedidos e clientes na Nuvemshop.

Exemplo de situação: Consultar um pedido ou executar uma ação comercial durante o atendimento.

Antes de começar

Conexão necessária: Conexão do workspace ou do canal.

Confirme que a integração ou o canal já está conectado no workspace.

Passo a passo

Adicione Nuvemshop ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
Confirme que a integração ou o canal já está conectado no workspace.
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
Dados da Loja	Executa a operação “Dados da Loja” com o bloco Nuvemshop.
Listar Produtos	Lista Produtos com o bloco Nuvemshop.
Consultar Produto	Consulta Produto com o bloco Nuvemshop.
Consultar Produto por SKU	Consulta Produto por SKU com o bloco Nuvemshop.
Criar Produto	Cria Produto com o bloco Nuvemshop.
Atualizar Produto	Atualiza Produto com o bloco Nuvemshop.
Atualizar Estoque e Preço	Atualiza Estoque e Preço com o bloco Nuvemshop.
Listar Pedidos	Lista Pedidos com o bloco Nuvemshop.
Consultar Pedido	Consulta Pedido com o bloco Nuvemshop.
Cancelar Pedido	Cancela Pedido com o bloco Nuvemshop.
Arquivar Pedido	Arquiva Pedido com o bloco Nuvemshop.
Reabrir Pedido	Reabre Pedido com o bloco Nuvemshop.
Listar Clientes	Lista Clientes com o bloco Nuvemshop.
Consultar Cliente	Consulta Cliente com o bloco Nuvemshop.
Listar Carrinhos Abandonados	Lista Carrinhos Abandonados com o bloco Nuvemshop.
Consultar Carrinho Abandonado	Consulta Carrinho Abandonado com o bloco Nuvemshop.
Criar Cupom	Cria Cupom com o bloco Nuvemshop.
Aplicar Cupom no Carrinho	Aplica Cupom no Carrinho com o bloco Nuvemshop.

Campos

Mostrar campos de

Operação
Escolhe qual ação este bloco executará.
Opções:
Dados da Loja · Listar Produtos · Consultar Produto · Consultar Produto por SKU · Criar Produto · Atualizar Produto · Atualizar Estoque e Preço · Listar Pedidos · Consultar Pedido · Cancelar Pedido · Arquivar Pedido · Reabrir Pedido · Listar Clientes · Consultar Cliente · Listar Carrinhos Abandonados · Consultar Carrinho Abandonado · Criar Cupom · Aplicar Cupom no Carrinho
Exemplo:
Dados da Loja
Conta Nuvemshop
Usa a loja Nuvemshop conectada no workspace. O token de acesso nunca é exposto a este bloco nem ao agente.
Exemplo:
(escolha na lista do campo)

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 <nuvemshop.response>: 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
`<nuvemshop.response>`	json	Resposta da API da Nuvemshop para a operação executada.

Exemplo de uso

Objetivo: Consultar um pedido ou executar uma ação comercial durante o atendimento.

InícioNuvemshoppróxima etapa

Operação: Dados da Loja
Conta Nuvemshop: (escolha na lista do campo)

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 <nuvemshop.response>. 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”.
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.