zudello-integration-sdk 1.0.0

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

@@ -0,0 +1,109 @@
+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) {
+    const fetchedItem = await Zudello.fetch({ model, uuid })
+
+    logger.log(fetchedItem)
+
+    if (fetchedItem && fetchedItem.data) {
+      const data = fetchedItem.data
+
+      logger.log(data)
+
+      const datePosted = (moment(_.get(data, "data.date_posted")).isValid()) ? moment(_.get(data, "data.date_posted")).format('YYYY-MM-DD') : moment(_.get(data, "data.date_issued")).format('YYYY-MM-DD')
+
+      const headerBody = {
+        "currencyCode": _.get(data, "data.currency.code"),
+        "creditMemoDate": moment(_.get(data, "data.date_issued")).format('YYYY-MM-DD'),
+        "postingDate": datePosted,
+        "invoiceNumber": _.get(data, "data.number"), // Must be passed as a string regardless of type
+        "vendorNumber": _.get(data, "data.supplier.code") // Must be passed as a string regardless of type
+      }
+
+      logger.log(headerBody)
+
+      const headerPayload = await BC.universal.request({ method: 'POST', url: 'purchaseCreditMemos', body: headerBody })
+
+      logger.log(headerPayload)
+
+      if (headerPayload && headerPayload.data) {
+        const headerPayloadData = headerPayload.data
+
+        let status = "COMPLETE"
+        let errorMessage = ""
+
+        for (const line of _.get(data, "data.lines")) {
+          logger.log(line)
+
+          const lineBody = {
+            "description": _.get(line, "description"),
+            "documentId": _.get(headerPayloadData, "id"),
+            "lineObjectNumber": _.get(line, "item.code") ? _.get(line, "item.code") : _.get(line, "account.code"),
+            "lineType": _.get(line, "item.external_id") ? "Item" : "Account",
+            "quantity": _.get(line, "quantity"),
+            "taxCode": _.get(line, "tax_rate.code"),
+            "unitCost": _.get(line, "total_exclusive")
+          }
+
+          logger.log(lineBody)
+
+          const linePayload = await BC.universal.request({ method: 'POST', url: 'purchaseCreditMemoLines', body: lineBody })
+
+          logger.log(linePayload)
+
+          if(!linePayload || !linePayload.success) {
+            await BC.universal.request({ method: 'DELETE', url: `purchaseCredits/${_.get(headerPayloadData, "id")}` })
+
+            logger.log(`Delete Transaction: ${_.get(headerPayloadData, "id")}`)
+
+            status = "UNABLE"
+            errorMessage = linePayload.error?.messages[0]?.error?.message
+
+            logger.log(errorMessage)
+
+            return
+          }
+        }
+
+        const zudelloUpdateData = {
+          uuid,
+          status,
+          external_id: _.get(headerPayloadData, "id")
+        }
+
+        if (status === "UNABLE") {
+          zudelloUpdateData.log_messages = {
+            replace: false,
+            items: [
+              {
+                create: true,
+                data: {
+                  status_code: 404,
+                  body: errorMessage,
+                  parse_as: "INTEGRATION_ERROR"
+                }
+              }
+            ]
+          }
+        }
+
+        const zudelloUpdateResponse = await Zudello.update({
+          model,
+          module: _.get(data, "data.module"),
+          submodule: _.get(data, "data.submodule"),
+          data: zudelloUpdateData
+        })
+
+        logger.log(zudelloUpdateResponse)
+      }
+    }
+  }
+}

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

@@ -0,0 +1,138 @@
+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) {
+    const fetchedItem = await Zudello.fetch({ model, uuid })
+
+    logger.log(fetchedItem)
+
+    if (fetchedItem && fetchedItem.data) {
+      const data = fetchedItem.data
+
+      logger.log(data)
+
+      const dateDue = (moment(_.get(data, "data.date_due")).isValid()) ? moment(_.get(data, "data.date_due")).format('YYYY-MM-DD') : null
+      const datePosted = (moment(_.get(data, "data.date_posted")).isValid()) ? moment(_.get(data, "data.date_posted")).format('YYYY-MM-DD') : moment(_.get(data, "data.date_issued")).format('YYYY-MM-DD')
+
+      const headerBody = {
+        "currencyCode": _.get(data, "data.currency.code"),
+        "dueDate": dateDue,
+        "invoiceDate": moment(_.get(data, "data.date_issued")).format('YYYY-MM-DD'),
+        "postingDate": datePosted,
+        "pricesIncludeTax": _.get(data, "tax_included"),
+        "vendorInvoiceNumber":  _.get(data, "data.document_number"), // Must be passed as a string regardless of type
+        "vendorNumber": _.get(data, "data.supplier.code") // Must be passed as a string regardless of type
+      }
+
+      logger.log(headerBody)
+
+      const headerPayload = await BC.universal.request({ method: 'POST', url: 'purchaseInvoices', body: headerBody })
+
+      logger.log(headerPayload)
+
+      if (headerPayload && headerPayload.data) {
+        const headerPayloadData = headerPayload.data
+
+        let status = "COMPLETE"
+        let errorMessage = ""
+
+        for (const line of _.get(data, "data.lines")) {
+          logger.log(line)
+
+          const lineBody = {
+            "description": _.get(line, "description"),
+            "documentId": _.get(headerPayloadData, "id"),
+            "lineObjectNumber": _.get(line, "item.code") ? _.get(line, "item.code") : _.get(line, "account.code"),
+            "lineType": _.get(line, "item.external_id") ? "Item" : "Account",
+            "quantity": _.get(line, "quantity"),
+            "taxCode": _.get(line, "tax_rate.code"),
+            "unitCost": _.get(line, "unit_price")
+          }
+
+          logger.log(lineBody)
+
+          const linePayload = await BC.universal.request({ method: 'POST', url: 'purchaseInvoiceLines', body: lineBody })
+
+          logger.log(linePayload)
+
+          if (!linePayload || !linePayload.success) {
+            await BC.universal.request({ method: 'DELETE', url: `purchaseInvoices/${_.get(headerPayloadData, "id")}` })
+
+            logger.log(`Delete Transaction: ${_.get(headerPayloadData, "id")}`)
+
+            status = "UNABLE"
+            errorMessage = linePayload.error?.messages[0]?.error?.message
+
+            logger.log(errorMessage)
+
+            break
+          }
+
+          const dimensions = [
+            'batch',
+            'bin',
+            'cost_centre',
+            'cost_type',
+            'department',
+            'project',
+            'warehouse',
+            'zone'
+          ]
+
+          for (dimension of dimensions) {
+            const dimensionMeta = metadata.get(`dimension_${dimension}`)
+
+            if (dimensionMeta) {
+              const lineDim = {
+                "code": dimensionMeta,
+                "valueCode": _.get(line, `${dimension}.code`)
+              }
+
+              const lineDimPayload = await BC.universal.request({ method: 'POST', url: `purchaseInvoiceLines(${linePayload.data.id})/dimensionSetLines`, body: lineDim })
+
+              logger.log(lineDimPayload)
+            }
+          }
+        }
+
+        const zudelloUpdateData = {
+          uuid,
+          status,
+          external_id: _.get(headerPayloadData, "id")
+        }
+
+        if (status === "UNABLE") {
+          zudelloUpdateData.log_messages = {
+            replace: false,
+            items: [
+              {
+                create: true,
+                data: {
+                  status_code: 404,
+                  body: errorMessage,
+                  parse_as: "INTEGRATION_ERROR"
+                }
+              }
+            ]
+          }
+        }
+
+        const zudelloUpdateResponse = await Zudello.update({
+          model,
+          module: _.get(data, "data.module"),
+          submodule: _.get(data, "data.submodule"),
+          data: zudelloUpdateData
+        })
+
+        logger.log(zudelloUpdateResponse)
+      }
+    }
+  }
+}

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

