zudello-integration-sdk 1.0.0

package/README.md

@@ -0,0 +1 @@
+# integration-sdk

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "zudello-integration-sdk",
+  "version": "1.0.0",
+  "description": "Zudello Integrations SDK",
+  "main": "./src/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zudello/integration-sdk.git"
+  },
+  "files": [
+    "src"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.658.0",
+    "axios": "^1.6.7",
+    "dotenv": "^16.4.5",
+    "lodash": "^4.17.21",
+    "moment-timezone": "^0.5.45",
+    "perf_hooks": "^0.0.1",
+    "standard": "^17.1.0"
+  },
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,62 @@
+'use strict'
+
+const Auth = require('./sdk/Auth')
+const ZudelloSDK = require('./sdk/Zudello')
+const NetsuiteSDK = require('./sdk/Netsuite')
+const NetsuiteSoapSDK = require('./sdk/NetsuiteSOAP')
+const IntacctSDK = require('./sdk/Intacct')
+const BusinessCentralSDK = require('./sdk/BusinessCentral')
+const ZenotiSDK = require('./sdk/Zenoti')
+const DearSDK = require('./sdk/Dear')
+const NexviaSDK = require('./sdk/Nexvia')
+const FoSDK = require('./sdk/Fo')
+const RetailExpressSDK = require('./sdk/RetailExpress')
+const MYOBAcumaticaSDK = require('./sdk/MYOBAcumatica')
+const SybizSDK = require('./sdk/Sybiz')
+const JobReadySDK = require('./sdk/JobReady')
+
+const Logger = require('./utils/logger')
+const Metadata = require('./utils/metadata')
+const Tags = require('./utils/tags')
+const Properties = require('./utils/properties')
+const MiscHelper = require('./utils/miscHelper')
+const ModelHelper = require('./utils/modelHelper')
+const {
+  getFileContent,
+  uploadFile,
+  listFiles,
+  deleteFile,
+  deleteFiles
+} = require('./utils/s3Client')
+
+const S3Client = {
+  getFileContent,
+  uploadFile,
+  listFiles,
+  deleteFile,
+  deleteFiles
+}
+
+module.exports = {
+  Auth,
+  ZudelloSDK,
+  NetsuiteSDK,
+  NetsuiteSoapSDK,
+  IntacctSDK,
+  BusinessCentralSDK,
+  ZenotiSDK,
+  DearSDK,
+  NexviaSDK,
+  FoSDK,
+  RetailExpressSDK,
+  MYOBAcumaticaSDK,
+  SybizSDK,
+  JobReadySDK,
+  Logger,
+  Metadata,
+  Tags,
+  Properties,
+  MiscHelper,
+  ModelHelper,
+  S3Client
+}

package/src/integrations/samples/bc-zudello/account.js

@@ -0,0 +1,40 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'accounts', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "number"),
+        "name": _.get(item, "displayName"),
+        "status": (item.blocked == false && item.directPosting == true) ? "ACTIVE" : "INACTIVE",
+        // "account_group": _.get(item, "category"),
+        "account_type": _.get(item, "accountType")
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.account.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/accountingPeriod.js

@@ -0,0 +1,52 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'accountingPeriods', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      const itemData = {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "id"),
+        "name": _.get(item, "name"),
+        "status": "ACTIVE",
+        "custom": JSON.stringify({
+          "newFiscalYear": _.get(item, "newFiscalYear")
+        }),
+        "is_closed": _.get(item, "closed"),
+        "ap_locked": _.get(item, "dateLocked"),
+        "ar_locked": _.get(item, "dateLocked")
+      }
+
+      const startDate = _.get(item, "startingDate")
+
+      if (startDate) {
+        itemData["start_date"] = moment(startDate).format("YYYY-MM-DD")
+      }
+
+      return itemData
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.accountingPeriod.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/currency.js

@@ -0,0 +1,42 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'currencies', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "code"),
+        "name": _.get(item, "displayName"),
+        "symbol": _.get(item, "symbol"),
+        "status": "ACTIVE",
+        "custom": JSON.stringify({
+          "amountRoundingPrecision": _.get(item, "amountRoundingPrecision")
+        })
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.currency.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/customer.js

@@ -0,0 +1,45 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'customers', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "number"),
+        "legal_name": _.get(item, "displayName"),
+        "trading_name": _.get(item, "displayName"),
+        "country": _.get(item, "country"),
+        "currency": _.get(item, "currencyCode"),
+        "payment_term": _.get(item, "paymentTermsId"),
+        "tax_number": _.get(item, "taxRegistrationNumber"),
+        "status": item.blocked == "_x0020_" ? "ACTIVE" : "INACTIVE",
+        "phone": _.get(item, "phone"),
+        "email": _.get(item, "email"),
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.customer.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/dimension.js

