Incluir DF-e

POST/v1/mdfe/{id}/inclusao-dfe

Inclui um Documento Fiscal Eletrônico (DF-e, por exemplo uma NF-e) vinculado ao MDF-e (evento 110115), para casos em que o documento de transporte precisa ser agregado depois da emissão original do manifesto.

Só se aplica a documentos com mod 58 (MDF-e) que já estejam AUTORIZADA e ainda não tenham sido encerrados.

Esse é um evento síncrono — a resposta HTTP já traz o resultado da SEFAZ, sem necessidade de polling.

Parâmetros do corpo

protocolostringpadrão: protocolo de autorização do MDF-e

Número de protocolo a ser referenciado no evento. Se omitido, usa o protocolo de autorização do próprio MDF-e.

codigo_municipio_carregamentostring | numberobrigatório

Código IBGE do município de carregamento.

nome_municipio_carregamentostring

Nome do município de carregamento.

documentosarrayobrigatório

Lista de documentos fiscais eletrônicos a incluir no MDF-e.

codigo_municipio_descarregamentostring | numberobrigatório

Código IBGE do município de descarregamento deste documento.

nome_municipio_descarregamentostring

Nome do município de descarregamento.

chave_nfestringobrigatório

Chave de acesso de 44 dígitos da NF-e (ou outro DF-e) vinculada.

Resposta

200 OK

statusstring

Valores aceitos: incluido | erro_inclusao

Resultado da inclusão junto à SEFAZ.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

caminho_xmlstring

URL pública do XML do evento, quando autorizado.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/mdfe/35f0a1b2-.../inclusao-dfe \
  -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 '{
    "codigo_municipio_carregamento": "3550308",
    "nome_municipio_carregamento": "São Paulo",
    "documentos": [
      {
        "codigo_municipio_descarregamento": "3304557",
        "nome_municipio_descarregamento": "Rio de Janeiro",
        "chave_nfe": "35260812345678000199550010000000011000000018"
      }
    ]
  }'

Node.js

const resposta = await client.mdfeAddTransportDocument(invoiceId, {
  codigo_municipio_carregamento: '3550308',
  nome_municipio_carregamento: 'São Paulo',
  documentos: [
    {
      codigo_municipio_descarregamento: '3304557',
      nome_municipio_descarregamento: 'Rio de Janeiro',
      chave_nfe: '35260812345678000199550010000000011000000018',
    },
  ],
});
console.log(resposta.status); // 'incluido'

Python

resposta = client.mdfe_add_transport_document(invoice_id, {
    "codigo_municipio_carregamento": "3550308",
    "nome_municipio_carregamento": "São Paulo",
    "documentos": [
        {
            "codigo_municipio_descarregamento": "3304557",
            "nome_municipio_descarregamento": "Rio de Janeiro",
            "chave_nfe": "35260812345678000199550010000000011000000018",
        },
    ],
})
print(resposta["status"])  # 'incluido'

Java

MdfeTransportDocument doc = new MdfeTransportDocument();
doc.codigo_municipio_descarregamento = "3304557";
doc.nome_municipio_descarregamento = "Rio de Janeiro";
doc.chave_nfe = "35260812345678000199550010000000011000000018";

MdfeAddTransportDocumentData data = new MdfeAddTransportDocumentData();
data.codigo_municipio_carregamento = "3550308";
data.nome_municipio_carregamento = "São Paulo";
data.documentos = List.of(doc);

SyncEventResponse resposta = client.mdfeAddTransportDocument(invoiceId, data);
System.out.println(resposta.status); // "incluido"

Exemplo de resposta

{
  "status": "incluido",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao MDF-e",
  "caminho_xml": "https://storage.../evento-inclusao-dfe.xml"
}