1. Home
  2. NS DDFe
  3. Consumo da API NS DDFe
  4. Resumo do DF-e

Resumo do DF-e

Nesse endpoint é possível obter um resumo do documento, contendo informações como data e hora dos registros.

Utilizando este método é possível visualizar uma linha do tempo, a partir do momento que obtivemos o resumo do documento, quando foi feita a manifestação, quando obtivemos o documento completo e quando ocorreram outros eventos do interessado.

URL

https://ddfe.ns.eti.br/dfe/resumo

Dados de entrada
CampoDescriçãotipoObrigatórioComentário
X-AUTH-TOKENToken de acesso da SHStringSimPode ser enviado também no cabeçalho da requisição ou na URL via Query String
CNPJInteressadoCNPJ do interessadoStringSimEx.: CNPJ da transportadora, destinatário, terceiro referenciado no XML, etc...
chaveChave de acesso do documentoStringSimPode ser informada chave de NF-e ou CT-e
tpAmbTipo de ambienteStringSim1- Produção
2- Homologação
Exemplo de requisição

Exemplo de JSON

curl -i -X POST \
-H "Content-Type: application/json" \
-d '{
    "X-AUTH-TOKEN": "ADQWREQW561D32AWS1D6",
    "CNPJInteressado": "07364617000135",
    "chave": "43220307364617000135570000000162061000003306",
    "tpAmb": 2
}'
https://ddfe.ns.eti.br/dfe/resumo

Exemplo de retorno 

{
    "status": 200,
    "motivo": "Informações do documento obtidas com sucesso!",
    "registros": [
        {
            "dhRegistro": "2026-05-11T06:58:06-03:00",
            "descricao": "Emissão"
        },
        {
            "dhRegistro": "2026-05-11T06:58:07-03:00",
            "descricao": "Autorização"
        },
        {
            "dhRegistro": "2026-05-11T07:19:59-03:00",
            "descricao": "Resumo obtido",
            "nsu": 398705
        },
        {
            "dhRegistro": "2026-05-11T07:20:35-03:00",
            "descricao": "Ciencia da Operacao"
        },
        {
            "dhRegistro": "2026-05-11T08:35:40-03:00",
            "descricao": "Documento completo obtido",
            "nsu": 398709
        }
    ]
}

How can we help?