2.3 - Boleto query

Consult by ID

The GetBoletoInById and GetBoletoById methods allow you to query a specific boleto, returning all the boleto's information.

GetBoletoInById

ParameterTypeDescriptionMandatory
Method String GetBoletoByIdYES 
PartnerId Long FitBank provided IDYES 
BusinessUnitId Long FitBank provided IDYES 
DocumentNumber String Internal transaction identifierYES 
{
  "Method": "GetBoletoInById",
  "PartnerId": 93234,
  "BusinessUnitId": 40380,
  "DocumentNumber": 135518
}
{
  "Success": "true",
  "Boleto": {
    "BoletoInId": 0,
    "OperationId": 0,
    "DueDate": "2024-02-06T12:44:19.844Z",
    "PaymentDate": "2024-02-06T12:44:19.844Z",
    "CreditDate": "2024-02-06T12:44:19.844Z",
    "CreationDate": "2024-02-06T12:44:19.844Z",
    "PrincipalValue": 0,
    "InterestDate": "2024-02-06T12:44:19.844Z",
    "InterestValue": 0,
    "InterestPercent": 0,
    "FineDate": "2024-02-06T12:44:19.844Z",
    "FineValue": 0,
    "FinePercent": 0,
    "TotalValue": 0,
    "RebateValue": 0,
    "PaidValue": 0,
    "Status": 0,
    "MailToSend": "string",
    "PhoneToSend": "string",
    "OurNumber": "string",
    "Identifier": "string",
    "Barcode": "string",
    "DigitableLine": "string",
    "Url": "string",
    "CustomerName": "string",
    "CustomerTaxNumber": "string",
    "DivergentPaymentType": 0,
    "MinPaymentValue": 0,
    "MaxPaymentValue": 0,
    "Products": [
      {
        "SellerPersonType": 0,
        "Reference": "string",
        "SellerName": "string",
        "SellerTaxNumber": "string",
        "ReceiverPersonType": 0,
        "ReceiverName": "string",
        "ReceiverTaxNumber": "string",
        "ProductCode": "string",
        "ProductName": "string",
        "ProductQty": 0,
        "ProductValue": 0,
        "ProductRateValue": 0,
        "AutomaticType": 0,
        "AccountType": 0,
        "Bank": "string",
        "BankBranch": "string",
        "BankAccount": "string",
        "BankAccountDigit": "string",
        "ReceiverBank": "string",
        "ReceiverBankBranch": "string",
        "ReceiverBankAccount": "string",
        "ReceiverBankAccountDigit": "string",
        "ProductRateValueToTransfer": 0,
        "FineSplitPercent": 0,
        "InterestSplitPercent": 0
      }
    ]
  }
}

GetBoletoById

ParameterTypeDescriptionMandatory
Method String GetBoletoByIdYES 
PartnerId Long FitBank provided IDYES 
BusinessUnitId Long FitBank provided IDYES 
DocumentNumber String Internal transaction identifierYES 

❗️

The GetBoletoById method will be discontinued.

Consult by Date

The GetBoletoByDate and GetListBoletoByDate methods allow you to see all the boletos issued within a certain period of time.

GetListBoletoByDate

