Com a integração entre o Tiny (ERP da Olist) e a Nuvemshop, você pode gerar as etiquetas do Nuvem Envio direto pelo painel do ERP. Assim, o faturamento, a emissão da nota fiscal e a impressão das etiquetas ficam no mesmo fluxo de expedição.
Neste tutorial, você vai ver como configurar o Tiny, qual é a ordem correta para gerar as etiquetas e como resolver os erros mais comuns.
Importante
Essa funcionalidade está disponível apenas para os planos Escala e Next. Nos planos inferiores, como o Impulso, a opção pode aparecer no painel do Tiny, mas irá retornar um erro ao tentar gerar a etiqueta.
Pré-requisitos obrigatórios
Para gerar etiquetas do Nuvem Envio pelo Tiny (Olist), sua loja deve cumprir os requisitos abaixo:
- Estar no Plano Escala ou Next;
- Tiny integrado à Nuvemshop: a integração entre o ERP e a sua loja deve estar ativa e sincronizando os pedidos;
- Saldo disponível no Nuvem Envio: a sua carteira do Nuvem Envio precisa ter saldo para cobrir o custo de cada etiqueta;
- Emissão de NF-e habilitada no Tiny: a emissão de notas fiscais deve estar ativa e com certificado digital válido no ERP;
- Emitir a Nota Fiscal do pedido antes de gerar a etiqueta: a nota fiscal é pré-requisito obrigatório, pois a Nuvemshop usa a chave da NF-e para vincular a etiqueta ao pedido e, sem ela, a solicitação falha. A nota precisa estar com o status "Autorizada.
Configurando o Tiny para emitir as etiquetas
A configuração é feita uma única vez e tem três partes: cadastrar as formas de envio, mapear as modalidades e ativar o envio automático da nota fiscal para a Nuvemshop.
Veja abaixo, o passo a passo de cada etapa:
Etapa 1: Configurar as formas de envio no Tiny
Para que o Tiny reconheça o Nuvem Envio como transportadora, seguir os passos abaixo:
1. Acessar o painel do Tiny.
2. No menu lateral seguir pelo caminho "Configurações > Vendas".
3. Descer a página até a seção Expedição e Logística e clicar na opção "Formas de Envio".
4. Selecionar a transportadora Nuvem Envio e clicar em "Adicionar forma de frete".
5. Nos campos "Descrição" e "Código do serviço", digitar o nome da modalidade exatamente como você usa no Nuvem Envio e clicar em "Salvar".
Veja abaixo exemplos de modalidades do Nuvem Envio que você pode incluir:
- Correios Sedex;
- Correios PAC;
- Correios Mini;
- Nuvem Envio Coleta;
- Jadlog Econômico;
- Jadlog Rápido;
- Loggi Econômico.
6. Repetir esses passos para cada modalidade que você utilizar.
7. Ao finalizar, clicar em “Salvar” para concluir.
Etapa 2: Configurar o meio de envio nas modalidades do Tiny
Para que o Tiny reconheça o Nuvem Envio corretamente nos pedidos importados, é preciso configurar os nomes das modalidades. Você pode fazer isso de duas formas:
Preencher diretamente
Nesse formato você configura os nomes das modalidades diretamente nas configurações de modalidades no Tiny. Para isso, seguir os passos abaixo:
1. Acessar o painel do Tiny.
2. No menu lateral seguir pelo caminho "Início > Integrações".
3. Clicar na integração com a Nuvemshop.
4. Clicar em “Mapeamentos > Formas de frete”.
5. Clicar em “Adicionar”.
6. Em seguida, você deverá preencher os campos Formas de envio, Formas de frete e Código na integração, conforme a modalidade de envio do Nuvem Envio. Para incluir o Código de Integração, basta clicar no ícone de Corrente/elo "🔗" e depois em “Informar o código manualmente”.
Por exemplo, para Correios PAC, você deve preencher da seguinte forma:
- Formas de envio: Nuvem Envio
- Formas de frete: Correios PAC
- Código na integração: Correios PAC
Veja abaixo o vídeo do passo a passo:
7. Ao finalizar clicar em “Selecionar” e depois em “Salvar”.
Identificar pedidos similares
Nesse formato você pode localizar um pedido que já contenha o meio de envio do Nuvem Envio e usar esse valor como referência para configurar as modalidades no Tiny. Para isso, seguir os passos abaixo:
1. Acessar o painel administrador da Nuvemshop.
2. Seguir pelo caminho "Vendas" > Lista de Vendas" e localizar o número do pedido finalizado com mesma modalidade de envio que você estiver configurando, por exemplo, Nuvem Envio - Correios Mini. Guarde o número do pedido para usar no próximo passo.
3. Acessar o painel do Tiny.
4. No menu lateral clicar em “Pedidos no e-commerce”.
5. Localizar o pedido dentro do Tiny com o mesmo número que você identificou no painel administrador da Nuvemshop e copiar o código que fica logo abaixo:
6. No menu lateral seguir pelo caminho "Início > Integrações".
7. Clicar na integração com a Nuvemshop.
8. Clicar em “Mapeamentos > Formas de frete”.
9. Clicar em “Adicionar”.
10. Em seguida, você deverá preencher os campos Formas de envio, Formas de frete e Código na integração, conforme a modalidade de envio do Nuvem Envio. Por exemplo, para Correios MINI, você deve preencher da seguinte forma:
- Formas de envio: Nuvem Envio
- Formas de frete: Correios MINI
- Código na integração: Colar o código
11. Para incluir o Código de Integração, basta clicar no ícone de Corrente/elo "🔗" e depois colar o código copiado no passo 5. Em seguida, clicar em "Buscar".
12. Selecionar a opção “Correios Mini”, ou a modalidade que você estiver configurando, e clicar em “Selecionar”.
Veja abaixo o vídeo do passo a passo:
13. Ao finalizar clicar em “Salvar”.
Etapa 3: Ativar o envio automático da nota fiscal para a Nuvemshop
A Nuvemshop precisa receber a NF-e do pedido para liberar a etiqueta. Para que isso aconteça de forma automática, seguir os passos:
1. No menu lateral do Tiny, clicar em "Integrações" e acessar a integração com a Nuvemshop.
2. Ir na aba "Pedidos" e clicar em "Dados Fiscais".
3. Em "Envio de dados da NFe", selecionar “Automático ao autorizar nota fiscal”.
4. Clicar em “Salvar”.
Sem essa configuração, a nota fiscal é emitida no Tiny, mas não chega à Nuvemshop automaticamente, e a etiqueta não pode ser gerada.
Como gerar as etiquetas do Nuvem Envio no Tiny?
Helpjuice Success Callout Title
Lembre-se que é obrigatório já ter emitido a nota fiscal do pedido antes de gerar a etiqueta. A nota precisa estar com o status “Autorizada”, notas em processamento, canceladas ou com erro não são aceitas.
Com a configuração pronta e a NF-e autorizada, você pode gerar as etiquetas de duas formas:
Pela tela de Pedidos de Venda
1. Após a emissão da NF-e, acessar "Pedidos de Venda" e selecionar os pedidos desejados.
2. Clicar em "Mais ações".
3. Clicar em "Imprimir etiqueta com um clique".
Pelo menu de Expedição
1. Após enviar o pedido para expedição, clicar em "Incluir Expedição".
2. Selecionar os pedidos com a forma de entrega Nuvem Envio e clicar em "Salvar".
3. Clicar em "Mais ações" e, em seguida, em "Imprimir etiquetas Nuvem Envio".
Pronto!
As etiquetas do Nuvem Envio foram geradas direto pelo Tiny e você já pode imprimi-las para despachar os seus pedidos.
Erros comuns ao gerar etiquetas no Tiny e como resolver
Abaixo, você encontra os erros mais comuns na geração de etiquetas pelo Tiny, com a causa de cada um e o que fazer para resolver.
Erro: sem documento fiscal identificado
Esse erro ocorre quando o pedido não possui NF-e vinculada na Nuvemshop. A mensagem de erro exibida é: dispatch-gw.error.invalid-or-missing-fiscal-document-key
O que fazer:
1. Abrir o pedido e verificar o status da NF-e.
2. Se a nota ainda não foi emitida, faturar o pedido primeiro.
3. Verificar se o envio automático da NF-e está ativo em "Integrações > Nuvemshop > Pedidos > Dados Fiscais".
4. Se necessário, enviar a NF-e manualmente para a Nuvemshop e tentar gerar a etiqueta novamente.
Erro: sem saldo suficiente
Esse erro ocorre quando a sua conta do Nuvem Envio não tem saldo suficiente para cobrir o custo da etiqueta. A mensagem exibida é: Saldo insuficiente na Nuvemshop para geração da etiqueta.
O que fazer:
1. Acessar o painel administrador Nuvemshop.
2. Ir em "Nuvem Envio > Meu saldo" e adicionar crédito.
3. Após a confirmação do pagamento, tentar gerar a etiqueta novamente no Tiny.
Para conferir o passo a passo completo de como adicionar saldo no Nuvem Envio, acessar o tutorial abaixo:
Erro: etiquetas em processamento
Esse erro aparece quando uma solicitação recente ainda está sendo processada pela Nuvemshop. Não é um erro definitivo, e a etiqueta pode até já ter sido gerada. A mensagem exibida é: A Nuvemshop ainda está processando as etiquetas, tente novamente dentro de alguns minutos.
O que fazer:
1. Aguardar de 2 a 5 minutos antes de tentar novamente.
2. Verificar no painel Nuvemshop, em Nuvem Envio, se a etiqueta já foi gerada.
3. Se o erro persistir por mais de 10 minutos, entrar em contato com nossa equipe de atendimento.
Erro: etiqueta cancelada
Esse erro ocorre quando a etiqueta foi cancelada, de forma manual no painel Nuvemshop ou automática. Etiquetas canceladas não podem ser reativadas. A mensagem exibida é: Label canceled by user request
O que fazer
1. Verificar o histórico da etiqueta no painel Nuvemshop, em Nuvem Envio.
2. Gerar uma nova etiqueta para o mesmo pedido diretamente no Tiny.
Dica
Para evitar falhas na hora do despacho, mantenha a carteira do Nuvem Envio sempre com saldo disponível e confira o status da NF-e antes de gerar as etiquetas.