Campos do XML do DC-e: caminho, tamanho e valores

(raiz do arquivo)

10 campos

Campo	O que é	Ocorrência	Regras
consSitDCe	Schema de validação XML do Pedido de Consulta da Situação Atual da DCe	Obrigatório, uma vez	—
consStatServDCe	Schema XML de validação do Pedido de Consulta do Status do Serviço DCe	Obrigatório, uma vez	—
DCe	Declaração de Conteúdo Eletrônica	Obrigatório, uma vez	—
dceProc	DCe processada	Obrigatório, uma vez	—
evCancDCe	Schema XML de validação do evento do cancelamento 110111	Obrigatório, uma vez	—
eventoDCe	Schema XML de validação do Pedido de Registro de Evento da DCe	Obrigatório, uma vez	—
retConsSitDCe	Schema XML de validação do retorno da consulta da situação atual da DCe	Obrigatório, uma vez	—
retConsStatServDCe	Schema XML de validação do Resultado da Consulta do Status do Serviço de DCe	Obrigatório, uma vez	—
retDCe	Schema XML de validação do retorno da DCe	Obrigatório, uma vez	—
retEventoDCe	Schema XML de validação do retorno Pedido de Evento da DCe	Obrigatório, uma vez	—

consSitDCe

1 campo

Campo	O que é	Ocorrência	Regras
xServ	Serviço Solicitado	Obrigatório, uma vez	—

DCe

2 campos

Campo	O que é	Ocorrência	Regras
infDCe	Informações da DCe	Obrigatório, uma vez	—
infDCeSupl	Informações suplementares da DCe	Obrigatório, uma vez	—

dceProc

5 campos

Campo	O que é	Ocorrência	Regras
dhConexao	Data e Hora da Conexão de Origem	Opcional, no máximo uma vez	—
ipTransmissor	IP do transmissor do documento fiscal para o ambiente autorizador	Opcional, no máximo uma vez	—
nPortaCon	Porta de origem utilizada na conexão (De 0 a 65535)	Opcional, no máximo uma vez	—
protDCe	Tipo Protocolo de status resultado do processamento da DCe (Modelo 99)	Obrigatório, uma vez	—
versao	Versão do leiaute	Obrigatório, uma vez	—

evCancDCe

2 campos

Campo	O que é	Ocorrência	Regras
descEvento	Descrição do Evento - “Cancelamento”	Obrigatório, uma vez	—
xJust	Justificativa do Cancelamento	Obrigatório, uma vez	—

eventoDCe

1 campo

Campo	O que é	Ocorrência	Regras
infEvento	—	Obrigatório, uma vez	—

retConsSitDCe

1 campo

Campo	O que é	Ocorrência	Regras
procEventoDCe	Pedido de Registro de Evento de DCe processado	Opcional, quantas vezes precisar	—

retConsStatServDCe

3 campos

Campo	O que é	Ocorrência	Regras
dhRetorno	AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados.	Opcional, no máximo uma vez	—
tMed	Tempo médio de resposta do serviço (em segundos) dos últimos 5 minutos	Opcional, no máximo uma vez	—
xObs	Campo observação utilizado para incluir informações ao contribuinte	Opcional, no máximo uma vez	—

DCe/infDCe

14 campos

Campo	O que é	Ocorrência	Regras
autXML	Autorizados para acessar o XML da DCe	0 a 10 vez(es)	—
dest	Identificação do destinatário da DCe	Obrigatório, uma vez	—
det	Detalhamento de itens da DCe	1 a 999 vez(es)	—
ECT	Identificação dos correios	Obrigatório, uma vez	—
emit	Identificação da DCe	Obrigatório, uma vez	—
Fisco	Identificação do Fisco (uso exclusivo fisco)	Obrigatório, uma vez	—
Id	Identificador da tag a ser assinada	Obrigatório, uma vez	—
ide	Identificação da DCe	Obrigatório, uma vez	—
infAdic	Informações Adicionais	Opcional, no máximo uma vez	—
infDec	Grupo para Declaraçao do usuário emitente	Obrigatório, uma vez	—
Marketplace	Identificação do Marketplace (uso exclusivo Marketplace)	Obrigatório, uma vez	—
total	Dados dos totais da DCe	Obrigatório, uma vez	—
transp	Dados dos transportes da DCe	Obrigatório, uma vez	—
Transportadora	Identificação da Transportadora (uso exclusivo Transportadora)	Obrigatório, uma vez	—

DCe/infDCeSupl

2 campos

Campo	O que é	Ocorrência	Regras
qrCodDCe	Texto com o QR-Code impresso da DCe	Obrigatório, uma vez	—
urlChave	URL para consulta chave de acesso	Obrigatório, uma vez	—

dceProc/protDCe

2 campos

Campo	O que é	Ocorrência	Regras
infFisco	Mensagem do Fisco	Opcional, no máximo uma vez	—
infProt	Dados do protocolo de status	Obrigatório, uma vez	—

eventoDCe/infEvento

9 campos

