Emitindo um MDF-e

POST /v1/mdfe/emitir

{
  "cpf_cnpj": "11222333000181",
  "referencia_externa": "viagem-4471",
  "nota": {
    "identificacao": {
      "codigo_uf": "31",
      "tipo_emitente": 1,
      "serie": "1", "numero": "1",
      "data_emissao": "2026-09-06T10:00:00-03:00",
      "data_inicio_viagem": "2026-09-06T12:00:00-03:00",
      "uf_inicio": "MG", "uf_fim": "SP",
      "municipios_carregamento": [
        { "codigo": "3170206", "municipio": "UBERLANDIA" }
      ],
      "percurso": [{ "uf": "GO" }]
    },
    "emitente": { "cnpj": "11222333000181", "razao_social": "TRANSPORTADORA EXEMPLO" },
    "rodoviario": {
      "rntrc": "12345678",
      "veiculo": {
        "codigo_interno": "1", "placa": "ABC1D23",
        "tara": "5000", "capacidade_kg": "20000",
        "tipo_rodado": "06", "tipo_carroceria": "02", "uf": "MG"
      },
      "condutores": [{ "nome": "MOTORISTA EXEMPLO", "cpf": "11122233396" }]
    },
    "descarregamento": [
      {
        "codigo": "3550308", "municipio": "SAO PAULO",
        "cte": [{ "chave": "3126..." }]
      }
    ],
    "produto_predominante": { "tipo_carga": "05", "descricao": "ELETRODOMESTICOS" },
    "totais": { "quantidade_cte": "1", "valor_carga": "50000.00",
                "unidade": "01", "quantidade_carga": "1200.0000" }
  }
}

Devolve 202 com um job_id.

O campo que mais gera erro

tipo_emitente tem de bater com o documento que você envia

tipo_emitente	Aceita em descarregamento[]
1 prestador de serviço de transporte	cte
2 transportador de carga própria	nfe
3 prestador com CT-e Globalizado	nfe

Mandar nfe com tipo_emitente: 1 não dá erro no autorizador — ele monta um manifesto sem documento nenhum, e autoriza. O Conota recusa antes:

{ "erro": "tipo_emitente=1 (prestador de servico de transporte) so aceita CTE no
manifesto, e o payload traz NFE. Essa combinacao nao da erro na biblioteca: ela monta
um manifesto SEM documento nenhum." }

Se você configurou tipo_emitente na empresa, não precisa repetir no payload.

O que vem da configuração da empresa

tipo_emitente e rntrc são cadastro, não dado de viagem. Configure uma vez em PUT /v1/empresas/{cpf_cnpj}/mdfe e o Conota preenche quando o payload não trouxer. O que vier no payload sempre vence.

Detalhes

Datas podem ir em ISO 8601

O autorizador exige dd/mm/aaaa; a conversão é nossa.

Percurso é a lista de UFs por onde a carga passa entre a origem e o destino — não inclui as duas pontas.

Municípios de carregamento aceitam mais de um: uma viagem pode recolher carga em vários pontos antes de sair.

Idempotência

referencia_externa faz o reenvio devolver o job original. Em manifesto isso importa: dois MDF-e para a mesma viagem é problema fiscal, não só duplicidade de registro. Ver Referência externa.

Depois de emitir

O manifesto não terminou. Ver Encerramento.