@@ -0,0 +1,150 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = {
+    url: 'purchaseOrders',
+    method: 'GET',
+    qs: {
+      $expand: "purchaseOrderLines($select=id,sequence,description,itemId,accountId,quantity,directUnitCost,totalTaxAmount,amountIncludingTax,taxCode;$expand=dimensionSetLines($select=id,code,displayName,valueId,valueCode,valueDisplayName))",
+      $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"),
+        "document_number": _.get(item, "number"),
+        "supplier": {
+          "external_id": _.get(item, "vendorId"),
+          "code": _.get(item, "vendorNumber"),
+          "legal_name": _.get(item, "vendorName"),
+          "payment_term": {
+            "external_id": _.get(item, "paymentTermsId")
+          }
+        },
+        "addressee": _.get(item, "shipToName"),
+        "attention": _.get(item, "shipToContact"),
+        "address_line_1": _.get(item, "shipToAddressLine1"),
+        "address_line_2": _.get(item, "shipToAddressLine2"),
+        "city": _.get(item, "shipToCity"),
+        "country": _.get(item, "shipToCountry"),
+        "state": _.get(item, "shipToState"),
+        "postcode": _.get(item, "shipToPostCode"),
+        "currency": {
+          "external_id": _.get(item, "currencyId"),
+          "code": _.get(item, "currencyCode")
+        },
+        "tax_included": _.get(item, "pricesIncludeTax"),
+        "discount": _.get(item, "discountAmount"),
+        "subtotal": _.get(item, "totalAmountExcludingTax"),
+        "tax": _.get(item, "totalTaxAmount"),
+        "total": _.get(item, "totalAmountIncludingTax"),
+        "status": _.get(item, "status"),
+        "lines": _.map(_.get(item, "purchaseOrderLines"), (lineItem) => {
+          const costCentreMetafield = metadata.get('dimension_cost_centre', '')
+          const departmentMetafield = metadata.get('dimension_department', '')
+          const costTypeMetafield = metadata.get('dimension_cost_type', '')
+
+          const lineData = {
+            "external_id": _.get(lineItem, "id"),
+            "line_number": _.get(lineItem, "sequence"),
+            "item": {
+              "external_id": _.get(lineItem, "itemId")
+            },
+            "account": {
+              "external_id": _.get(lineItem, "accountId")
+            },
+            "description": _.get(lineItem, "description"),
+            "unit_of_measure": {
+              "external_id": _.get(lineItem, "unitOfMeasureId"),
+              "code": _.get(lineItem, "unitOfMeasureCode")
+            },
+            "quantity": _.get(lineItem, "quantity"),
+            "unit_price": _.get(lineItem, "directUnitCost"),
+            "discount_amount": _.get(lineItem, "discountAmount"),
+            "discount_percent": _.get(lineItem, "discountPercent"),
+            "tax_rate": {
+              "external_id": _.get(lineItem, "taxCode")
+            },
+            "location": {
+              "external_id": _.get(lineItem, "locationId")
+            }
+            // "quantity": _.get(lineItem, "invoiceQuantity"), // we already have "quantity": _.get(lineItem, "quantity"),
+            // "quantity": _.get(lineItem, "receiveQuantity"),
+          }
+
+          const dimensionSetLines = _.get(lineItem, "dimensionSetLines")
+
+          if (departmentMetafield) {
+            const departmentLine = dimensionSetLines.find(line => line.code === departmentMetafield)
+
+            if (departmentLine) {
+              lineData.department = departmentLine.valueId
+            }
+          }
+
+          if (costCentreMetafield) {
+            const costCentreLine = dimensionSetLines.find(line => line.code === costCentreMetafield)
+
+            if (costCentreLine) {
+              lineData.cost_centre = costCentreLine.valueId
+            }
+          }
+
+          if (costTypeMetafield) {
+            const costTypeLine = dimensionSetLines.find(line => line.code === costTypeMetafield)
+
+            if (costTypeLine) {
+              lineData.cost_type = costTypeLine.valueId
+            }
+          }
+
+          return lineData
+        })
+      }
+
+      const orderDate = _.get(item, "orderDate")
+
+      if (orderDate) {
+        itemData["date_issued"] = moment(orderDate).format("YYYY-MM-DD")
+      }
+
+      const postingDate = _.get(item, "postingDate")
+
+      if (postingDate) {
+        itemData["date_posted"] = moment(postingDate).format("YYYY-MM-DD")
+      }
+
+      const dueDate = _.get(item, "dueDate")
+
+      if (dueDate) {
+        itemData["date_due"] = moment(dueDate).format("YYYY-MM-DD")
+      }
+
+      return itemData
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.purchaseOrder.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/purchaseOrderFetch.js

@@ -0,0 +1,100 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+
+  const fetchData = {
+    url: 'purchaseOrders',
+    method: 'GET',
+    qs: {
+      $orderby: 'lastModifiedDateTime',
+      $expand: "purchaseOrderLines( $select=id , sequence , description , itemId , accountId , quantity , directUnitCost , totalTaxAmount , amountIncludingTax , taxCode;$expand=dimensionSetLines( $select=id , code , displayName , valueId , valueCode , valueDisplayName ) )"
+    }
+  }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(JSON.stringify(fetchData))
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(JSON.stringify(items))
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        model: "Transaction",
+        data: {
+          module: "PURCHASING",
+          submodule: "ORDER",
+          document_type: "PURCHASE_ORDER",
+          "external_id": _.get(item, 'id'),
+          "supplier": {
+            "fetch": true,
+            "create": true,
+            "data": {
+              "external_id": _.get(item, 'vendorId')
+            }
+          },
+          "company_name": _.get(item, 'vendorName'),
+          "document_number": _.get(item, 'number'),
+          "date_issued": _.get(item, 'orderDate'),
+          "date_due": _.get(item, 'requestedReceiptDate'),
+          "subtotal": _.get(item, 'totalAmountExcludingTax'),
+          "subtotal": _.get(item, 'totalTaxAmount'),
+          "total": _.get(item, 'totalAmountIncludingTax'),
+          "status": "COMPLETE",
+          "lines": {
+            "replace": false,
+            "items": _.map(_.get(item, 'purchaseOrderLines'), (x) => {
+              return {
+                "create": true,
+                "update": true,
+                "data": {
+                    "external_id": _.get(x, 'id'),
+                    "description": _.get(x, 'description'),
+                    "line_number": _.get(x, 'sequence'),
+                    "quantity": _.get(x, 'quantity'),
+                    "unit_price": _.get(x, 'directUnitCost'),
+                    "total": _.get(x, 'amountIncludingTax'),
+                    "item": {
+                      "fetch": true,
+                      "create": true,
+                      "data": {
+                        "external_id": _.get(x, 'itemId')
+                      }
+                    },
+                    "account": {
+                      "fetch": true,
+                      "create": true,
+                      "data": {
+                        "external_id": _.get(x, 'accountId')
+                      }
+                    }
+                  }
+                }
+            })
+          }
+        },
+        "enrich": false,
+        "submit": false,
+        "create": true,
+        "update": true,
+        "update_status": false
+      }
+    })
+
+    logger.log(JSON.stringify(data))
+
+    const result = await Zudello.updateOrCreate({ data })
+
+    logger.log(JSON.stringify(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/supplier.js

@@ -0,0 +1,40 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'vendors', 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"),
+        "tax_number": _.get(item, "taxRegistrationNumber"),
+        "status": item.blocked == "_x0020_" ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.supplier.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/taxRate.js

@@ -0,0 +1,39 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'taxGroups', method: 'GET', qs: { $orderby: 'lastModifiedDateTime' } }
+
+  if (lastModifiedDateTime) {
+    fetchData.qs.$filter = `lastModifiedDateTime gt ${lastModifiedDateTime}`
+  }
+
+  logger.log(JSON.stringify(fetchData))
+
+  for await (const items of BC.universal.autoPaginationList(fetchData)) {
+    logger.log(JSON.stringify(items))
+
+    const data = _.map(items.data.value, (item) => {
+      return {
+        "external_id": _.get(item, "id"),
+        "code": _.get(item, "code"),
+        "name": _.get(item, "displayName"),
+        "status": "ACTIVE",
+           "rate": _.includes(_.get(item, "code"), "100") ? 100.00 : _.includes(_.get(item, "code"), "10") ? 10.00 : 0.00
+      }
+    })
+
+    logger.log(JSON.stringify(data))
+
+    const result = await Zudello.tax.rate.updateOrCreate({ data })
+
+    logger.log(JSON.stringify(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/uom.js

@@ -0,0 +1,42 @@
+const handler = async (providedData) => {
+  const lastModifiedDateTime = metadata.get('lastModifiedDateTime')
+  const fetchData = { url: 'unitsOfMeasure', 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({
+          "internationalStandardCode": _.get(item, "internationalStandardCode"),
+          "symbol": _.get(item, "symbol")
+        })
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.uom.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/dear-zudello/account.js

@@ -0,0 +1,20 @@
+const handler = async (providedData) => {
+  for await (const items of Dear.universal.autoPaginationList({ url: 'ref/account', method: 'GET' })) {
+    logger.log(items)
+
+    const data = _.map(items.data.AccountsList, (item) => {
+      return {
+        "external_id": _.get(item, "Code"),
+        "code": _.get(item, "Code"),
+        "name": _.get(item, "Name"),
+        "status": (_.get(item, "Status") == "Active") ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.account.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}

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

@@ -0,0 +1,23 @@
+const handler = async (providedData) => {
+  for await (const items of Dear.universal.autoPaginationList({ url: 'customer', method: 'GET', qs: {
+    "ModifiedSince": "2024-07-30"
+  } })) {
+    logger.log(items)
+
+    const data = _.map(items.data.CustomerList, (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, "Status") == "Active") ? "ACTIVE" : "INACTIVE"
+      }
+    })
+
+    logger.log(data)
+
+    const result = await Zudello.customer.updateOrCreate({ data })
+
+    logger.log(result)
+  }
+}