TaxPlus | FAQ | SPED Contribuições | Chave de acesso de documentos de terceiros (campo de usuário "Chave de Acesso")
6 min
Criado por Juliel Trindade em 04/11/2026 09:16
Atualizado por Juliel Trindade em 04/11/2026 10:44

Dúvida

Como informar a chave de acesso de notas fiscais e conhecimentos de transporte que não foram emitidos pelo TaxPlus, para que ela seja levada corretamente ao SPED Contribuições?


De onde o TaxPlus busca a chave

A origem depende de quem emitiu o documento, o que no SAP é indicado pelo tipo de sequencial:

Documento

Sequencial no SAP

De onde vem a chave

Emitido pelo próprio TaxPlus (NF-e, NFC-e, CT-e, NFS-e)

Próprio

Do retorno da autorização, gravado pelo add-on emissor. Na NFS-e, na aba Nota Fiscal de Serviço e no Follow-up

Recebido de fornecedor ou transportador (nota de entrada, CT-e de frete)

Externo

Do campo de usuário "Chave de Acesso" (U_ChaveAcesso) do documento

Emitido pela empresa fora do TaxPlus (no portal da prefeitura ou em outro sistema)

Deve ser Manual

Do campo de usuário "Chave de Acesso"


Importante: 

Documento emitido fora do TaxPlus não pode usar sequencial próprio. 

Com sequencial próprio, o TaxPlus procura a chave no módulo emissor, não a encontra, e o registro sai sem chave. 

Configure a sequencia desses documentos como sequencial Manual e preencha o campo de usuário.

Como preencher o campo "Chave de Acesso"

  1. No documento (nota de entrada, nota de saída emitida fora do add-on, CT-e), abra os campos de usuário do cabeçalho.
  2. Informe a chave somente com números, sem espaços, pontos, traços ou barras.
  3. Confira o tamanho:

Modelo do documento

Tamanho da chave

NF-e (55), NFC-e (65)

44 dígitos

CT-e (57), CT-e OS (67)

44 dígitos

NFS-e padrão nacional

50 dígitos​

NFS-e municipal (outros padrões)

Varia por prefeitura: informe exatamente como consta na nota autorizada


  1. Grave o documento. Se o período já foi apurado, reabra-o no Novo Magnético e gere o arquivo de novo.

Atenção: o TaxPlus leva a chave ao arquivo exatamente como está no campo. 

Uma chave colada com espaços ou traços (por exemplo, "3526 0912 3456…" ou com hífens) gera erro no validador. 

Não há hoje limpeza automática desses caracteres.

O campo é exclusivo da chave de acesso. 

Não use para outras informações: um texto, como a descrição do CFOP, interrompe a geração do SPED e da Análise do Movimento Fiscal com o erro "inserted value too large for column".


Em quais registros a chave aparece

Registro

Campo

Documentos

C100

CHV_NFE

NF-e e NFC-e

D100

CHV_CTE

CT-e e CT-e OS

A100

CHV_NFSE

NFS-e


Documentos importados por XML (DF-e)

Notas e CT-e importados pelo TaxPlus DF-e trazem a chave do XML. 

Mesmo assim, confira por amostragem, principalmente em documentos lançados ou alterados à mão depois da importação.


Como localizar documentos com chave inválida


No Gerador de Consultas do SAP, liste os documentos do período com chave fora do padrão. 

Exemplo para documentos de entrada (HANA):

SELECT T0."DocEntry", T0."DocNum", T0."Serial", T0."DocDate", T0."CardCode",
       T0."U_ChaveAcesso", LENGTH(T0."U_ChaveAcesso") AS "Tamanho"
FROM OPCH T0
WHERE T0."DocDate" BETWEEN '[data inicial]' AND '[data final]'
  AND T0."U_ChaveAcesso" IS NOT NULL
  AND (LENGTH(T0."U_ChaveAcesso") <> 44
       OR T0."U_ChaveAcesso" LIKE '% %'
       OR T0."U_ChaveAcesso" LIKE '%-%'
       OR T0."U_ChaveAcesso" LIKE '%.%')

A consulta considera 44 dígitos (NF-e e CT-e). 

Para NFS-e, filtre pelo modelo e ajuste o tamanho. 

Repita para notas de saída (OINV) e devoluções (ORPC, ORIN). 

Em SQL Server, use LEN no lugar de LENGTH e retire as aspas duplas. 

Corrija os documentos pela tela do SAP, e não com UPDATE direto no banco.


Erros comuns e como corrigir

Sintoma

Causa

Correção

A100 ou C100 sem chave, para nota emitida no portal da prefeitura ou em outro sistema

Sequencial próprio, ou campo de usuário vazio

Usar sequencial Manual e preencher o campo

Validador: chave de acesso inválida

Chave com espaços, traços ou dígitos a mais ou a menos

Corrigir o campo só com números, no tamanho do modelo

Geração interrompida: "inserted value too large for column" (sp_MovFiscal)

Texto que não é chave gravado no campo

Localizar com a consulta e limpar o campo

Duplicidade de documento de saída (NFS-e cancelada)

Número da RPS no lugar do número da NFS-e, ou status alterado manualmente

Ver o artigo TaxPlus NFS-e – Chave da NFS-e


Artigos relacionados: 

TaxPlus NFS-e – Chave da NFS-e

Registro A100

Registro D100 

Importar XML externo de NF-e e CT-e

FAQ SPED Contribuições