Área do Cliente: as notas fiscais que o seu cliente vê no portal

Esta fonte trata do que a Área do Cliente faz com notas JÁ emitidas: o que o seu cliente enxerga no portal, o que ele baixa e por que uma nota não aparece para ele. Emitir, cancelar, corrigir ou resolver rejeição é assunto do módulo Fiscal do ERP, não daqui.

Dois "clientes" convivem neste assunto. Você, assinante, é o dono do ERP e emite a nota. O cliente-final é o seu cliente, que entra no portal com o acesso que você liberou. Quando o texto falar em "o cliente vê", é sempre o cliente-final.

TRÊS LISTAS SEPARADAS, UMA POR MODELO DE NOTA
O portal não tem uma lista única de notas. São três páginas independentes no menu: NF-e, NFS-e e NFC-e. Cada uma tem seus próprios filtros e sua própria lista.
NF-e é a nota modelo 55. NFC-e é a modelo 65. As duas são registradas juntas no ERP e o portal separa uma da outra pelo modelo. NFS-e é a nota de serviço, que tem registro próprio e regras próprias.

CADA LISTA DEPENDE DE UM SERVIÇO LIBERADO NO CADASTRO
No cadastro do cliente-final existe o campo Serviços disponíveis, com oito opções: Ordens de serviços, Pedidos, Cobranças, Atendimentos, Assinaturas, NF-e, NFS-e e NFC-e. O menu do portal é montado a partir do que está marcado ali, e cada uma das três notas gera o seu próprio item de menu. Se você não marcou NFS-e, o item NFS-e não existe para aquele cliente.
Quando você cria o acesso, o sistema já vem com quase tudo marcado por padrão (inclusive NF-e, NFS-e e NFC-e) — normalmente o que existe é alguém ter desmarcado, não faltar marcar.
Quem tenta abrir uma página sem o serviço liberado recebe "Você não tem permissão para acessar esta área!" e volta para o início.

QUAL NOTA ENTRA NA LISTA DE UM CLIENTE
O recorte é curto: a nota tem que ser da sua empresa e ter como destinatário exatamente aquele cadastro de cliente que está logado. O vínculo é pelo cadastro, não pelo CNPJ digitado, não pelo nome e não pelo e-mail.
Consequências diretas: nota emitida para um fornecedor não aparece para ninguém no portal; NFC-e de balcão, sem cliente identificado no cadastro, não aparece; e se o mesmo CNPJ tem dois cadastros no seu ERP, o cliente só vê as notas do cadastro que ele usa para entrar.
Não existe filtro por loja. Se a sua empresa tem várias lojas, o cliente vê as notas dele de qualquer loja. A lista é paginada e vem da nota cadastrada mais recentemente para a mais antiga (é a ordem de registro no ERP, que normalmente coincide com a ordem de emissão).

AS SITUAÇÕES QUE A TELA DEIXA PASSAR
NF-e e NFC-e: Aprovada, Denegada, Cancelada e Corrigida.
NFS-e: Aprovada, Cancelada e Denegada.
Em aberto, Enviando e Reprovada não entram na listagem do portal.
O porquê é simples: nota que ainda está em aberto, indo para a SEFAZ ou reprovada não é documento, é rascunho ou erro. Só sai da sua mão o que virou documento.
Repare no efeito prático: cancelar não some a nota do portal. Ela continua na lista com a etiqueta Cancelada. Já uma nota reprovada não aparece na tela do cliente.
Uma ressalva honesta: isso é o comportamento da tela, não um cofre. O filtro de situação pode ser trocado por quem abre a página, então não trate a lista como garantia de sigilo — o que garante o recorte é o vínculo com o cadastro do cliente e com a sua empresa.

OS FILTROS DA TELA
São dois filtros nas três páginas: período de emissão (À partir de / Até) e Situação. O Situação oferece Todos mais exatamente as situações da lista acima, conforme o tipo de nota. Não há busca por número, por valor, por loja nem por natureza da operação.
O período olha a data de emissão da nota, não a data em que ela foi cadastrada.

O QUE A LISTA MOSTRA
NF-e e NFC-e: Nº, Tipo de documento (Entrada ou Saída), Data, Natureza da operação, Valor total, Situação e as ações.
NFS-e: Nº, Data, Natureza da operação, Valor total, Situação e as ações.
A situação aparece como etiqueta colorida. Passando o mouse nela, o cliente lê o motivo gravado na nota; em NF-e e NFC-e, quando a situação é Corrigida, o que aparece é o texto da correção. Ou seja: o motivo da denegação ou do cancelamento fica visível para o seu cliente.
Na NF-e, quando a nota tem carta de correção, a própria etiqueta vira link para o PDF da CC-e.
A lista é o fim da linha: não há botão para "abrir" a nota dentro do portal. O que o cliente faz com ela é baixar o PDF ou o XML.

