Bill credit notes

Explore BillCreditNotes endpoints in Swagger.

Overview

A bill credit note is issued by a supplier to record credit. For example, if a supplier couldn't fulfil an order placed by a business, or delivered damaged goods, they would issue a bill credit note. A bill credit note reduces the amount a business owes to the supplier, and can be refunded or used to pay off future bills.

In the Codat, a bill credit note is an accounts payable record issued by a supplier.

A bill credit note includes detail of:

  • The original and remaining credit.
  • Any allocations of the credit against other records such as bills.
  • The supplier that issued the bill credit note.

Data model

Field

Type

Description

id

string

Identifier for the bill credit note that is unique to a company in the accounting platform.

billCreditNoteNumber

string

Friendly reference for the bill credit note.

supplierRef

reference type

Supplier that issued the bill credit note.

totalAmount

decimal

Total amount of credit that has been applied to the business' account with the supplier, including discounts and tax.

totalDiscount

decimal

Total value of any discounts applied.

subTotal

decimal

Total amount of the bill credit note, including discounts but excluding tax.

totalTaxAmount

decimal

Amount of tax included in the bill credit note.

discountPercentage

decimal

Percentage rate of any discount applied to the bill credit note.

remainingCredit

decimal

Amount of the bill credit note that is still outstanding.

status

string

Current state of the bill credit note, either:

  • Draft - Not yet confirmed in the accounting system

  • Submitted - Confirmed and with an outstanding balance

  • Paid - Allocated or refunded in full

  • Void - Invalid or void

issueDate

string
See date

Date the bill credit note was issued by the supplier.

allocatedOnDate

string
See date

Date the bill credit note was fully refunded or allocated.

currency

string
See currency

Currency of the bill credit note.

currencyRate

decimal
See currency rate

Conversion rate between the currency of the bill credit note and the base currency of the company.

lineItems

An array of BillCreditNoteLineItems.

paymentAllocations

An array of CreditNotePaymentAllocations.

modifiedDate

string
See date

Date the record was last updated in the Codat system.

sourceModifiedDate

string
See date

Date the record was last updated in the accounting system.

note

string

Any additional information about the bill credit note.

Line items

Details of each line of the bill credit note.

Field

Type

Description

description

string

Friendly name of each line item. For example, the goods or service for which credit has been received.

unitAmount

decimal

Unit price of the goods or service.

quantity

decimal

Number of units of the goods or service for which credit has been received.

discountAmount

decimal

Value of any discounts applied.

subTotal

decimal

Amount of credit associated with the line item, including discounts but excluding tax.

taxAmount

decimal

Amount of tax associated with the line item.

totalAmount

decimal

Total amount of the line item, including discounts and tax.

accountRef

reference type

Reference to the account to which the line item is linked.

discountPercentage

decimal

Percentage rate of any discount applied to the line item.

taxRateRef

reference type

Reference to the tax rate to which the line item is linked.

itemRef

reference type

Reference to the item the line is linked to.

trackingCategoryRefs

reference type

Reference to the tracking categories to which the line item is linked.

Payment allocations

Field

Type

Description

id

string

Identifier of the bill payment that was allocated to some or all of this bill credit note.

totalAmount

decimal

Amount allocated in the currency of the bill credit note.

currency

string
See currency

Currency of the original bill payment.

currencyRate

number
See currency rate

Conversion rate between the currency of the bill credit note and the currency of the bill payment.

date

string
See date

Date the bill payment was allocated to some or all of this bill credit note.

note

string

Notes attached to the bill payment.

Example data

{
    "id": "6a0e9dfb-87b0-47d3-aaaf-9753ae9e757d",
    "billCreditNoteNumber": "14763237",
    "totalAmount": 693,
    "remainingCredit": 693,
    "status": "Submitted",
    "issueDate": "2019-02-18T16:03:07.268Z",
  "note": "Track separately",  
    "currency": "USD",
    "lineItems": [
        {
            "description": "AcmeMagnet",
            "unitAmount": 25,
            "discountAmount": 0,
            "quantity": 4,
            "subTotal": 100,
            "taxAmount": 10,
            "totalAmount": 110,
            "itemRef": {
                "id": "3"
            },
            "taxRateRef": {
                "id": "6c88aff3-7cb9-4980-a3d3-443e72e02498"
            },
            "accountRef": {
                "id": "3f267b10-757d-44c0-bef9-20f70cc8fbe3"
            },
            "trackingCategoryRefs": [
                {
                    "id": "department_1",
                    "name": "ACMERockets"
                },
                {
                    "id": "costcode_2",
                    "name": "ACM2-ACMESigns"
                }
            ]
        },
        {
            "description": "ACMEDisintegratingPistol",
            "unitAmount": 25,
            "discountAmount": 0,
            "quantity": 3,
            "subTotal": 75,
            "taxAmount": 7.5,
            "totalAmount": 82.5,
            "itemRef": {
                "id": "3abf0883-03f7-44c6-bc15-1372522d25e1"
            },
            "taxRateRef": {
                "id": "6c88aff3-7cb9-4980-a3d3-443e72e02498"
            },
            "accountRef": {
                "id": "3f267b10-757d-44c0-bef9-20f70cc8fbe3"
            }
        },
        {
            "description": "ACMEWhippedCreamDispenser",
            "unitAmount": 52,
            "discountAmount": 0,
            "quantity": 6,
            "subTotal": 312,
            "taxAmount": 31.2,
            "totalAmount": 343.2,
            "itemRef": {
                "id": "3691f3d9-0ff7-4358-8a93-bed31c1b4b03"
            },
            "taxRateRef": {
                "id": "6c88aff3-7cb9-4980-a3d3-443e72e02498"
            },
            "accountRef": {
                "id": "3f267b10-757d-44c0-bef9-20f70cc8fbe3"
            }
        },
        {
            "description": "ACMEJetPropelledPogoStick",
            "unitAmount": 130,
            "discountAmount": 0,
            "quantity": 1,
            "subTotal": 130,
            "taxAmount": 27.3,
            "totalAmount": 157.3,
            "itemRef": {
                "id": "075410d4-7edc-4936-ba52-9e1e43cbe300"
            },
            "taxRateRef": {
                "id": "d606732b-db18-44d7-823b-7f15f42c32ea"
            },
            "accountRef": {
                "id": "3f267b10-757d-44c0-bef9-20f70cc8fbe3"
            }
        }
    ],
    "supplierRef": {
        "id": "67C6A7A1-5E84-4AC4-B950-24A114E379D0",
        "supplierName": "Chin's Gas and Oil"
    }
}

Did this page help you?