@@ -0,0 +1,85 @@
+const handler = async (providedData) => {
+  const dimensions = await BC.universal.list({ url: 'dimensions', method: 'GET' })
+
+  logger.log(dimensions)
+
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'dimensionValues', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    const dimenionValueGroups = _.groupBy(items.data.value, "dimensionId")
+
+    logger.log(dimenionValueGroups)
+
+    Object.keys(dimenionValueGroups).forEach(async dimensionId => {
+      const dimensionObj = _.head(
+        _.filter(dimensions.data.value, { "id": _.get(_.head(dimenionValueGroups[dimensionId]), "dimensionId") })
+      )
+
+      logger.log(dimensionObj)
+
+      let result = null
+
+      if (dimensionObj) {
+        const metafield = metadata.get('dimension_' + dimensionObj.code , "")
+
+        logger.log(dimensionObj.code)
+        logger.log(metafield)
+
+        if (metafield) {
+          const data = _.map(dimenionValueGroups[dimensionId], (item) => {
+            return {
+              "external_id": _.get(item, "id"),
+              "code": _.get(item, "code"),
+              "name": _.get(item, "displayName")
+            }
+          })
+
+          logger.log(data)
+
+          switch (_.toUpper(metafield)) {
+            case 'PROJECT': {
+              result = await Zudello.project.updateOrCreate({ data })
+              logger.log(result)
+
+              break
+            }
+            case 'DEPARTMENT': {
+              result = await Zudello.department.updateOrCreate({ data })
+              logger.log(result)
+
+              break
+            }
+            case 'COST_CENTRE': {
+              result = await Zudello.costCentre.updateOrCreate({ data })
+              logger.log(result)
+
+              break
+            }
+            case 'COST_TYPE': {
+              result = await Zudello.costType.updateOrCreate({ data })
+              logger.log(result)
+
+              break
+            }
+          }
+        }
+      }
+
+      if (result && result.success) {
+        const lastObject = _.last(items.data.value)
+        const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+        if (updatedLastModifiedDateTime) {
+          metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+        }
+      }
+    })
+  }
+}

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

@@ -0,0 +1,38 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'employees', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "number"),
+        "first_name": _.get(item, "givenName"),
+        "last_name": _.get(item, "surname")
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.employee.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/fixedAsset.js

@@ -0,0 +1,48 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'fixedAssets', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "number"),
+        "name": _.get(item, "displayName"),
+        "status": item.blocked ? "INACTIVE" : "ACTIVE",
+        "custom": JSON.stringify({
+          "fixedAssetLocationCode": _.get(item, "fixedAssetLocationCode"),
+          "fixedAssetLocationId": _.get(item, "fixedAssetLocationId"),
+          "classCode": _.get(item, "classCode"),
+          "subclassCode": _.get(item, "subclassCode"),
+          "serialNumber": _.get(item, "serialNumber"),
+          "employeeNumber": _.get(item, "employeeNumber"),
+          "employeeId": _.get(item, "employeeId"),
+          "underMaintenance": _.get(item, "underMaintenance")
+        })
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.fixedAsset.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/item.js

@@ -0,0 +1,45 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'items', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "sku": _.get(item, "number"),
+        "item_category": _.get(item, "itemCategoryId"),
+        "item_type": _.get(item, "type"),
+        "short_description": _.get(item, "displayName"),
+        "description": _.get(item, "displayName2"),
+        "purchase_price": _.get(item, "unitCost"),
+        "sell_price": _.get(item, "unitPrice"),
+        "tax_rate": _.get(item, "taxGroupId"),
+        "unit_of_measure": _.get(item, "baseUnitOfMeasureId"),
+        "status": item.blocked == false ? "ACTIVE" : "INACTIVE",
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.item.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/itemCategory.js

@@ -0,0 +1,37 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'itemCategories', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "code"),
+        "name": _.get(item, "displayName")
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.itemCategory.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/location.js

@@ -0,0 +1,37 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'locations', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "code"),
+        "name": _.get(item, "displayName")
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.location.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/paymentMethod.js

@@ -0,0 +1,38 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'paymentMethods', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "code"),
+        "name": _.get(item, "displayName"),
+        "status": "ACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.paymentMethod.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/paymentTerm.js

@@ -0,0 +1,41 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'paymentTerms', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "code"),
+        "name": _.get(item, "displayName"),
+        "status": "ACTIVE",
+        "custom": JSON.stringify({
+          "dueDateCalculation": _.get(item, "dueDateCalculation")
+        })
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.paymentTerm.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}

package/src/integrations/samples/bc-zudello/project.js

@@ -0,0 +1,38 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'projects', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(fetchData)
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(items)
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "number"),
+        "name": _.get(item, "displayName"),
+        "status": "ACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.project.updateOrCreate({ data })
+
+    logger.log(result)
+
+    if (result.success) {
+      const lastObject = _.last(items.data.value)
+      const updatedLastModifiedDateTime = lastObject ? lastObject.lastModifiedDateTime : null
+
+      if (updatedLastModifiedDateTime) {
+        metadata.set('lastModifiedDateTime', updatedLastModifiedDateTime)
+      }
+    }
+  }
+}