@things-factory/integration-marketplace 4.0.7 → 4.0.12

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

@@ -0,0 +1,52 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193531.0.0.4f406bbetGwYgx#/api?cid=26&path=/reverse/getreverseordersforseller */
+
+export function getStoreRefundOrders() {
+  return {
+    method: 'get',
+    path: '/reverse/getreverseordersforseller',
+    denormalize(req) {
+      var { pagination } = req || {}
+      var { page, limit } = pagination || { page: 0, limit: 100 }
+
+      return {
+        page_no: page + 1,
+        page_size: limit
+      }
+    },
+    normalize(res, { store }) {
+      var { items, total, page_size, page_no } = res
+
+      var more: boolean = false
+      if (page_size * page_no < total) {
+        more = true
+      }
+
+      let results: any[] = []
+
+      items.forEach(async item => {
+        let refundItems = item.reverse_order_lines.map(item => {
+          let channelSku = item.product.product_sku
+          let { reverse_order_line_id: name, reverse_order_line_id: orderItemId, reverse_status: status } = item
+          name = name.toString()
+          orderItemId = orderItemId.toString()
+          return {
+            name,
+            orderItemId,
+            status,
+            channelSku
+          }
+        })
+
+        const result = {
+          name: item.reverse_order_id.toString(),
+          orderNo: item.reverse_order_id.toString(),
+          originalOrderNo: item.trade_order_id.toString(),
+          items: refundItems
+        }
+
+        results.push({ ...result })
+      })
+      return { results, more }
+    }
+  }
+}

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

@@ -20,3 +20,5 @@ export * from './set-order-invoice-no'
 export * from './update-store-product-stock'
 export * from './update-store-product-variation-stock'
 export * from './update-store-product'
+export * from './get-store-refund-orders'
+export * from './get-store-order-item-transaction-details'

package/server/controllers/lazada/client/lazada.ts

@@ -1,8 +1,11 @@
+import FormData from 'form-data'
 import fetch from 'node-fetch'
-import { Parameter, Endpoint } from './types'
+import { getRepository } from 'typeorm'
+
+import { MarketplaceStore } from '../../../entities'
 import { makeSystemParameters } from './signature'
+import { Endpoint, Parameter } from './types'
 import { xmlize } from './xml'
-import FormData from 'form-data'
 
 export class Lazada {
   endpoint: string
@@ -38,13 +41,13 @@ export class Lazada {
     return await response.json()
   }
 
-  async refreshAccessToken(payload: { refresh_token: string }) {
+  public static async refreshAccessToken(payload: { refresh_token: string }, appKey, appSecret, storeId) {
     /* CONFIRM-ME not qualified */
     const apiPath = '/auth/token/refresh'
 
     const body = {
       ...payload,
-      ...makeSystemParameters(this.appKey, this.appSecret, apiPath, undefined, payload)
+      ...makeSystemParameters(appKey, appSecret, apiPath, undefined, payload)
     }
 
     const response = await fetch(Endpoint.auth + apiPath, {
@@ -55,6 +58,25 @@ export class Lazada {
       body: JSON.stringify(body)
     })
 
+    const repository = getRepository(MarketplaceStore)
+    const store: MarketplaceStore = await repository.findOne({
+      where: { id: storeId }
+    })
+
+    const refreshTokenInfo = await response.json()
+    const { access_token, refresh_token } = refreshTokenInfo
+
+    var patch = {
+      accessToken: access_token,
+      refreshToken: refresh_token,
+      accessInfo: JSON.stringify(refreshTokenInfo, null, 2)
+    }
+
+    await repository.save({
+      ...store,
+      ...patch
+    })
+
     return await response.json()
   }
 
@@ -72,6 +94,10 @@ export class Lazada {
       }
     })
 
+    if (!response.ok) {
+      throw response
+    }
+
     return await response.json()
   }
 
@@ -80,13 +106,13 @@ export class Lazada {
       params.payload = xmlize(params.payload)
     }
 
