Pular para o conteúdo
ISBI
Integrações

Nuvemshop · E-commerce

Loja na Nuvemshop com a conta de margem fechada

O painel da Nuvemshop mostra o que vendeu. Quanto sobrou depende de custo do produto, frete, taxa de pagamento e mídia, que vivem em quatro lugares. Trazemos todos para a mesma base.

Onde isso costuma travar

Loja própria na Nuvemshop resolve a venda com competência. O que fica sem resposta é a conta de rentabilidade: o painel nativo é bom em faturamento e não tem como saber o custo do seu produto, quanto você pagou de anúncio para trazer aquele pedido, nem qual taxa o meio de pagamento cobrou. Sem esses quatro pedaços juntos, margem é chute.

O que é específico do Nuvemshop

Cada sistema tem os seus próprios pontos cegos, e generalizar aqui não ajuda ninguém. Estes são os do Nuvemshop.

    01

    Faturamento aparece, rentabilidade não

    A loja informa quanto entrou. Custo do produto, taxa do meio de pagamento, frete real e gasto com mídia estão fora dela. A margem por pedido só existe depois que alguém reúne as quatro pontas, e quase sempre isso vira planilha manual.

    02

    Custo de aquisição por produto fica invisível

    O total gasto em anúncio e o total vendido são fáceis. Quanto custou vender aquele item específico, e se ele se paga, exige amarrar a campanha ao pedido. É a conta que decide o que continuar anunciando.

    03

    Cliente recorrente não é medido

    Saber se o cliente volta, quanto ele vale ao longo do tempo e qual canal traz gente que recompra muda a estratégia inteira. É leitura de série histórica, e a loja não guarda essa série pronta.

    04

    Abandono e conversão vivem em outra ferramenta

    O funil está na analítica do site, a venda está na loja, o custo está na mídia. Três fontes para uma pergunta só, e nenhuma delas responde sozinha.

Como tiramos o dado de lá

Leitura programada, sem exportação manual

    01

    OAuth 2 com token por loja

    A plataforma segue OAuth 2: a loja autoriza o aplicativo e a integração passa a usar um token próprio em cada chamada. Autorização explícita e revogável pelo dono da loja.

    02

    Balde furado: quarenta de estouro, duas por segundo

    O controle de chamadas usa leaky bucket, com balde de 40 requisições e vazão de 2 por segundo, multiplicado por dez nos planos superiores. Os cabeçalhos da resposta informam quanto resta e em quanto tempo o balde esvazia, então a carga se regula pelo que a própria API responde.

    03

    Identificação obrigatória na chamada

    Toda requisição precisa enviar um User-Agent com o nome da aplicação e um contato; sem isso a resposta é 400. É a pegadinha que derruba a primeira integração de quase todo mundo, e ela não aparece no erro de forma óbvia.

O que trazemos

  • Pedidos, itens e valor
  • Produtos, variações e preço
  • Clientes e recorrência de compra
  • Cupons e descontos aplicados
  • Frete cobrado e modalidade
  • Status de pagamento

Costuma vir junto com

Sistema de origem sozinho responde pouco. A pergunta de gestão quase sempre exige cruzar dois ou três, e é esse cruzamento que não existe pronto em nenhum deles.

Conferido na documentação oficial

O que muda

As perguntas que passam a ter resposta

    Qual a margem por produto depois de taxa, frete e mídia

    Quanto custa adquirir um cliente, por canal

    Que porcentagem do faturamento vem de quem já comprou

    Qual campanha traz cliente que recompra

    Como a loja própria compara ao marketplace em rentabilidade

Perguntas frequentes

Já uso um app de relatórios na Nuvemshop. Qual a diferença?+

App de relatório trabalha com o que está dentro da loja. A conta de margem precisa de coisas que não estão lá: custo do produto no ERP, taxa do meio de pagamento, gasto de mídia. O trabalho aqui é reunir essas fontes numa base sua e calcular sobre o conjunto.

Vendo na loja e em marketplace. Consigo comparar os dois?+

Sim, e é uma das leituras mais úteis. Cada canal tem estrutura de custo diferente, então a modelagem traduz todos para as mesmas métricas. Só assim "margem" quer dizer a mesma coisa na loja e no marketplace.

Preciso instalar algo na loja?+

Uma autorização de aplicativo, que você concede e pode revogar quando quiser. Nada muda no tema, na velocidade ou no funcionamento da loja para quem compra.

Quanto tempo até ter o primeiro número?+

Cerca de um mês para o primeiro painel com dados reais da sua loja. Não é demonstração com dados de exemplo: é o seu custo, a sua taxa e o seu gasto de mídia.

Usa Nuvemshop? Vamos ver o que dá para extrair dele

Seis perguntas, cerca de dois minutos. Roda no seu navegador e não pede e-mail para mostrar o resultado.