1. Inicio
  2. Documentos
  3. Portal DFe
  4. Portal DFe API
  5. Lista de NFC-es inutilizadas

Lista de NFC-es inutilizadas

Este método possibilita listar NFC-es inutilizadas de acordo com o filtro enviado.

URL

https://portal.ns.eti.br/dfe_portal_server/nfce/reports/inut/listinut

Dados de entrada
CampoDescriçãoObrigatórioObservações
idEmitIdentificação do emitenteS
datainiData inicial para o filtro (dd/MM/yyyy HH:mm:ss)S
datafinData final para o filtro (dd/MM/yyyy HH:mm:ss)S
idlicencaIdentificação da licençaN
nnfiniNumero da Nota Inicial a ser filtradoN
nnffinNumero da Nota Final a ser filtradoN
chaveChave de acesso da NFC-eN
serieSerie da NFC-eN
ambienteTipo de ambiente:1 - Produção2 - Homologação N

Obs.: O intervalo máximo entre as datas inicial e final não deve ser superior a 31 dias.

Exemplo de requisição

Requisição de lista de NFCes Inutilizadas

curl -X POST \
    -H "Content-Type: application/json" \
    -H "X-NS-REST-Token: SEU_TOKEN" \
    -d '{
         "idEmit": "6", 
         "dataini": "16/03/2018 14:12:08", 
         "datafin": "27/03/2018 14:12:10"
        }' \
http://portal.ns.eti.br/dfe_portal_server/nfce/reports/inut/listinut
Dados retornados
CampoDescrição
statusCódigo de status da requisição
msgDescrição literal do status
registersArray contendo as inutilizações obtidas pelo filtro



Exemplo de retorno

Retorno da requisição de lista de NFCes em PDF

{
  "status": 200,
  "msg": "Consulta realizada com sucesso",
    "registers": [
        {
            "idInutilizacao": 3,
            "idlicenca": 651,
            "nnfini": 171,
            "nnffin": 171,
            "serie": 1,
            "ambiente": 2,
            "chave": "99999999999999999999999999999999999999999",
            "xjust": "Erro na emissao do documento",
            "cstat": 102,
            "xmotivo": "Inutilização de número homologado",
            "dhrecbto": "26/03/2018",
            "idequip_acesso": 1,
            "datahora": "26/03/2018"
        }
    ]
}
Códigos de retorno
CódigoDescrição
200Consulta realizada com sucesso
404Nenhum registro encontrado com os filtros informados
400Erro na requisição

Como podemos ajudar?