ParameterTypeDescriptionMandatory
Method String GetListBoletoByDateYES 
PartnerId Long FitBank provided IDYES 
BusinessUnitId Long FitBank provided IDYES 
InicialDate DateTime (yyyy/mm/dd)YES 
FinalDate DateTime (yyyy/mm/dd)YES 
PageIndexNumberReference of which page will be accessedYES
PageSizeNumberNumber of results that will be displayed on the same pageYES
Status Short Created - 0
Registered - 3
Settlement - 5
Canceled - 7
NO 
CustomerTaxNumberStringCPF/CNPJ of the payerNO 
SupplierTaxNumberStringCPF/CNPJ of the Boleto issuing accountNO
SupplierBankStringInternal account identification BankNO
SupplierBankBranchStringInternal account identification Bank BranchNO
SupplierBankAccountStringInternal account identification Bank Account NO
SupplierBankAccountDigitStringInternal account identification Bank Account DigitNO
{
  "Method": "GetListBoletoByDate",
  "PartnerId": 93234,
  "BusinessUnitId": 40380,
  "InitialDate": "2024-02-01",
  "FinalDate": "2024-02-05",
  "PageIndex": 0,
  "PageSize": 10,
  "Status": null,
  "CustomerTaxNumber": null,
  "SupplierTaxNumber": null,
  "SupplierBank": null,
  "SupplierBankBranch": null,
  "SupplierBankAccount": null,
  "SupplierBankAccountDigit": null
}
{
  "Success": "true",
  "Boletos": [
    {
      "BoletoInId": 0,
      "DueDate": "2024-02-06T13:39:06.143Z",
      "PaymentDate": "2024-02-06T13:39:06.143Z",
      "CreationDate": "2024-02-06T13:39:06.143Z",
      "PrincipalValue": 0,
      "InterestDate": "2024-02-06T13:39:06.143Z",
      "InterestValue": 0,
      "InterestPercent": 0,
      "FineDate": "2024-02-06T13:39:06.143Z",
      "FineValue": 0,
      "RebateValue": 0,
      "TotalValue": 0,
      "PaidValue": 0,
      "Status": 0,
      "OurNumber": "string",
      "Identifier": "string",
      "Barcode": "string",
      "DigitableLine": "string",
      "FileName": "string",
      "CustomerName": "string",
      "CustomerTaxNumber": "string",
      "SupplierName": "string",
      "SupplierTaxNumber": "string"
    }
  ]
}

GetBoletoByDate

ParameterTypeDescriptionMandatory
Method String GetBoletoByDateYES 
PartnerId Long FitBank provided IDYES 
BusinessUnitId Long FitBank provided IDYES 
InicialDate DateTime (yyyy/mm/dd)YES 
FinalDate DateTime (yyyy/mm/dd)YES 
CustomerNameStringPayer nameNO
CustomerTaxNumber String CPF/CNPJ of the payerNO 
CustomerBank String Payer's bank codeNO 
CustomerBankBranch String Payer's bank branchNO 
CustomerBankAccountString Payer's bank accountNO 
CustomerBankAccountDigitString Payer's bank account digitNO 
InicialDueDateString (yyyy/mm/dd)NO
FinalDueDateString (yyyy/mm/dd)NO
InicialPaymentDateString(yyyy/mm/dd)NO 
FinalPaymentDateString (yyyy/mm/dd)NO 
Status Short Created - 0
CanBeRegister - 1
Registered - 3
Settlement - 5
Canceled - 7
Error - 8
NO 
RecieverTaxNumber String CPF/CNPJ of the Boleto receiverNO
RecieverBank Varchar Internal account receiver identification BankNO 
RecieverBankBranch Varchar Internal account receiver identification Bank BranchNO 
RecieverBankAccount Varchar Internal account receiver identification Bank AccountNO 
RecieverBankAccountDigit Varchar Internal account receiver identification Bank Account DigitNO 
SellerTaxNumber String CPF/CNPJ of the Boleto issuing accountNO 
SellerBank String Seller Bank NO 
SellerBankBranch String Seller Bank BranchNO
SellerBankAccount String Seller Bank AccountNO 
SupplierTaxNumber String CPF/CNPJ of the Boleto issuing account NO 
SupplierBank VarcharInternal account identification BankNO 
SupplierBankBranch VarcharInternal account identification Bank BranchNO 
SupplierBankAccount Varchar Internal account identification Bank AccountNO 
SupplierBankAccountDigit VarcharInternal account identification Bank Account DigitNO 
PageIndexStringReference of which page will be accessedNO
PageSizeStringNumber of results that will be displayed on the same pageNO

❗️

The GetBoletoByDate method will be discontinued.\

````