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

package/server/controllers/shopee/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/shopee/apis/get-address.ts

@@ -0,0 +1,32 @@
+/* https://open.shopee.com/documents?module=3&type=1&id=381 */
+
+export function getAddress() {
+  return {
+    path: '/logistics/address/get',
+    denormalize() {
+      return
+    },
+    normalize(res) {
+      var { address_list } = res
+      let result = []
+      address_list.map(list => {
+        const {
+          address_id: addressId,
+          country,
+          state,
+          city,
+          address,
+          zipcode,
+          district,
+          town,
+          address_flag: addressFlag
+        } = list
+
+        if (addressFlag.includes('pickup_address'))
+          result.push({ addressId, country, state, city, address, zipcode, district, town, addressFlag })
+      })
+
+      return result
+    }
+  }
+}

package/server/controllers/shopee/apis/get-branch-list.ts

@@ -0,0 +1,30 @@
+/* https://open.shopee.com/documents?module=3&type=1&id=383 */
+
+export function getBranchList() {
+  return {
+    path: '/logistics/branch/get',
+    denormalize(req) {
+      var { orderNo: ordersn } = req
+      return { ordersn }
+    },
+    normalize(res) {
+      var { branch } = res
+
+      let result = branch.map(list => {
+        const { branch_id: branchId, country, state, city, address, zipcode, district, town } = list
+        return {
+          branchId,
+          country,
+          state,
+          city,
+          address,
+          zipcode, 
+          district,
+          town
+        }
+      })
+
+      return result
+    }
+  }
+}

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

