Este método possibilita filtrar e listar em um arquivo PDF uma relação das NFC-es emitidas pelos CNPJs que o usuário possui acesso.
URL
https://portal.ns.eti.br/dfe_portal_server/nfce/reports/issues/listpdf
Dados de entrada
Campo | Descrição | Obrigatório | |
---|---|---|---|
emitenteCnpj | CNPJ do emitente (sem máscara) | N | |
dhEmisBegin | Data início de emissão (dd/MM/yyyy HH:mm:ss) | S | opcional quando a chave for informada |
dhEmisEnd | Data final de emissão (dd/MM/yyyy HH:mm:ss) | S | opcional quando a chave for informada |
chave | Chave de acesso da NFC-e | N | |
tpEmis | Tipo de emissão:1 - Normal9 - Contingência | N | |
tpAmb | Tipo de ambiente:1 - Produção2 - Homologação | N |
Obs.: O intervalo máximo entre as datas de emissão inicial e final não deve ser superior a 31 dias.
Exemplo de requisição
Requisição de lista de NFCes em PDF
curl -X POST \
-H "Content-Type: application/json" \
-H "X-NS-REST-Token: SEU_TOKEN" \
-d '{
"dhEmisBegin" : "01/01/2016 00:00:00",
"dhEmisEnd" : "10/01/2016 00:00:00"
}' \
http://portal.ns.eti.br/dfe_portal_server/nfce/reports/issues/listpdf
Dados retornados
Campo | Descrição |
---|---|
status | Código de status da requisição |
msg | Descrição literal do status |
pdfId | Identificador do arquivo PDF geradoObs.: Veja Download do Arquivo PDF para mais informações sobre como utilizar este identificador para fazer o download do PDF. |
Exemplo de retorno
Retorno da requisição de lista de NFCes em PDF
{
"status": 200,
"msg": "Consulta realizada com sucesso",
"pdfId": "1463094541737"
}
Códigos de retorno
Código | Descrição |
---|---|
200 | Consulta realizada com sucesso |
404 | Nenhum registro encontrado com os filtros informados |
400 | Erro na requisição |
Download do arquivo PDF
O método da API gera um arquivo PDF com a lista de notas e disponibiliza este arquivo para download através de uma URL específica que deve ser acessada junto com identificador do arquivo enviado no campo pdfId da mensagem de retorno.
Para fazer o download é necessário acessar a seguinte URL:
https://portal.ns.eti.br/portal_files/downloads/nfce/rel_emissoes_{ID}.pdf
Onde {ID} deve ser substituído pelo identificador do arquivo recebido.