Canais de venda (Mercado Livre e marketplaces)

Conectar um canal de venda faz a Notavia emitir a NF-e dos seus pedidos sozinha. Quando uma venda é paga no marketplace, a nota é gerada com os dados do pedido e devolvida ao canal — sem você digitar nada.

A tela fica em Administração → Integração → Canais de venda.

Leia isto antes de conectar

Conectar leva um minuto, mas a conexão começa a trabalhar imediatamente — inclusive sobre vendas que já aconteceram. Estes dois avisos evitam o susto mais comum:

⚠️ A primeira varredura busca os pedidos dos últimos 7 dias. Se você conectar com "Emitir automaticamente" ligado, a Notavia pode emitir NF-e de vendas da semana passada — inclusive de pedidos que você já faturou em outro sistema, gerando notas em duplicidade. Conecte sempre com o automático desligado, confira a lista de pedidos que apareceu e só então decida.

⚠️ A primeira sincronização cria produtos no seu cadastro. Os anúncios da loja que não casarem com um produto existente viram produtos rascunho em Cadastros, para você completar (NCM, tributação). Não é erro — mas se o seu cadastro é enxuto, espere vê-lo crescer.

Antes de conectar

Confira estes cinco itens. Cada um trava o fluxo em um ponto diferente:

1. Emitente com certificado A1 válido. É o mesmo cadastro da NF-e comum (Emitente e certificado A1). Sem certificado, nenhuma nota é assinada.

2. A opção "Intermediador" marcada no emitente. No cadastro do emitente, na lista de segmentos.

⚠️ Este é o erro mais fácil de cometer e o mais difícil de perceber. A nota de marketplace deve informar quem intermediou a venda (o grupo infIntermed, com o CNPJ do canal e o seu apelido de vendedor). A Notavia monta esse grupo sozinha — mas se a opção não estiver marcada, ele é descartado em silêncio. A nota é autorizada normalmente, sem erro nenhum, e sai sem a informação do intermediador. Marque antes de conectar.

3. Uma operação fiscal para as vendas do canal. Ela define CFOP, finalidade e tributação (Cadastros). Vale criar uma operação dedicada — assim você separa as vendas do marketplace nos relatórios.

4. Produtos cadastrados, com o código igual ao SKU do anúncio. É por esse código que os dois sistemas se reconhecem.

ℹ️ No Mercado Livre, preencha os dois campos de SKU do anúncio com o mesmo valor. O anúncio tem o SKU e o código universal / código do vendedor, e a Notavia lê um deles ao sincronizar o catálogo e o outro ao receber o pedido. Preenchendo ambos com o código do produto da Notavia, o casamento funciona nos dois momentos.

5. Plano com cota disponível. Cada nota emitida pelo canal consome a sua franquia mensal (Planos e assinatura).

Conectar a loja

1. Abra Administração → Integração → Canais de venda.
2. Na aba Conexões, clique em Conectar loja e escolha o canal.
3. A janela é redirecionada para o site do marketplace. Faça login com a conta da loja e confirme as permissões.
4. Você volta para a Notavia. Não aparece mensagem de sucesso — a confirmação é a loja surgir na lista, com status PendenteConfig.

⚠️ Autorize com a conta certa. Conectar a conta errada não substitui a conexão anterior: cria uma segunda linha na lista, e as duas ficam ativas. Se errar, desconecte a indesejada. Reconectar a mesma conta, ao contrário, preserva toda a configuração que você já tinha feito.

Se a tela avisar "Conectores não configurados. Fale com o suporte.", a integração ainda não está liberada para a sua conta — abra um chamado.

Configurar a conexão

Clique em Configurar na linha da loja:

Sem emitente e operação padrão a tela avisa "Informe o emitente e a operação fiscal padrão." Ao salvar, o status passa a Conectada.

⚠️ PendenteConfig não significa parada. Mesmo antes de você configurar, a Notavia já busca os pedidos da loja e os enfileira. O que falta é só a emissão — que destrava quando você salva a configuração. Por isso os pedidos dos últimos 7 dias podem já estar esperando quando você abrir a tela pela primeira vez.

⚠️ Sobre o cancelamento automático. Marcada, essa opção cancela a NF-e assim que o pedido cai no canal, com uma justificativa padrão. Ela não verifica o prazo legal de 24 horas para cancelamento — passado o prazo, a SEFAZ recusa e o cancelamento fica pendente para você resolver à mão. Em operação de alto volume, vale deixar desmarcada e cancelar conferindo.

ℹ️ Desmarcar "Enviar o documento ao canal" não tem plano B. Sem ela, o XML nunca chega ao marketplace — não existe botão de envio manual. Deixe marcada, salvo se você já entrega a nota por outro caminho.

Como um pedido vira nota

Assim que a venda é paga, a Notavia recebe o aviso do canal, busca os dados do pedido, casa os produtos pelo SKU, calcula os impostos pela sua matriz de impostos, emite a NF-e e devolve o documento ao canal.

