zudello-integration-sdk 1.0.0

package/src/integrations/samples/intacct-zudello/apBill.js

@@ -0,0 +1,146 @@
+const handler = async (providedData) => {
+  const { payload } = providedData
+
+  const model = payload?.resource?.model || null
+  const uuid = payload?.resource?.uuid || null
+
+  logger.log(payload)
+  logger.log(model)
+  logger.log(uuid)
+
+  if (!model || !uuid) return
+
+  const fetchedItem = await Zudello.fetch({ model, uuid })
+
+  logger.log(fetchedItem)
+
+  if (!fetchedItem?.data?.data) return
+
+  const data = fetchedItem.data.data
+
+  logger.log(data)
+
+  const mapLine = line => ({
+    TAXTYPE: line.tax_rate?.external_id,
+    ACCOUNTNO: line.account?.external_id,
+    LOCATIONID: line.location?.external_id,
+    DEPARTMENTID: line.department?.external_id,
+    CLASSID: line.cost_centre?.external_id,
+    ITEMID: line.item?.external_id,
+    SUBSIDIARYID: line.subsidiary?.external_id,
+    TRXAMOUNT: line.total_exclusive,
+    TAXAMOUNT: line.tax_amount,
+    ENTRYDESCRIPTION: line.description,
+    customFields: [{ field_name: "QTY", field_value: line.quantity }]
+  })
+
+  const lines = data.lines?.map(mapLine) || []
+
+  const getFormattedDate = (date) => date ? moment(date).format('MM/DD/YYYY') : null
+
+  const getFileNameFromUrl = (url) => {
+    const regex = /[^/?#]+(?=\?|$)/
+    const matches = url.match(regex)
+    return matches ? matches[0] : null
+  }
+
+  const datePosted = getFormattedDate(data.date_posted) || getFormattedDate(data.date_issued)
+
+  const dateDue = getFormattedDate(data.date_due)
+
+  const fileAttachment = await Zudello.getFileAttachment({ uuid, type: 'EXTRACTED' })
+
+  if (!fileAttachment.success) {
+    logger.log('Failed to fetch attachment file')
+    return
+  }
+
+  logger.log('------------------------')
+  logger.log(fileAttachment)
+  logger.log('------------------------')
+
+  const metaFolderName = metadata.get('folder_name', 'Zudello Attachments')
+  const attachmentId = moment().unix()
+
+  const createAttachmentPayload = {
+    ENTITY_ID: { isMap: false, value: null },
+    PARENT_FOLDER_NAME: { isMap: false, value: metaFolderName },
+    PARENT_NAME: { isMap: false, value: `${_.get(data, "document_type")} ${_.get(data, "document_number")}` },
+    ATTACHMENT_ID: { isMap: false, value: attachmentId },
+    ATTACHMENT_URL: { isMap: false, value: fileAttachment.data },
+    ATTACHMENT_DESC: { isMap: false, value: `${_.get(data, "document_type")} ${_.get(data, "document_number")}` },
+    MIME_TYPE: { isMap: false, value: "application/pdf" },
+    FILE_NAME: { isMap: false, value: getFileNameFromUrl(fileAttachment.data) },
+  }
+
+  logger.log('------------------------')
+  logger.log(createAttachmentPayload)
+  logger.log('------------------------')
+
+  const intacctAttachment = await Intacct.file.create(createAttachmentPayload)
+
+  logger.log(JSON.stringify(intacctAttachment.data.response))
+
+  const createPayload = {
+    VENDORID: { isMap: false, value: data.supplier?.external_id },
+    WHENCREATED: { isMap: false, value: getFormattedDate(data.date_issued) },
+    WHENPOSTED: { isMap: false, value: datePosted },
+    WHENDUE: { isMap: false, value: dateDue },
+    EXCH_RATE_DATE: { isMap: false, value: datePosted },
+    RECORDID: { isMap: false, value: data.document_number },
+    DOCNUMBER: { isMap: false, value: data.reference },
+    DESCRIPTION: { isMap: false, value: fetchedItem.data.short_url },
+    CURRENCY: { isMap: false, value: data.currency?.code },
+    BASECURR: { isMap: false, value: data.currency?.code },
+    TAXSOLUTIONID: { isMap: false, value: "Australia - GST" },
+    APBILLITEMS: { isMap: true, value: `{{${JSON.stringify(lines)}}}` },
+    SUPDOCID: { isMap: true, value: attachmentId },
+    customFields: [{ field_name: "ARI_HEADER_LOCATION", field_value: lines[0]?.LOCATIONID }]
+  }
+
+  logger.log(createPayload)
+
+  const apBillResponse = await Intacct.apBill.create(createPayload)
+
+  logger.log(JSON.stringify(apBillResponse))
+
+  if (!apBillResponse?.data) return
+
+  const apBillResponseData = apBillResponse.data
+  const operationResult = apBillResponseData[0]?.operation[0]?.result[0]
+
+  let status = "COMPLETE"
+
+  if (operationResult?.status[0] === "failure") {
+    logger.log(operationResult?.errormessage[0]?.error[0]?.description2[0])
+    status = "UNABLE"
+  }
+
+  const resultPayload = {
+    model,
+    module: data.module,
+    submodule: data.submodule,
+    data: {
+      uuid,
+      status,
+      external_id: operationResult?.data?.[0]?.apbill?.[0]?.RECORDNO?.[0] || data.external_id,
+      log_messages: status === "UNABLE" ? {
+        replace: true,
+        items: [{
+          create: true,
+          data: {
+            status_code: 404,
+            body: JSON.stringify({ message: _.unescape(operationResult?.errormessage?.[0]?.error?.[0]?.description2?.[0]) }),
+            parse_as: "SENTENCE_ERROR"
+          }
+        }]
+      } : null
+    }
+  }
+
+  logger.log(JSON.stringify(resultPayload))
+
+  const zudelloUpdateResponse = await Zudello.update(resultPayload)
+
+  logger.log(JSON.stringify(zudelloUpdateResponse))
+}

package/src/integrations/samples/intacct-zudello/apBillFetch.js

@@ -0,0 +1,195 @@
+const handler = async (providedData) => {
+  const lastModified = metadata.get('lastModified')
+  const fetchData = { pageSize: 50, offset: 0, include: ['WHENMODIFIED'], orderBy: 'WHENMODIFIED' }
+
+  if (lastModified) {
+    fetchData.filters = [{
+      fName: { value: 'WHENMODIFIED' },
+      operator: { value: 'greaterthan' },
+      fValue: { value: lastModified }
+    }]
+  }
+
+  logger.log(fetchData)
+
+  for await (const itemPaginated of Intacct.apBill.autoPaginationList(fetchData)) {
+    logger.log(itemPaginated)
+
+    if (!Array.isArray(itemPaginated?.data)) {
+      continue
+    }
+
+    const itemIds = itemPaginated?.data?.map(pageItem => pageItem["RECORDNO"])
+    const items = await Intacct.universal.read({ type: "APBILL", keys: itemIds.join(', ') })
+
+    logger.log(items?.data?.response[0]?.operation[0]?.result[0]?.data[0]?.APBILL)
+
+    const data = _.map(items?.data?.response[0]?.operation[0]?.result[0]?.data[0]?.APBILL, (result) => {
+      return {
+        model: "Transaction",
+        data: {
+          module: "PURCHASING",
+          submodule: "INVOICE",
+          document_type: "EXPENSE",
+          "external_id": _.get(result, 'RECORDNO.0'),
+          "supplier": {
+            "fetch": true,
+            "create": true,
+            "update": false,
+            "data": {
+              "external_id": _.get(result, 'VENDORID.0')
+            }
+          },
+          "company_name": _.get(result, 'VENDORNAME.0'),
+          "company_tax": _.get(result, 'TAXID.0'),
+          "currency": {
+            "fetch": true,
+            "create": true,
+            "update": false,
+            "data": {
+              "external_id": _.get(result, 'CURRENCY.0')
+            }
+          },
+          "document_number": _.get(result, 'RECORDID.0'),
+          "reference": _.get(result, 'DOCNUMBER.0'),
+          "date_issued": _.get(result, 'WHENCREATED.0'),
+          "date_due": _.get(result, 'WHENDUE.0'),
+          "total": _.get(result, 'TOTALENTERED.0'),
+          "status": "COMPLETE",
+          "lines": {
+            "replace": false,
+            "items": _.flatten(_.map(_.get(result, 'APBILLITEMS.0.apbillitem'), (x) => {
+              const taxRate = _.get(x, "DETAILID.0")
+              const item = _.get(x, 'ITEMID.0')
+              const account = _.get(x,'ACCOUNTNO.0')
+              const department = _.get(x, 'DEPARTMENTID.0')
+              const location = _.get(x, 'LOCATIONID.0')
+              const costCentre = _.get(x, 'CLASSID.0')
+              const costType = _.get(x, "TASKID.0")
+              const project = _.get(x, "PROJECTID.0")
+
+              const itemData = {
+                "create": true,
+                "update": true,
+                "data": {
+                  "external_id": _.get(x, 'RECORDNO.0'),
+                  "description": _.get(x, 'ENTRYDESCRIPTION.0'),
+                  "line_number": _.get(x, 'LINE_NO.0'),
+                  "quantity": _.isNumber(_.get(x,'QTY.0',''))? _.get(x,'QTY.0') : 1,
+                  "unit_price": _.isNumber(_.get(x,'QTY.0',''))? _.get(x, 'TRX_AMOUNT.0')/_.get(x,'QTY.0') : _.get(x, 'TRX_AMOUNT.0'),
+                  "total": _.get(x, 'TRX_AMOUNT.0')
+                }
+              }
+
+              if (taxRate) {
+                itemData.data.tax_rate = {
+                  "fetch": true,
+                  "create": true,
+                  "update": false,
+                  "data": {
+                    "external_id": _.get(x, "DETAILID.0")
+                  }
+                }
+              }
+
+              if (item) {
+                itemData.data.item = {
+                  "fetch": true,
+                  "create": true,
+                  "update": false,
+                  "data": {
+                    "external_id": _.get(x, 'ITEMID.0')
+                  }
+                }
+              }
+              if (account) {
+                itemData.data.account = {
+                  "fetch": true,
+                  "create": true,
+                  "update": false,
+                  "data": {
+                    "external_id": _.get(x, 'ACCOUNTNO.0')
+                  }
+                }
+              }
+              if (department) {
+                itemData.data.department = {
+                  "fetch": true,
+                  "create": true,
+                  "update": false,
+                  "data": {
+                    "external_id": _.get(x, 'DEPARTMENTID.0')
+                  }
+                }
+              }
+
+              if (location) {
+                itemData.data.location = {
+                  "fetch": true,
+                  "create": true,
+                  "update": false,
+                  "data": {
+                    "external_id": _.get(x, 'LOCATIONID.0')
+                  }
+                }
+              }
+
+              if (costCentre) {
+                itemData.data.cost_centre = {
+                  "fetch": true,
+                  "create": true,
+                  "update": false,
+                  "data": {
+                    "external_id": _.get(x, 'CLASSID.0')
+                  }
+                }
+              }
+
+              if (costType) {
+                itemData.data.cost_type = {
+                  "fetch": true,
+                  "create": true,
+                  "update": false,
+                  "data": {
+                    "external_id": _.get(x, "TASKID.0")
+                  }
+                }
+              }
+
+              if (project) {
+                itemData.data.project = {
+                  "fetch": true,
+                  "create": true,
+                  "update": false,
+                  "data": {
+                    "external_id": _.get(x, "PROJECTID.0")
+                  }
+                }
+              }
+
+              return itemData
+            }))
+          }
+        },
+        "enrich": false,
+        "submit": false,
+        "create": true,
+        "update": true,
+        "update_status": false
+      }
+    })
+
+    logger.log(data)
+    const result = await Zudello.updateOrCreate({ data })
+    logger.log(result)
+
+    if (result.success) {
+    const lastObject = _.last(itemPaginated.data)
+      const updatedLastModified = lastObject ? lastObject.WHENMODIFIED : null
+
+      if (updatedLastModified) {
+        metadata.set('lastModified', updatedLastModified)
+      }
+    }
+  }
+}

package/src/integrations/samples/intacct-zudello/costCentre.js

@@ -0,0 +1,54 @@
+const handler = async (providedData) => {
+  const lastModified = metadata.get('lastModified')
+  const fetchData = { pageSize: 2000, offset: 0, include: ['WHENMODIFIED'], orderBy: 'WHENMODIFIED' }
+
+  if (lastModified) {
+    fetchData.filters = [{
+      fName: { value: 'WHENMODIFIED' },
+      operator: { value: 'greaterthan' },
+      fValue: { value: lastModified }
+    }]
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of Intacct.class.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "CLASSID"),
+        "code": _.get(item, "CLASSID"),
+        "name": _.get(item, "NAME"),
+        "status": _.get(item, "STATUS", "ACTIVE").toUpperCase(),
+      }
+    })
+
+    const batchSize = 100
+
+    for (let i = 0; i < data.length; i += batchSize) {
+      const batch = data.slice(i, i + batchSize)
+
+      logger.log(batch)
+
+      const result = await Zudello.costCentre.updateOrCreate({ data: batch })
+
+      logger.log(result)
+      logger.log(`Processed batch ${Math.ceil((i + batchSize) / batchSize)} of ${Math.ceil(data.length / batchSize)}`)
+
+      if (result.success) {
+        const lastObject = _.last(items.data)
+        const updatedLastModified = lastObject ? lastObject.WHENMODIFIED : null
+
+        if (updatedLastModified) {
+          metadata.set('lastModified', updatedLastModified)
+        }
+      }
+
+      // Introduce a delay of 3 seconds (3000 milliseconds) after each batch
+      if (i + batchSize < data.length) {
+        await new Promise(resolve => setTimeout(resolve, 3000))
+      }
+    }
+  }
+}

