@things-factory/integration-marketplace 8.0.0-beta.8 → 8.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/integration-marketplace",
-  "version": "8.0.0-beta.8",
+  "version": "8.0.0",
   "main": "dist-server/index.js",
   "browser": "client/index.js",
   "things-factory": true,
@@ -25,18 +25,18 @@
     "test": "DEBUG=things-factory:* NODE_ENV=development npx mocha -r ts-node/register ./test/**/*spec.ts"
   },
   "dependencies": {
-    "@operato/data-grist": "^8.0.0-beta",
-    "@things-factory/apptool-ui": "^8.0.0-beta.8",
-    "@things-factory/auth-ui": "^8.0.0-beta.8",
-    "@things-factory/biz-base": "^8.0.0-beta.8",
-    "@things-factory/code-ui": "^8.0.0-beta.8",
-    "@things-factory/context-ui": "^8.0.0-beta.5",
-    "@things-factory/i18n-base": "^8.0.0-beta.8",
-    "@things-factory/integration-lmd": "^8.0.0-beta.8",
-    "@things-factory/integration-ui": "^8.0.0-beta.8",
-    "@things-factory/more-ui": "^8.0.0-beta.5",
-    "@things-factory/resource-ui": "^8.0.0-beta.8",
-    "@things-factory/setting-ui": "^8.0.0-beta.8",
+    "@operato/data-grist": "^8.0.0",
+    "@things-factory/apptool-ui": "^8.0.0",
+    "@things-factory/auth-ui": "^8.0.0",
+    "@things-factory/biz-base": "^8.0.0",
+    "@things-factory/code-ui": "^8.0.0",
+    "@things-factory/context-ui": "^8.0.0",
+    "@things-factory/i18n-base": "^8.0.0",
+    "@things-factory/integration-lmd": "^8.0.0",
+    "@things-factory/integration-ui": "^8.0.0",
+    "@things-factory/more-ui": "^8.0.0",
+    "@things-factory/resource-ui": "^8.0.0",
+    "@things-factory/setting-ui": "^8.0.0",
     "debug": "^4.1.1",
     "node-fetch": "^2.6.0"
   },
@@ -50,5 +50,5 @@
     "nock": "^13.0.2",
     "should": "^13.2.3"
   },
-  "gitHead": "bf5206511b2d84dfb95edc3dae7f54f6cbb9bcca"
+  "gitHead": "07ef27d272dd9a067a9648ac7013748510556a18"
 }

package/server/controllers/index.ts

@@ -0,0 +1,9 @@
+import './lazada'
+import './shopee'
+import './shopify'
+import './zalora'
+import './woocommerce'
+import './tiktok'
+
+export * from './shopify'
+export * from './store-api'

package/server/controllers/lazada/apis/cancel-store-order.ts

