Importando XML de NF-e e NFC-e

Importe arquivos XML de NF-e e NFC-e para creditar selos, pontos ou cashback aos clientes, com o resultado de cada arquivo e o significado dos erros.

Com a importação de XML, você mesmo credita as compras dos clientes a partir dos arquivos das notas emitidas pela sua loja, sem depender de o cliente enviar o cupom. Este artigo mostra como importar e como ler o resultado de cada arquivo.

Plano Enterprise. Apenas Proprietário e Membro.

Antes de começar

O programa de fidelidade precisa estar ativo.
A nota precisa ter sido emitida pelo CNPJ da sua loja ou de uma filial cadastrada.
A nota precisa trazer o CPF ou CNPJ do destinatário. Sem ele, não há para quem creditar.
Aceita XML de NF-e (modelo 55) e NFC-e (modelo 65), com até 5 MB por arquivo.

Passo a passo

No menu lateral, clique em Importar XML.
Arraste os arquivos para a área Arraste seus arquivos XML aqui ou clique em Selecionar arquivos. Você pode escolher vários de uma vez.
Confira a lista. Para tirar um arquivo, clique no ícone de lixeira.
Clique em Importar todos. Os arquivos são processados um por vez.
Veja o resultado em cada arquivo:
- Verde: a compra foi creditada. Aparecem o Programa, quanto foi Adicionado e o Saldo atual do cliente.
- Vermelho: a nota não foi creditada. A mensagem explica o motivo. Depois de corrigir, clique em Tentar novamente.
Para começar outro lote, clique em Limpar lista.

Como o cliente é identificado

O LoyalPass usa o CPF ou CNPJ do destinatário da nota.
Cliente já cadastrado: recebe o crédito. Se ainda não estava inscrito no programa, é inscrito na hora.
Cliente novo: se a nota traz o nome do destinatário, o cliente é cadastrado e inscrito automaticamente. Sem o nome, a importação para com "Nome do destinatário é obrigatório no XML para cadastrar um novo cliente."
O telefone da nota não é usado. Cliente criado pelo XML fica sem telefone e não recebe aviso de saldo por WhatsApp.

Bom saber

As regras do programa valem para o XML: prazo máximo do cupom, Valor mínimo para pontuar, Compra mínima do cashback, limite diário de selos e Bloquear clientes não inscritos.
Limite diário: até 3 notas aprovadas por dia para o mesmo CPF, no mesmo CNPJ emissor. Somam-se as notas enviadas pelo cliente e as importadas.
Cada nota vale uma vez. Se o cliente já enviou o cupom daquela compra, o XML é recusado como duplicado, e o contrário também.
Recompensa por produto: os itens do XML são usados para calcular selos, pontos ou cashback por produto. No cashback, se nenhum item tiver regra, o arquivo fica cinza com "Nenhum item desta nota corresponde a um produto com cashback configurado. Esta compra não gerou cashback."
Arquivos que não são XML ou passam de 5 MB não entram na lista.
Envio público desligado não afeta a importação de XML.
Os arquivos recusados ficam registrados em Auditoria → Importações → Tentativas, menos os barrados pelo limite diário.
⚠️ O crédito é imediato. Não há como desfazer uma importação pela tela. Para corrigir um saldo, abra um chamado com o suporte.

Mensagens de erro

Mensagem	O que fazer
"XML não contém CPF/CNPJ do destinatário."	A nota foi emitida sem CPF. Não dá para importar.
"XML malformado ou não é uma NF-e/NFC-e."	Confira se o arquivo é o XML da nota.
"Modelo fiscal não suportado. Use NF-e (mod 55) ou NFC-e (mod 65)."	Só esses dois modelos são aceitos.
"CNPJ do emitente não corresponde a nenhum estabelecimento cadastrado."	A nota é de um CNPJ que não está na sua loja. Cadastre a filial, se for o caso.
"Este cupom pertence a outro estabelecimento."	O CNPJ emissor pertence a outra loja do LoyalPass.
"Estabelecimento não tem programa de fidelidade ativo."	Ative o programa em Programa.
"Este XML já foi importado anteriormente."	A nota já gerou crédito, por XML ou por envio do cliente.
"Data de emissão fora do prazo permitido."	A nota passou do prazo máximo do programa.
"Valor do cupom abaixo do mínimo para pontuar."	O total é menor que o Valor mínimo para pontuar.
"Valor total abaixo do mínimo para cashback."	O total é menor que a Compra mínima do cashback.
"Limite de importações por dia atingido para este CPF/CNPJ."	O cliente já tem 3 notas aprovadas hoje nesse CNPJ. Tente amanhã.
"Cliente não cadastrado. É necessário se cadastrar antes de importar notas para este programa."	Bloquear clientes não inscritos está ligado. O cliente precisa se inscrever antes.

Perguntas frequentes

O cliente importado recebe aviso?

Recebe o aviso de saldo por WhatsApp só se já tinha cadastro com telefone. O cartão na wallet é atualizado para quem já instalou.

A importação de XML cadastra produtos?

Não. O cadastro de produtos é feito por você. Veja Cadastro de produtos e importação por planilha.

Importando XML de NF-e e NFC-e

Importe arquivos XML de NF-e e NFC-e para creditar selos, pontos ou cashback aos clientes, com o resultado de cada arquivo e o significado dos erros.

Importando XML de NF-e e NFC-e