package/src/integrations/samples/intacct-zudello/costType.js

@@ -0,0 +1,54 @@
+const handler = async (providedData) => {
+  const lastModified = metadata.get('lastModified')
+  const fetchData = { pageSize: 2000, offset: 0, include: ['WHENMODIFIED'], orderBy: 'WHENMODIFIED' }
+
+  if (lastModified) {
+    fetchData.filters = [{
+      fName: { value: 'WHENMODIFIED' },
+      operator: { value: 'greaterthan' },
+      fValue: { value: lastModified }
+    }]
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of Intacct.costType.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "COSTTYPEID"),
+        "code": _.get(item, "COSTTYPEID"),
+        "name": _.get(item, "NAME"),
+        "status": _.get(item, "STATUS", "ACTIVE").toUpperCase(),
+      }
+    })
+
+    const batchSize = 100
+
+    for (let i = 0; i < data.length; i += batchSize) {
+      const batch = data.slice(i, i + batchSize)
+
+      logger.log(batch)
+
+      const result = await Zudello.costType.updateOrCreate({ data: batch })
+
+      logger.log(result)
+      logger.log(`Processed batch ${Math.ceil((i + batchSize) / batchSize)} of ${Math.ceil(data.length / batchSize)}`)
+
+      if (result.success) {
+        const lastObject = _.last(items.data)
+        const updatedLastModified = lastObject ? lastObject.WHENMODIFIED : null
+
+        if (updatedLastModified) {
+          metadata.set('lastModified', updatedLastModified)
+        }
+      }
+
+      // Introduce a delay of 3 seconds (3000 milliseconds) after each batch
+      if (i + batchSize < data.length) {
+        await new Promise(resolve => setTimeout(resolve, 3000))
+      }
+    }
+  }
+}

