---
title: "Create Billing Note"
method: POST
path: "/api/v1/BillingNotes"
tags: ["BillingNotes"]
---

# Create Billing Note

`POST /api/v1/BillingNotes`

## Query parameters

- `getResult` integer — Numeric code used to reduce the amount of response data received

## Headers

- `Time-Stamp` string, required
- `Time-Signature` string, required
- `User-Token` string, required
- `Client-Token` string, required

## Request body

- PeakAPIsLibraryModelRequestBillingNotesBillingNotesPostModel
  - `peakBillingNotes` PeakAPIsLibraryModelRequestBillingNotesBillingNotesPostModelBillingNotes
    - `billingNotes` PeakAPIsLibraryModelRequestTransactionSharedBillingNotesTransaction[]
      - `code` string — The code of the document for which a billing note is to be issued
      - `issuedDate` string — Document issuance date
      - `dueDate` string — Document due date, which must be after the document issuance date
      - `contactId` string — Unique Identifier of the contact associated with the document
      - `contactCode` string — Code of the contact associated with the document (If contactId has been assigned a value, contactCode is not required)
      - `remark` string — Additional remarks or notes
      - `tags` string[] — Label attached to someone or something for the purpose of identification or to give other information
      - `transactions` PeakAPIsLibraryModelRequestTransactionSharedBillingNotesInvoice[] — The object array containing data of the documents to be invoiced
        - `id` string — The Unique Identifier of the document to be used for invoicing
        - `code` string — The Code of the document to be used for invoicing
        - `amount` number, double — Invoice amount
      - `paidPayments` PeakAPIsLibraryModelRequestTransactionSharedNormalPaymentsTransaction
        - `payments` PeakAPIsLibraryModelRequestTransactionSharedNormalPayment[] — The object with payment details
          - `cheque` PeakAPIsLibraryModelRequestTransactionSharedNormalCheque
            - `accountNo` string — Bank account number
            - `branchNo` string — Bank branch number
            - `chequeNo` string — Cheque number
            - `amount` number, double — Amount specified in the Cheque
            - `chequeDate` string — Cheque issuance date in the format yyyyMMdd
            - `bankId` integer — The numerical code that indicates a financial institution (If type is 2, bankId is required)
            - `paymentMethodId` string — The Unique Identifier of the payment method used to record the Cheque payment
            - `paymentMethodCode` string — The Code of the payment method used to record the Cheque payment
          - `note` string — Additional remarks or notes for that specific payment received
          - `isCheque` integer — The numerical code indicating whether this payment is made by Cheque or not
          - `amount` number, double — Payment amount
          - `paymentMethodId` string — The Unique Identifier of the payment method
          - `paymentMethodCode` string — Code of the payment method (If paymentMethodId has been assigned a value, paymentMethodCode is not required)
          - `accountCode` string — Account code to be used for recording financial transactions
          - `accountSubId` string — Sub account Unique Identifier to be used for recording financial transactions
          - `accountSubCode` string — Sub account code to be used for recording financial transactions
        - `paymentDate` string — Payment date in the format yyyyMMdd
        - `withHoldingTaxAmount` string
    - `getResult` integer

## Response `200`

Success

- PeakWCFModelsAPIResponseResponseBillingNoteModel
  - `peakBillingNotes` PeakWCFModelsAPIBodyAPIBodyBillingNote
    - `billingNotes` PeakWCFModelsAPIAPITransactionsBillingNotesAPIBillingNotesModel[]
      - `resCode` string
      - `resDesc` string
      - `id` string
      - `code` string
      - `issuedDate` string
      - `dueDate` string
      - `contactId` string
      - `contactCode` string
      - `remark` string
      - `tags` string[]
      - `transactions` PeakWCFModelsAPIAPITransactionsBillingNotesAPIBillingNoteInvoices[]
        - `id` string
        - `code` string
        - `amount` number, double
      - `paidPayments` PeakWCFModelsAPIAPITransactionsAPITransactionPayments[]
        - `id` string
        - `paymentDate` string
        - `withHoldingTaxAmount` string
        - `paymentGroupId` integer
        - `paymentTotal` number, double
        - `payments` PeakWCFModelsAPIAPITransactionsAPITransactionPaymentLists[]
          - `paymentMethodId` string
          - `paymentMethodCode` string
          - `accountCode` string
          - `accountSubId` string
          - `accountSubCode` string
          - `amount` number, double
          - `note` string
          - `isCheque` integer
          - `cheque` PeakWCFModelsAPIAPITransactionsAPITransactionChequePayment
            - `chequeDate` string
            - `paymentMethodId` string
            - `paymentMethodCode` string
            - `bankId` integer
            - `bankName` string
            - `amount` number, double
            - `chequeNo` string
            - `branchNo` string
            - `accountNo` string
            - `isDeposited` integer
        - `journals` PeakWCFModelsAPIAPITransactionsAPITransactionJournals[]
          - `id` string
          - `code` string
        - `referenceCode` string
        - `referenceId` string
        - `referenceType` string
      - `preTaxAmount` number, double
      - `netAmount` number, double
      - `vatAmount` number, double
      - `whtAmount` number, double
      - `paymentAmount` number, double
      - `remainAmount` number, double
      - `remainWhtAmount` number, double
      - `isVoid` integer
      - `documentLink` string
      - `onlineViewLink` string
    - `totalBillingNote` integer
    - `resDesc` string
    - `resCode` string
  - `eventType` string
  - `apiType` string

---

[API](https://skmtc.net/peakaccount/apis/peakapis-core.md) · [All operations](https://skmtc.net/peakaccount/apis/peakapis-core/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peakaccount/peakapis-core/versions/516e79534d77/schema)