-    const {   
-      app_key,
-      timestamp,
-      access_token,
-      sign_method,
-      sign 
-    } = makeSystemParameters(this.appKey, this.appSecret, path, accessToken || this.accessToken, params)
+    const { app_key, timestamp, access_token, sign_method, sign } = makeSystemParameters(
+      this.appKey,
+      this.appSecret,
+      path,
+      accessToken || this.accessToken,
+      params
+    )
 
     const body = new FormData()
 
@@ -96,7 +122,7 @@ export class Lazada {
     body.append('sign_method', sign_method)
     body.append('sign', sign)
 
-    for(let key in params) {
+    for (let key in params) {
       body.append(key, params[key])
     }
 
@@ -106,6 +132,10 @@ export class Lazada {
       body
     })
 
+    if (!response.ok) {
+      throw response
+    }
+
     return await response.json()
   }
 }

package/server/controllers/lazada/platform-action.ts

@@ -1,10 +1,29 @@
+import { config } from '@things-factory/env'
+
 import { Lazada } from './client'
 
-import { config } from '@things-factory/env'
 const lazadaConfig = config.get('marketplaceIntegrationLazada', {})
 const { appKey, appSecret } = lazadaConfig
 
 export const action = async ({ store, method = 'get', path, request }) => {
+  try {
+    return await _action({ store, method, path, request })
+  } catch (ex) {
+    if (ex.code === 'IllegalAccessToken') {
+      var refreshStore = await Lazada.refreshAccessToken(
+        { refresh_token: store.refreshToken },
+        appKey,
+        appSecret,
+        store.id
+      )
+      return await _action({ store: refreshStore, method, path, request })
+    } else {
+      throw ex
+    }
+  }
+}
+
+export const _action = async ({ store, method = 'get', path, request }) => {
   const client = new Lazada(store.countryCode, appKey, appSecret)
 
   var response = await client[method == 'post' ? 'post' : 'get'](path, request, store.accessToken)
@@ -12,5 +31,5 @@ export const action = async ({ store, method = 'get', path, request }) => {
     throw response
   }
 
-  return response.data
+  return response?.data ? response.data : response.result
 }

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

@@ -0,0 +1,29 @@
+/* https://open.shopee.com/documents?module=4&type=1&id=396&version=1 */
+
+export function getStoreOrderTransactionDetails() {
+  return {
+    method: 'post',
+    path: '/orders/my_income',
+    denormalize(req) {
+      var { orderNo } = req
+
+      return {
+        ordersn: orderNo
+      }
+    },
+    normalize(res) {
+      var { order } = res
+      const result = {
+        voucherAmount: parseFloat(order.income_details.voucher_seller) || null,
+        shippingRebate: parseFloat(order.income_details.shipping_fee_rebate) || null,
+        commissionFee: parseFloat(order.income_details.commission_fee) || null,
+        serviceFee: parseFloat(order.income_details.service_fee) || null,
+        transactionFee: parseFloat(order.income_details.seller_transaction_fee) || null,
+        totalRealeasedAmount: parseFloat(order.income_details.escrow_amount) || null,
+        voucherCode: order.income_details.voucher_code,
+        shippingMode: order.shipping_carrier
+      }
+      return result
+    }
+  }
+}

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

@@ -1,5 +1,7 @@
 /* https://open.shopee.com/documents?module=4&type=1&id=397 */
 
