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

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/get-time-slot.ts

@@ -0,0 +1,25 @@
+/* https://open.shopee.com/documents?module=3&type=1&id=387 */
+
+export function getTimeSlot() {
+  return {
+    path: '/logistics/timeslot/get',
+    denormalize(req) {
+      var { orderNo: ordersn, addressId } = req
+      var address_id = parseInt(addressId)
+      return { ordersn, address_id }
+    },
+    normalize(res) {
+      var { pickup_time } = res
+      let result = pickup_time.map(time => {
+        const { pickup_time_id: pickupTimeId, date, time_text: timeText } = time
+        var pickupDate = new Date(date * 1000).toDateString()
+        return {
+          pickupTimeId,
+          pickupDate,
+          timeText
+        }
+      })
+      return result
+    }
+  }
+}

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

@@ -0,0 +1,30 @@
+export * from './echo'
+export * from './create-store-product'
+export * from './create-store-product-variations'
+export * from './update-store-product'
+export * from './delete-store-product'
+export * from './cancel-store-order'
+export * from './accept-store-order-cancellation'
+export * from './reject-store-order-cancellation'
+export * from './get-address'
+export * from './get-store-order'
+export * from './get-store-orders'
+export * from './get-store-order-items'
+export * from './get-store-order-document'
+export * from './get-store-product-categories'
+export * from './get-store-product-category-attributes'
+export * from './get-store-product'
+export * from './get-store-products'
+export * from './get-store-logistics'
+export * from './get-logistics-param'
+export * from './get-time-slot'
+export * from './get-branch-list'
+export * from './init-logistics'
+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'
+export * from './get-store-order-payout-dates'

package/server/controllers/shopee/apis/init-logistics.ts

@@ -0,0 +1,39 @@
+/* https://open.shopee.com/documents?module=3&type=1&id=389 */
+
+export function initLogistics() {
+  return {
+    path: '/logistics/init',
+    denormalize(req) {
+      var { orderNo: ordersn, deliveryType } = req
+      let pickup = {}
+      let dropoff = {}
+      let non_integrated = {}
+      let args = {}
+
+      if (deliveryType?.pickup) {
+        var { addressId, pickupTimeId: pickup_time_id } = deliveryType.pickup
+        var address_id = parseInt(addressId)
+        pickup = { address_id, pickup_time_id }
+        args = { ordersn, pickup: { ...pickup } }
+      }
+
+      if (deliveryType?.non_integrated) {
+        var { trackingNo: tracking_no } = deliveryType.non_integrated
+        non_integrated = { tracking_no }
+        args = { ordersn, non_integrated: { tracking_no } }
+      }
+
+      if (deliveryType?.dropoff) {
+        var { branchId: branch_id } = deliveryType.dropoff
+        dropoff = { branch_id }
+        args = { ordersn, dropoff: { ...dropoff } }
+      }
+      
+      return args
+    },
+    normalize(res) {
+      var { tracking_number: trackingNo } = res
+      return trackingNo
+    }
+  }
+}

package/server/controllers/shopee/apis/reject-store-order-cancellation.ts

@@ -0,0 +1,22 @@
+/* https://open.shopee.com/documents?module=2&type=1&id=365 */
+
+export function rejectStoreOrderCancellation() {
+  return {
+    path: '/orders/buyer_cancellation/reject',
+    denormalize(req) {
+      var { name: ordersn } = req
+
+      return {
+        ordersn
+      }
+    },
+    normalize(res) {
+      var { modified_time, request_id } = res
+
+      /* convert unified type */
+      return {
+        updatedAt: modified_time
+      }
+    }
+  }
+}

package/server/controllers/shopee/apis/split-order.ts

@@ -0,0 +1,44 @@
+export function splitOrder() {
+  return {
+    path: '/orders/split',
+    denormalize(req) {
+      // parcels request body
+      // ordersn: '123',
+      // parcels: [{
+      //   item_id,
+      //   variation_id,
+      //   order_item_id,
+      //   promotion_group_id
+      // }]
+
+      var { ordersn, parcels } = req
+
+      return {
+        ordersn,
+        parcels
+      }
+    },
+    normalize(res) {
+      var { ordersn, forders, package_list } = res.item
+
+      /* convert unified type */
+      return {
+        ordersn,
+        forders,
+        packageList: package_list.map(packageItem => {
+          return {
+            packageNumber: packageItem.package_number,
+            items: packageItem.items.map(item => {
+              return {
+                itemId: item.item_id,
+                variationId: item.variation_id,
+                orderItemId: item.order_item_id,
+                promotionGroupId: item.promotion_group_id
+              }
+            })
+          }
+        })
+      }
+    }
+  }
+}

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

