Protesto

Consulta um protesto por TituloID

Esta rota permite consultar os dados de um protesto específico a partir do identificador do título.

Requisição

CampoTipoDescriçãoObrigatório
TituloIdNúmeroIdentificador do títuloSim

Resposta

CampoTipoDescrição
IdGUIDIdentificador único do protesto
TransacaoIdGUIDIdentificador da transação relacionada, caso não exista será retornado um GUID vazio
CobrancaIdGUIDIdentificador da cobrança associada, caso exista
TituloIDNúmeroIdentificador do título registrado
ClienteIdGUIDIdentificador do cliente proprietário
ClienteNomeTextoNome do cliente proprietário do protesto
CredorNomeTextoNome do credor do título protestado
DevedorNomeTextoNome do devedor do título protestado
DescricaoTextoDescrição adicional do protesto
TipoNúmeroTipo do protesto - "DuplicataMercantil = 0", "DuplicataServico = 1", "Contrato = 2", "CedulaCreditoBancario = 3"
TipoDescricaoTextoDescrição amigável do tipo de título/protesto
IdentificadorTextoReferência externa atribuída ao título
DataEmissaoDataData de emissão do título
DataInclusaoDataData em que o protesto foi incluído no sistema
DataCriacaoDataData em que o protesto foi criado
DataVencimentoDataData de vencimento do título
VencimentoTransacaoDataData de vencimento da transação
AtivoBooleanoIndica se o protesto está ativo ou inativo
SituacaoTextoSituação atual do protesto
SituacaoAmigavelTextoStatus formatado de forma amigável para exibição na UI
SituacaoDetalhadaTextoDescrição detalhada do status individual (ex: "Aguardando Coleta", "Protestado")
SituacaoCompletaTextoDescrição completa com grupo amigável e status original do Protesto24h
GrupoStatusTextoGrupo do status
NomeGrupoTextoNome do grupo formatado (mesmo que SituacaoAmigavel)
MotivoRejeicaoTextoMotivo da rejeição quando o status for DEVOLVIDO
DescricaoMotivoRejeicaoTextoDescrição detalhada do motivo da rejeição quando o status for DEVOLVIDO
DescricaoErroTextoDescrição do erro quando o status for ERRO_PROCESSAMENTO
ValorTotalNuméricoValor total do título
ValorSaldoNuméricoValor de saldo pendente do título
ValorTaxasNuméricoValor total das taxas associadas
ClasseBadgeTextoClasse CSS para badge do status
HtmlTooltipMotivoRejeicaoTextoHTML do ícone de informação com tooltip do motivo da rejeição quando aplicável
get/api/ConsultaProtestoPorId

Request

  • Base URL
    https://pagamentos.meuk8.com.br/CobrancasAPI
  • URL
    https://pagamentos.meuk8.com.br/CobrancasAPI/api/ConsultaProtestoPorId
  • Auth
    OAuth 2
    Password
    Token URL: /CobrancasAPI/token scopes: BknBankCobrancasAPI

Query parameters

TituloIdinteger required

Headers

Aeskeystring required

Response

Consulta realizada com sucesso

Idstring uuid
TransacaoIdstring uuid
CobrancaIdstring uuid
TituloIDinteger
ClienteIdstring uuid
ClienteNomestring
CredorNomestring
DevedorNomestring
Descricaostring
Tipointeger
TipoDescricaostring
Identificadorstring
DataEmissaostring date-time
DataInclusaostring date-time
DataCriacaostring date-time
DataVencimentostring date-time
VencimentoTransacaostring date-time
Ativoboolean
Situacaostring
SituacaoAmigavelstring
SituacaoDetalhadastring
SituacaoCompletastring
GrupoStatus'Preparacao' | 'EmProcessamento' | 'EmCartorio' | 'EncerradoPago' | 'EncerradoProtestado' | 'EncerradoDevolvidoImpedido' | 'EncerradoRetirado' | 'EncerradoCancelado' | 'Judicial'
NomeGrupostring
MotivoRejeicaostring
DescricaoMotivoRejeicaostring
DescricaoErrostring
ValorTotalnumber double
ValorSaldonumber double
ValorTaxasnumber double
ClasseBadgestring
HtmlTooltipMotivoRejeicaostring

Example response

{
  "Id": "00000000-0000-0000-0000-000000000000",
  "TransacaoId": "00000000-0000-0000-0000-000000000000",
  "CobrancaId": "00000000-0000-0000-0000-000000000000",
  "ClienteId": "00000000-0000-0000-0000-000000000000"
}

Changes

No recorded changes to this operation across all 1 revision of this API.