Lista de NFC-es emitidas
Este método possibilita filtrar e listar 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/list
Header
Name | Value |
---|---|
Content-Type | application/json |
X-NS-REST-Token | Token do Usuário que vai consumir a API |
Dados de entrada [filter]
Campo | Descrição | Obrigatório | Pai | Observação |
---|---|---|---|---|
filter | Objeto onde serão informados os filtros | S | ||
idPessoaEmit | Array com o id da Pessoa Emitente Esta informação deve ser obtida com a NS Tecnologia | S | filter | Obrigatório quando CNPJ não informado |
CNPJ | CNPJ do emitente | S | filter | Apenas digitos.Obrigatório quando idPessoaEmit não informado |
dhEmiIni | Data início de emissão (dd/MM/yyyy HH:mm:ss) | S | filter | |
dhEmiFin | Data final de emissão (dd/MM/yyyy HH:mm:ss) | S | filter | |
Status | Chave de acesso da NFC-e Opções AUTHORIZED = Somente Documentos Autorizados CANCELED = Somente Documentos Cancelados ALL | N | filter |
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
{
"filter":
{
"CNPJ": "99999999999999",
"dhEmiIni":"15/02/2019 00:00:00",
"dhEmiFin":"15/02/2019 23:59:59"
}
}
Dados retornados
Campo | Descrição |
---|---|
status | Código de status da requisição |
msg | Descrição literal do status |
issues | Identificador da Lista de Documentos |
Exemplo de retorno
Retorno da requisição de lista de NFCes em PDF
{
"status": 200,
"msg": "Consulta realizada com sucesso",
"issues": [
{
"nFCE": {...},
"nFCE": {...},
"nFCE": {...},
"nFCE": {...}
}],
"page": 0,
"totalPages": 1,
"totalIssues": 23,
"totalCancelations": 0,
"totalVNFIssued": 348.52,
"totalVNFCanceled": 0,
"totalVICMS": 7.700000000000001,
"totalVST": 0,
"totalVTotTrib": 80.03999999999999
}
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 |