package/src/integrations/samples/intacct-zudello/customerCategory.js

@@ -0,0 +1,54 @@
+const handler = async (providedData) => {
+  const lastModified = metadata.get('lastModified')
+  const fetchData = { pageSize: 2000, offset: 0, include: ['WHENMODIFIED'], orderBy: 'WHENMODIFIED' }
+
+  if (lastModified) {
+    fetchData.filters = [{
+      fName: { value: 'WHENMODIFIED' },
+      operator: { value: 'greaterthan' },
+      fValue: { value: lastModified }
+    }]
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of Intacct.customerType.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "RECORDID"),
+        "code": _.get(item, "RECORDID"),
+        "name": _.get(item, "NAME"),
+        "status": _.get(item, "STATUS", "ACTIVE").toUpperCase(),
+      }
+    })
+
+    const batchSize = 100
+
+    for (let i = 0; i < data.length; i += batchSize) {
+      const batch = data.slice(i, i + batchSize)
+
+      logger.log(batch)
+
+      const result = await Zudello.customerCategory.updateOrCreate({ data: batch })
+
+      logger.log(result)
+      logger.log(`Processed batch ${Math.ceil((i + batchSize) / batchSize)} of ${Math.ceil(data.length / batchSize)}`)
+
+      if (result.success) {
+        const lastObject = _.last(items.data)
+        const updatedLastModified = lastObject ? lastObject.WHENMODIFIED : null
+
+        if (updatedLastModified) {
+          metadata.set('lastModified', updatedLastModified)
+        }
+      }
+
+      // Introduce a delay of 3 seconds (3000 milliseconds) after each batch
+      if (i + batchSize < data.length) {
+        await new Promise(resolve => setTimeout(resolve, 3000))
+      }
+    }
+  }
+}