@@ -0,0 +1,71 @@
+/* https://open.shopee.com/documents?module=3&type=1&id=386 */
+import { StoreAPI } from '../../store-api'
+
+export function getLogisticsParam() {
+  return {
+    path: '/logistics/init_info/get',
+    denormalize(req) {
+      var { orderNo } = req
+
+      return {
+        ordersn: orderNo
+      }
+    },
+    async normalize(res, { store }) {
+      delete res.request_id
+      const infoNeeded: any = res.info_needed
+      let logisticsDetail: any
+
+      if (infoNeeded?.pickup?.length > 0) {
+        let addressList: any[] = []
+        const pickup: any = res.pickup
+
+        if (!pickup?.address_list?.length) {
+          addressList = await StoreAPI.getAddress(store)
+        } else {
+          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/apis/get-store-logistics.ts

@@ -0,0 +1,21 @@
+/* https://open.shopee.com/documents?module=3&type=1&id=384 */
+
+export function getStoreLogistics() {
+  return {
+    path: '/logistics/channel/get',
+    denormalize(req) {
+      return {}
+    },
+    normalize(res) {
+
+      let results = res.logistics.filter(x=>x.enabled== true).map(provider => {
+        const { logistic_name, preferred } = provider
+          return {
+            name : logistic_name,
+            isDefault : preferred
+          }
+      })
+      return results
+    }
+  }
+}

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

@@ -0,0 +1,27 @@
+export function getStoreOrderDocument() {
+  return {
+    path: '/logistics/airway_bill/get_mass',
+    denormalize(req) {
+      var { docRefNo } = req
+
+      return {
+        ordersn_list: docRefNo
+      }
+    },
+    normalize(res) {
+      var { airway_bills } = res.result
+      let airwayBills: any[] = []
+
+      airwayBills = airway_bills.map(item => {
+        var { ordersn: orderNo, airway_bill: airwayBill } = item
+
+        return {
+          orderNo,
+          airwayBill
+        }
+      })
+
+      return airwayBills
+    }
+  }
+}

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

@@ -0,0 +1,47 @@
+/* https://open.shopee.com/documents?module=4&type=1&id=397 */
+
+export function getStoreOrderItems() {
+  return {
+    path: '/orders/detail',
+    denormalize(req) {
+      var { orderNo } = req
+
+      return {
+        ordersn_list: [orderNo]
+      }
+    },
+    normalize(res) {
+      let results = res.orders.map(order => {
+        const { orderNo, items } = order
+
+        let orderItems = items.map(item => {
+          var {
+            item_id: name,
+            variation_id,
+            variation_quantity_purchased: qty,
+            variation_discounted_price: variationDiscountedPrice,
+            promotion_type: promotionType,
+            promotion_id: promotionId,
+            is_wholesale: isWholesale
+          } = item
+          var variationId = variation_id == 0 ? name : variation_id
+          return {
+            name,
+            variationId,
+            qty,
+            paidPrice: variationDiscountedPrice * qty,
+            orderNo,
+            promotionType,
+            promotionId,
+            isWholesale,
+            docRefNo: orderNo
+          }
+        })
+
+        return orderItems
+      })
+
+      return results
+    }
+  }
+}

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

@@ -0,0 +1,29 @@
+/* https://open.shopee.com/documents?module=69&type=1&id=467&version=1 */
+
+export function getStoreOrderPayoutDates() {
+  return {
+    path: '/orders/get_escrow_detail',
+    method: 'post',
+    denormalize(req) {
+      var { fromCreatedDate, toCreatedDate, pagination } = req || {}
+      var { page, limit } = pagination
+      return {
+        release_time_from: fromCreatedDate.split('T')[0],
+        release_time_to: toCreatedDate.split('T')[0],
+        pagination_entries_per_page: limit,
+        pagination_offset: page * limit
+      }
+    },
+    normalize(res) {
+      var { orders, more } = res
+      const result = orders.map(order => {
+        let payoutDate = new Date(order.escrow_release_time * 1000).toISOString()
+        return {
+          orderNo: order.ordersn,
+          payoutDate
+        }
+      })
+      return { result, more }
+    }
+  }
+}

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

@@ -0,0 +1,136 @@
+/* https://open.shopee.com/documents?module=4&type=1&id=397 */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreOrder() {
+  return {
+    path: '/orders/detail',
+    denormalize(req) {
+      var { orderNo } = req
+
+      return {
+        ordersn_list: [orderNo]
+      }
+    },
+    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,
+          order_status,
+          shipping_carrier: shippingProvider,
+          create_time,
+          update_time,
+          cancel_by: cancelBy,
+          cancel_reason: reason,
+          total_amount: totalAmount,
+          tracking_no,
+          recipient_address,
+          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)
+        var orderCreatedAt = new Date(create_time * 1000)
+        var recipientAddress = JSON.stringify(recipient_address)
+        var itemCount = items.length
+        var trackingNo = tracking_no === '' ? null : tracking_no
+        let docRefNo = orderNo
+
+        let orderItems = order.items.map(item => {
+          var {
+            item_id: name,
+            variation_id,
+            variation_quantity_purchased: qty,
+            variation_discounted_price: variationDiscountedPrice,
+            promotion_type: promotionType,
+            promotion_id: promotionId,
+            is_wholesale: isWholesale,
+            variation_original_price: variationOriginalPrice
+          } = item
+          var variationId = variation_id == 0 ? name : variation_id
+          return {
+            name,
+            variationId,
+            qty,
+            paidPrice: qty * variationDiscountedPrice,
+            orderNo,
+            promotionType,
+            promotionId,
+            isWholesale,
+            docRefNo,
+            originalPrice: qty * variationOriginalPrice,
+            discount: qty * variationOriginalPrice - qty * variationDiscountedPrice
+          }
+        })
+
+        const { full_address, zipcode: postCode, phone, country, city, name: attentionTo, state } = recipient_address
+
+        let shippingFeeFloat = parseFloat(shippingFee)
+        let actualShippingFeeFloat = parseFloat(actualShippingFee)
+        var orderShipping = {
+          address1: full_address,
+          address2: null,
+          address3: null,
+          address4: null,
+          address5: null,
+          phone1: phone,
+          phone2: null,
+          postCode,
+          city,
+          state,
+          country: country === 'MY' ? 'Malaysia' : country,
+          collectionCurrency: null,
+          attentionTo,
+          trackingNo,
+          transporter: shippingProvider,
+          shippingFee: !isNaN(shippingFeeFloat) ? shippingFeeFloat : null,
+          actualShippingFee: !isNaN(order.is_actual_shipping_fee_confirmed ? actualShippingFeeFloat : shippingFeeFloat)
+            ? order.is_actual_shipping_fee_confirmed
+              ? actualShippingFeeFloat
+              : shippingFeeFloat
+            : null
+        }
+
+        let escrowDetails = await StoreAPI.getStoreOrderTransactionDetails(store, { orderNo })
+
+        return {
+          name,
+          orderNo,
+          docRefNo,
+          status,
+          orderCreatedAt,
+          orderUpdatedAt,
+          totalAmount,
+          cancelBy,
+          reason,
+          trackingNo,
+          recipientAddress,
+          shippingProvider,
+          itemCount,
+          orderItems,
+          orderShipping,
+          buyerUsername,
+          payTime,
+          ...escrowDetails
+        }
+      })
+
+      results = results[0]
+
+      return results
+    }
+  }
+}

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

@@ -0,0 +1,39 @@
+/* https://open.shopee.com/documents?module=4&type=1&id=399 */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreOrders() {
+  return {
+    path: '/orders/basics',
+    denormalize(req) {
+      var { pagination, fromCreatedDate, toCreatedDate } = req || {}
+      var { page = 0, limit = 100 } = pagination || {}
+
+      var create_time_from = Math.floor(new Date(fromCreatedDate).getTime() / 1000)
+      var create_time_to = Math.floor(new Date(toCreatedDate).getTime() / 1000)
+
+      return {
+        pagination_entries_per_page: limit,
+        pagination_offset: page * limit,
+        create_time_from,
+        create_time_to
+      }
+    },
+    async normalize(res, { store }) {
+      var { orders, more } = res
+
+      let results: any[] = []
+
+      for (var i = 0; i < orders?.length; i++) {
+        const order = orders[i]
+        const orderNo = order.ordersn
+
+        const result = await StoreAPI.getStoreOrder(store, { orderNo })
+
+        results.push({ ...result })
+      }
+
+      return { results, more }
+    }
+  }
+}

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

@@ -0,0 +1,19 @@
+/* https://open.shopee.com/documents?module=2&type=1&id=373 */
+
+export function getStoreProductCategories() {
+  return {
+    path: '/item/categories/get',
+    denormalize(req) {
+      var { pagination } = req || {}
+      var { page = 0, limit = 100 } = pagination || {}
+
+      return {
+        pagination_entries_per_page: limit,
+        pagination_offset: page * limit
+      }
+    },
+    normalize(res) {
+      return res.categories
+    }
+  }
+}

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

@@ -0,0 +1,18 @@
+/* https://open.shopee.com/documents?module=2&type=1&id=372 */
+
+export function getStoreProductCategoryAttributes() {
+  return {
+    path: '/item/attributes/get',
+    denormalize(req) {
+      var { categoryId, isCrossBorder = true } = req
+
+      return {
+        category_id: categoryId,
+        is_cb: isCrossBorder
+      }
+    },
+    normalize(res) {
+      return res.attributes
+    }
+  }
+}

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

@@ -0,0 +1,84 @@
+export function getStoreProduct() {
+  return {
+    path: '/item/get',
+    denormalize(req) {
+      return {
+        item_id: req
+      }
+    },
+    normalize(res) {
+      const result = {
+        itemId: res.item.item_id,
+        isku: res.item.item_sku,
+        marketplaceStatus: res.item.status,
+        name: res.item.name,
+        description: res.item.description,
+        currency: res.item.currency,
+        costPrice: res.item.original_price,
+        sellPrice: res.item.price,
+        weight: res.item.weight,
+        qty: res.item.stock,
+        bufferQty: res.item.reserved_stock,
+        categoryId: res.item.category_id,
+        packageLength: res.item.package_length,
+        packageWidth: res.item.package_width,
+        packageHeight: res.item.package_height,
+        afterTaxCostPrice: res.item.inflated_original_price,
+        afterTaxSalesPrice: res.item.inflated_price,
+        condition: res.item.condition,
+        daysToShip: res.item.days_to_ship,
+        discountId: res.item.discount_id,
+        isPreOrder: res.item.is_pre_order,
+        hasVariation: res.item.has_variation,
+        attributes: res.item.attributes.map(attribute => {
+          return {
+            attributeId: attribute.attribute_id,
+            name: attribute.attribute_name,
+            attributeType: attribute.attribute_type,
+            originalValue: attribute.attribute_value,
+            isMandatory: attribute.is_mandatory
+          }
+        }),
+        variations:
+          res.item.has_variation == false
+            ? [
+                {
+                  variationId: res.item.item_id,
+                  variationSku: res.item.item_sku,
+                  channelSku: res.item.item_sku,
+                  name: res.item.name,
+                  description: res.item.description,
+                  qty: res.item.stock,
+                  bufferQty: res.item.reserved_stock,
+                  costPrice: res.item.original_price,
+                  sellPrice: res.item.price,
+                  discountId: res.item.discount_id,
+                  marketplaceStatus: res.item.status,
+                  afterTaxCostPrice: res.item.inflated_original_price,
+                  afterTaxSalesPrice: res.item.inflated_price,
+                  primaryUnitValue: res.item.weight
+                }
+              ]
+            : res.item.variations.map(variation => {
+                return {
+                  variationId: variation.variation_id,
+                  variationSku: variation.variation_sku,
+                  channelSku: variation.variation_sku,
+                  name: variation.name,
+                  description: variation.description,
+                  qty: variation.stock,
+                  bufferQty: variation.reserved_stock,
+                  costPrice: variation.original_price,
+                  sellPrice: variation.price,
+                  discountId: variation.discount_id,
+                  marketplaceStatus: variation.status,
+                  afterTaxCostPrice: variation.inflated_original_price,
+                  afterTaxSalesPrice: variation.inflated_price,
+                  primaryUnitValue: res.item.weight
+                }
+              })
+      }
+      return result
+    }
+  }
+}

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

@@ -0,0 +1,30 @@
+/* https://open.shopee.com/documents?module=2&type=1&id=375 */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreProducts() {
+  return {
+    path: '/items/get',
+    denormalize(req) {
+      var { pagination } = req || {}
+      var { page = 0, limit = 100 } = pagination || {}
+
+      return {
+        pagination_entries_per_page: limit,
+        pagination_offset: page * limit
+      }
+    },
+    async normalize(res, { store }) {
+      let results: any[] = []
+
+      for (var i = 0; i < res.items.length; i++) {
+        const product: any = res.items[i]
+
+        const productDetails = await StoreAPI.getStoreProduct(store, product.item_id)
+        results.push({ ...productDetails })
+      }
+
+      return { results, total: res.total }
+    }
+  }
+}

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
+    }
+  }
+}