@@ -0,0 +1,24 @@
+export function updateStoreProductStock() {
+  return {
+    path: '/items/update/items_stock',
+    async denormalize(req, { store }) {
+      var { id, sku, qty } = req
+
+      return {
+        items: [
+          ...req.map(data => {
+            return {
+              item_id: parseInt(data.itemId),
+              stock: data.qty
+            }
+          })
+        ]
+      }
+    },
+    async normalize(res, { store }) {
+      let result = res
+
+      return {}
+    }
+  }
+}

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

@@ -0,0 +1,21 @@
+export function updateStoreProductVariationStock() {
+  return {
+    path: '/items/update/vars_stock',
+    denormalize(req) {
+      return {
+        variations: [
+          ...req.map(data => {
+            return {
+              variation_id: parseInt(data.variationId),
+              stock: data.qty,
+              item_id: parseInt(data.itemId)
+            }
+          })
+        ]
+      }
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

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

@@ -0,0 +1,85 @@
+export function updateStoreProduct() {
+  return {
+    path: '/item/update',
+    denormalize(req) {
+      var {
+        id: item_id,
+        categoryId: category_id,
+        name,
+        description,
+        price,
+        stock,
+        productSku: item_sku,
+        images,
+        variations,
+        logistics,
+        wholesales,
+        weight,
+        length: package_length,
+        width: package_width,
+        height: package_height
+      } = req
+
+      variations = variations.map(variation => {
+        const { id: variation_id, name, variationSku: variation_sku } = variation
+        return {
+          variation_id,
+          name,
+          variation_sku
+        }
+      })
+
+      wholesales = wholesales.map(wholesale => {
+        const { min, max, unitPrice: unit_price } = wholesale
+        return {
+          min,
+          max,
+          unit_price
+        }
+      })
+
+      logistics = logistics.map(logistic => {
+        const {
+          logisticId: logistic_id,
+          enabled,
+          shippingFee: shipping_fee,
+          sizeId: size_id,
+          isFree: is_free
+        } = logistic
+        return {
+          logistic_id,
+          enabled,
+          shipping_fee,
+          size_id,
+          is_free
+        }
+      })
+
+      return {
+        item_id,
+        category_id,
+        name,
+        description,
+        price,
+        stock,
+        item_sku,
+        images,
+        wholesales,
+        variations,
+        logistics,
+        weight,
+        package_height,
+        package_length,
+        package_width
+      }
+    },
+    normalize(res) {
+      var { item_id, logistics, price, original_price, package_width, cmt_count } = res.item
+
+      /* convert unified type */
+      return {
+        id: item_id
+      }
+    }
+  }
+}

package/server/controllers/shopee/apis2/create-shipping-document.ts

@@ -0,0 +1,27 @@
+/* https://open.shopee.com/documents/v2/v2.logistics.create_shipping_document?module=95&type=1 */
+
+import { StoreAPI } from '../../store-api'
+
+export function createShippingDocument() {
+  return {
+    path: '/logistics/create_shipping_document',
+    method: 'postV2',
+    async denormalize(req, { store }) {
+      const { orderNo } = req
+
+      let trackingNo = await StoreAPI.getTrackingNumber(store, { orderNo })
+
+      return {
+        order_list: [
+          {
+            order_sn: orderNo,
+            tracking_number: trackingNo
+          }
+        ]
+      }
+    },
+    normalize(res) {
+      return res
+    }
+  }
+}

package/server/controllers/shopee/apis2/echo.ts

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

package/server/controllers/shopee/apis2/get-logistics-param.ts

@@ -0,0 +1,66 @@
+/* https://open.shopee.com/documents/v2/v2.logistics.get_shipping_parameter?module=95&type=1 */
+
+export function getLogisticsParam() {
+  return {
+    path: '/logistics/get_shipping_parameter',
+    method: 'getV2',
+    denormalize(req) {
+      var { orderNo } = req
+
+      return {
+        order_sn: orderNo
+      }
+    },
+    normalize(res) {
+      const infoNeeded: any = res.info_needed
+      let logisticsDetail: any
+
+      if (infoNeeded?.pickup?.length > 0) {
+        let addressList: any[] = []
+        const pickup: any = res.pickup
+
+        addressList = pickup.address_list.map(address => {
+          return {
+            ...address,
+            addressId: address.address_id,
+            timeSlot:
+              address?.time_slot_list && !address.time_slot_list?.error
+                ? address.time_slot_list.map(ts => {
+                    return {
+                      ...ts,
+                      pickupDate: new Date(ts.date * 1000).toDateString(),
+                      pickupTimeId: ts.pickup_time_id,
+                      timeText: ts.time_text
+                    }
+                  })
+                : []
+          }
+        })
+
+        logisticsDetail = { pickup: addressList?.length ? addressList : [] }
+      }
+
+      if (infoNeeded?.dropoff?.length > 0) {
+        const dropoff: any = res.dropoff
+        let branchList: any[] = []
+
+        if (dropoff?.branch_list?.length) {
+          branchList = dropoff.branch_list.map(branch => {
+            return {
+              ...branch,
+              branchId: branch.branch_id
+            }
+          })
+        }
+        logisticsDetail = { dropoff: branchList?.length ? branchList : [] }
+      }
+
+      if (infoNeeded?.non_integrated?.length > 0) {
+        logisticsDetail = { non_integrated: infoNeeded.non_integrated }
+      }
+
+      const result = { ...infoNeeded, logisticsDetail }
+      return result
+    }
+  }
+}

package/server/controllers/shopee/apis2/get-shipping-document-result.ts

@@ -0,0 +1,21 @@
+/* https://open.shopee.com/documents/v2/v2.logistics.get_shipping_document_result?module=95&type=1 */
+
+export function getShippingDocumentResult() {
+  return {
+    path: '/logistics/get_shipping_document_result',
+    method: 'postV2',
+    denormalize(req) {
+      const { orderNo } = req
+      return {
+        order_list: [
+          {
+            order_sn: orderNo[0]
+          }
+        ]
+      }
+    },
+    normalize(res) {
+      return res?.result_list[0]?.status
+    }
+  }
+}

package/server/controllers/shopee/apis2/get-store-logistics.ts

@@ -0,0 +1,23 @@
+/* https://open.shopee.com/documents/v2/v2.logistics.get_channel_list?module=95&type=1 */
+
+export function getStoreLogistics() {
+    return {
+      path: '/logistics/get_channel_list',
+      method: 'getV2',
+      denormalize(req) {
+        return {}
+      },
+      normalize(res) {
+  
+        let results = res.logistics_channel_list.filter(x=>x.enabled== true).map(provider => {
+          const { logistics_channel_name, preferred } = provider
+            return {
+              name : logistics_channel_name,
+              isDefault : preferred
+            }
+        })
+        return results
+      }
+    }
+  }
+  

package/server/controllers/shopee/apis2/get-store-order-by-batch.ts

@@ -0,0 +1,97 @@
+/* https://open.shopee.com/documents/v2/v2.order.get_order_detail?module=94&type=1 */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreOrderByBatch() {
+  return {
+    path: '/order/get_order_detail',
+    method: 'getV2',
+    denormalize(req) {
+      const { orderIdList } = req
+
+      return {
+        order_sn_list: orderIdList,
+        response_optional_fields: [
+          'recipient_address',
+          'item_list',
+          'total_amount',
+          'shipping_carrier',
+          'estimated_shipping_fee',
+          'buyer_username',
+          'actual_shipping_fee',
+          'pay_time',
+          'cancel_by',
+          'cancel_reason',
+          'actual_shipping_fee_confirmed'
+        ]
+      }
+    },
+    async normalize(res, { store }) {
+      let results = []
+      for (let order of res.order_list) {
+        let recipientAddress = order?.recipient_address
+        let escrowDetails: any = {}
+        let trackingNo = null
+        try {
+          escrowDetails = await StoreAPI.getStoreOrderTransactionDetails(store, { orderNo: order.order_sn })
+        } catch (e) {}
+        try {
+          trackingNo = await StoreAPI.getTrackingNumber(store, { orderNo: order.order_sn })
+        } catch (e) {}
+        const result = {
+          name: order.order_sn,
+          orderNo: order.order_sn,
+          docRefNo: order.order_sn,
+          status: order.order_status.toLowerCase(),
+          orderCreatedAt: new Date(order.create_time * 1000),
+          orderUpdatedAt: new Date(order.update_time * 1000),
+          totalAmount: order.total_amount,
+          cancelBy: order?.cancel_by,
+          reason: order?.cancel_reason,
+          recipientAddress: recipientAddress ? JSON.stringify(recipientAddress) : null,
+          shippingProvider: order.shipping_carrier,
+          itemCount: order.item_list.length,
+          buyerUsername: order.buyer_username,
+          payTime: order?.pay_time ? new Date(order.pay_time * 1000) : null,
+          orderItems: order.item_list.map(item => {
+            return {
+              name: item.item_id,
+              variationId: item.model_id == 0 ? item.item_id : item.model_id,
+              qty: item.model_quantity_purchased,
+              paidPrice: item.model_discounted_price * item.model_quantity_purchased,
+              orderNo: order.order_sn,
+              promotionType: item?.promotion_type,
+              promotionId: item?.promotion_id,
+              isWholesale: item.wholesale,
+              docRefNo: order.order_sn,
+              originalPrice: item.model_quantity_purchased * item.model_original_price,
+              discount:
+                item.model_quantity_purchased * item.model_original_price -
+                item.model_quantity_purchased * item.model_discounted_price
+            }
+          }),
+          orderShipping: {
+            address1: recipientAddress?.full_address,
+            phone1: recipientAddress?.phone,
+            postCode: recipientAddress?.zipcode,
+            city: recipientAddress?.city,
+            state: recipientAddress?.state,
+            country: recipientAddress?.region == 'MY' ? 'Malaysia' : recipientAddress?.region,
+            attentionTo: recipientAddress?.name,
+            transporter: order?.shipping_carrier,
+            shippingFee: parseFloat(order?.estimated_shipping_fee) || null,
+            actualShippingFee: order.actual_shipping_fee_confirmed
+              ? parseFloat(order?.actual_shipping_fee)
+              : parseFloat(order?.estimated_shipping_fee) || null,
+            trackingNo
+          },
+          ...escrowDetails,
+          trackingNo
+        }
+        results.push(result)
+      }
+
+      return results
+    }
+  }
+}

package/server/controllers/shopee/apis2/get-store-order-document.ts

@@ -0,0 +1,39 @@
+/* https://open.shopee.com/documents/v2/v2.logistics.download_shipping_document?module=95&type=1 */
+
+import { StoreAPI } from '../../store-api'
+import { uploadAwb } from '@things-factory/attachment-base'
+
+export function getStoreOrderDocument() {
+  return {
+    path: '/logistics/download_shipping_document',
+    method: 'postV2',
+    async denormalize(req, { store }) {
+      var { docRefNo } = req
+
+      return {
+        order_list: [
+          {
+            order_sn: docRefNo[0]
+          }
+        ]
+      }
+    },
+    async normalize(res) {
+      let awb
+      try {
+        awb = await uploadAwb({
+          content: res.awb,
+          title: res.data.order_list[0].order_sn
+        })
+      } catch (e) {
+        return []
+      }
+      return [
+        {
+          orderNo: res.data.order_list[0].order_sn,
+          airwayBill: awb?.url
+        }
+      ]
+    }
+  }
+}

package/server/controllers/shopee/apis2/get-store-order-payout-dates.ts

@@ -0,0 +1,33 @@
+/* https://open.shopee.com/documents/v2/v2.payment.get_payout_detail?module=97&type=1 */
+
+export function getStoreOrderPayoutDates() {
+  return {
+    path: '/payment/get_payout_detail',
+    method: 'getV2',
+    denormalize(req) {
+      var { fromCreatedDate, toCreatedDate, pagination } = req || {}
+      var { page, limit } = pagination
+      return {
+        payout_time_from: new Date(fromCreatedDate).getTime() / 1000,
+        payout_time_to: new Date(toCreatedDate).getTime() / 1000,
+        page_size: limit,
+        page_no: page * limit
+      }
+    },
+    normalize(res) {
+      var { payout_list, more } = res
+      let results = []
+
+      for (let payout of payout_list) {
+        let payoutDate = new Date(payout.payout_info.payout_time * 1000).toISOString()
+        for (let escrow of payout.escrow_list) {
+          results.push({
+            orderNo: escrow.order_sn,
+            payoutDate
+          })
+        }
+      }
+      return { results, more }
+    }
+  }
+}