zudello-integration-sdk 1.0.0

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

@@ -0,0 +1,20 @@
+const handler = async (providedData) => {
+  for await (const items of Nexvia.universal.autoPaginationList({ url: 'locations', method: 'GET' })) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "name"),
+        "name": _.get(item, "name"),
+        "status": "ACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.location.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}

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

@@ -0,0 +1,20 @@
+const handler = async (providedData) => {
+  for await (const items of Nexvia.universal.autoPaginationList({ url: 'jobs', method: 'GET' })) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "number"),
+        "name": _.get(item, "name"),
+        "status": (_.get(item, "statusId") == 1) ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.project.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}

package/src/integrations/samples/nexvia-zudello/supplier.js

@@ -0,0 +1,21 @@
+const handler = async (providedData) => {
+  for await (const items of Nexvia.universal.autoPaginationList({ url: 'suppliers', method: 'GET' })) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "legal_name": _.get(item, "name"),
+        "trading_name": _.get(item, "name"),
+        "tax_number": _.get(item, "taxNumber"),
+        "status": (!_.get(item, "disabled", false)) ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.supplier.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}

package/src/integrations/samples/nexvia-zudello/taxRate.js

@@ -0,0 +1,21 @@
+const handler = async (providedData) => {
+  for await (const items of Nexvia.universal.autoPaginationList({ url: 'tax-rates', method: 'GET' })) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "code"),
+        "name": _.get(item, "name"),
+        "rate": _.get(item, "rate"),
+        "status": (_.get(item, "status") == "active") ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.tax.rate.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}

package/src/integrations/samples/nexvia-zudello/uom.js

@@ -0,0 +1,19 @@
+const handler = async (providedData) => {
+  for await (const items of Nexvia.universal.autoPaginationList({ url: 'measures', method: 'GET' })) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "name": _.get(item, "description"),
+        "status": (_.get(item, "active")) ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.uom.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}

package/src/integrations/samples/nexvia-zudello/zone.js

