Nuvem Shop
A integração com o Nuvem Shop conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 30 parâmetros distribuídos em 4 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis na Configuração (ícone de engrenagem) da integração.
Categoria no catálogo do idworks: Canal de Venda.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Pedidos
- Como fica um pedido atendido por mais de uma localização (CD)?
- Dá para importar pedidos que já foram entregues?
- Dá para escolher o status do pedido que a busca automática traz?
Referência rápida
O que é a integração Nuvem Shop?
É a conexão entre o canal Nuvem Shop e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é Canal de Venda), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Nuvem Shop.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Nuvem Shop e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Validar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
4 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
| CNPJ loja na plataforma (apenas números) | Texto | CNPJ da loja cadastrado na plataforma (apenas números) |
| ID da loja | Cópia | (sem descrição cadastrada) |
| Atualizar transportadoras cotação de frete | URL | (sem descrição cadastrada) |
Integração de Vendas
8 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| Fechar pedido automaticamente | Sim/Não | Quando marcado, o idworks fecha o pedido integrado do canal de vendas através do hub. Se desmarcado, o pedido quando integrado permanece com o status de aberto para atualização manual. |
| Cancelar pedido automaticamente | Sim/Não | Ative se quiser cancelar pedido automaticamente caso ele seja cancelado no canal de vendas |
| Dividir pedido entre multiplos armazéns | Sim/Não | Ative para que um pedido atendido por mais de uma localização da Nuvemshop entre dividido: uma linha em Pedidos Integrados e um pedido no idworks por remessa. Veja Como fica um pedido atendido por mais de uma localização (CD)?. |
| Importar pedidos com status entregue | Sim/Não | Ative para que a busca automática traga também os pedidos com envio entregue. Veja Dá para importar pedidos que já foram entregues?. |
| Lista de status para importar pedido | Texto | Status de pedido da Nuvemshop que a busca automática traz, no lugar de open (em aberto). Exemplo: closed. Veja Dá para escolher o status do pedido que a busca automática traz?. |
Integração de Produtos
15 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Atualizar saldo estoque | Sim/Não | Ative se quiser enviar a atualização de saldo de estoque na integração. |
| Estoque de segurança | Inteiro | Se a quantidade disponível de um produto ficar abaixo do valor escolhido, o saldo enviado ao canal é reduzido nessa diferença até o mínimo de zero — o anúncio continua ativo, pois este parâmetro não pausa anúncios automaticamente. O valor de estoque mínimo é aplicado a todos os produtos. |
| Valor de ajuste no preço | Decimal | Valor em R$ fixo a ser somado ao preço por (base) para compor o preço de venda |
| Valor de ajuste no preço frete grátis | Decimal | Valor em R$ fixo a ser somado ao preço de venda já ajustado, se houver frete grátis e se o preço com o ajuste normal atingir a regra de frete grátis |
| Arredondamento dos centavos do preço | Decimal | Valor em centavos para arredondar o preço de venda. Preencha entre 0,01 e 0,99. |
| Atualizar Imagem | Sim/Não | Ative se quiser enviar a atualização de imagem na integração |
| Atualizar preço | Sim/Não | Ative se quiser enviar a atualização de preço na integração |
| Atualizar produto | Sim/Não | Ative se quiser enviar a atualização de produto na integração |
| Armazéns para somar quantidade | Lista múltipla | Selecionar os armazéns que deve somar a quantidade para enviar aos canais de venda. Caso não seja preenchido, será enviado a quantidade do armazém que esta no de/para |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| Agrupar imagem por variaçao tipo cor | Sim/Não | Ative se quiser enviar imagens únicas nas variações tipo cor. Por exemplo, se tiver 4 variações da mesma cor com tamanhos diferentes, será enviado somente a imagem da primeira variação para os demais tamanhos. Para garantir o correto funcionamento, é necessário que as imagens estejam no SKU e não no produto |
| Número imagem principal variação | Inteiro | Informar o número (1 -> principal, 2 -> segunda e etc) da imagem que deseja subir como principal de cada variação |
| Percentual disponibilidade de estoque | % | Valor base para utilizar do estoque em percentual. Ex. se tiver 100 unidades disponíveis e o percentual for 80% será enviado 80 para o canal |
| **Enviar cód. referência como tag ** | Sim/Não | Ative se quiser enviar o(s) código(s) de referência como tags no produto dentro da plataforma. |
| Não enviar descrição ao atualizar produto | Sim/Não | Ative para não enviar a descrição do produto ao sincronizar. (Não apagar a descrição que já existe na plataforma) |
Importação de Anúncios
3 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Criar Produto/SKU, com base no Anúncio Importado. | Sim/Não | Cria o Produto/SKU com base no anúncio importado... |
| **Importar somente anúncios inexistente dentro da ** | Sim/Não | Só importa anúncios que ainda não estão cadastrados no sistema. |
| Importar apenas ativos | Sim/Não | Importar apenas anuncios com o status ativo no canal |
Como fica um pedido atendido por mais de uma localização (CD)?
Na Nuvemshop, um mesmo pedido pode sair de mais de uma localização (centro de distribuição): cada localização vira uma remessa separada. O que o idworks faz com esse pedido depende do parâmetro Dividir pedido entre multiplos armazéns, no grupo Integração de Vendas da integração:
- Parâmetro desligado (comportamento padrão) — o pedido entra inteiro: uma linha em Integrações (HUB) → Pedidos Integrados e um pedido no idworks, com todos os itens. Cada item fica com o armazém da localização que o atende. Se o mesmo produto sai de dois CDs, o item inteiro fica com um armazém só; para separar por CD, ligue Dividir pedido entre multiplos armazéns.
- Parâmetro ligado — o pedido é dividido: uma linha por remessa em Pedidos Integrados, todas com o mesmo Pedido origem, e cada linha gera o seu próprio pedido no idworks.
Com a divisão ligada, cada linha leva só o que é da sua remessa:
- os itens e as quantidades que saem daquela localização (se o mesmo produto sai de dois CDs, cada linha fica com a sua parte);
- o frete, o desconto, o valor total e o prazo de entrega da remessa;
- o armazém correspondente à localização da remessa;
- o pagamento com o valor total calculado daquela remessa (itens + frete da remessa). Todas as partes ficam com a mesma forma de pagamento e o mesmo identificador de transação do pedido original.
O Shipping ID de cada linha traz o ID interno do pedido na Nuvemshop seguido do ID da remessa (ex.: 123456789-987654), e é ele que diferencia as partes de um mesmo pedido.
Daí em diante, cada pedido do idworks conversa com a Nuvemshop só sobre a sua remessa: ao criar o pedido, só aquela remessa é marcada como embalada; a nota fiscal, o envio e a entrega também são informados só para ela, sem mexer nas remessas que estão nos outros pedidos. As notas de todas as partes ficam registradas no mesmo pedido da Nuvemshop.
Quando o pedido não é dividido mesmo com o parâmetro ligado: se o pedido tiver uma remessa só, ou se depois da separação sobrar apenas uma remessa com itens, ele segue o fluxo normal de pedido inteiro.
Dá para importar pedidos que já foram entregues?
Sim, ligando o parâmetro Importar pedidos com status entregue, no grupo Integração de Vendas da integração. A busca automática só roda com Importar pedidos ligado; veja como ela fica:
| Situação | Pedidos que a busca automática traz |
|---|---|
| Parâmetro desligado (padrão) | Pedidos pagos, no status de pedido da busca (padrão: em aberto) e com envio não embalado |
| Parâmetro ligado | Os mesmos de cima e também os pedidos pagos, no mesmo status de pedido, com envio entregue |
Nos dois casos, a busca automática olha os pedidos criados nos últimos 2 dias.
Atenção: o pedido entregue entra em Integrações (HUB) → Pedidos Integrados, mas o idworks não o cria na hora, porque a criação imediata vale só para envio não embalado. O que acontece depois depende da coluna Criar pedido da linha, que mostra se o status entregue da Nuvemshop está liberado para gerar pedido:
- Criar pedido = Sim — a rotina periódica de criação de pedidos cria o pedido. Ela pega os pedidos que chegaram entre 30 minutos e 5 dias atrás e que já têm os SKUs vinculados.
- Criar pedido = Não — a rotina não pega a linha, e o + é recusado com a mensagem de que o status atual do pedido não permite criar pedido. Para liberar o status entregue, fale com o suporte.
Para criar antes de a rotina rodar, use o + da linha (veja Como criar o pedido idworks a partir de uma linha?).
Dá para escolher o status do pedido que a busca automática traz?
Por padrão, a busca automática só traz pedidos que estão em aberto na Nuvemshop. O parâmetro Lista de status para importar pedido, no grupo Integração de Vendas, troca esse status — ele permite importar pedidos que já foram fechados na Nuvemshop.
- Parâmetro em branco — nada muda: a busca traz só os pedidos em aberto.
- Parâmetro preenchido — a busca passa a trazer os pedidos do status informado, no lugar de "em aberto".
Atenção: preencher com o status de pedido fechado (closed) faz a busca trazer só os fechados; os em aberto deixam de vir pela busca automática. Para voltar a trazer os em aberto, deixe o campo em branco.
O valor vai para a Nuvemshop do jeito que foi preenchido; o idworks não confere se é um status que a Nuvemshop reconhece. Se o valor não for reconhecido, a busca automática para de trazer pedidos, sem mostrar erro na tela. Combine o valor com o suporte antes de mudar, para não deixar de importar pedidos.
Os outros filtros da busca continuam valendo: só pedidos pagos, com envio não embalado (ou entregue, se Importar pedidos com status entregue estiver ligado) e criados nos últimos 2 dias. A criação imediata do pedido no idworks também não muda: ela depende do envio estar não embalado, não do status do pedido. Os pedidos de envio entregue não passam pela criação imediata; veja como são criados em Dá para importar pedidos que já foram entregues?.
Esse filtro de status vale só para a busca automática. Pedidos que chegam pelo aviso de pagamento confirmado da Nuvemshop entram sem passar por ele.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Abrir a Configuração (engrenagem), editar nome e status e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |