GET/nfse/consultar/periodo

Consultar notas por período

Retorna todas as notas enviadas em determinado período, de um cpfCnpj específico, independente de sua situação. Limitado a 25 registros por consulta, sendo necessário realizar a paginação através do campo hashProximaPagina. Tipos de consulta: - Somente com cpfCnpj, retorna todos os registros. - cpfCnpj + dataInicial + dataFinal, retorna todos os registros do período solicitado. Cenários de uso: - Quero consolidar todas as emissões do dia, ou do mês. - Quero encontrar uma nota que eu não tenho o ID, e que não possuí idIntegracao. - Quero consultar todas as notas enviadas, em um período específico. Observações: - O intervalo máximo de consulta é de 31 dias. - A ordenação dos registros é decrescente. - A data de filtro se refere a data de recebimento da nota pela API, que pode ser diferente da data de autorização, e ou emissão. - O cache dessa rota é de 300 segundos, para consultas em tempo real, utilize a consultar por ID ou idIntegracao.

Produção: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parâmetros

cpfCnpj query · obrigatório	CPF ou CNPJ da Empresa que deseja consultar.
dataInicial query	Período inicial de consulta.
dataFinal query	Período final de consulta.
hashProximaPagina query	Hash da próxima nota para paginação;

Requisição

cURL

curl -X GET 'https://api.otentecnologia.com.br/nfse/consultar/periodo' \
  -H 'x-api-key: $OTEN_API_KEY' \
  -H 'Content-Type: application/json'

Respostas

200OK

400Bad Request

JSON

{
  "error": {
    "message": "O CPF utilizado na operação é inválido",
    "data": {
      "cpf": "0"
    }
  }
}

401Unauthorized

JSON

{
  "error": {
    "message": "O token informado é inválido. Para o ambiente de produção, Acesse https://www.otentecnologia.com.br/, e gere o seu TOKEN de acesso"
  }
}