@@ -0,0 +1,20 @@
+const handler = async (providedData) => {
+  for await (const items of Nexvia.universal.autoPaginationList({ url: 'labour-types', method: 'GET' })) {
+    logger.log(items)
+
+    const data = _.map(items.data, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "shortName"),
+        "name": _.get(item, "name"),
+        "status": (!_.get(item, "disabled", false)) ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.zone.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}

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

@@ -0,0 +1,20 @@
+const handler = async (providedData) => {
+  for await (const items of Zenoti.universal.autoPaginationList({ url: 'centers', method: 'GET' })) {
+    logger.log(items)
+
+    const data = _.map(items.data.centers, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "code"),
+        "name": _.get(item, "display_name"),
+        "status": (_.get(item, "STATUS", "is_fbe_enabled")) ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.location.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}

package/src/integrations/samples/zenoti-zudello/product.js

@@ -0,0 +1,32 @@
+const handler = async (providedData) => {
+  for await (const centers of Zenoti.universal.autoPaginationList({ url: 'centers', method: 'GET' })) {
+    for (center of centers.data.centers) {
+      for await (const items of Zenoti.universal.autoPaginationList({
+       url: `centers/${center.id}/products`, 
+       method: 'GET',
+       body: {
+        show_in_catalog: true,
+        expand: ["centers", "tags", "catalog_info", "preferences", "barcodes"]
+       }
+     })) {
+        logger.log(items)
+
+        const data = _.map(items.data.products, (item) => {
+          return {
+            "external_id": _.get(item, "code"),
+            "sku": _.get(item, "code"),
+            "description": _.get(item, "description"),
+            "short_description": _.get(item, "name"),
+            "status": "ACTIVE"
+          }
+        })
+
+        logger.log(data)
+
+        const result = await Zudello.item.updateOrCreate({ data })
+
+        logger.log(result)
+      }
+    }
+  }
+}

package/src/integrations/samples/zenoti-zudello/purchaseOrder.js

@@ -0,0 +1,193 @@
+const handler = async (providedData) => {
+  for await (const centers of Zenoti.universal.autoPaginationList({ url: 'centers', method: 'GET' })) {
+    for (center of centers.data.centers) {
+      logger.log(center.id)
+
+      for await (const items of Zenoti.universal.autoPaginationList({
+        url: 'inventory/purchase_orders',
+        method: 'GET',
+        qs: {
+          center_id: center.id,
+          start_date: moment().startOf('month').format('YYYY-MM-DD'),
+          end_date: moment().endOf('month').format('YYYY-MM-DD'),
+          show_delivery_details: true,
+          date_criteria: 1,
+          status: 2
+        }
+      })) {
+        logger.log(items)
+
+        const data = await Promise.all(_.map(items.data.orders, async (item) => {
+          logger.log(item)
+
+          const productCodes = _.flatten(
+            _.map(_.get(item, 'partials'), (partial, invoiceID) => {
+              return _.map(_.get(partial, 'line_items'), (lineItem, lineID) => {
+                return _.get(lineItem, 'product_code');
+              })
+            })
+          );
+
+          const zudelloItems = await Zudello.search({
+            "model": "Item",
+            "offset": 0,
+            "limit": 30,
+            "select": [
+              "unit_of_measure_conversions__factor",
+              "unit_of_measure_conversions__operation",
+              "sku"
+            ],
+            "order_by": [
+              "-created_at"
+            ],
+            "filter": {
+              "sku__in": productCodes,
+              "module": "INVENTORY",
+              "submodule": "CATALOGUE",
+              "status": "ACTIVE"
+            }
+          });
+
+          logger.log(zudelloItems);
+
+          const zudelloItemsData = zudelloItems?.data?.data ?? [];
+
+          const tax = _.reduce(item.partials, (acc, partial) => {
+            const partialTax = _.reduce(partial.line_items, (partialAcc, lineItem) => {
+              return partialAcc + (lineItem.ordered_tax_amount * lineItem.ordered_retail_quantity)
+            }, 0)
+
+            return acc + partialTax
+          }, 0)
+
+          const total = _.reduce(item.partials, (acc, partial) => {
+            const partialTotal = _.reduce(partial.line_items, (partialAcc, lineItem) => {
+              return partialAcc + (lineItem.ordered_unit_price * lineItem.ordered_retail_quantity)
+            }, 0)
+
+            return acc + partialTotal
+          }, 0)
+
+          const transactionData = {
+            model: "Transaction",
+            data: {
+              module: "PURCHASING",
+              submodule: "ORDER",
+              document_type: "PURCHASE_ORDER",
+              "external_id": _.get(item, "order_id"),
+              "supplier": {
+                "fetch": true,
+                "create": true,
+                "update": false,
+                "data": {
+                  "external_id": _.get(item, 'vendor.code')
+                }
+              },
+              "company_name": _.get(item, 'vendor_name'),
+              "company_tax": _.get(item, 'vendor.tin'),
+              "document_number": _.get(item, "order_number"),
+              "subtotal": total - tax,
+              "tax": tax,
+              "total": total,
+              "status": "READY",
+              "lines": {
+                "replace": false,
+                "items": _.flatten(_.map(_.get(item, 'partials'), (partial, invoiceID) => {
+                  return _.map(_.get(partial, 'line_items'), (lineItem, lineID) => {
+                    const productCode = _.get(lineItem, 'product_code');
+                    const location = _.get(item, 'center.code');
+
+                    const productCodeItem = zudelloItemsData.find(item => item.sku === productCode);
+
+                    let itemDataQty = _.get(lineItem, "ordered_retail_quantity")
+
+                    logger.log('---------------------')
+                    logger.log(itemDataQty)
+
+                    if (productCodeItem) {
+                      const factor = productCodeItem.unit_of_measure_conversions?.factor ? Number(productCodeItem.unit_of_measure_conversions?.factor) : null
+                      const operation = productCodeItem.unit_of_measure_conversions?.operation ?? null
+
+                      if (operation === 'MULTIPLY' && factor) {
+                        logger.log('MULTIPLY')
+                        logger.log(factor)
+
+                        itemDataQty = itemDataQty * factor
+                      }
+
+                      if (operation === 'DIVIDE' && factor) {
+                        logger.log('DIVIDE')
+                        logger.log(factor)
+
+                        itemDataQty = itemDataQty / factor
+                      }
+                    }
+
+                    logger.log(itemDataQty)
+                    logger.log('---------------------')
+
+                    const itemData = {
+                      "create": true,
+                      "update": true,
+                      "data": {
+                        "external_id": _.get(item, "order_id") + "-" + invoiceID + "-" + lineID,
+                        "description": _.get(lineItem, 'product_name'),
+                        "quantity": itemDataQty, 
+                        "unit_price": _.get(lineItem, "ordered_unit_price"),
+                        "total": _.get(lineItem, "ordered_retail_quantity") * _.get(lineItem, "ordered_unit_price"),
+                        "note": _.get(lineItem, "notes")
+                      }
+                    };
+
+                    if (productCode) {
+                      itemData.data.item = {
+                        "fetch": true,
+                        "create": true,
+                        "update": false,
+                        "data": {
+                          "external_id": productCode
+                        }
+                      };
+                    }
+
+                    if (location) {
+                      itemData.data.location = {
+                        "fetch": true,
+                        "create": true,
+                        "update": false,
+                        "data": {
+                          "external_id": location
+                        }
+                      };
+                    }
+
+                    return itemData;
+                  });
+                }))
+              }
+            },
+            "enrich": false,
+            "submit": false,
+            "create": true,
+            "update": true,
+            "update_status": false
+          }
+
+          const orderedDate = _.get(item, 'ordered_date');
+
+          if (orderedDate) {
+            transactionData.data.date_issued = moment(orderedDate).format('YYYY-MM-DD')
+          }
+
+          return transactionData
+        }))
+
+        logger.log(data)
+
+        const result = await Zudello.updateOrCreate({ data })
+
+        logger.log(result)
+      }
+    }
+  }
+}

package/src/sdk/Auth.js

@@ -0,0 +1,42 @@
+'use strict'
+
+const ApiInstance = require('../utils/apiInstance')
+
+class Auth {
+  /**
+   * Constructor.
+   * @param {string} teamUUID The UUID of the Team we're working on.
+   * @param {string|null} token JWT Token.
+   */
+  constructor ({ teamUUID, token }) {
+    this.teamUUID = teamUUID
+    this.token = token
+
+    this.apiInstance = new ApiInstance()
+  }
+
+  /**
+   * Getter function for teamUUID.
+   * @returns {string} Team UUID.
+   */
+  getTeamUUID () {
+    return this.teamUUID
+  }
+
+  /**
+   * Getter function for apiInstance.
+   * @returns {class} Api Instance Class Object.
+   */
+  getApiInstance () {
+    return this.apiInstance
+  }
+
+  /**
+   * Makes an auth based on provided keys and stores the Bearer Token.
+   */
+  async authenticate () {
+    this.apiInstance.setBearerToken(this.token)
+  }
+}
+
+module.exports = Auth

package/src/sdk/Base.js

@@ -0,0 +1,118 @@
+'use strict'
+
+const config = require('../utils/config')
+const Validator = require('../utils/validator')
+const Logger = require('../utils/logger')
+
+class BaseSDK {
+  /**
+   * Constructor.
+   * @param {class} auth Auth class object with authorized api instance.
+   * @param {string|null} connectionUUID The UUID of the Connection we're working on.
+   * @param {string|null} appUUIDKey The Key of UUID of the App we're working on.
+   * @param {boolean} isExternal Is Connection external.
+   * @param {string} organizationUUID The UUID of the Organization.
+   * @param {string} apiURL The URL of the API.
+   * @param {string} apiVersion The Version of the API.
+   */
+  constructor ({
+    auth,
+    connectionUUID = null,
+    appUUIDKey = null,
+    isExternal = true,
+    organizationUUID,
+    apiURL,
+    apiVersion = 'v1',
+    integrationName = '',
+    loggerClass = null
+  }) {
+    this.config = config
+    this.connectionUUID = connectionUUID
+    this.isExternal = isExternal
+    this.organizationUUID = organizationUUID
+    this.integrationName = integrationName
+
+    this.validator = new Validator()
+    this.logger = loggerClass ? loggerClass : new Logger()
+
+    this.teamUUID = auth.getTeamUUID()
+    this.apiInstance = auth.getApiInstance()
+
+    this.responseHandler = this.apiInstance.responseHandler
+
+    this.apiVersion = apiVersion
+    this.apiURL = apiURL
+
+    this.appUUID = appUUIDKey
+      ? this.config.appUUIDs[appUUIDKey]
+      : null
+  }
+
+  async makeRequest (method, url, data, params = {}, returnHeaders = false) {
+    const callback = ({ status, response, body, params, headers }) => {
+      this.logger.request(`${this.integrationName} - ${method} ${url}`, {
+        status,
+        request: {
+          url,
+          method,
+          body,
+          params,
+          headers
+        },
+        response
+      })
+    }
+
+    switch (method.toLowerCase()) {
+      case 'get':
+        return await this.apiInstance.get(url, this.populateStaticParams(data), this.getStaticHeaders(), returnHeaders, callback)
+      case 'post':
+        return await this.apiInstance.post(url, data, this.getStaticHeaders(), this.populateStaticParams(params), callback)
+      case 'put':
+        return await this.apiInstance.put(url, data, this.getStaticHeaders(), this.populateStaticParams(params), callback)
+      case 'delete':
+        return await this.apiInstance.delete(url, callback)
+      default:
+        return this.responseHandler.error(['Request method not found.'])
+    }
+  }
+
+  /**
+   * Get static object of headers for all requests.
+   * @returns {object} Object with static headers.
+   */
+  getStaticHeaders () {
+    return {
+      'x-team': this.teamUUID,
+      'X-Organization': this.organizationUUID,
+      'Content-Type': 'application/json'
+    }
+  }
+
+  /**
+   * Get static object of params for all requests.
+   * @returns {object} Object with static params.
+   */
+  getStaticParams () {
+    return this.isExternal ? {
+      _debug: false,
+      connection: this.connectionUUID,
+      team: this.teamUUID,
+      app: this.appUUID
+    } : {}
+  }
+
+  /**
+   * Populate dynamic params with static ones.
+   * @param {object} params The dynamic params.
+   * @returns {object} Populated object of static and dynamic params.
+   */
+  populateStaticParams (params) {
+    return {
+      ...this.getStaticParams(),
+      ...params
+    }
+  }
+}
+
+module.exports = BaseSDK

package/src/sdk/BusinessCentral.js

@@ -0,0 +1,31 @@
+'use strict'
+
+const BaseSDK = require('./Base')
+const UniversalModule = require('./submodules/bc/Universal')
+
+class BusinessCentralSDK extends BaseSDK {
+  /**
+   * Constructor.
+   * @param {class} auth Auth class object with authorized api instance.
+   * @param {string} connectionUUID The UUID of the Connection we're working on.
+   */
+  constructor (auth, connectionUUID, organizationUUID, apiURL, apiVersion, loggerClass = null) {
+    super({
+      auth,
+      connectionUUID,
+      organizationUUID,
+      apiURL,
+      apiVersion,
+      appUUIDKey: 'bc',
+      integrationName: 'BC',
+      loggerClass
+    })
+
+    /**
+     * Create submodule instances.
+     */
+    this.universal = new UniversalModule(this)
+  }
+}
+
+module.exports = BusinessCentralSDK

package/src/sdk/Dear.js

@@ -0,0 +1,31 @@
+'use strict'
+
+const BaseSDK = require('./Base')
+const UniversalModule = require('./submodules/dear/Universal')
+
+class DearSDK extends BaseSDK {
+  /**
+   * Constructor.
+   * @param {class} auth Auth class object with authorized api instance.
+   * @param {string} connectionUUID The UUID of the Connection we're working on.
+   */
+  constructor (auth, connectionUUID, organizationUUID, apiURL, apiVersion, loggerClass = null) {
+    super({
+      auth,
+      connectionUUID,
+      organizationUUID,
+      apiURL,
+      apiVersion,
+      appUUIDKey: 'dear',
+      integrationName: 'Dear',
+      loggerClass
+    })
+
+    /**
+     * Create submodule instances.
+     */
+    this.universal = new UniversalModule(this)
+  }
+}
+
+module.exports = DearSDK

package/src/sdk/Fo.js

@@ -0,0 +1,31 @@
+'use strict'
+
+const BaseSDK = require('./Base')
+const UniversalModule = require('./submodules/fo/Universal')
+
+class FoSDK extends BaseSDK {
+  /**
+   * Constructor.
+   * @param {class} auth Auth class object with authorized api instance.
+   * @param {string} connectionUUID The UUID of the Connection we're working on.
+   */
+  constructor (auth, connectionUUID, organizationUUID, apiURL, apiVersion, loggerClass = null) {
+    super({
+      auth,
+      connectionUUID,
+      organizationUUID,
+      apiURL,
+      apiVersion,
+      appUUIDKey: 'fo',
+      integrationName: 'FO',
+      loggerClass
+    })
+
+    /**
+     * Create submodule instances.
+     */
+    this.universal = new UniversalModule(this)
+  }
+}
+
+module.exports = FoSDK