feat: ability to change customer/vendor opening balance.

server/src/services/Contacts/ContactsService.ts

@@ -1,5 +1,6 @@
 import { Inject, Service } from 'typedi';
 import { difference, upperFirst, omit } from 'lodash';
+import moment from 'moment';
 import { ServiceError } from "exceptions";
 import TenancyService from 'services/Tenancy/TenancyService';
 import {
@@ -11,6 +12,10 @@ import JournalPoster from '../Accounting/JournalPoster';
 
 type TContactService = 'customer' | 'vendor';
 
+const ERRORS = {
+  OPENING_BALANCE_DATE_REQUIRED: 'OPENING_BALANCE_DATE_REQUIRED',
+};
+
 @Service()
 export default class ContactsService {
   @Inject()
@@ -185,4 +190,40 @@ export default class ContactsService {
       journal.deleteEntries(),
     ]);
   }
+
+  /**
+   * Chanages the opening balance of the given contact.
+   * @param {number} tenantId 
+   * @param {number} contactId
+   * @param {ICustomerChangeOpeningBalanceDTO} changeOpeningBalance 
+   * @return {Promise<void>}
+   */
+  public async changeOpeningBalance(
+    tenantId: number,
+    contactId: number,
+    contactService: string,
+    openingBalance: number,
+    openingBalanceAt?: Date|string,
+  ): Promise<void> {
+    const { contactRepository } = this.tenancy.repositories(tenantId);
+
+    // Retrieve the given contact details or throw not found service error.
+    const contact = await this.getContactByIdOrThrowError(tenantId, contactId, contactService);
+
+    // Should the opening balance date be required.
+    if (!contact.openingBalanceAt && !openingBalanceAt) {
+      throw new ServiceError(ERRORS.OPENING_BALANCE_DATE_REQUIRED);
+    };
+    // Changes the customer the opening balance and opening balance date.
+    await contactRepository.update({
+      openingBalance: openingBalance,
+
+      ...(openingBalanceAt) && ({
+        openingBalanceAt: moment(openingBalanceAt).toMySqlDateTime(),
+      }),
+    }, {
+      id: contactId,
+      contactService,
+    });
+  }
 }