Campos — DC-e

Listagem completa dos campos aceitos no corpo de POST /v1/dce/emit quando mod corresponde a este tipo de documento. Gerado a partir do schema de validação usado pelo motor fiscal — sempre reflete os nomes de campo e descrições reais aceitos pela API.

Isso é referência exaustiva, não um guia — se você só quer emitir um documento, veja Emitir DC-e, que já cobre os campos essenciais. Use a busca abaixo pra pular direto pro campo que precisa, ou expanda um grupo pra navegar. Campos do tipo array de objeto têm um atalho que abre e rola até o grupo de campos referenciado.

Campos principais73 campos

mod59obrigatório

Modelo do documento fiscal. Fixo '59' para DC-e

seriestring | number

Série do documento fiscal. Informar zero para série única.

numerostring | number

Número do documento fiscal. 1 a 999999999. Deixe em branco para numeração automática.

data_emissaostring | number

Data e hora de emissão. Formato UTC (AAAA-MM-DDThh:mm:ssTZD).

forma_emissaostring | number

Forma de emissão. 1: Normal 2: Contingência off-line

tipo_emitentestring | number

Tipo do Emitente da DCe. 0: App Fisco 1: Marketplace 2: Emissor próprio 3: Transportadora 4: ECT

numero_site_autorizadorstring | number

Número do site do autorizador (0 para site único, 1-9 para múltiplos).

versao_aplicativostring

Versão do aplicativo emissor.

cnpj_emitentestring

CNPJ do emitente.

cpf_emitentestring | number

CPF do emitente.

nome_emitentestring

Razão social ou nome do emitente.

logradouro_emitentestring

Logradouro do emitente.

numero_emitentestring

Número do endereço do emitente.

complemento_emitentestring

Complemento do endereço do emitente.

bairro_emitentestring

Bairro do emitente.

codigo_municipio_emitentestring | number

Código do município do emitente (IBGE 7 dígitos).

municipio_emitentestring

Município do emitente.

uf_emitentestring

UF do emitente.

cep_emitentestring | number

CEP do emitente.

codigo_pais_emitentestring | number

Código do país do emitente. Default 1058 (Brasil).

nome_pais_emitentestring

Nome do país do emitente.

telefone_emitentestring | number

Telefone do emitente.

email_emitentestring

Email do emitente.

cnpj_marketplacestring

CNPJ do Marketplace (apenas quando tipo_emitente=1).

nome_marketplacestring

Razão Social do Marketplace.

site_marketplacestring

Endereço ou site do Marketplace.

cnpj_transportadorastring

CNPJ da Transportadora (apenas quando tipo_emitente=3).

nome_transportadorastring

Razão Social da Transportadora.

cnpj_ectstring

CNPJ dos Correios (apenas quando tipo_emitente=4).

nome_ectstring

Nome dos Correios.

cnpj_remetentestring

CNPJ do remetente.

cpf_remetentestring | number

CPF do remetente.

nome_remetentestring

Razão social ou nome do remetente.

logradouro_remetentestring

Logradouro do remetente.

numero_remetentestring

Número do endereço do remetente.

complemento_remetentestring

Complemento do endereço do remetente.

bairro_remetentestring

Bairro do endereço do remetente.

codigo_municipio_remetentestring | number

Código do município do remetente (IBGE).

municipio_remetentestring

Município do remetente.

uf_remetentestring

UF do remetente.

cep_remetentestring | number

CEP do remetente.

codigo_pais_remetentestring | number

Código do país do remetente. Fixo 1058 (Brasil).

nome_pais_remetentestring

Nome do país do remetente.

telefone_remetentestring | number

Telefone do remetente.

cnpj_destinatariostring

CNPJ do destinatário.

cpf_destinatariostring | number

CPF do destinatário.

id_outros_destinatariostring

Identificação do destinatário (estrangeiro/quilombola/indígena).

nome_destinatariostring

Razão social ou nome do destinatário.

logradouro_destinatariostring

Logradouro do destinatário.

numero_destinatariostring

Número do destinatário.

complemento_destinatariostring

Complemento do destinatário.

bairro_destinatariostring

Bairro do destinatário.

codigo_municipio_destinatariostring | number

Código do município do destinatário (IBGE).

municipio_destinatariostring

Município do destinatário.

uf_destinatariostring

UF do destinatário.

cep_destinatariostring | number

CEP do destinatário.

codigo_pais_destinatariostring | number

Código do país do destinatário (BACEN).

nome_pais_destinatariostring

Nome do país do destinatário.

telefone_destinatariostring | number

Telefone do destinatário.

email_destinatariostring

E-mail do destinatário.

autorizados_download_xmlarray de objeto

Autorizados para acessar o XML da DCe (máx 10).

itensarray de objeto

Detalhamento de itens da DCe.

valor_totalstring | number

Valor Total da DCe.

modalidade_transportestring | number

Modalidade do transporte. 0: Correios 1: Conta própria 2: Empresa transportadora

cnpj_transportestring

CNPJ da empresa transportadora.

informacoes_adicionais_fiscostring

Informações adicionais de interesse do Fisco.

informacoes_adicionaisstring

Informações complementares de interesse do emitente.

informacoes_adicionais_marketplacestring

Informações adicionais do Marketplace.

informacoes_adicionais_ectstring

Informações adicionais dos Correios.

observacoes_emitentearray de objeto

Observações do emitente (máx 10).

observacoes_fiscoarray de objeto

Observações do Fisco (máx 10).

observacoes_marketplacearray de objeto

Observações do Marketplace.

observacoes_ectarray de objeto

Observações dos Correios.

DceDataAutorizadosDownloadXml2 campos

cnpjstring

CNPJ autorizado.

cpfstring | number

CPF autorizado.

DceDataItens7 campos

numerostring | number

Número do item da DCe, começando por 1.

descricao_produtostringobrigatório

Descrição do produto, bem ou mercadoria.

codigo_ncmstringobrigatório

Código NCM (capítulo 2 dígitos ou completo 8 dígitos).

quantidadestring | number

Quantidade.

valor_unitariostring | numberobrigatório

Valor unitário do item.

valor_produtostring | numberobrigatório

Valor total bruto do item.

informacoes_adicionaisstring

Informações adicionais do item.

DceDataObservacoesEmitente2 campos

campostring

Nome do campo.

textostring

Conteúdo do campo.

DceDataObservacoesFisco2 campos

campostring

Nome do campo.

textostring

Conteúdo do campo.

DceDataObservacoesMarketplace2 campos

campostring

Nome do campo.

textostring

Conteúdo do campo.

DceDataObservacoesEct2 campos

campostring

Nome do campo.

textostring

Conteúdo do campo.