package/src/integrations/samples/intacct-zudello/customerGroup.js

@@ -0,0 +1,54 @@
+const handler = async (providedData) => {
+  const lastModified = metadata.get('lastModified')
+  const fetchData = { pageSize: 2000, offset: 0, include: ['WHENMODIFIED'], orderBy: 'WHENMODIFIED' }
+
+  if (lastModified) {
+    fetchData.filters = [{
+      fName: { value: 'WHENMODIFIED' },
+      operator: { value: 'greaterthan' },
+      fValue: { value: lastModified }
+    }]
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of Intacct.customerGroup.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "ID"),
+        "code": _.get(item, "ID"),
+        "name": _.get(item, "NAME"),
+        "status": "ACTIVE",
+      }
+    })
+
+    const batchSize = 100
+
+    for (let i = 0; i < data.length; i += batchSize) {
+      const batch = data.slice(i, i + batchSize)
+
+      logger.log(batch)
+
+      const result = await Zudello.customerGroup.updateOrCreate({ data: batch })
+
+      logger.log(result)
+      logger.log(`Processed batch ${Math.ceil((i + batchSize) / batchSize)} of ${Math.ceil(data.length / batchSize)}`)
+
+      if (result.success) {
+        const lastObject = _.last(items.data)
+        const updatedLastModified = lastObject ? lastObject.WHENMODIFIED : null
+
+        if (updatedLastModified) {
+          metadata.set('lastModified', updatedLastModified)
+        }
+      }
+
+      // Introduce a delay of 3 seconds (3000 milliseconds) after each batch
+      if (i + batchSize < data.length) {
+        await new Promise(resolve => setTimeout(resolve, 3000))
+      }
+    }
+  }
+}

