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

package/server/controllers/lazada/apis/get-store-product-brands.ts

@@ -0,0 +1,27 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193531.0.0.62986bbe73cFsS#/api?cid=5&path=/products/get */
+
+export function getStoreProductBrands() {
+  return {
+    method: 'get',
+    path: '/brands/get',
+    denormalize(req) {
+      var { pagination } = req || {}
+      var { page, limit } = pagination || { page: 0, limit: 100 }
+
+      return {
+        filter: 'all' /* all, live, inactive, deleted, image-missing, pending, rejected, sold-out */,
+        // update_before: '',
+        // update_after: '',
+        // create_before: '',
+        // create_after: '',
+        offset: page * limit,
+        limit: limit
+        // options: '',
+        // sku_seller_list: ''
+      }
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

package/server/controllers/lazada/apis/get-store-product-categories.ts

@@ -0,0 +1,14 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193494.0.0.1805266b7Xrdkj#/api?cid=5&path=/category/tree/get */
+
+export function getStoreProductCategories() {
+  return {
+    method: 'get',
+    path: '/category/tree/get',
+    denormalize(req) {
+      return req
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

package/server/controllers/lazada/apis/get-store-product-category-attributes.ts

@@ -0,0 +1,16 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193494.0.0.1805266b7Xrdkj#/api?cid=5&path=/category/attributes/get */
+
+export function getStoreProductCategoryAttributes() {
+  return {
+    method: 'get',
+    path: '/category/attributes/get',
+    denormalize(req) {
+      return {
+        primary_category_id: req
+      }
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

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

@@ -0,0 +1,42 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193531.0.0.62986bbe73cFsS#/api?cid=5&path=/products/get */
+
+export function getStoreProduct() {
+  return {
+    method: 'get',
+    path: '/product/item/get',
+    denormalize(req) {
+      return req
+    },
+    normalize(res) {
+      var { item_id, primary_category, skus } = res
+
+      const result: any = {
+        itemId: item_id,
+        categoryId: primary_category,
+        variations: skus.map(sku => {
+          return {
+            variationId: sku.ShopSku,
+            variationSku: sku.SellerSku,
+            channelSku: sku.SkuId,
+            qty: sku?.quantity ? sku.quantity : 0,
+            bufferQty: 0,
+            costPrice: sku.price,
+            sellPrice: sku.price,
+            discountId: sku.discount_id,
+            marketplaceStatus: sku.Status,
+            height: sku.package_height,
+            length: sku.package_length,
+            weight: sku.package_weight,
+            width: sku.package_width,
+            promo_from: sku.special_from_time,
+            promo_to: sku.special_to_time,
+            promo_price: sku.special_price,
+            promo_time_format: sku.special_time_format
+          }
+        })
+      }
+
+      return result
+    }
+  }
+}

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

@@ -0,0 +1,84 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193531.0.0.62986bbe73cFsS#/api?cid=5&path=/products/get */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreProducts() {
+  return {
+    method: 'get',
+    path: '/products/get',
+    denormalize(req) {
+      var { pagination } = req || {}
+      var { page, limit } = pagination || { page: 0, limit: 100 }
+
+      return {
+        filter: 'all' /* all, live, inactive, deleted, image-missing, pending, rejected, sold-out */,
+        offset: (page * limit).toString(),
+        limit: limit.toString()
+      }
+    },
+    async normalize(res, { store }) {
+      var results: any[] = []
+
+      for (var i = 0; i < res.products.length; i++) {
+        const product = res.products[i]
+
+        const categoryAttributes: any[] = await StoreAPI.getStoreProductCategoryAttributes(
+          store,
+          product.primary_category
+        )
+
+        const result: any = {
+          itemId: product.item_id,
+          name: product.attributes.name,
+          description: product.attributes.description,
+          categoryId: product.primary_category,
+          attributes: Object.keys(product.attributes).reduce((acc, attributeName) => {
+            const attributes: any[] = categoryAttributes.filter(x => x.name == attributeName)
+            if (attributes && attributes.length > 0) {
+              const attribute: any = attributes[0]
+              return [
+                ...acc,
+                {
+                  attributeId: attribute.label,
+                  name: attribute.label,
+                  description: attribute.name,
+                  attributeType: attribute.attribute_type,
+                  originalValue: product.attributes[attributeName],
+                  isMandatory: !!(attribute.is_mandatory || 0)
+                }
+              ]
+            } else {
+              return acc
+            }
+          }, []),
+          variations: product.skus.map(sku => {
+            return {
+              variationId: sku.ShopSku,
+              variationSku: sku.SellerSku,
+              channelSku: sku.SkuId,
+              name: product.attributes.name,
+              qty: sku?.quantity ? sku.quantity : 0,
+              bufferQty: 0,
+              costPrice: sku.price,
+              sellPrice: sku.price,
+              discountId: sku.discount_id,
+              marketplaceStatus: sku.Status,
+              height: sku.package_height,
+              length: sku.package_length,
+              primaryUnitValue: sku.package_weight,
+              width: sku.package_width,
+              promo_from: sku.special_from_time,
+              promo_to: sku.special_to_time,
+              promo_price: sku.special_price,
+              promo_time_format: sku.special_time_format
+            }
+          })
+        }
+
+        results.push({ ...result })
+      }
+
+      return { results, total: res.total_products }
+    }
+  }
+}

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

@@ -0,0 +1,24 @@
+export * from './echo'
+export * from './create-store-product'
+export * from './delete-store-product'
+export * from './cancel-store-order'
+export * from './get-store-order-document'
+export * from './get-store-logistics'
+export * from './get-store-order'
+export * from './get-store-orders'
+export * from './set-store-order-status-ready-to-ship'
+export * from './set-store-order-status-packed-by-marketplace'
+export * from './set-store-order-status-delivered'
+export * from './set-store-order-status-failed-delivery'
+export * from './get-store-order-items'
+export * from './get-store-product-categories'
+export * from './get-store-product-category-attributes'
+export * from './get-store-products'
+export * from './get-store-product'
+export * from './get-store-product-brands'
+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/apis/set-order-invoice-no.ts

@@ -0,0 +1,24 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193531.0.0.39b76bbelL2ZaZ#/api?cid=8&path=/order/invoice_number/set */
+
+export function setOrderInvoiceNo() {
+  return {
+    method: 'post',
+    path: '/order/invoice_number/set',
+    denormalize(req) {
+      var { orderItemId: order_item_id, invoiceNo: invoice_number } = req
+
+      return {
+        order_item_id,
+        invoice_number
+      }
+    },
+    normalize(res) {
+      var { order_item_id: orderItemId, invoice_number: invoiceNo } = res
+
+      return {
+        orderItemId,
+        invoiceNo
+      }
+    }
+  }
+}

package/server/controllers/lazada/apis/set-store-order-status-delivered.ts

@@ -0,0 +1,17 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193487.0.0.3ac413fezJn6Cq#/api?cid=8&path=/order/sof/delivered */
+
+export function setStoreOrderStatusDelivered() {
+  return {
+    method: 'post',
+    path: '/order/sof/delivered',
+    denormalize(req) {
+      var { orderItemId: order_item_ids } = req
+      var output = '[' + order_item_ids.join(',') + ']'
+
+      return { order_item_ids: output }
+    },
+    normalize(res) {
+      return res.order_items
+    }
+  }
+}

package/server/controllers/lazada/apis/set-store-order-status-failed-delivery.ts

@@ -0,0 +1,17 @@
+/* https://open.lazada.com/doc/api.htm?spm=a2o9m.11193487.0.0.3ac413fezJn6Cq#/api?cid=8&path=/order/sof/failed_delivery */
+
+export function setStoreOrderStatusFailedDelivery() {
+  return {
+    method: 'post',
+    path: '/order/sof/failed_delivery',
+    denormalize(req) {
+      var { orderItemId: order_item_ids } = req
+      var output = '[' + order_item_ids.join(',') + ']'
+
+      return { order_item_ids: output }
+    },
+    normalize(res) {
+      return res.order_items
+    }
+  }
+}

package/server/controllers/lazada/apis/set-store-order-status-packed-by-marketplace.ts

@@ -0,0 +1,46 @@
+/* https://open.shopee.com/documents?module=2&type=1&id=365 */
+
+export function setStoreOrderStatusPackedByMarketplace() {
+  return {
+    method: 'post',
+    path: '/order/pack',
+    denormalize(req) {
+      var { deliveryType: delivery_type, orderItemId: order_item_ids, shippingProvider: shipment_provider } = req
+      var output = '[' + order_item_ids.join(',') + ']'
+
+      return {
+        delivery_type,
+        order_item_ids: output,
+        shipment_provider
+      }
+    },
+    normalize(res) {
+      let results = res.order_items
+      results = results
+        .reduce((orderItem, item) => {
+          orderItem = {
+            ...orderItem,
+            items: [
+              ...orderItem.items, 
+              {
+                order_item_id: item.order_item_id,
+                tracking_code: item.tracking_number
+              }]
+          }
+
+          const foundtrackingNumber = orderItem.trackingNumber.find(f => f == item.tracking_number)
+
+          if (!foundtrackingNumber) {
+            orderItem = {
+              ...orderItem,
+              trackingNumber: [...orderItem.trackingNumber, item.tracking_number]
+            }
+          }
+
+          return orderItem
+        }, {items: [], trackingNumber: []})
+
+      return results
+    }
+  }
+}

package/server/controllers/lazada/apis/set-store-order-status-ready-to-ship.ts

@@ -0,0 +1,28 @@
+/* https://open.shopee.com/documents?module=2&type=1&id=365 */
+
+export function setStoreOrderStatusReadyToShip() {
+  return {
+    method: 'post',
+    path: '/order/rts',
+    denormalize(req) {
+      var {
+        deliveryType: delivery_type,
+        orderItemId: order_item_ids,
+        shipmentProvider: shipment_provider,
+        trackingNo: tracking_number
+      } = req
+
+      var output = '[' + order_item_ids.join(',') + ']'
+
+      return {
+        delivery_type,
+        order_item_ids: output,
+        shipment_provider,
+        tracking_number
+      }
+    },
+    normalize(res) {
+      return res.order_items
+    }
+  }
+}

package/server/controllers/lazada/apis/update-store-product-stock.ts

@@ -0,0 +1,29 @@
+export function updateStoreProductStock() {
+  return {
+    path: '/product/stock/sellable/update',
+    denormalize(req) {
+      return {
+        payload: {
+          Request: {
+            Product: {
+              Skus: [
+                ...req.map(data => {
+                  return {
+                    Sku: {
+                      ItemId: data.itemId,
+                      SellerSku: data.variationSku,
+                      SellableQuantity: data.qty
+                    }
+                  }
+                })
+              ]
+            }
+          }
+        }
+      }
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

package/server/controllers/lazada/apis/update-store-product-variation-stock.ts

@@ -0,0 +1,29 @@
+export function updateStoreProductVariationStock() {
+  return {
+    path: '/product/stock/sellable/update',
+    denormalize(req) {
+      return {
+        payload: {
+          Request: {
+            Product: {
+              Skus: [
+                ...req.map(data => {
+                  return {
+                    Sku: {
+                      ItemId: data.itemId,
+                      SellerSku: data.variationSku,
+                      SellableQuantity: data.qty
+                    }
+                  }
+                })
+              ]
+            }
+          }
+        }
+      }
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

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

@@ -0,0 +1,51 @@
+export function updateStoreProduct() {
+  return {
+    method: 'post',
+    path: '/product/update',
+    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) {
+      return res
+    }
+  }
+}

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

@@ -0,0 +1,3 @@
+export * from './types'
+export * from './lazada'
+export * from './xml'

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

@@ -0,0 +1,142 @@
+import FormData from 'form-data'
+import fetch from 'node-fetch'
+
+import { getRepository } from '@things-factory/shell'
+
+import { MarketplaceStore } from '../../../entities'
+import { makeSystemParameters } from './signature'
+import { Endpoint, Parameter } from './types'
+import { xmlize } from './xml'
+
+export class Lazada {
+  endpoint: string
+  appKey: string
+  appSecret: string
+  accessToken: string
+
+  constructor(countryCode: string, appKey: string, appSecret: string) {
+    this.endpoint = Endpoint[countryCode]
+    this.appKey = appKey
+    this.appSecret = appSecret
+  }
+
+  async generateAccessToken(payload: {
+    code: string // oauth code, get from app callback URL
+    uuid?: string // unique identifier, anti-replay
+  }) {
+    const apiPath = '/auth/token/create'
+
+    const body = {
+      ...payload,
+      ...makeSystemParameters(this.appKey, this.appSecret, apiPath, undefined, payload)
+    }
+
+    const response = await fetch(Endpoint.auth + apiPath, {
+      method: 'post',
+      headers: {
+        'Content-Type': 'application/json'
+      },
+      body: JSON.stringify(body)
+    })
+
+    return await response.json()
+  }
+
+  public static async refreshAccessToken(payload: { refresh_token: string }, appKey, appSecret, storeId) {
+    /* CONFIRM-ME not qualified */
+    const apiPath = '/auth/token/refresh'
+
+    const body = {
+      ...payload,
+      ...makeSystemParameters(appKey, appSecret, apiPath, undefined, payload)
+    }
+
+    const response = await fetch(Endpoint.auth + apiPath, {
+      method: 'post',
+      headers: {
+        'Content-Type': 'application/json'
+      },
+      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()
+  }
+
+  async get(path: string, params: Parameter, accessToken?: string) {
+    const qs = Object.entries({
+      ...params,
+      ...makeSystemParameters(this.appKey, this.appSecret, path, accessToken || this.accessToken, params)
+    })
+      .map(([k, v]) => `${k}=${encodeURIComponent(String(v))}`)
+      .join('&')
+
+    const response = await fetch(this.endpoint + path + '?' + qs, {
+      headers: {
+        'Content-Type': 'application/json'
+      }
+    })
+
+    if (!response.ok) {
+      throw response
+    }
+
+    return await response.json()
+  }
+
+  async post(path: string, params: Parameter, accessToken?: string) {
+    if ('payload' in params) {
+      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 body = new FormData()
+
+    body.append('app_key', app_key)
+    body.append('timestamp', timestamp)
+    body.append('access_token', access_token)
+    body.append('sign_method', sign_method)
+    body.append('sign', sign)
+
+    for (let key in params) {
+      body.append(key, params[key])
+    }
+
+    const response = await fetch(this.endpoint + path, {
+      method: 'post',
+      headers: body.getHeaders(),
+      body
+    })
+
+    if (!response.ok) {
+      throw response
+    }
+
+    return await response.json()
+  }
+}