Skip to main content
The Bill Credit Notes Data Model represents a financial transaction that can be applied against one or multiple bills issued to vendors. This unified model standardizes and simplifies the management of credit note information across various accounting platforms.
  • Unified credit note properties: Essential credit note details, such as contact ID, document number, total amount, and currency, are standardized across different accounting platforms
  • Detailed status tracking: The model supports various credit note statuses, including draft, submitted, partially paid, paid, overdue, void, and unknown, for better organisation and reporting
  • Line item integration: Credit notes can include an array of associated line items, ensuring comprehensive representation of credit note details and relationships to other data models

​
Attributes

​
Bill Credit Note Attributes

PropertyTypeDescription
rootfi_idintegerUnique identifier assigned by Commenda for this bill credit note
rootfi_created_atstringTimestamp when this record was created in Commenda’s system (ISO 8601)
rootfi_updated_atstringTimestamp when this record was last updated in Commenda’s system (ISO 8601)
rootfi_company_idintegerCompany identifier this bill credit note belongs to within Commenda
platform_idstringUnique identifier for this bill credit note in the source accounting platform
platform_unique_idstringAlternative unique identifier from the platform (some platforms provide multiple IDs)
contact_idstringThe contact ID of the bill credit note
currency_idstringThe currency ID of the bill credit note
bill_idsarrayThe bill IDs associated with the bill credit note
document_numberstringThe document number of the bill credit note
total_amountdoubleThe total amount of the bill credit note
remaining_creditdoubleThe remaining credit amount of the bill credit note
posted_datestringThe posted date of the bill credit note
statusenumThe status of the bill credit note
memostringThe memo or notes of the bill credit note
updated_atstringThe date and time the bill credit note was last updated
line_itemsarrayThe line items of the bill credit note

​
Status Enum Values

ValueDescription
DRAFTBill credit note is in draft status and has not been finalized
SUBMITTEDBill credit note has been submitted but not yet paid
PARTIALLY_PAIDBill credit note has received partial payment
PAIDBill credit note has been fully paid
OVERDUEBill credit note has passed its due date without payment
VOIDBill credit note has been voided or canceled
UNKNOWNStatus cannot be determined from the platform

​
Expandable Attributes

Use the expand query parameter to include related objects:
  • expand=contact - Includes full Contact object details
  • expand=currency - Includes full Currency object details
  • expand=payments - Includes all BillPayment objects where this credit note has been applied
  • expand=line_items - Includes detailed LineItem objects

​
Properties Supported

PropertyTypeDescription
platform_idstringThe Platform’s ID for the credit note
contact_idstringThe contact ID of the bill credit note
currency_idstringThe currency ID of the bill credit note
bill_idsarrayThe bill IDs associated with the bill credit note
document_numberstringThe document number of the bill credit note
total_amountdoubleThe total amount of the bill credit note
remaining_creditdoubleThe remaining credit amount of the bill credit note
posted_datestringThe posted date of the bill credit note
statusenumThe status of the bill credit note
memostringThe memo or notes of the bill credit note
line_itemsarrayThe line items of the bill credit note
updated_atstringThe date and time the bill credit note was last updated

​
Addresses

PropertyTypeDescription
platform_idstringPlatform's ID for the address
typeenumThe type of address. Values are: SHIPPING, BILLING, COMPANY, WAREHOUSE.
data_modelstringThe data model to which this address is linked. Observed values in current read mappers are COMPANY_INFO, CONTACT, INVOICE, BILL, INVOICE_CREDIT_NOTE, BILL_CREDIT_NOTE, PURCHASE_ORDER, SALES_ORDER, CASH_SALE, CASH_REFUND, and ORDER
data_model_idstringThe unique identifier for the data model associated with this address
streetstringThe street information of the address
localitystringThe locality or neighborhood information of the address
citystringThe city information of the address
statestringThe state or region information of the address
countrystringThe country information of the address
pincodestringThe postal or zip code of the address
updated_atdateThe date and time at which the address information was last updated in the accounting platform

​
Line Items

PropertyTypeDescription
platform_idstringPlatform ID associated with this line item
item_idstringThe platform ID of the item associated with this line item
tax_idstringThe platform ID of the tax associated with this line item
account_idstringThe platform ID of the account associated with this line item
line_item_typeenumThe data model linked to the line item. Values are: BILL, INVOICE, BILL_CREDIT_NOTE, INVOICE_CREDIT_NOTE, GOODS_RECEIPT_NOTE, EXPENSE, PURCHASE_ORDER, SALES_ORDER, CASH_REFUND, CASH_SALE, JOURNAL_ENTRY, ORDER
line_item_type_idstringThe platform ID of the associated data model
descriptionstringThe description for this line item
quantityfloatThe quantity of the product/service for this line item
unit_amountfloatPrice per unit for this line item
sub_totalfloatThe pre tax total value for this line item
tax_amountfloatThe tax amount for this line item
total_amountfloatThe total value of this line item
tracking_category_idsobjectThe tracking category Ids associated with this line item

​
Line Items Expandable Attributes

You can expand the following attributes to get the related line item data
PropertyData ModelDescription
itemItemsThe item associated with this line item
tax_rateTax RatesThe tax associated with this line item
accountAccountsThe account associated to the invoice
{
  "rootfi_id": 123,
  "rootfi_created_at": "2024-01-25T09:00:00Z",
  "rootfi_updated_at": "2024-01-25T09:00:00Z",
  "rootfi_company_id": 456,
  "platform_id": "123456_1",
  "platform_unique_id": "123456",
  "contact_id": "123456",
  "bill_ids": ["123456"],
  "currency_id": "123456",
  "document_number": "BCN2023-001",
  "total_amount": 140.0,
  "remaining_credit": 140.0,
  "posted_date": "2023-04-17T00:00:00.000Z",
  "status": "SUBMITTED",
  "memo": "Payment for Services",
  "updated_at": "2023-11-05T16:30:00.000Z",
  "line_items": []
}