v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

DCe

Emitir

Quando uma DCe é enviada para processamento, é realizada uma pré-validação, caso ocorra algum problema como: ausência de campos essenciais, formato de dados incorreto ou problemas com o cadastro do emitente em nossa base, a DCe não será aceita e você receberá uma mensagem de erro de forma síncrona.

Caso a DCe seja aceita para processamento, ela será enviada para uma fila e será processada de forma assíncrona. Com isto, a DCe poderá ser autorizada ou retornar um erro, de acordo com a validação do autorizador nacional.

Para verificar se a DCe já foi autorizada, você terá que efetuar uma consulta ou se utilizar de webhooks (gatilhos).

Abaixo você poderá verificar uma listagem dos principais campos disponíveis. Para verificar a listagem completa de campos veja o link a seguir.

Documentação completa de campos da DCe

post/dce

Query parameters

refstring required

Example:123456

Referência única da DCe

Request body

cnpj_emitentestring required

CNPJ do emitente (somente números).

nome_emitentestring

Razão social ou nome do emitente.

tipo_emitente'1' | '2' | '3' | '4' required

Tipo do Emitente da DCe. 1: Marketplace<br> 2: Emissor próprio<br> 3: Transportadora<br> 4: ECT

cnpj_remetentestring

CNPJ do remetente (somente números).

cpf_remetentestring

CPF do remetente (somente números). Informar quando não houver CNPJ.

nome_remetentestring

Razão social ou nome do remetente.

logradouro_remetentestring

Logradouro do endereço 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

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

municipio_remetentestring

Nome do município do remetente.

uf_remetentestring

Sigla da UF do remetente.

cep_remetentestring

CEP do endereço do remetente (8 dígitos).

telefone_remetentestring

Telefone do emitente (7 a 12 dígitos).

cnpj_destinatariostring

CNPJ do destinatário (somente números).

cpf_destinatariostring

CPF do destinatário (somente números). Informar quando não houver CNPJ.

nome_destinatariostring required

Razão social ou nome do destinatário.

logradouro_destinatariostring

Logradouro do endereço do destinatário.

numero_destinatariostring

Número do endereço do destinatário.

complemento_destinatariostring

Complemento do endereço do destinatário.

bairro_destinatariostring

Bairro do endereço do destinatário.

codigo_municipio_destinatariostring

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

municipio_destinatariostring

Nome do município do destinatário.

uf_destinatariostring

Sigla da UF do destinatário.

cep_destinatariostring

CEP do endereço do destinatário (8 dígitos).

codigo_pais_destinatariostring

Código do país do destinatário (tabela BACEN). Fixo 1058 para Brasil.

nome_pais_destinatariostring

Nome do país do destinatário.

telefone_destinatariostring

Telefone do destinatário (7 a 12 dígitos).

email_destinatariostring

E-mail do destinatário.

cnpj_marketplacestring

CNPJ do Marketplace. Obrigatório quando tipo_emitente=1 (Marketplace).

nome_marketplacestring

Razão Social ou Nome do Marketplace.

site_marketplacestring

Endereço ou site do Marketplace.

cnpj_transportadorastring

CNPJ da Transportadora contratada. Obrigatório quando tipo_emitente=3 (Transportadora).

nome_transportadorastring

Razão Social ou Nome da Transportadora contratada.

cnpj_ectstring

CNPJ dos Correios. Obrigatório quando tipo_emitente=4 (ECT).

nome_ectstring

Razão Social ou Nome dos Correios.

valor_totalstring

Valor total da DCe. Se não informado, será calculado automaticamente pela soma dos itens.

modalidade_transporte'0' | '1' | '2' required

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

cnpj_transportestring

CNPJ da empresa responsável pelo transporte físico da mercadoria. Pode diferir da Transportadora contratada.

informacoes_complementaresstring

Informações complementares de interesse do emitente (até 5000 caracteres).

informacoes_adicionais_fiscostring

Informações adicionais de interesse do Fisco (até 2000 caracteres).

informacoes_adicionais_marketplacestring

Informações adicionais do Marketplace (até 5000 caracteres).

informacoes_adicionais_ectstring

Informações adicionais dos Correios (até 5000 caracteres).

Example request

{
  "cnpj_emitente": "12345678000123",
  "nome_emitente": "EMPRESA LTDA",
  "tipo_emitente": "2",
  "cnpj_remetente": "12345678000123",
  "cpf_remetente": "12345678901",
  "nome_remetente": "EMPRESA LTDA",
  "logradouro_remetente": "Rua das Flores",
  "numero_remetente": "123",
  "complemento_remetente": "Sala 1",
  "bairro_remetente": "Centro",
  "codigo_municipio_remetente": "4106902",
  "municipio_remetente": "Curitiba",
  "uf_remetente": "PR",
  "cep_remetente": "80010000",
  "telefone_remetente": "11999999999",
  "cnpj_destinatario": "98765432000188",
  "cpf_destinatario": "12345678901",
  "nome_destinatario": "CLIENTE EXEMPLO",
  "logradouro_destinatario": "Rua das Flores",
  "numero_destinatario": "456",
  "complemento_destinatario": "Apto 12",
  "bairro_destinatario": "Centro",
  "codigo_municipio_destinatario": "4106902",
  "municipio_destinatario": "Curitiba",
  "uf_destinatario": "PR",
  "cep_destinatario": "80010000",
  "codigo_pais_destinatario": "1058",
  "nome_pais_destinatario": "Brasil",
  "telefone_destinatario": "11988888888",
  "email_destinatario": "destinatario@exemplo.com.br",
  "cnpj_marketplace": "12345678000199",
  "nome_marketplace": "Marketplace Brasil LTDA",
  "site_marketplace": "https://www.marketplace.com.br",
  "cnpj_transportadora": "98765432000100",
  "nome_transportadora": "Transportadora Rápida LTDA",
  "cnpj_ect": "11222333000144",
  "nome_ect": "Empresa Brasileira de Correios e Telégrafos",
  "itens": [
    {
      "numero": "1",
      "descricao_produto": "Camiseta algodao tamanho M",
      "codigo_ncm": "61091000",
      "quantidade": "2.0000",
      "valor_unitario": "49.90000000",
      "valor_produto": "99.80000000"
    }
  ],
  "valor_total": "229.70",
  "modalidade_transporte": "0",
  "cnpj_transporte": "12345678000123",
  "informacoes_complementares": "Pedido #98765 - Loja Virtual Exemplo",
  "observacoes_emitente": [
    {
      "campo": "pedido",
      "texto": "98765"
    }
  ],
  "observacoes_fisco": [
    {
      "campo": "pedido",
      "texto": "98765"
    }
  ],
  "observacoes_marketplace": [
    {
      "campo": "pedido",
      "texto": "98765"
    }
  ],
  "observacoes_ect": [
    {
      "campo": "pedido",
      "texto": "98765"
    }
  ],
  "autorizados_download_xml": [
    {
      "cnpj": "12345678000199",
      "cpf": "12345678901"
    }
  ]
}

Response

Requisição aceita para processamento

cnpj_emitentestring

CNPJ do emitente

refstring

Referência única da DCe.

statusstring

Status da DCe