POST https://api.legendonlineservices.co.uk/POS/BillingWriteDowns

Write downs billing items

Request Parameters

From Body Type Description
ContactId Guid Contact who owns the Billing items
Notes String Any user friendly note to help during the reconcillation process
TenderTypeId Int32 Check Legend support for the TenderTypeId
WriteDownDate DateTime The date the payment was collected
[BillingWriteDownsRequestLineItem] List of billing items and payments. Make sure there is always one BillingId per request
Name Type Description
Amount Decimal Must be greater than zero and must not exceed the balance
BillingId Int32 Legend BillingId
GLAccountId Int32 GL Account to be used for write down 




{
  "ContactId": "51fae8d4-6a1f-49a8-93a2-6177f6066133",
  "WriteDownDate": "2025-10-18T09:49:48.2121926+01:00",
  "BillingWriteDowns": [
    {
      "BillingId": 1,
      "Amount": 2.0,
      "GLAccountId": 3
    },
    {
      "BillingId": 1,
      "Amount": 2.0,
      "GLAccountId": 3
    },
    {
      "BillingId": 1,
      "Amount": 2.0,
      "GLAccountId": 3
    }
  ],
  "TenderTypeId": 2,
  "Notes": "sample string 3"
}

Response - (Status 200 - OK)

BillingWriteDownsResponse

Name Type Description
ContactId Guid Contact who the Billing items belongs to
ErrorMessage String Error message if there is a global failure
Success Boolean
[BillingWriteDownsResponseLineItem] For each write down request, you will get one line item
Name Type Description
Balance Decimal Balance left on the billing item
BillingId Int32 Legend BillingId
ErrorMessage String For basic validation like not enough balance etc
ProcessDate DateTime
WriteDownDate DateTime 




{
  "ContactId": "b1308913-8654-4de4-943b-65d494372320",
  "BillingWriteDowns": [
    {
      "BillingId": 1,
      "Balance": 1.0,
      "ProcessDate": "2025-10-18T09:49:48.2121926+01:00",
      "WriteDownDate": "2025-10-18T09:49:48.2121926+01:00",
      "ErrorMessage": "sample string 2"
    },
    {
      "BillingId": 1,
      "Balance": 1.0,
      "ProcessDate": "2025-10-18T09:49:48.2121926+01:00",
      "WriteDownDate": "2025-10-18T09:49:48.2121926+01:00",
      "ErrorMessage": "sample string 2"
    },
    {
      "BillingId": 1,
      "Balance": 1.0,
      "ProcessDate": "2025-10-18T09:49:48.2121926+01:00",
      "WriteDownDate": "2025-10-18T09:49:48.2121926+01:00",
      "ErrorMessage": "sample string 2"
    }
  ],
  "ErrorMessage": "sample string 2",
  "Success": false
}

Bundle(s)
BillingWriteDown