{
  "platform_id": "3770712000001725001",
  "contact_id": "3770712000000209007",
  "bill_id": ["3770712000001725001"],
  "currency_id": "3770712000000209999",
  "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",
  "currency": {
    "data": {
      "platform_id": "3770712000000209999",
      "name": "Indian Rupee",
      "code": "INR",
      "symbol": "₹",
      "is_base_currency": true,
      "exchange_rate": 1.0,
      "updated_at": "2023-11-05T16:30:00.000Z"
    }
  },
  "line_Items": {
    "data": [
      {
        "platform_id": "3770712000001725011",
        "line_item_type": "Bill Credit Notes",
        "line_item_type_id": "3770712000001725001",
        "tracking_category_ids": [],
        "item_id": "3770712000000085075",
        "tax_id": "3770712000000106071",
        "account_id": "3770712000000076064",
        "description": "Test Line Item Description",
        "quantity": 5,
        "unit_amount": 25.0,
        "total_amount": 140.0,
        "sub_total": 125.0,
        "tax_amount": 15.0,
        "total_discount": null,
        "updated_at": "2023-11-05T16:30:00.000Z"
      }
    ]
  },
  "contact": null,
  "updated_at": "2023-11-05T16:30:00.000Z"
}

The Bill Credit Notes Data Model is designed to standardise and simplify the management of credit note information across various accounting platforms.

  • Unified credit note properties: The model consolidates essential credit note details, such as customer ID, document number, total amount, and currency, making it easier to work with credit note data from different 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

​
platform_id
string
required

The accounting Platform’s ID for the credit note

​
contact_id
string

The accounting platform’s unique identifier for the contact associated with this credit note

​
bill_id
string[]

An Array of bills associated with the credit note

​
currency_id
string

The ISO-4217 currency code of the transaction

​
document_number
string

Reference number for the credit note

​
total_amount
float

Total amount of credit note

​
remaining_credit
float

The balance amount remaining on the credit note

​
posted_date
date

Date on which the credit note was posted

​
status
enum

The status of the credit note. Values are: DRAFT, SUBMITTED, PARTIALLY_PAID, PAID, OVERDUE, VOID, UNKNOWN.

​
memo
string

Description of the credit note

​
currency
string

Currency of the credit note

​
line_Items
Line Item

An array of Credit Note Line Items

​
updated_at
date

The last ISO 8601 timestamp that the data was updated at

​
Properties Supported

PropertyTypeDescription
platform_idstringThe Platform’s ID for the credit note
contact_idstringThe accounting platform’s unique identifier for the contact associated with this credit note
document_numberstringReference number for the credit note
total_amountfloatTotal amount of credit note
remaining_creditfloatThe balance amount remaining on the credit note
posted_datedateDate on which the credit note was posted
statusenumThe status of the credit note. Values are: DRAFT, SUBMITTED, PARTIALLY_PAID, PAID, OVERDUE, VOID, UNKNOWN
memostringDescription of the credit note
currencystringCurrency of the credit note
line_ItemsLine ItemAn array of Credit Note Line Items
bill_idBillsAn Array of bills associated with the credit note
contactContactThe contact associated with this credit note
updated_atdateThe last ISO 8601 timestamp that the data was updated at
{
  "platform_id": "3770712000001725001",
  "contact_id": "3770712000000209007",
  "bill_id": ["3770712000001725001"],
  "currency_id": "3770712000000209999",
  "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",
  "currency": {
    "data": {
      "platform_id": "3770712000000209999",
      "name": "Indian Rupee",
      "code": "INR",
      "symbol": "₹",
      "is_base_currency": true,
      "exchange_rate": 1.0,
      "updated_at": "2023-11-05T16:30:00.000Z"
    }
  },
  "line_Items": {
    "data": [
      {
        "platform_id": "3770712000001725011",
        "line_item_type": "Bill Credit Notes",
        "line_item_type_id": "3770712000001725001",
        "tracking_category_ids": [],
        "item_id": "3770712000000085075",
        "tax_id": "3770712000000106071",
        "account_id": "3770712000000076064",
        "description": "Test Line Item Description",
        "quantity": 5,
        "unit_amount": 25.0,
        "total_amount": 140.0,
        "sub_total": 125.0,
        "tax_amount": 15.0,
        "total_discount": null,
        "updated_at": "2023-11-05T16:30:00.000Z"
      }
    ]
  },
  "contact": null,
  "updated_at": "2023-11-05T16:30:00.000Z"
}