+import { StoreAPI } from '../../store-api'
+
 export function getStoreOrder() {
   return {
     path: '/orders/detail',
@@ -10,8 +12,17 @@ export function getStoreOrder() {
         ordersn_list: [orderNo]
       }
     },
-    normalize(res) {
-      let results = res.orders.map(order => {
+    normalize(res, { store }) {
+      let results = res.orders.map(async order => {
+        if (order.pay_time) {
+          order.pay_time = new Date(order.pay_time * 1000)
+        }
+        if (order.estimated_shipping_fee) {
+          order.estimated_shipping_fee = parseFloat(order.estimated_shipping_fee)
+        }
+        if (order.actual_shipping_cost) {
+          order.actual_shipping_cost = parseFloat(order.actual_shipping_cost)
+        }
         const {
           ordersn: name,
           ordersn: orderNo,
@@ -24,7 +35,11 @@ export function getStoreOrder() {
           total_amount: totalAmount,
           tracking_no,
           recipient_address,
-          items
+          items,
+          buyer_username: buyerUsername,
+          pay_time: payTime,
+          estimated_shipping_fee: shippingFee,
+          actual_shipping_cost: actualShippingFee
         } = order
         var status = order_status.toLowerCase()
         var orderUpdatedAt = new Date(update_time * 1000)
@@ -42,7 +57,8 @@ export function getStoreOrder() {
             variation_discounted_price: variationDiscountedPrice,
             promotion_type: promotionType,
             promotion_id: promotionId,
-            is_wholesale: isWholesale
+            is_wholesale: isWholesale,
+            variation_original_price: variationOriginalPrice
           } = item
           var variationId = variation_id == 0 ? name : variation_id
           return {
@@ -54,7 +70,9 @@ export function getStoreOrder() {
             promotionType,
             promotionId,
             isWholesale,
-            docRefNo
+            docRefNo,
+            originalPrice: qty * variationOriginalPrice,
+            discount: qty * variationOriginalPrice - qty * variationDiscountedPrice
           }
         })
 
@@ -74,9 +92,13 @@ export function getStoreOrder() {
           collectionCurrency: null,
           attentionTo,
           trackingNo,
-          transporter: shippingProvider
+          transporter: shippingProvider,
+          shippingFee: parseFloat(shippingFee) || null,
+          actualShippingFee: parseFloat(actualShippingFee) || null
         }
 
+        let escrowDetails = await StoreAPI.getStoreOrderTransactionDetails(store, { orderNo })
+
         return {
           name,
           orderNo,
@@ -92,7 +114,10 @@ export function getStoreOrder() {
           shippingProvider,
           itemCount,
           orderItems,
-          orderShipping
+          orderShipping,
+          buyerUsername,
+          payTime,
+          ...escrowDetails
         }
       })
 

package/server/controllers/shopee/apis/get-store-refund-order-details.ts

@@ -0,0 +1,41 @@
+/* https://open.shopee.com/documents?module=5&type=1&id=443&version=1 */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreRefundOrderDetails() {
+  return {
+    path: '/returns/detail',
+    denormalize(req) {
+      var { refundOrderNo } = req
+
+      return {
+        returnsn: refundOrderNo
+      }
+    },
+    async normalize(res, { store }) {
+      let refundItems = res.items.map(item => {
+        let { item_id: name, item_id: orderItemId, item_price: price, amount: qty, variation_id: variationId } = item
+        name = name.toString()
+        orderItemId = orderItemId.toString()
+        return {
+          name,
+          orderItemId,
+          price,
+          qty,
+          variationId
+        }
+      })
+
+      let results = {
+        name: res.returnsn.toString(),
+        orderNo: res.returnsn.toString(),
+        amount: res.refund_amount,
+        status: res.status,
+        items: refundItems,
+        variationId: res.variationId
+      }
+
+      return results
+    }
+  }
+}

package/server/controllers/shopee/apis/get-store-refund-orders.ts

@@ -0,0 +1,47 @@
+/* https://open.shopee.com/documents?module=5&type=1&id=403&version=1 */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreRefundOrders() {
+  return {
+    path: '/returns/get',
+    denormalize(req) {
+      var { pagination, fromDate, toDate } = req || {}
+      var { page = 0, limit = 100 } = pagination || {}
+
+      var create_time_from = Math.floor(new Date(fromDate).getTime() / 1000)
+      var create_time_to = Math.floor(new Date(toDate).getTime() / 1000)
+
+      return {
+        pagination_entries_per_page: limit,
+        pagination_offset: page * limit,
+        create_time_from,
+        create_time_to
+      }
+    },
+    async normalize(res, { store }) {
+      // res.returns.push( // TO BE REMOVED
+      //   {
+      //     returnsn: 180529163852038,
+      //     refund_amount: 122,
+      //     status: 'CANCELLED',
+      //     ordersn: '211104MSNDH3CD'
+      //   }
+      // )
+
+      var { returns, more } = res
+
+      let results: any[] = []
+
+      for (var i = 0; i < returns?.length; i++) {
+        const refundOrder = returns[i]
+        const refundOrderNo = refundOrder.returnsn
+
+        const result = await StoreAPI.getStoreRefundOrderDetails(store, { refundOrderNo })
+
+        results.push({ ...result, originalOrderNo: refundOrder.ordersn })
+      }
+      return { results, more }
+    }
+  }
+}

package/server/controllers/shopee/apis/index.ts

@@ -24,3 +24,6 @@ export * from './split-order'
 // export * from './update-store-product'
 export * from './update-store-product-stock'
 export * from './update-store-product-variation-stock'
+export * from './get-store-refund-orders'
+export * from './get-store-refund-order-details'
+export * from './get-store-order-transaction-details'

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

@@ -27,6 +27,9 @@ export function getStoreOrders() {
     },
     async normalize(res, { store }) {
       // return res.orders
+
+      // removed item -> fulfillable_quantity = 0
+
       const linkParams = res.link
       var more: boolean = false
 
@@ -42,6 +45,9 @@ export function getStoreOrders() {
         .map(order => {
           const orderId = order.id
           const fulfillmentStatus = order.fulfillment_status
+          let orderStatus = order?.cancelled_at ? 'cancelled' : fulfillmentStatus ? fulfillmentStatus : 'unfulfilled'
+
+          let itemCount: Number = 0
           let result: any
 
           if (fulfillmentStatus != null) {
@@ -49,14 +55,14 @@ export function getStoreOrders() {
 
             result = {
               name: fulfillment.order_id,
-              orderNo: order.order_number,
+              orderNo: order.name,
               currency: order.currency,
               totalAmount: order.current_total_price,
               remark: order.note,
               orderCreatedAt: new Date(order.created_at).toUTCString(),
               orderUpdatedAt: new Date(order.updated_at).toUTCString(),
               discountValue: order.total_discounts,
-              status: fulfillmentStatus,
+              status: orderStatus,
               trackingNo: fulfillment.tracking_number,
               shippingProvider: fulfillment.tracking_company,
               recipientAddress:
@@ -79,15 +85,33 @@ export function getStoreOrders() {
           } else {
             let lineItems = []
 
-            order.line_items.map(lineItem => {
-              const refundItems = order.refunds.map(refund => {
-                const refundLineItems = refund.refund_line_items
-                return {
-                  ...refundLineItems
+            const refundItems = order.refunds
+              .reduce((acc, curr) => {
+                const refundLineItems = curr.refund_line_items
+                acc.push(...refundLineItems)
+
+                return acc
+              }, [])
+              .reduce((acc, curr) => {
+                let sum = acc.findIndex(x => x.line_item_id === curr.line_item_id)
+                if (sum >= 0) {
+                  acc[sum].quantity += curr.quantity
+                } else {
+                  acc.push(curr)
                 }
-              })
 
-              const matchedLineItem = refundItems.find(item => item[0].line_item_id == lineItem.id)
+                return acc
+              }, [])
+
+            let filteredLineItems = []
+            if (orderStatus == 'cancelled') {
+              filteredLineItems = order.line_items
+            } else {
+              filteredLineItems = order.line_items.filter(item => item.fulfillable_quantity > 0)
+            }
+
+            filteredLineItems.map(lineItem => {
+              const matchedLineItem = refundItems.find(item => item.line_item_id == lineItem.id)
 
               if (!matchedLineItem) {
                 lineItem = {
@@ -102,6 +126,19 @@ export function getStoreOrders() {
                 }
 
                 lineItems.push(lineItem)
+              } else {
+                lineItem = {
+                  name: lineItem.id.toString(),
+                  qty: orderStatus == 'cancelled' ? lineItem.quantity : lineItem.quantity - matchedLineItem.quantity,
+                  paidPrice: lineItem.price,
+                  docRefNo: lineItem.id,
+                  variationId: lineItem.product_exists === true ? lineItem.variant_id : lineItem.id.toString(),
+                  variationSku: lineItem.sku,
+                  channelSku: lineItem.sku,
+                  variationName: lineItem.name
+                }
+
+                if (lineItem.qty >= 0) lineItems.push(lineItem)
               }
             })
 
@@ -109,13 +146,13 @@ export function getStoreOrders() {
               name: orderId,
               orderNo: order.name,
               currency: order.currency,
-              totalAmount: order.current_total_price,
+              totalAmount: orderStatus == 'cancelled' ? order.total_price : order.current_total_price,
               remark: order.note,
               orderCreatedAt: new Date(order.created_at).toUTCString(),
               orderUpdatedAt: new Date(order.updated_at).toUTCString(),
               discountValue: order.total_discounts,
               recipientAddress: order.billing_address,
-              status: order.fulfillment_status == null ? 'unfulfilled' : order.fulfillment_status,
+              status: orderStatus,
               reason: order.cancel_reason,
               orderItems: lineItems
             }
@@ -130,7 +167,8 @@ export function getStoreOrders() {
               city,
               country,
               first_name,
-              last_name
+              last_name,
+              province: state
             } = order?.shipping_address ? order.shipping_address : order.billing_address
 
             var orderShipping = {
@@ -143,6 +181,7 @@ export function getStoreOrders() {
               phone2: null,
               postCode,
               city,
+              state,
               country: country === 'MY' ? 'Malaysia' : country,
               collectionCurrency: null,
               attentionTo: `${first_name} ${last_name}`
@@ -151,6 +190,9 @@ export function getStoreOrders() {
             result.orderShipping = orderShipping
           }
 
+          itemCount = result.orderItems.length
+          result.itemCount = itemCount
+
           return result
         })
 

package/server/controllers/shopify/apis/get-store-products.ts

@@ -1,6 +1,7 @@
 /* https://shopify.dev/docs/admin-api/rest/reference/products/product?api[version]=2020-07#index-2020-07 */
 
 import { URL } from 'url'
+
 import { StoreAPI } from '../../store-api'
 
 export function getStoreProducts() {
@@ -68,6 +69,7 @@ export function getStoreProducts() {
           name: product.title,
           type: product.product_type,
           description: product.body_html,
+          marketplaceStatus: product.status,
           hasVariation: true,
           categoryId: product?.collection_id ? product.collection_id : null,
           attributes: [],
@@ -76,7 +78,7 @@ export function getStoreProducts() {
               variationId: variant.id,
               variationSku: variant.sku,
               channelSku: variant.sku,
-              name: variant.title,
+              name: variant.title == 'Default Title' ? product.title : variant.title,
               qty: variant.inventory_quantity,
               inventoryPolicy: variant.inventory_policy,
               inventoryItemId: variant.inventory_item_id,

package/server/controllers/store-api/index.ts

@@ -1,4 +1,5 @@
 import { getRepository } from 'typeorm'
+
 import { MarketplaceStore } from '../../entities'
 import { api } from './decorators'
 
@@ -80,6 +81,9 @@ export class StoreAPI {
   @api
   static updateStoreProduct(store, req): any {}
 
+  @api
+  static updateOrder(store, req): any {}
+
   @api
   static cancelStoreOrder(store, req): any {}
 
@@ -151,4 +155,28 @@ export class StoreAPI {
 
   @api
   static splitOrder(store, req): any {}
+
+  @api
+  static getStoreRefundOrders(store, req): any {}
+
+  @api
+  static getStoreRefundOrderDetails(store, req): any {}
+
+  @api
+  static getStoreOrderItemPaymentFee(store, req): any {}
+
+  @api
+  static getStoreOrderItemTransactionDetails(store, req): any {}
+
+  @api
+  static updateProductAttribute(store, req): any {}
+
+  @api
+  static getStoreOrderTransactionDetails(store, req): any {}
+
+  @api
+  static updateStoreProductVariationPrice(store, req): any {}
+
+  @api
+  static updateStoreProductPrice(store, req): any {}
 }

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

@@ -0,0 +1,17 @@
+/* https://woocommerce.github.io/woocommerce-rest-api-docs/?javascript#retrieve-an-order */
+
+export function getStoreOrder() {
+  return {
+    method: 'get',
+    path: '/orders/{orderId}',
+    denormalize(req) {
+      var { orderId } = req
+      return {
+          resource: { orderId }
+      }
+    },
+    normalize(res) {
+        return res.items
+    }
+  }
+}