API Docs Início Documentação Referência de API Copiar para LLM
GET/v{version}/CreditNote/{id}/LiquidationScheduleCreditNote
Crédito · Operação de crédito

Listar Credit Note

Lista e filtra registros de Credit Note.

Visão geral

Lista e filtra registros de Credit Note.

Autenticação e pré-requisitos

Requer autenticação. Envie o token no header Authorization: Bearer {{token}} (JWT do AWS Cognito). Integrações servidor-a-servidor podem usar X-Api-Key. Todo tráfego é HTTPS e a credencial nunca vai na URL nem em query string.

Pré-requisitos: a rota exige identificador(es) de recurso já existente(s):

Request

Parâmetros

NomeEmTipoObrigatórioDescriçãoExemplo
idpathstring (uuid)obrigatório3fa85f64-5717-4562-b3fc-2c963f66afa6
versionpathstringobrigatório1
linkStatusquerystringopcionalvalor
statusquerystringopcionalvalor
pagequeryintegeropcional10
sizequeryintegeropcional10

Corpo da requisição

Este endpoint não recebe corpo.

Response

Resposta 200.

Campos

CampoTipoObrigatórioDescriçãoValoresExemplo
pageintegeropcional0
totalPagesintegeropcional0
totalItemsintegeropcional0
dataarray de objetoopcionalobjeto — ver detalhe abaixo[ … ]
paginationTokenstringopcional"texto"
totalValueinteger (int64)opcional0
totalAssignmentValueinteger (int64)opcional0

Detalhe de data

CampoTipoObrigatórioDescriçãoValoresExemplo
idstring (uuid)opcional"3fa85f64-5717-4562-b3fc-2c963f66afa6"
amountInCentsinteger (int64)opcional0
pixQrCodeobjetoopcionalobjeto — ver detalhe abaixo{ … }
bankSlipobjetoopcionalobjeto — ver detalhe abaixo{ … }
pixKeyobjetoopcionalobjeto — ver detalhe abaixo{ … }
transferobjetoopcionalobjeto — ver detalhe abaixo{ … }
descriptionstringopcional"texto"
informedDueDatestring (date-time)opcional"2025-08-11T13:45:00Z"
retrievedDataobjetoopcionalobjeto — ver detalhe abaixo{ … }
typestringopcional"texto"
typeDisplaystringopcional"texto"
linkStatusstringopcional"texto"
linkStatusDisplaystringopcional"texto"
statusstringopcional"texto"
statusDisplaystringopcional"texto"
paymentTypestringopcional"texto"
paymentTypeDisplaystringopcional"texto"
failureMessagestringopcional"texto"
cosifAccountCodestringopcional"texto"
nsustringopcional"texto"

Detalhe de pixQrCode

CampoTipoObrigatórioDescriçãoValoresExemplo
qrCodestringopcional"texto"

Detalhe de bankSlip

CampoTipoObrigatórioDescriçãoValoresExemplo
barcodeOrDigitableLinestringopcional"texto"

Detalhe de pixKey

CampoTipoObrigatórioDescriçãoValoresExemplo
keystringopcional"texto"
pixKeyTypestringopcionalNaturalRegistrationNumber, LegalRegistrationNumber, Phone, Email, Automatic, AgencyAndAccount"NaturalRegistrationNumber"
typeDisplaystringopcional"texto"

Detalhe de transfer

CampoTipoObrigatórioDescriçãoValoresExemplo
toobjetoopcionalobjeto — ver detalhe abaixo{ … }
typestringopcionalTransfer, Pix"Transfer"
typeDisplaystringopcional"texto"

Detalhe de retrievedData

CampoTipoObrigatórioDescriçãoValoresExemplo
beneficiaryobjetoopcionalobjeto — ver detalhe abaixo{ … }
bankslipDataobjetoopcionalobjeto — ver detalhe abaixo{ … }

Detalhe de to

CampoTipoObrigatórioDescriçãoValoresExemplo
namestringopcional"Fulano de Tal"
registrationNumberstringopcional"12345678909"
bankCodeintegeropcional0
bankCodeDisplaystringopcional"texto"
bankIspbinteger (int64)opcional0
agencystringopcional"texto"
accountNumberstringopcional"texto"
accountTypestringopcional"texto"
accountTypeDisplaystringopcional"texto"

Detalhe de beneficiary

CampoTipoObrigatórioDescriçãoValoresExemplo
namestringopcional"Fulano de Tal"
registrationNumberstringopcional"12345678909"
bankintegeropcional0
bankCodeDisplaystringopcional"texto"
bankIspbinteger (int64)opcional0
agencystringopcional"texto"
accountNumberstringopcional"texto"
accountTypestringopcional"texto"
accountTypeDisplaystringopcional"texto"

Detalhe de bankslipData

CampoTipoObrigatórioDescriçãoValoresExemplo
dueDatestring (date-time)opcional"2025-08-11T13:45:00Z"
discountinteger (int64)opcional0
paymentLimitDatestring (date-time)opcional"2025-08-11T13:45:00Z"

Exemplo de resposta

{
  "page": 0,
  "totalPages": 0,
  "totalItems": 0,
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "amountInCents": 0,
      "pixQrCode": {
        "qrCode": "texto"
      },
      "bankSlip": {
        "barcodeOrDigitableLine": "texto"
      },
      "pixKey": {
        "key": "texto",
        "pixKeyType": {},
        "typeDisplay": "texto"
      },
      "transfer": {
        "to": {},
        "type": {},
        "typeDisplay": "texto"
      },
      "description": "texto",
      "informedDueDate": "2025-08-11T13:45:00Z",
      "retrievedData": {
        "beneficiary": {},
        "bankslipData": {}
      },
      "type": "texto",
      "typeDisplay": "texto",
      "linkStatus": "texto",
      "linkStatusDisplay": "texto",
      "status": "texto",
      "statusDisplay": "texto",
      "paymentType": "texto",
      "paymentTypeDisplay": "texto",
      "failureMessage": "texto",
      "cosifAccountCode": "texto",
      "nsu": "texto"
    }
  ],
  "paginationToken": "texto",
  "totalValue": 0,
  "totalAssignmentValue": 0
}

Códigos de retorno

CódigoSignificadoDetalhe do contrato
200Requisição bem-sucedida.Success

Exemplos

curl -X GET "{{baseUrl}}/v1/CreditNote/3fa85f64-5717-4562-b3fc-2c963f66afa6/LiquidationScheduleCreditNote" \
  -H "Authorization: Bearer {{token}}"
var baseUrl = "{{baseUrl}}";
var token   = "{{token}}";

using var http = new HttpClient { BaseAddress = new Uri(baseUrl) };
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token);

var rota = "/v1/CreditNote/3fa85f64-5717-4562-b3fc-2c963f66afa6/LiquidationScheduleCreditNote";

var resp = await http.GetAsync(rota);
resp.EnsureSuccessStatusCode();
var json = await resp.Content.ReadAsStringAsync();
const baseUrl = '{{baseUrl}}';
const token   = '{{token}}';

const resp = await fetch(`${baseUrl}/v1/CreditNote/3fa85f64-5717-4562-b3fc-2c963f66afa6/LiquidationScheduleCreditNote`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();

Troque apenas {{baseUrl}} e {{token}}. No Postman, defina-os como variáveis de environment; o cURL importa em Import > Raw text.

Downloads

Este endpoint já vem configurado nas collections abaixo, na pasta da etapa correspondente.

Guia de importação: Como importar no Postman · Todos os downloads: Downloads