@things-factory/worksheet-base 8.0.0-beta.8 → 8.0.0

package/server/controllers/outbound/returning-worksheet-controller.ts

@@ -0,0 +1,254 @@
+import { OrderInventory, ORDER_INVENTORY_STATUS, ORDER_STATUS, ReleaseGood } from '@things-factory/sales-base'
+import {
+  Inventory,
+  Warehouse,
+  INVENTORY_STATUS,
+  INVENTORY_TRANSACTION_TYPE,
+  LOCATION_TYPE,
+  Location
+} from '@things-factory/warehouse-base'
+import { In } from 'typeorm'
+import { WORKSHEET_STATUS, WORKSHEET_TYPE } from '../../constants'
+import { Worksheet, WorksheetDetail } from '../../entities'
+import { VasWorksheetController } from '../vas/vas-worksheet-controller'
+
+export class ReturningWorksheetController extends VasWorksheetController {
+  async generateReturningWorksheet(
+    releaseGoodNo: string,
+    targetInventories: Partial<OrderInventory>[]
+  ): Promise<Worksheet> {
+    //@ts-ignore
+    const releaseGood: ReleaseGood = await this.findRefOrder(
+      //@ts-ignore
+      ReleaseGood,
+      { domain: { id: this.domain.id }, name: releaseGoodNo },
+      ['bizplace']
+    )
+    return await this.generateWorksheet(
+      WORKSHEET_TYPE.WAREHOUSE_RETURN,
+      releaseGood,
+      //@ts-ignore
+      targetInventories,
+      ORDER_STATUS.PARTIAL_RETURN,
+      ORDER_INVENTORY_STATUS.RETURNING
+    )
+  }
+
+  async activateReturning(
+    worksheetNo: string,
+    returningWorksheetDetails: Partial<WorksheetDetail>[]
+  ): Promise<Worksheet> {
+    const worksheet: Worksheet = await this.findActivatableWorksheet(worksheetNo, WORKSHEET_TYPE.WAREHOUSE_RETURN, [
+      'bizplace',
+      'releaseGood',
+      'worksheetDetails',
+      'worksheetDetails.targetInventory'
+    ])
+
+    const worksheetDetails: WorksheetDetail[] = worksheet.worksheetDetails
+    const targetInventories: OrderInventory[] = worksheetDetails.map((wsd: WorksheetDetail) => {
+      let targetInventory: OrderInventory = wsd.targetInventory
+      targetInventory.status = ORDER_INVENTORY_STATUS.RETURNING
+      targetInventory.updater = this.user
+      return targetInventory
+    })
+    await this.updateOrderTargets(targetInventories)
+    return await this.activateWorksheet(worksheet, worksheetDetails, returningWorksheetDetails)
+  }
+
+  async returning(
+    worksheetDetailName: [string],
+    palletId: string,
+    cartonId: string,
+    toLocation: string
+  ): Promise<void> {
+    if (cartonId) {
+      await this.warehouseReturnPutawayCarton(worksheetDetailName, cartonId, toLocation)
+    } else {
+      await this.warehouseReturnPutawayPallet(worksheetDetailName[0], palletId, toLocation)
+    }
+  }
+
+  async warehouseReturnPutawayPallet(
+    worksheetDetailName: string,
+    palletId: string,
+    toLocationName: string
+  ): Promise<void> {
+    let worksheetDetail: WorksheetDetail = await this.findExecutableWorksheetDetailByName(
+      worksheetDetailName,
+      WORKSHEET_TYPE.WAREHOUSE_RETURN,
+      [
+        'worksheet',
+        'worksheet.releaseGood',
+        'targetInventory',
+        'targetInventory.inventory',
+        'targetInventory.inventory.location'
+      ]
+    )
+
+    const worksheet: Worksheet = worksheetDetail.worksheet
+    const releaseGood: ReleaseGood = worksheet.releaseGood
+    let targetInventory: OrderInventory = worksheetDetail.targetInventory
+    let inventory: Inventory = targetInventory.inventory
+    let location: Location = inventory.location
+
+    const originLocation: Location = inventory.location
+    const originPalletId: string = inventory.palletId
+
+    const toLocation: Location = await this.trxMgr.getRepository(Location).findOne({
+      where: { domain: { id: this.domain.id }, name: toLocationName },
+      relations: ['warehouse']
+    })
+
+    if (worksheet.type === 'WAREHOUSE_RETURN' && releaseGood.recall) {
+      if (
+        ![LOCATION_TYPE.QUARANTINE, LOCATION_TYPE.RESERVE].some(l => {
+          return l === toLocation.type
+        })
+      ) {
+        throw new Error('Location should be assigned only to Quarantine or Reserve Zone')
+      }
+    }
+
+    if (!toLocation) throw new Error(this.ERROR_MSG.FIND.NO_RESULT(toLocationName))
+
+    const isPalletDiff: boolean = originPalletId !== palletId
+    if (isPalletDiff) {
+      throw new Error(this.ERROR_MSG.VALIDITY.CANT_PROCEED_STEP_BY('return', 'pallet ID is not matched'))
+    }
+
+    inventory.qty += targetInventory.releaseQty
+    inventory.uomValue += targetInventory.releaseUomValue
+    inventory.status = INVENTORY_STATUS.STORED
+
+    const isLocationChanged: boolean = originLocation.id !== toLocation.id
+    if (isLocationChanged) {
+      inventory.location = toLocation
+      inventory.warehouse = toLocation.warehouse
+      inventory.zone = toLocation.zone
+    }
+
+    await this.transactionInventory(
+      inventory,
+      releaseGood,
+      targetInventory.releaseQty,
+      targetInventory.releaseUomValue,
+      INVENTORY_TRANSACTION_TYPE.RETURN
+    )
+
+    // update status of order inventory
+    targetInventory.status = ORDER_INVENTORY_STATUS.TERMINATED
+    targetInventory.updater = this.user
+    targetInventory.returnToLocationQty = targetInventory.releaseQty
+    targetInventory.returnToLocationUomValue = targetInventory.releaseUomValue
+
+    await this.updateOrderTargets([targetInventory])
+
+    // update status of worksheet detail (EXECUTING => DONE)
+    worksheetDetail.status = WORKSHEET_STATUS.DONE
+    worksheetDetail.updater = this.user
+    await this.trxMgr.getRepository(WorksheetDetail).save(worksheetDetail)
+  }
+
+  async warehouseReturnPutawayCarton(
+    worksheetDetailName: [string],
+    cartonId: string,
+    toLocationName: string
+  ): Promise<void> {
+    const worksheetDetails: WorksheetDetail[] = await this.findExecutableWorksheetDetailByNames(
+      worksheetDetailName,
+      WORKSHEET_TYPE.WAREHOUSE_RETURN,
+      [
+        'worksheet',
+        'worksheet.releaseGood',
+        'targetInventory',
+        'targetInventory.inventory',
+        'targetInventory.inventory.location'
+      ]
+    )
+
+    for (var i = 0; i < worksheetDetails.length; i++) {
+      const worksheetDetail = worksheetDetails[i]
+      const worksheet: Worksheet = worksheetDetail.worksheet
+      const releaseGood: ReleaseGood = worksheet.releaseGood
+      let targetInventory: OrderInventory = worksheetDetail.targetInventory
+      let inventory: Inventory = targetInventory.inventory
+      let invLocation: Location = inventory.location
+
+      if (inventory.cartonId !== cartonId) {
+        throw new Error(this.ERROR_MSG.VALIDITY.UNEXPECTED_FIELD_VALUE('cartonId', cartonId, inventory.cartonId))
+      }
+
+      const location: Location = await this.trxMgr.getRepository(Location).findOne({
+        where: {
+          domain: { id: this.domain.id },
+          name: toLocationName,
+          type: In([
+            LOCATION_TYPE.SHELF,
+            LOCATION_TYPE.BUFFER,
+            LOCATION_TYPE.FLOOR,
+            LOCATION_TYPE.BIN,
+            LOCATION_TYPE.QUARANTINE
+          ])
+        },
+        relations: ['warehouse']
+      })
+
+      if (worksheet.type === 'WAREHOUSE_RETURN' && releaseGood.recall) {
+        if (
+          ![LOCATION_TYPE.QUARANTINE, LOCATION_TYPE.RESERVE].some(l => {
+            return l === location.type
+          })
+        ) {
+          throw new Error('Location should be assigned only to Quarantine or Reserve Zone')
+        }
+      }
+
+      if (!location) throw new Error(this.ERROR_MSG.FIND.NO_RESULT(toLocationName))
+      const warehouse: Warehouse = location.warehouse
+      //@ts-ignore
+      const zone: string = warehouse.zone
+
+      inventory.qty += targetInventory.releaseQty
+      inventory.uomValue += targetInventory.releaseUomValue
+      inventory.location = location
+      inventory.status = INVENTORY_STATUS.STORED
+      inventory.warehouse = warehouse
+      inventory.zone = zone
+      await this.transactionInventory(
+        inventory,
+        releaseGood,
+        targetInventory.releaseQty,
+        targetInventory.releaseUomValue,
+        INVENTORY_TRANSACTION_TYPE.RETURN
+      )
+
+      targetInventory.status = ORDER_INVENTORY_STATUS.TERMINATED
+      targetInventory.updater = this.user
+      targetInventory.returnToLocationQty = targetInventory.releaseQty
+      targetInventory.returnToLocationUomValue = targetInventory.releaseUomValue
+      await this.updateOrderTargets([targetInventory])
+
+      worksheetDetail.status = WORKSHEET_STATUS.DONE
+      worksheetDetail.updater = this.user
+      await this.trxMgr.getRepository(WorksheetDetail).save(worksheetDetail)
+    }
+  }
+
+  async completeReturning(releaseGoodNo: string): Promise<Worksheet> {
+    //@ts-ignore
+    const releaseGood: ReleaseGood = await this.findRefOrder(ReleaseGood, {
+      domain: { id: this.domain.id },
+      name: releaseGoodNo,
+      status: ORDER_STATUS.PARTIAL_RETURN
+    })
+
+    const worksheet: Worksheet = await this.findWorksheetByRefOrder(releaseGood, WORKSHEET_TYPE.WAREHOUSE_RETURN, [
+      'worksheetDetails',
+      'worksheetDetails.targetInventory'
+    ])
+    this.checkRecordValidity(worksheet, { status: WORKSHEET_STATUS.EXECUTING })
+
+    return await this.completeWorksheet(worksheet, ORDER_STATUS.DONE)
+  }
+}