Campo	O que é	Ocorrência	Regras
CNPJAutor	CNPJ da empresa, Fisco, Marketplace ou Transportadora emitente do evento deve ser o mesmo CNPJ informado do Grupo D. Identificação da Empresa, Fisco,…	Obrigatório, uma vez	—
CNPJUsEmit	CNPJ do Usuário Emitente da DCe que o evento estará vinculado Deve ser o mesmo informado no campo C02 da DCe	Obrigatório, uma vez	—
cOrgao	Código do órgão de recepção do Evento	Obrigatório, uma vez	—
CPFUsEmit	CPF do Usuário Emitente da DCe que o evento estará vinculado Deve ser o mesmo informao no campo C02a da DCe	Obrigatório, uma vez	—
detEvento	Detalhamento do evento específico	Obrigatório, uma vez	—
dhEvento	Data e Hora do Evento, formato UTC (AAAA-MM-DDThh:mm:ssTZD)	Obrigatório, uma vez	—
IdOutrosUsEmit	Identificação do usuário emitente não obrigado a CPF ou CNPJ que o evento estará vinculado Deve ser o mesmo informado no campo C02b da DCe	Obrigatório, uma vez	—
nSeqEvento	Seqüencial do evento para o mesmo tipo de evento. Para maioria dos eventos será 1, nos casos em que possa existir mais de um evento o autor do evento…	Obrigatório, uma vez	—
tpEvento	Tipo do Evento	Obrigatório, uma vez	—

retEventoDCe/infEvento

2 campos

Campo	O que é	Ocorrência	Regras
dhRegEvento	Data e Hora de do recebimento do evento ou do registro do evento formato AAAA-MM-DDThh:mm:ssTZD	Opcional, no máximo uma vez	—
xEvento	Descrição do Evento	Opcional, no máximo uma vez	—

DCe/infDCe/autXML

2 campos

Campo	O que é	Ocorrência	Regras
CNPJ	CNPJ do autorizado	Obrigatório, uma vez	—
CPF	CPF do autorizado	Obrigatório, uma vez	—

DCe/infDCe/dest

3 campos

Campo	O que é	Ocorrência	Regras
enderDest	Endereço do destinatário / assinante	Obrigatório, uma vez	—
idOutros	Identificação do destinatário outros	Obrigatório, uma vez	—
xNome	Razão social ou Nome do destinatário	Obrigatório, uma vez	—

DCe/infDCe/det

3 campos

Campo	O que é	Ocorrência	Regras
infAdProd	Informações adicionais do item	Opcional, no máximo uma vez	—
nItem	Número do item da DCe	Obrigatório, uma vez	—
prod	Dados do Produto ou Serviço	Obrigatório, uma vez	—

DCe/infDCe/emit

1 campo

Campo	O que é	Ocorrência	Regras
enderEmit	Endereço do emitente	Obrigatório, uma vez	—

DCe/infDCe/Fisco

2 campos

Campo	O que é	Ocorrência	Regras
UF	Sigla da UF	Obrigatório, uma vez	220
xOrgao	Nome do órgão	Obrigatório, uma vez	—

DCe/infDCe/ide

12 campos

Campo	O que é	Ocorrência	Regras
cDC	Código numérico que compõe a Chave de Acesso.	Obrigatório, uma vez	—
cDV	Digito verificador da chave de acesso	Obrigatório, uma vez	—
cUF	Código da UF de emissão e autorização da DCe	Obrigatório, uma vez	220
dhEmi	Data e hora de emissão do documento fiscal	Obrigatório, uma vez	—
mod	Modelo da DCe	Obrigatório, uma vez	—
nDC	Número do documento fiscal	Obrigatório, uma vez	—
nSiteAutoriz	Identificação do número do Site do Autorizador de recepção da DCe	Obrigatório, uma vez	—
serie	Série do documento fiscal	Obrigatório, uma vez	—
tpAmb	Tipo do Ambiente	Obrigatório, uma vez	598
tpEmis	Forma de emissão do Documento Fiscal	Obrigatório, uma vez	—
tpEmit	Tipo do Emitente da DCe	Obrigatório, uma vez	—
verProc	Versão do processo de emissão	Obrigatório, uma vez	—

DCe/infDCe/infAdic

8 campos

Campo	O que é	Ocorrência	Regras
infAdECT	Informações Adicionais do Correio	Opcional, no máximo uma vez	—
infAdFisco	Informações adicionais de interesse do Fisco	Opcional, no máximo uma vez	—
infAdMarketplace	Informações Adicionais do MarketPlace	Opcional, no máximo uma vez	—
infCpl	Informações complementares de interesse do Emitente	Opcional, no máximo uma vez	—
obsECT	Grupo Campo de uso livre dos Correios	0 a 10 vez(es)	—
obsEmit	Grupo Campo de uso livre do Emitente	0 a 10 vez(es)	—
obsFisco	Grupo Campo de uso livre do Fisco	0 a 10 vez(es)	—
obsMarketplace	Grupo Campo de uso livre do MarketPlace	0 a 10 vez(es)	—

DCe/infDCe/infDec

2 campos