Importe arquivos XML de NF-e e NFC-e para creditar selos, pontos ou cashback aos clientes, com o resultado de cada arquivo e o significado dos erros.

Plano Enterprise. Apenas Proprietário e Membro.

Antes de começar

O programa de fidelidade precisa estar ativo.
A nota precisa ter sido emitida pelo CNPJ da sua loja ou de uma filial cadastrada.
A nota precisa trazer o CPF ou CNPJ do destinatário. Sem ele, não há para quem creditar.
Aceita XML de NF-e (modelo 55) e NFC-e (modelo 65), com até 5 MB por arquivo.

Passo a passo

No menu lateral, clique em Importar XML.
Arraste os arquivos para a área Arraste seus arquivos XML aqui ou clique em Selecionar arquivos. Você pode escolher vários de uma vez.
Confira a lista. Para tirar um arquivo, clique no ícone de lixeira.
Clique em Importar todos. Os arquivos são processados um por vez.
Veja o resultado em cada arquivo:
- Verde: a compra foi creditada. Aparecem o Programa, quanto foi Adicionado e o Saldo atual do cliente.
- Vermelho: a nota não foi creditada. A mensagem explica o motivo. Depois de corrigir, clique em Tentar novamente.
Para começar outro lote, clique em Limpar lista.

Como o cliente é identificado

O LoyalPass usa o CPF ou CNPJ do destinatário da nota.
Cliente já cadastrado: recebe o crédito. Se ainda não estava inscrito no programa, é inscrito na hora.
Cliente novo: se a nota traz o nome do destinatário, o cliente é cadastrado e inscrito automaticamente. Sem o nome, a importação para com "Nome do destinatário é obrigatório no XML para cadastrar um novo cliente."
O telefone da nota não é usado. Cliente criado pelo XML fica sem telefone e não recebe aviso de saldo por WhatsApp.

Bom saber

As regras do programa valem para o XML: prazo máximo do cupom, Valor mínimo para pontuar, Compra mínima do cashback, limite diário de selos e Bloquear clientes não inscritos.
Limite diário: até 3 notas aprovadas por dia para o mesmo CPF, no mesmo CNPJ emissor. Somam-se as notas enviadas pelo cliente e as importadas.
Cada nota vale uma vez. Se o cliente já enviou o cupom daquela compra, o XML é recusado como duplicado, e o contrário também.
Recompensa por produto: os itens do XML são usados para calcular selos, pontos ou cashback por produto. No cashback, se nenhum item tiver regra, o arquivo fica cinza com "Nenhum item desta nota corresponde a um produto com cashback configurado. Esta compra não gerou cashback."
Arquivos que não são XML ou passam de 5 MB não entram na lista.
Envio público desligado não afeta a importação de XML.
Os arquivos recusados ficam registrados em Auditoria → Importações → Tentativas, menos os barrados pelo limite diário.
⚠️ O crédito é imediato. Não há como desfazer uma importação pela tela. Para corrigir um saldo, abra um chamado com o suporte.

Mensagens de erro

Mensagem	O que fazer
"XML não contém CPF/CNPJ do destinatário."	A nota foi emitida sem CPF. Não dá para importar.
"XML malformado ou não é uma NF-e/NFC-e."	Confira se o arquivo é o XML da nota.
"Modelo fiscal não suportado. Use NF-e (mod 55) ou NFC-e (mod 65)."	Só esses dois modelos são aceitos.
"CNPJ do emitente não corresponde a nenhum estabelecimento cadastrado."	A nota é de um CNPJ que não está na sua loja. Cadastre a filial, se for o caso.
"Este cupom pertence a outro estabelecimento."	O CNPJ emissor pertence a outra loja do LoyalPass.
"Estabelecimento não tem programa de fidelidade ativo."	Ative o programa em Programa.
"Este XML já foi importado anteriormente."	A nota já gerou crédito, por XML ou por envio do cliente.
"Data de emissão fora do prazo permitido."	A nota passou do prazo máximo do programa.
"Valor do cupom abaixo do mínimo para pontuar."	O total é menor que o Valor mínimo para pontuar.
"Valor total abaixo do mínimo para cashback."	O total é menor que a Compra mínima do cashback.
"Limite de importações por dia atingido para este CPF/CNPJ."	O cliente já tem 3 notas aprovadas hoje nesse CNPJ. Tente amanhã.
"Cliente não cadastrado. É necessário se cadastrar antes de importar notas para este programa."	Bloquear clientes não inscritos está ligado. O cliente precisa se inscrever antes.

Perguntas frequentes

O cliente importado recebe aviso?

Recebe o aviso de saldo por WhatsApp só se já tinha cadastro com telefone. O cartão na wallet é atualizado para quem já instalou.

A importação de XML cadastra produtos?

Não. O cadastro de produtos é feito por você. Veja Cadastro de produtos e importação por planilha.

Importando XML de NF-e e NFC-e

Importando XML de NF-e e NFC-e

Antes de começar

Passo a passo

Como o cliente é identificado

Bom saber

Mensagens de erro

Perguntas frequentes

O cliente importado recebe aviso?

A importação de XML cadastra produtos?

Artigos relacionados

Importando XML de NF-e e NFC-e

Importando XML de NF-e e NFC-e

Antes de começar

Passo a passo

Como o cliente é identificado

Bom saber

Mensagens de erro

Perguntas frequentes

O cliente importado recebe aviso?

A importação de XML cadastra produtos?

Artigos relacionados