Nada é instantâneo. O aviso do marketplace normalmente dispara o processamento na hora, mas há também uma varredura de segurança a cada 5 minutos, e a devolução do documento ao canal roda a cada 2 minutos. Se um pedido demorar alguns minutos para aparecer, é o esperado.

Todas as notas de canal saem marcadas como venda pela internet — é o campo pelo qual o fisco caracteriza e-commerce, e ele vai correto automaticamente.

A aba Pedidos

Mostra os 50 pedidos mais recentes (sem filtro nem busca). O botão Atualizar recarrega.

⚠️ Pedido em Erro não tem botão para tentar de novo. O Emitir só aparece em AguardandoConfirmacao. Um pedido que caiu em Erro precisa ser emitido pela tela normal de Emitir NF-e — e, se você fizer isso, desmarque o envio automático ou envie o XML ao canal por fora, porque a Notavia não vai vincular essa nota ao pedido.

ℹ️ A coluna Observação pode mostrar uma mensagem antiga: ela guarda o último erro e nem sempre é limpa quando o pedido avança. Confie no Status fiscal como estado atual, e use a Observação só para entender o que travou.

A aba não tem link para a nota. Para ver o XML, o DANFE ou os eventos, procure a NF-e em Notas pelo número.

Status da conexão

A coluna Emissão mostra Automática ou Assistida, conforme a configuração.

⚠️ Ninguém te avisa quando a conexão cai. Em TokenExpirado ou Revogada a loja deixa de ser varrida e os pedidos param de virar nota, em silêncio. Vale conferir esta tela de tempos em tempos — se os pedidos pararam de aparecer, comece por aqui. Reconectar restaura a configuração anterior e volta o status para Conectada.

Desconectar uma loja

No ícone de desconectar, na linha da loja. A Notavia confirma avisando que os pedidos novos deixarão de gerar NF-e até reconectar — e é literal: a loja para de ser consultada. As notas já emitidas continuam guardadas normalmente.

Nuvemshop (loja própria)

Na Nuvemshop a venda é da sua loja, não de um marketplace — por isso a nota não leva intermediador e você não precisa marcar essa opção no emitente. O CPF/CNPJ vem do checkout (a Nuvemshop o exige), o endereço vem da cobrança (ou da entrega, quando a cobrança está vazia) e o frete cobrado do cliente entra na nota.

O comprador vira cliente sozinho. Você não precisa cadastrar quem compra na loja: na hora de emitir, a Notavia cria o cliente pelo CPF/CNPJ do pedido — nome (ou razão social e inscrição estadual, no checkout de empresa), e-mail, telefone e endereço — e, se ele já existia, atualiza com o que o pedido trouxe (o dado mais recente é o do próprio comprador; campo vazio no pedido não apaga o que você já tinha). O código do município (IBGE) é resolvido pelo nome da cidade + UF. Quando isso não dá — cidade que não existe na base, endereço sem bairro, CPF inválido — o pedido fica Aguardando dados com o motivo na aba Pedidos; corrija o cadastro do cliente (ou o pedido na loja) e a próxima varredura, em poucos minutos, emite sem você clicar em nada.

Pagamento e frete. A nota sai com um pagamento à vista no total do pedido, com a forma que o cliente usou (cartão de crédito, débito, boleto, PIX; transferência/carteira saem como "outros" quando a plataforma não detalha). Cupom de desconto do pedido é rateado entre os itens, para a nota fechar exatamente no valor pago. O frete segue a modalidade configurada na conexão; pedido com retirada (frete zero) sai como "Sem frete".

A Nuvemshop não tem um campo próprio de nota fiscal. A Notavia devolve a NF-e ao pedido da forma que a plataforma define: uma lista de notas gravada no pedido, com a chave de acesso e um link para o XML — é essa lista que as transportadoras (Melhor Envio e similares) leem para despachar. O link abre o XML autorizado sem login, mas só funciona com a assinatura que a Notavia gera; ele não pode ser adivinhado a partir da chave. O DANFE continua indo por e-mail.

Pedidos que a Nuvemshop importa do Mercado Livre aparecem na aba Pedidos como Ignorado: a nota deles é emitida pela conexão do Mercado Livre, a partir do pedido original — emitir pela loja duplicaria a nota. Se a Nuvemshop suspender o aplicativo, a conexão fica como Suspensa e a loja deixa de ser consultada até ser reativada; desinstalar o app revoga a conexão.

Perguntas frequentes

A nota some se eu desconectar? Não. Notas autorizadas são imutáveis e ficam guardadas permanentemente (Exportar seus XMLs).

Posso conectar mais de uma loja? Sim, inclusive do mesmo canal. Cada uma tem a sua configuração de emitente e operação fiscal.

Preciso conferir cada nota? No começo, sim — mantenha Emitir automaticamente desmarcado. Depois que o cálculo estiver batendo, ligue o automático.

O cliente recebe a nota por e-mail? Se você tiver o envio automático ligado, sim — ele vale para todas as notas, inclusive as de canal.

Anúncio com variação (tamanho, cor) funciona? O casamento por SKU é feito pelo código do produto. Se cada variação for um produto diferente no seu cadastro, dê a cada uma um SKU próprio no anúncio.