O QUE O CLIENTE BAIXA: PDF E XML
NF-e: Danfe (PDF) e XML.
NFC-e: Danfe (PDF) e XML.
NFS-e: Imprimir (PDF da nota de serviço) e XML.
Os três são links públicos da própria nota. Eles abrem sem login. É o mesmo link usado no e-mail da nota. Na prática: se o cliente encaminhar o link, quem receber abre o documento.
O XML tem trava por situação, e ela não é igual à lista do portal. NF-e e NFC-e só entregam XML se a nota estiver aprovada, reprovada, denegada, cancelada ou corrigida; fora disso a resposta é "Não é possível baixar o XML pois a nota não foi aprovada ou denegada!". NFS-e só entrega XML de nota aprovada ou cancelada; fora disso vem "Não foi possível baixar o XML pois a nota não foi aprovada ou cancelada!".
O XML não é montado na hora, é lido do arquivo guardado no envio. Se o arquivo não estiver lá, a resposta é "Não foi possível baixar o XML!".
Se a nota foi apagada do ERP, o link avisa que a NF-e foi removida do sistema ou que a NFS-e foi deletada do sistema.

O QUE ACONTECE DO SEU LADO QUANDO ELE ABRE O PDF
Abrir o DANFE pelo link público, de fora da sua empresa, marca a nota como visualizada. Se aquela nota já tinha sido enviada por e-mail pelo ERP, o usuário que fez o envio ainda recebe o registro do acesso: em NF-e e NFC-e vira notificação, em NFS-e vira registro de log. O texto usa o nome do destinatário gravado na nota, no formato "Fulano visualizou a NF-e de número #123".
Isso acontece uma vez só, na primeira abertura, enquanto a nota ainda não estava marcada como visualizada. Em NF-e e NFC-e, abertura feita pela pré-visualização do WhatsApp é ignorada de propósito, para não marcar como lida o que ninguém leu.

POR QUE A NOTA NÃO APARECE PARA O CLIENTE
Siga nesta ordem, é quase sempre uma destas.
1. O serviço não está liberado. Confira NF-e, NFS-e ou NFC-e em Serviços disponíveis no cadastro daquele cliente. Cada um é um serviço separado: liberar NF-e não libera NFS-e.
2. A nota não foi emitida para aquele cadastro. É o campo destinatário da nota apontando para o cadastro de cliente. Cadastro duplicado do mesmo CNPJ é a causa número um: você emitiu no cadastro A e ele entra pelo cadastro B.
3. A situação não é visível. Nota em aberto, enviando ou reprovada não é listada.
4. O período do filtro não cobre a data de emissão da nota.
5. O destinatário é um fornecedor, ou é NFC-e sem cliente identificado. Nesses casos não há cadastro de cliente na nota, e ela não tem como aparecer.

O QUE COSTUMA DAR ERRADO
Esperar que o portal avise o cliente. Ele não avisa. O portal expõe a nota para consulta; quem quiser avisar manda o e-mail da nota pelo módulo Fiscal.
Achar que o portal esconde nota cancelada. Não esconde. Cancelada continua listada, com a etiqueta e o motivo visíveis para o cliente.
Nota de teste aparecendo. O recorte do portal não separa ambiente de produção de ambiente de homologação. Nota emitida em homologação, se ficou aprovada e com aquele cliente como destinatário, entra na lista dele.
NFS-e denegada que lista mas não baixa XML. É esperado: a lista aceita Denegada, o download de XML de NFS-e não.
Cliente que baixou o XML de uma NF-e cancelada. Também é esperado, o XML de nota cancelada é liberado.
Menu com item que você achava não ter liberado. O menu monta pelo que está exatamente marcado, mas a validação da página de NF-e procura o texto NF dentro da lista de serviços do cliente. Como NFS e NFC contêm NF, quem tem só NFS-e ou NFC-e liberado consegue abrir a página de NF-e mesmo assim — e mesmo aí ele continua vendo só as notas do próprio cadastro, nunca as de outro cliente. Se isso incomoda, o controle prático é revisar os serviços marcados no cadastro.
Tratar o link do DANFE como sigiloso. Não é: ele abre sem login para qualquer um que tenha o link.