package/src/integrations/samples/intacct-zudello/department.js

@@ -0,0 +1,54 @@
+const handler = async (providedData) => {
+  const lastModified = metadata.get('lastModified')
+  const fetchData = { pageSize: 2000, offset: 0, include: ['WHENMODIFIED'], orderBy: 'WHENMODIFIED' }
+
+  if (lastModified) {
+    fetchData.filters = [{
+      fName: { value: 'WHENMODIFIED' },
+      operator: { value: 'greaterthan' },
+      fValue: { value: lastModified }
+    }]
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of Intacct.department.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "DEPARTMENTID"),
+        "code": _.get(item, "DEPARTMENTID"),
+        "name": _.get(item, "TITLE"),
+        "status": _.get(item, "STATUS", "ACTIVE").toUpperCase(),
+      }
+    })
+
+    const batchSize = 100
+
+    for (let i = 0; i < data.length; i += batchSize) {
+      const batch = data.slice(i, i + batchSize)
+
+      logger.log(batch)
+
+      const result = await Zudello.department.updateOrCreate({ data: batch })
+
+      logger.log(result)
+      logger.log(`Processed batch ${Math.ceil((i + batchSize) / batchSize)} of ${Math.ceil(data.length / batchSize)}`)
+
+      if (result.success) {
+        const lastObject = _.last(items.data)
+        const updatedLastModified = lastObject ? lastObject.WHENMODIFIED : null
+
+        if (updatedLastModified) {
+          metadata.set('lastModified', updatedLastModified)
+        }
+      }
+
+      // Introduce a delay of 3 seconds (3000 milliseconds) after each batch
+      if (i + batchSize < data.length) {
+        await new Promise(resolve => setTimeout(resolve, 3000))
+      }
+    }
+  }
+}

package/src/integrations/samples/intacct-zudello/employee.js

@@ -0,0 +1,51 @@
+const handler = async (providedData) => {
+  const lastModified = metadata.get('lastModified')
+  const fetchData = { pageSize: 100, offset: 0, include: ['WHENMODIFIED'], filters: [{ fName: "VENDTYPE", operator: "equalto", fValue: "Employees" }], orderBy: 'WHENMODIFIED' }
+
+  if (lastModified) {
+    fetchData.filters.push({
+      fName: { value: 'WHENMODIFIED' },
+      operator: { value: 'greaterthan' },
+      fValue: { value: lastModified }
+    })
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of Intacct.vendor.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data, (result) => {
+      return {
+        "external_id": _.get(result, "VENDORID"),
+        "first_name": _.get(result, "DISPLAYCONTACT.FIRSTNAME"), 
+        "last_name": _.get(result, "DISPLAYCONTACT.LASTNAME"), 
+        "emails": {
+          "replace": true,
+          "items": (_.get(result, "DISPLAYCONTACT.EMAIL1")) ?[ 
+              {
+                "create": true,
+                "data": {
+                  "email": _.get(result, "DISPLAYCONTACT.EMAIL1")
+                }
+              }
+          ] : []
+        },
+        "status": _.get(result, "STATUS").toUpperCase()
+      }
+    })
+
+
+    const result = await Zudello.employee.updateOrCreate({ data })
+    logger.log(JSON.stringify(result))
+    if (result.success) {
+      const lastObject = _.last(items.data)
+      const updatedLastModified = lastObject ? lastObject.WHENMODIFIED : null
+
+      if (updatedLastModified) {
+        metadata.set('lastModified', updatedLastModified)
+      }
+    }
+
+  }
+}