Campo	O que é	Ocorrência	Regras
xObs1	Observação 1 ao usuário emitente	Obrigatório, uma vez	—
xObs2	Observação 2 ao usuário emitente	Obrigatório, uma vez	—

DCe/infDCe/Marketplace

1 campo

Campo	O que é	Ocorrência	Regras
Site	Endereço ou site do Marketplace	Obrigatório, uma vez	—

DCe/infDCe/total

1 campo

Campo	O que é	Ocorrência	Regras
vDC	Valor Total da DCe	Obrigatório, uma vez	—

DCe/infDCe/transp

2 campos

Campo	O que é	Ocorrência	Regras
CNPJTransp	Número do CNPJ da Transportadora	Obrigatório, uma vez	—
modTrans	Modalidade do transporte	Obrigatório, uma vez	—

dceProc/protDCe/infFisco

2 campos

Campo	O que é	Ocorrência	Regras
cMsg	Código do status da mensagem do fisco	Obrigatório, uma vez	—
xMsg	Mensagem do Fisco	Obrigatório, uma vez	—

dceProc/protDCe/infProt

7 campos

Campo	O que é	Ocorrência	Regras
chDCe	Chave de acesso da DCe	Obrigatório, uma vez	—
cStat	Código do status da DCe	Obrigatório, uma vez	—
dhRecbto	Data e hora de processamento, no formato AAAA-MM-DDTHH:MM:SS TZD	Obrigatório, uma vez	—
digVal	Digest Value da DCe processado. Utilizado para conferir a integridade da DCe original	Opcional, no máximo uma vez	—
nProt	Número do Protocolo de Status da DCe	Opcional, no máximo uma vez	—
verAplic	Versão do Aplicativo que processou a DCe	Obrigatório, uma vez	—
xMotivo	Descrição literal do status da DCe	Obrigatório, uma vez	—

eventoDCe/infEvento/detEvento

1 campo

Campo	O que é	Ocorrência	Regras
versaoEvento	—	Obrigatório, uma vez	—

DCe/infDCe/dest/enderDest

11 campos

Campo	O que é	Ocorrência	Regras
CEP	CEP	Obrigatório, uma vez	—
cMun	Código do município (utilizar a tabela do IBGE)	Obrigatório, uma vez	—
cPais	Código do país	Opcional, no máximo uma vez	377
email	Endereço de E-mail	Opcional, no máximo uma vez	—
fone	Telefone	Opcional, no máximo uma vez	—
nro	Número	Obrigatório, uma vez	—
xBairro	Bairro	Obrigatório, uma vez	—
xCpl	Complemento	Opcional, no máximo uma vez	—
xLgr	Logradouro	Obrigatório, uma vez	—
xMun	Nome do município	Obrigatório, uma vez	—
xPais	Nome do país	Opcional, no máximo uma vez	—

DCe/infDCe/det/prod

5 campos

Campo	O que é	Ocorrência	Regras
NCM	Código NCM	Obrigatório, uma vez	—
qCom	Quantidade	Obrigatório, uma vez	—
vProd	Valor total brutp do item	Obrigatório, uma vez	—
vUnCom	Valor unitário do item	Obrigatório, uma vez	—
xProd	Descrição do produto, bem ou mercadoria	Obrigatório, uma vez	—

DCe/infDCe/infAdic/obsECT

2 campos

Campo	O que é	Ocorrência	Regras
xCampo	—	Opcional, no máximo uma vez	—
xTexto	Conteúdo do Campo	Obrigatório, uma vez	—

Perguntas frequentes

Quantos campos tem o XML do DC-e?

O esquema oficial (PL_DCe_v1.00a_NT2024.001v1.00), lido pelo Buscador NCM, declara 119 nomes de tag distintos, em 362 posições — a mesma tag aparece em mais de um lugar do arquivo, e cada posição tem ocorrência própria. Deste total, 232 posições estão no documento em si; as demais são de evento, consulta e retorno do web service.

Onde fica cada tag no XML do DC-e?

No caminho completo a partir do elemento raiz, reconstruído caminhando pela árvore do esquema oficial — não por tabela de manual. O Buscador NCM agrupa os campos pelo grupo em que eles ficam, na ordem em que o arquivo é montado, e a ficha de cada tag mostra todas as posições dela.

O campo do DC-e é o mesmo campo da NF-e?

Não necessariamente, e essa confusão custa caro. O mesmo nome de tag existe em vários documentos fiscais com regras e sentidos diferentes: uTrib na NF-e não é o uTrib do CT-e. Cada ficha lista o mesmo nome nos outros documentos, com a redação e o caminho de cada um — justamente para que a regra de um não seja aplicada ao outro.

Todo campo que aparece no pacote de esquemas do DC-e é um campo do DC-e?

Não. O pacote traz um arquivo de tipos COMPARTILHADO entre os documentos fiscais, e nele viajam grupos que pertencem a outros documentos. O critério do Buscador NCM é alcance: só entra a tag que o caminho alcança a partir do elemento raiz do documento. Tag declarada no pacote e não alcançada não é campo do leiaute dele.