Oten Tecnologia
Oten Fiscal
Documentação
GET/nfcom/consulta/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/nfcom/consulta/periodo' \
  -H 'x-api-key: $OTEN_API_KEY' \
  -H 'Content-Type: application/json'

Respostas

200OK
400Bad Request
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"
  }
}