Emitir DCe

POST/v1/dce/emit

POST /v1/dce/emit emite uma DC-e (mod: "59") — Declaração de Conteúdo Eletrônica, usada para declarar o conteúdo de encomendas transportadas pelos Correios ou por transportadoras/marketplaces.

Endpoint assíncrono

Esta chamada retorna 202 Accepted assim que o documento entra na fila de processamento — não espera pela SEFAZ. Uma rejeição da SEFAZ (schema inválido, duplicidade, regra de negócio, etc.) não vira erro HTTP nesta chamada: ela só aparece depois, consultando GET /v1/dce/{id} com o invoiceId retornado aqui. Use esse endpoint para fazer polling até o status deixar de ser PENDENTE.

Parâmetros do corpo

Campos comuns

modstringobrigatório

Valores aceitos: 59

Modelo do documento: fixo 59 para DC-e.

tipo_emitentestring | number

Valores aceitos: 0 | 1 | 2 | 3 | 4

Tipo do Emitente da DCe — ver listagem completa de campos.

cnpj_emitentestring

CNPJ do emitente.

nome_emitentestring

Razão social ou nome do emitente.

nome_destinatariostring

Razão social ou nome do destinatário.

cnpj_destinatariostring

CNPJ do destinatário.

cpf_destinatariostring | number

CPF do destinatário.

itensarray

Detalhamento de itens da DCe.

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 com 2 dígitos ou completo com 8 dígitos).

quantidadestring | number

Quantidade.

valor_unitariostring | numberobrigatório

Valor unitário do item.

valor_produtostring | numberobrigatório

Valor total bruto do item.

valor_totalstring | number

Valor total da DCe.

Todos os campos de identificação do emitente e destinatário são opcionais no nível raiz do documento — apenas os campos dentro de cada item (descricao_produto, codigo_ncm, valor_unitario, valor_produto) são obrigatórios quando itens é enviado. Veja a listagem completa de campos de DC-e para todos os grupos (remetente, marketplace, transportadora, ECT, observações, etc).

Resposta

202 Accepted

messagestring

Confirmação de que o documento entrou na fila de processamento.

invoiceIdstring

UUID interno do documento — use na chamada de consulta.

accessKeystring

Chave de acesso de 44 dígitos do documento fiscal, quando já pode ser calculada no momento do enfileiramento.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/dce/emit \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "mod": "59",
    "tipo_emitente": "2",
    "cnpj_emitente": "12345678000199",
    "nome_emitente": "Loja Exemplo LTDA",
    "nome_destinatario": "João da Silva",
    "cpf_destinatario": "11122233344",
    "itens": [
      {
        "numero": "1",
        "descricao_produto": "Caneta Azul",
        "codigo_ncm": "96081000",
        "quantidade": 10,
        "valor_unitario": 2.50,
        "valor_produto": 25.00
      }
    ],
    "valor_total": 25.00
  }'

Node.js

import { NFeClient } from '@tenzanlabs/nfe-node-sdk';

const client = new NFeClient('nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', 'nfe_test_SUA_CHAVE_AQUI');

const resposta = await client.emit({
  mod: '59',
  tipo_emitente: '2',
  cnpj_emitente: '12345678000199',
  nome_emitente: 'Loja Exemplo LTDA',
  nome_destinatario: 'João da Silva',
  cpf_destinatario: '11122233344',
  itens: [
    {
      numero: '1',
      descricao_produto: 'Caneta Azul',
      codigo_ncm: '96081000',
      quantidade: 10,
      valor_unitario: 2.5,
      valor_produto: 25.0,
    },
  ],
  valor_total: 25.0,
});
console.log(resposta.invoiceId);

Python

from nfe_sdk import NFeClient

client = NFeClient(access_key='nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', api_key='nfe_test_SUA_CHAVE_AQUI')

resposta = client.emit({
    "mod": "59",
    "tipo_emitente": "2",
    "cnpj_emitente": "12345678000199",
    "nome_emitente": "Loja Exemplo LTDA",
    "nome_destinatario": "João da Silva",
    "cpf_destinatario": "11122233344",
    "itens": [
        {
            "numero": "1",
            "descricao_produto": "Caneta Azul",
            "codigo_ncm": "96081000",
            "quantidade": 10,
            "valor_unitario": 2.50,
            "valor_produto": 25.00,
        }
    ],
    "valor_total": 25.00,
})
print(resposta["invoiceId"])

Java

import br.com.saascore.nfe.NFeClient;
import br.com.saascore.nfe.model.DceData;
import java.util.*;

NFeClient client = new NFeClient("nfe_access_SUA_CHAVE_DE_ACESSO_AQUI", "nfe_test_SUA_CHAVE_AQUI");

DceData nota = new DceData();
nota.mod = "59";
nota.tipo_emitente = "2";
nota.cnpj_emitente = "12345678000199";
nota.nome_emitente = "Loja Exemplo LTDA";
nota.nome_destinatario = "João da Silva";
nota.cpf_destinatario = "11122233344";
nota.valor_total = 25.00;

DceData.DceDataItens item = new DceData.DceDataItens();
item.numero = "1";
item.descricao_produto = "Caneta Azul";
item.codigo_ncm = "96081000";
item.quantidade = 10;
item.valor_unitario = 2.50;
item.valor_produto = 25.00;
nota.itens = List.of(item);

var resposta = client.emit(nota);
System.out.println(resposta.invoiceId);

Exemplo de resposta

{
  "message": "Documento enfileirado para processamento",
  "invoiceId": "59f0a1b2-...",
  "accessKey": "35260812345678000199590010000000011000000018"
}