@@ -0,0 +1,19 @@
+/* https://open.shopee.com/documents?module=2&type=1&id=365 */
+
+export function cancelStoreOrder() {
+  return {
+    method: 'post',
+    path: '/order/cancel',
+    denormalize(req) {
+      var { name: order_item_id, reason: reason_id } = req
+
+      return {
+        order_item_id,
+        reason_id
+      }
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

package/server/controllers/lazada/apis/create-store-product.ts

@@ -0,0 +1,55 @@
+export function createStoreProduct() {
+  return {
+    method: 'post',
+    path: '/product/create',
+    denormalize(req) {
+      var { categoryId: primary_category, attributes, skus } = req
+
+      skus = skus.map(sku => {
+        const {
+          skuId: sellerSku,
+          price,
+          quantity,
+          discountedPrice: special_price,
+          discountFromDate: special_from_date,
+          discountToDate: special_to_date,
+          weight: product_weight,
+          packageWidth: package_weight,
+          packageHeight: package_height,
+          packageLength: package_length,
+          packageContent: package_content,
+          images
+        } = sku
+        return {
+          sellerSku,
+          price,
+          special_price,
+          special_from_date,
+          special_to_date,
+          quantity,
+          product_weight,
+          package_weight,
+          package_height,
+          package_length,
+          package_content,
+          images
+        }
+      })
+
+      var payload = {
+        primary_category,
+        attributes,
+        skus
+      }
+
+      return { payload }
+    },
+    normalize(res) {
+      var { item_id, sku_list } = res
+      return {
+        item_id,
+        sku_list
+      }
+    }
+  }
+}

package/server/controllers/lazada/apis/delete-store-product.ts

@@ -0,0 +1,16 @@
+export function deleteStoreProduct() {
+  return {
+    method: 'post',
+    path: '/product/remove',
+    denormalize(req) {
+      var { itemList } = req
+
+      return {
+        seller_sku_list: itemList
+      }
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

package/server/controllers/lazada/apis/echo.ts

@@ -0,0 +1,14 @@
+export function echo() {
+  return {
+    path: '/echo',
+    denormalize(req) {
+      return { ...req }
+    },
+    normalize(res) {
+      return { ...res }
+    },
+    action({ store, method, path, request, platformAction }) {
+      return { ...request }
+    }
+  }
+}

package/server/controllers/lazada/apis/get-store-logistics.ts

@@ -0,0 +1,21 @@
+/* https://open.shopee.com/documents?module=3&type=1&id=384 */
+
+export function getStoreLogistics() {
+  return {
+    method: 'get',
+    path: '/shipment/providers/get',
+    denormalize(req) {
+      return {}
+    },
+    normalize(res) {
+      let results = res.shipment_providers.map(provider => {
+        const { name, is_default: isDefault } = provider
+        return {
+          name,
+          isDefault
+        }
+      })
+      return results
+    }
+  }
+}

package/server/controllers/lazada/apis/get-store-order-document.ts

@@ -0,0 +1,25 @@
+export function getStoreOrderDocument() {
+  return {
+    method: 'get',
+    path: '/order/document/get',
+    denormalize(req) {
+      var { docRefNo, docType } = req
+      var doc_type = docType
+      var output = '[' + docRefNo.join(',') + ']'
+
+      return {
+        doc_type,
+        order_item_ids: output
+      }
+    },
+    normalize(res) {
+      var { file, mime_type: mimeType, document_type: documentType } = res.document
+      let orderDocuments = []
+
+      const orderDocument = { file, mimeType, documentType }
+      orderDocuments.push(orderDocument)
+
+      return orderDocuments
+    }
+  }
+}

package/server/controllers/lazada/apis/get-store-order-item-transaction-details.ts

@@ -0,0 +1,65 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193531.0.0.4f406bbetGwYgx#/api?cid=9&path=/finance/transaction/details/get */
+
+export function getStoreOrderItemTransactionDetails() {
+  return {
+    method: 'get',
+    path: '/finance/transaction/details/get',
+    denormalize(req) {
+      var { orderItemId, orderCreatedAt } = req
+      let startDate = new Date(orderCreatedAt)
+      let endDate = new Date(orderCreatedAt)
+      endDate.setDate(endDate.getDate() + 14)
+      let currentDate = new Date()
+      if (endDate > currentDate) {
+        endDate = currentDate
+      }
+
+      return {
+        start_time: startDate.toISOString().replace(/T.*/, '').split('-').join('-'),
+        end_time: endDate.toISOString().replace(/T.*/, '').split('-').join('-'),
+        trade_order_line_id: orderItemId
+      }
+    },
+    normalize(res) {
+      let payment_fee = 0
+      let commission_fee = 0
+      let promotional_charges = 0
+      let shipping_fee_paid_by_customer = 0
+      let item_price_credit = 0
+      let orders_marketplace_fees_total = 0
+      let orders_sales_total = 0
+      let orders_marketing_fees_total = 0
+      let orders_logistics_total = 0
+      let promotional_charges_flexi_combo = 0
+      let auto_shipping_subsidy_marketplace = 0
+
+      res.forEach(item => {
+        if (item.fee_name == 'Payment Fee') { payment_fee += parseFloat(item.amount) || 0 }
+        if (item.fee_name == 'Commission') { commission_fee += parseFloat(item.amount) || 0 }
+        if (item.fee_name == 'Item Price Credit') { item_price_credit += parseFloat(item.amount) || 0 }
+        if (item.fee_name == 'Promotional Charges Vouchers') { promotional_charges += parseFloat(item.amount) || 0 }
+        if (item.fee_name == 'Shipping Fee (Paid By Customer)') { shipping_fee_paid_by_customer += parseFloat(item.amount) || 0 }
+        if (item.fee_name == 'Promotional Charges Flexi-Combo') { promotional_charges_flexi_combo += parseFloat(item.amount) || 0 }
+        if (item.fee_name == 'Auto. Shipping fee subsidy (by Lazada)') { auto_shipping_subsidy_marketplace += parseFloat(item.amount) || 0 }
+
+        if (item.transaction_type == 'Orders-Lazada Fees') { orders_marketplace_fees_total += parseFloat(item.amount) || 0 }
+        if (item.transaction_type == 'Orders-Sales') { orders_sales_total += parseFloat(item.amount) || 0 }
+        if (item.transaction_type == 'Orders-Marketing Fees') { orders_marketing_fees_total += parseFloat(item.amount) || 0 }
+        if (item.transaction_type == 'Orders-Logistics') { orders_logistics_total += parseFloat(item.amount) || 0 }
+      })
+      return {
+        payment_fee: Math.trunc(payment_fee * 100) / 100,
+        commission_fee: Math.trunc(commission_fee * 100) / 100,
+        promotional_charges: Math.trunc(promotional_charges * 100) / 100,
+        shipping_fee_paid_by_customer: Math.trunc(shipping_fee_paid_by_customer * 100) / 100,
+        item_price_credit: Math.trunc(item_price_credit * 100) / 100,
+        orders_marketplace_fees_total: Math.trunc(orders_marketplace_fees_total * 100) / 100,
+        orders_sales_total: Math.trunc(orders_sales_total * 100) / 100,
+        orders_marketing_fees_total: Math.trunc(orders_marketing_fees_total * 100) / 100,
+        orders_logistics_total: Math.trunc(orders_logistics_total * 100) / 100,
+        promotional_charges_flexi_combo: Math.trunc(promotional_charges_flexi_combo * 100) / 100,
+        auto_shipping_subsidy_marketplace: Math.trunc(auto_shipping_subsidy_marketplace * 100) / 100
+      }
+    }
+  }
+}

package/server/controllers/lazada/apis/get-store-order-items.ts

@@ -0,0 +1,179 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193494.0.0.1805266b7Xrdkj#/api?cid=8&path=/orders/get */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreOrderItems() {
+  return {
+    method: 'get',
+    path: '/order/items/get',
+    denormalize(req) {
+      var { orderId } = req
+
+      return {
+        order_id: orderId
+      }
+    },
+    async normalize(res, { store }) {
+      for (var i = 0; i < res.length; i++) {
+        let item = res[i]
+        let req = {
+          orderItemId: item.order_item_id,
+          orderCreatedAt: item.created_at
+        }
+        let transactionDetails = await StoreAPI.getStoreOrderItemTransactionDetails(store, req)
+        res[i] = {
+          ...res[i],
+          ...transactionDetails
+        }
+      }
+
+      let results = res
+        .reduce((newItem, item) => {
+          var idxFoundItem = newItem.findIndex(
+            newItem => newItem.shop_sku === item.shop_sku && newItem.sku === item.sku
+          )
+          if (idxFoundItem < 0) {
+            let data = {
+              order_item_id: item.order_item_id,
+              order_id: item.order_id,
+              shop_sku: item.shop_sku,
+              sku: item.sku,
+              package_id: item.package_id,
+              cancel_return_initiator: item.cancel_return_initiator,
+              reason: item.reason,
+              paid_price: item.paid_price,
+              item_price: item.item_price,
+              payment_fee: item.payment_fee,
+              commission_fee: item.commission_fee,
+              promotional_charges: item.promotional_charges,
+              shipping_fee_paid_by_customer: item.shipping_fee_paid_by_customer,
+              item_price_credit: item.item_price_credit,
+              orders_marketplace_fees_total: item.orders_marketplace_fees_total,
+              orders_sales_total: item.orders_sales_total,
+              orders_marketing_fees_total: item.orders_marketing_fees_total,
+              orders_logistics_total: item.orders_logistics_total,
+              qty: 1,
+              shipment_provider: item.shipment_provider,
+              tracking_code: JSON.stringify(
+                item.tracking_code ? [{ order_item_id: item.order_item_id, tracking_code: item.tracking_code }] : []
+              ),
+              status: item.status,
+              voucher_platform_lpi: item.voucher_platform_lpi,
+              voucher_seller_lpi: item.voucher_seller_lpi,
+              shipping_fee_discount_platform: item.shipping_fee_discount_platform,
+              shipping_fee_discount_seller: item.shipping_fee_discount_seller,
+              promotional_charges_flexi_combo: item.promotional_charges_flexi_combo,
+              auto_shipping_subsidy_marketplace: item.auto_shipping_subsidy_marketplace,
+              shipping_fee_original: item.shipping_fee_original,
+              tax_amount: item.tax_amount
+            }
+
+            newItem.push(data)
+          } else {
+            let existingItem = newItem[idxFoundItem]
+            newItem[idxFoundItem] = {
+              ...existingItem,
+              order_item_id: existingItem.order_item_id + ',' + item.order_item_id,
+              qty: existingItem.qty + 1,
+              paid_price: item.paid_price + existingItem.paid_price,
+              item_price: item.item_price + existingItem.item_price,
+              payment_fee: item.payment_fee + existingItem.payment_fee,
+              commission_fee: item.commission_fee + existingItem.commission_fee,
+              promotional_charges: item.promotional_charges + existingItem.promotional_charges,
+              shipping_fee_paid_by_customer: item.shipping_fee_paid_by_customer + existingItem.shipping_fee_paid_by_customer,
+              item_price_credit: item.item_price_credit + existingItem.item_price_credit,
+              orders_marketplace_fees_total: item.orders_marketplace_fees_total + existingItem.orders_marketplace_fees_total,
+              orders_sales_total: item.orders_sales_total + existingItem.orders_sales_total,
+              orders_marketing_fees_total: item.orders_marketing_fees_total + existingItem.orders_marketing_fees_total,
+              orders_logistics_total: item.orders_logistics_total + existingItem.orders_logistics_total,
+              tracking_code: item.tracking_code
+                ? JSON.stringify([
+                    ...JSON.parse(existingItem.tracking_code),
+                    { order_item_id: item.order_item_id, tracking_code: item.tracking_code }
+                  ])
+                : existingItem.tracking_code,
+              voucher_platform_lpi: item.voucher_platform_lpi + existingItem.voucher_platform_lpi,
+              voucher_seller_lpi: item.voucher_seller_lpi + existingItem.voucher_seller_lpi,
+              shipping_fee_discount_platform: item.shipping_fee_discount_platform + existingItem.shipping_fee_discount_platform,
+              shipping_fee_discount_seller: item.shipping_fee_discount_seller + existingItem.shipping_fee_discount_seller,
+              promotional_charges_flexi_combo: item.promotional_charges_flexi_combo + existingItem.promotional_charges_flexi_combo,
+              auto_shipping_subsidy_marketplace: item.auto_shipping_subsidy_marketplace + existingItem.auto_shipping_subsidy_marketplace,
+              shipping_fee_original: item.shipping_fee_original + existingItem.shipping_fee_original,
+              tax_amount: item.tax_amount + existingItem.tax_amount
+            }
+          }
+          return newItem
+        }, [])
+        .map(orderItem => {
+          const {
+            order_item_id: name,
+            order_item_id: docRefNo,
+            order_id: orderNo,
+            package_id: packageId,
+            shop_sku: variationId,
+            qty,
+            paid_price: paidPrice,
+            cancel_return_initiator: cancelBy,
+            reason,
+            shipment_provider: shippingProvider,
+            tracking_code,
+            status,
+            item_price: originalPrice,
+            payment_fee: paymentFee,
+            commission_fee: commissionFee,
+            promotional_charges: promotionalCharges,
+            shipping_fee_paid_by_customer: shippingFeePaidByCustomer,
+            item_price_credit: itemPriceCredit,
+            orders_marketplace_fees_total: ordersMarketplaceFeesTotal,
+            orders_sales_total: ordersSalesTotal,
+            orders_marketing_fees_total: ordersMarketingFeesTotal,
+            orders_logistics_total: ordersLogisticsTotal,
+            voucher_platform_lpi: marketplaceBonus,
+            voucher_seller_lpi: marketplaceBonusSeller,
+            shipping_fee_discount_platform: shippingFeeDiscountMarketplace,
+            shipping_fee_discount_seller: shippingFeeDiscountSeller,
+            promotional_charges_flexi_combo: promotionalChargesFlexiCombo,
+            auto_shipping_subsidy_marketplace: autoShippingSubsidyMarketplace,
+            shipping_fee_original: originalShippingFee,
+            tax_amount: taxAmount
+          } = orderItem
+          var trackingNo = tracking_code === '' ? null : tracking_code
+
+          return {
+            name: name.toString(),
+            variationId,
+            qty,
+            paidPrice,
+            orderNo,
+            docRefNo,
+            packageId,
+            cancelBy,
+            reason,
+            shippingProvider,
+            trackingNo,
+            status,
+            originalPrice,
+            paymentFee,
+            commissionFee,
+            promotionalCharges,
+            shippingFeePaidByCustomer,
+            itemPriceCredit,
+            ordersMarketplaceFeesTotal,
+            ordersSalesTotal,
+            ordersMarketingFeesTotal,
+            ordersLogisticsTotal,
+            marketplaceBonus,
+            marketplaceBonusSeller,
+            shippingFeeDiscountMarketplace,
+            shippingFeeDiscountSeller,
+            promotionalChargesFlexiCombo,
+            autoShippingSubsidyMarketplace,
+            originalShippingFee,
+            taxAmount
+          }
+        })
+
+      return results
+    }
+  }
+}

package/server/controllers/lazada/apis/get-store-order.ts

@@ -0,0 +1,87 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193494.0.0.1805266b7Xrdkj#/api?cid=8&path=/orders/get */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreOrder() {
+  return {
+    method: 'get',
+    path: '/order/get',
+    denormalize(req) {
+      var { orderId, orderNo } = req
+
+      return {
+        order_id: orderId
+      }
+    },
+    async normalize(res, { store }) {
+      var {
+        order_id,
+        order_number: orderNo,
+        items_count: itemCount,
+        price: totalAmount,
+        statuses,
+        address_shipping,
+        created_at,
+        updated_at
+      } = res
+
+      var orderCreatedAt = new Date(created_at).toUTCString()
+      var orderUpdatedAt = new Date(updated_at).toUTCString()
+      var status = statuses[0]
+
+      var orderId = order_id
+      var name = order_id.toString()
+      let orderItemResult = await StoreAPI.getStoreOrderItems(store, { orderId })
+
+      // get only 1 tracking no
+      let trackingNo = orderItemResult[0].trackingNo
+
+      // get only 1 shipping provider
+      let shippingProvider = orderItemResult[0].shippingProvider
+
+      const {
+        address1,
+        address2,
+        address3,
+        address4,
+        address5,
+        post_code: postCode,
+        phone,
+        phone2,
+        country,
+        city,
+        first_name,
+        last_name
+      } = address_shipping
+
+      var orderShipping = {
+        address1,
+        address2,
+        address3,
+        address4,
+        address5,
+        phone,
+        phone2,
+        postCode,
+        city,
+        state: address3,
+        country: country === 'MY' ? 'Malaysia' : country,
+        attentionTo: `${first_name} ${last_name}`
+      }
+
+      return {
+        name,
+        orderNo,
+        status,
+        orderCreatedAt,
+        orderUpdatedAt,
+        totalAmount,
+        trackingNo,
+        shippingProvider,
+        itemCount,
+        orderItems: orderItemResult,
+        orderShipping
+      }
+    }
+  }
+}

package/server/controllers/lazada/apis/get-store-orders.ts

@@ -0,0 +1,127 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193494.0.0.1805266b7Xrdkj#/api?cid=8&path=/orders/get */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreOrders() {
+  return {
+    method: 'get',
+    path: '/orders/get',
+    denormalize(req) {
+      var { pagination, fromCreatedDate, toCreatedDate } = req || {}
+      var { page, limit } = pagination || { page: 0, limit: 100 }
+
+      var created_before = new Date(toCreatedDate).toISOString()
+      var created_after = new Date(fromCreatedDate).toISOString()
+
+      return {
+        offset: page * limit,
+        limit,
+        created_before,
+        created_after
+      }
+    },
+    async normalize(res, { store }) {
+      var { orders, count, countTotal } = res
+
+      let results: any[] = []
+
+      for (var i = 0; i < orders.length; i++) {
+        const order = orders[i]
+
+        const {
+          order_id,
+          order_number: orderNo,
+          items_count: itemCount,
+          price: totalAmount,
+          statuses,
+          address_shipping,
+          shipping_fee,
+          remarks,
+          shipping_fee_original,
+          shipping_fee_discount_platform,
+          shipping_fee_discount_seller,
+          created_at,
+          updated_at
+        } = order
+
+        var orderCreatedAt = new Date(created_at).toUTCString()
+        var orderUpdatedAt = new Date(updated_at).toUTCString()
+        var status = statuses[0]
+
+        var orderId = order_id
+        var name = order_id.toString()
+        const orderItems = await StoreAPI.getStoreOrderItems(store, { orderId })
+
+        let trackingNos: any[] = []
+        orderItems.forEach(orderItem => {
+          if (orderItem?.trackingNo) {
+            const trackingNo: any = JSON.parse(orderItem.trackingNo)
+            if (trackingNo?.length > 0) trackingNos.push(...trackingNo)
+          }
+        })
+
+        // get only 1 tracking no
+        const trackingNo = JSON.stringify(trackingNos)
+        const currency = orderItems[0].currency
+        const shippingProvider = orderItems[0].shippingProvider
+
+        const {
+          address1,
+          address2,
+          address3,
+          address4,
+          address5,
+          post_code: postCode,
+          phone,
+          phone2,
+          country,
+          city,
+          first_name,
+          last_name
+        } = address_shipping
+
+        var orderShipping = {
+          address1,
+          address2,
+          address3,
+          address4,
+          address5,
+          phone1: phone,
+          phone2,
+          postCode,
+          city,
+          state: address3,
+          country,
+          collectionAmount: shipping_fee,
+          collectionCurrency: currency,
+          trackingNo,
+          transporter: shippingProvider,
+          attentionTo: `${first_name} ${last_name}`,
+          shippingFee: shipping_fee_original,
+          actualShippingFee: shipping_fee,
+          marketplaceShippingFeeVoucher: shipping_fee_discount_platform,
+          sellerShippingFeeVoucher: shipping_fee_discount_seller
+        }
+
+        results.push({
+          name,
+          orderNo,
+          status,
+          orderCreatedAt,
+          orderUpdatedAt,
+          trackingNo,
+          shippingProvider,
+          totalAmount,
+          itemCount,
+          remarks,
+          orderItems,
+          orderShipping
+        })
+      }
+
+      var more: boolean = Boolean(count < countTotal)
+
+      return { results, more }
+    }
+  }
+}