@cityssm/dynamics-gp/gp/getItemByItemNumber.ts

Read only inquiries into Microsoft Dynamics GP using a SQL Server connection.

import { type mssql, connect } from '@cityssm/mssql-multi-pool'

import type { GPItemWithQuantities } from './types.js'

/**
 * Inquiry > Inventory > Item
 * @param mssqlConfig - The mssql configuration object.
 * @param itemNumber - The item number to look up.
 * @returns The item information or undefined if not found.
 */
export default async function _getItemByItemNumber(
  mssqlConfig: mssql.config,
  itemNumber: string
): Promise<GPItemWithQuantities | undefined> {
  const pool = await connect(mssqlConfig)

  const itemResult = await pool.request().input('itemNumber', itemNumber)
    .query<GPItemWithQuantities>(`SELECT top 1
      rtrim(ITEMNMBR) as itemNumber,
      rtrim(ITEMDESC) as itemDescription,
      rtrim(ITMSHNAM) as itemShortName,
      rtrim(ITEMTYPE) as itemType,
      rtrim(ITMCLSCD) as itemClassCode,
      rtrim(ITMGEDSC) as itemGenericDescription,
      STNDCOST as standardCost,
      CURRCOST as currentCost,
      CREATDDT as dateCreated,
      MODIFDT as dateModified
      FROM IV00101
      where ITEMNMBR = @itemNumber`)

  const item =
    itemResult.recordset.length > 0 ? itemResult.recordset[0] : undefined

  if (item !== undefined) {
    const quantityResults = await pool.request().input('itemNumber', itemNumber)
      .query(`SELECT
        rtrim(LOCNCODE) as locationCode,
        rtrim(BINNMBR) as binNumber,
        rtrim(PRIMVNDR) as primaryVendorId,
        BGNGQTY as beginningQuantity,
        LSORDQTY as lastOrderedQuantity,
        LSTORDDT as lastOrderedDate,
        rtrim(LSORDVND) as lastOrderedVendorId,
        LRCPTQTY as lastReceiptedQuantity,
        LSRCPTDT as lastReceiptedDate,
        QTYRQSTN as quantityRequisitioned,
        QTYONORD as quantityOnOrder,
        QTYBKORD as quantityBackOrdered,
        QTY_Drop_Shipped as quantityDropShipped,
        QTYINUSE as quantityInUse,
        QTYINSVC as quantityInService,
        QTYRTRND as quantityReturned,
        QTYDMGED as quantityDamaged,
        QTYONHND as quantityOnHand,
        ATYALLOC as quantityAllocated,
        QTYCOMTD as quantityCommitted,
        QTYSOLD as quantitySold,
        dateadd(second, DATEPART(second, LSTCNTTM), dateadd(minute, DATEPART(minute, LSTCNTTM), dateadd(hour, DATEPART(hour, LSTCNTTM), LSTCNTDT))) as lastCountDateTime,
        dateadd(second, DATEPART(second, NXTCNTTM), dateadd(minute, DATEPART(minute, NXTCNTTM), dateadd(hour, DATEPART(hour, NXTCNTTM), NXTCNTDT))) as nextCountDateTime
        FROM IV00102
        where ITEMNMBR = @itemNumber`)

    item.quantities = quantityResults.recordset
  }

  return item
}