AntiFraude1

BaixaManual1

CancelaTransacao1

CapturarTransacaoCartao1

ConsultaCartaoTitular1

ConsultaFrancesinha1

ConsultaTransacao2

ConsultaTransacoes2

CriaTokenCartao2

CriaTransacaoBoleto1

CriaTransacaoBoletoCartaoPix1

CriaTransacaoBoletoCartaoPixSplit1

CriaTransacaoBoletoHibrido1

CriaTransacaoBoletoSplit1

CriaTransacaoCartao1

CriaTransacaoCartaoSplit1

CriaTransacaoCartoes1

CriaTransacaoCartoesSplit1

CriaTransacaoCheckout2

CriaTransacaoOpenFinance1

CriaTransacaoPix1

CriaTransacaoPixSimples1

CriaTransacaoPixSimplesSplit1

CriaTransacaoPixSplit1

CriaTransacaoSaldoConta1

Especie313

EstornaTransacaoPIx1

GerarPDF1

Marketplace10

NotaFiscal3

NotaFiscalConfiguracao9

PagueContas3

Protesto5

ProtestoV21

NotaFiscal

Consulta as notas fiscais por IdEmpresa filtros

Changed on Nov 3, 2026

Esta API oferece às empresas a capacidade de buscar notas fiscais específicas com base em critérios definidos, otimizando o processo de localização e gerenciamento desses documentos.

Requisição

Campo	Tipo	Descrição	Obrigatório
NumeroNota	Texto	Número da nota fiscal para pesquisa	Não
Serie	Texto	Série das notas para pesquisa	Não
Situacao	Texto	Situação das Notas pesquisadas	Não
Descricao	Texto	Descrição das Notas pesquisadas	Não
DataEmissaoIni	Data	Range inicial de data da emissão das notas	Não
DataEmissaoFim	Data	Range final de data de emissão das notas	Não
ClienteId	Texto	Id único do Cliente que emitiu a nota	Não
Page	Número	Número da página, sendo 0 o número da primeira página	Não
PageSize	Número	Total de itens a serem retornados por página, sendo 10 o padrão quando não informado	Não
OrderBy	Número	Campo no qual será aplicado a ordenação da pesquisa (opções: emissao, cliente, valor, descricao)	Não
OrderDirection	Número	Direção na qual será feita a ordenação da pesquisa	Não

Resposta

Campo	Tipo	Descrição
Id	GUID	Id da nota fiscal
TransacaoId	GUID	Id da transação associada a nota fiscal
ClienteId	GUID	Id do cliente associado a nota fiscal
IdentificadorInterno	Texto	Identificação interna da nota fiscal
IdentificadorExterno	Texto	Identificação externa da nota fiscal
DataEmissao	Texto	Data de emissão da nota fiscal
Situacao	Texto	Situação da nota fiscal
MotivoStatusNF	Texto	Motivo do Status da nota fiscal
Descricao	Texto	Descrição da nota fiscal
Valor	Número	Valor da nota fiscal
ValorPagamento	Número	Valor da transação associada à nota fiscal
VencimentoPagamento	Data	Data de vencimento da transação associada à nota fiscal
DataPagamento	Data	Data de pagamento da transação associada à nota fiscal
ClienteNome	Texto	Nome do cliente da nota fiscal
NFNumero	Texto	Número da nota fiscal
LinkPDF	Texto	Link do PDF da nota fiscal
LinkXML	Texto	Link do XML da nota fiscal
CodigoVerificacao	Texto	Código de Verificação da Nota Fiscal

get/api/NotaFiscal

Request

Base URL
https://pagamentos.meuk8.com.br/PagamentosAPI
URL
https://pagamentos.meuk8.com.br/PagamentosAPI/api/NotaFiscal
Auth
OAuth 2
Password
Token URL: /BknBankPagamentosAPI/token scopes: BknBankPagamentosAPI

Query parameters

NumeroNotastring

Número da Nota Fiscal que deseja consultar

Seriestring

Série das notas fiscais para pesquisa

Situacao das notas fiscais para pesquisa

Descricaostring

Descricao das notas fiscais para pesquisa

DataEmissaoInistring date-time

Data inicial de Emissão para pesquisa de um range de notas fiscais

DataEmissaoFimstring date-time

Data Final de Emissão para pesquisa de um range de notas fiscais

ClienteIdstring uuid

Id do cliente das Notas Fiscais

Pageinteger

Número da página, sendo 0 o número da primeira página

PageSizeinteger

Total de itens a serem retornados por página

OrderBystring

Campo no qual será aplicado a ordenação

OrderDirection'ASC' | 'DESC'

Direção na qual será feita a ordenação

Headers

Aeskeystring required

Response

Notas fiscais consultadas com sucesso

Idstring

Id da nota fiscal

CobrancaIdstring uuid

Id da cobrança associada a nota fiscal

ClienteIdstring uuid

Id do cliente associado a nota fiscal

IdentificadorInternostring

Identificação interna da nota fiscal

IdentificadorExternostring

Identificação externa da nota fiscal

DataEmissaostring date-time

Data de emissão da nota fiscal

Situacao'Pendente' | 'Emitida' | 'Cancelada'

Situação da nota fiscal

MotivoStatusNFstring required

Descrição da nota fiscal

Descricaostring

Descrição da nota fiscal

Valornumber double

Valor da nota fiscal

ValorPagamentonumber double

Valor da cobrança da nota fiscal

VencimentoPagamentostring date-time

Vencimento da cobrança da nota fiscal

DataPagamentostring

Data de pagamento da cobrança da nota fiscal

ClienteNomestring

Nome do cliente da nota fiscal

NFNumerostring

Número da nota fiscal

LinkPDFstring

Link do PDF da nota fiscal

LinkXMLstring

Link do XML da nota fiscal

CodigoVerificacaostring

Código de Verificação da nota fiscal

Example response

[
  {
    "CobrancaId": "00000000-0000-0000-0000-000000000000",
    "ClienteId": "00000000-0000-0000-0000-000000000000"
  }
]

Changes

Nov 3, 2026a8b4ea0aa298 Revision changes
- breaking
  the response property / became optional for the status (media type: application/json)
- breaking
  the response property / became optional for the status (media type: text/json)
- breaking
  the response property / became optional for the status (media type: application/xml)
- breaking
  the response property / became optional for the status (media type: text/xml)
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: text/json)
- warning
  removed the optional property from the response with the status (media type: application/xml)
- warning
  removed the optional property from the response with the status (media type: text/xml)
- info
  api operation id NotaFiscal_ConsultaNotasFiscais removed and replaced with NotaFiscal_ConsultaNotasFiscais_ConsultaNotasFiscais_GET
- info
  the security scope BknBankPagamentosAPI was added to the endpoint's security scheme oauth2
- info
  the security scope BknBankCobrancasAPI was removed from the endpoint's security scheme oauth2
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: application/xml)
- info
  added the optional property to the response with the status (media type: text/xml)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: application/xml)
- info
  added the optional property to the response with the status (media type: text/xml)
- info
  added the required property / to the response with the status (media type: application/json)
- info
  added the required property / to the response with the status (media type: text/json)
- info
  added the required property / to the response with the status (media type: application/xml)
- info
  added the required property / to the response with the status (media type: text/xml)

Operation history