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

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

@@ -0,0 +1,209 @@
+import { getRepository } from '@things-factory/shell'
+
+import { MarketplaceStore } from '../../entities'
+import { api } from './decorators'
+
+export class StoreAPI {
+  static platforms = {}
+
+  static registerPlatform(name, action, apis) {
+    StoreAPI.platforms[name] = {
+      action,
+      apis
+    }
+  }
+
+  static getPlatform(name) {
+    return StoreAPI.platforms[name]
+  }
+
+  static async getMarketplaceStore(id) {
+    const repository = getRepository(MarketplaceStore)
+    return await repository.findOne({
+      where: { id },
+      relations: ['domain', 'marketplaceDistributors']
+    })
+  }
+
+  static async getMarketplaceStores(domain, options?) {
+    const repository = getRepository(MarketplaceStore)
+    return await repository.find({
+      where: { domain: { id: domain.id }, status: 'ACTIVE', ...options },
+      relations: ['domain']
+    })
+  }
+
+  @api
+  static echo(store, req): any {}
+
+  @api
+  static getAirwayBill(store, req): any {}
+
+  @api
+  static getStoreProductCategories(store, req?): any {}
+
+  @api
+  static getStoreProductCategoryAttributes(store, req): any {}
+
+  @api
+  static getStoreProduct(store, req): any {}
+
+  @api
+  static getStoreProducts(store, req): any {}
+
+  @api
+  static getStoreProductsCount(store, req): any {}
+
+  @api
+  static getStoreProductBrands(store, req): any {}
+
+  @api
+  static getStoreProductVariations(store, req): any {}
+
+  @api
+  static getStoreOrders(store, req): any {}
+
+  @api
+  static getStoreOrder(store, req): any {}
+
+  @api
+  static getStoreOrderPackages(store, req): any {}
+
+  @api
+  static getStoreOrderPackage(store, req): any {}
+
+  @api
+  static getStoreOrderItems(store, req): any {}
+
+  @api
+  static getStoreOrderDocument(store, req): any {}
+
+  @api
+  static createStoreProduct(store, req): any {}
+
+  @api
+  static createStoreProductVariations(store, req): any {}
+
+  @api
+  static updateStoreProduct(store, req): any {}
+
+  @api
+  static updateOrderStatus(store, req): any {}
+
+  @api
+  static cancelStoreOrder(store, req): any {}
+
+  @api
+  static acceptStoreOrderCancellation(store, req): any {}
+
+  @api
+  static rejectStoreOrderCancellation(store, req): any {}
+
+  @api
+  static setStoreOrderStatusReadyToShip(store, req): any {}
+
+  @api
+  static setStoreOrderStatusDelivered(store, req): any {}
+
+  @api
+  static setStoreOrderStatusFailedDelivery(store, req): any {}
+
+  @api
+  static setStoreOrderStatusPackedByMarketplace(store, req): any {}
+
+  @api
+  static setOrderInvoiceNo(store, req): any {}
+
+  @api
+  static deleteStoreProduct(store, req): any {}
+
+  @api
+  static getStoreLogistics(store, req): any {}
+
+  @api
+  static getLogisticsParam(store, req): any {}
+
+  @api
+  static getAddress(store): any {}
+
+  @api
+  static getBranchList(store, req): any {}
+
+  @api
+  static getTimeSlot(store, req): any {}
+
+  @api
+  static initLogistics(store, req): any {}
+
+  @api
+  static updateStoreProductStock(store, req): any {}
+
+  @api
+  static updateStoreProductVariationStock(store, req): any {}
+
+  @api
+  static getInventoryLevel(store, req): any {}
+
+  @api
+  static createOrderNote(store, req): any {}
+
+  @api
+  static createOrderComment(store, req): any {}
+
+  @api
+  static createOrderRefund(store, req): any {}
+
+  @api
+  static createOrderShip(store, req): any {}
+
+  @api
+  static getStoreStockItem(store, req): any {}
+
+  @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 {}
+
+  @api
+  static getCustomerInfo(store, req): any {}
+
+  @api
+  static getStoreOrderPayoutDates(store, req): any {}
+
+  @api
+  static getStoreProductVariationStock(store, req): any {}
+
+  @api
+  static getStoreOrderByBatch(store, req): any {}
+
+  @api
+  static getTrackingNumber(store, req): any {}
+
+  @api
+  static createShippingDocument(store, req): any {}
+
+  @api
+  static getShippingDocumentResult(store, req): any {}
+}

package/server/controllers/tiktok/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/tiktok/apis/get-store-order-document.ts

@@ -0,0 +1,26 @@
+/* https://bytedance.feishu.cn/docs/doccnDyz5Bbk26iOdejbBRBlLrb#ytBXoS */
+
+export function getStoreOrderDocument() {
+  return {
+    method: 'get',
+    path: '/api/fulfillment/shipping_document',
+    denormalize(req) {
+      var { packageId, documentType } = req || {}
+
+      return { payload: { package_id: packageId, document_type: documentType } }
+    },
+    async normalize(res) {
+      const { data } = res
+
+      let result: any[] = [
+        {
+          file: data.doc_url,
+          fileTypeValue: 'AWB',
+          mimeType: 'application/pdf'
+        }
+      ]
+
+      return result
+    }
+  }
+}

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

@@ -0,0 +1,46 @@
+/* https://bytedance.feishu.cn/docs/doccnDyz5Bbk26iOdejbBRBlLrb#ytBXoS */
+
+export function getStoreOrderPackage() {
+  return {
+    method: 'get',
+    path: '/api/fulfillment/detail',
+    denormalize(req) {
+      var { packageId } = req || {}
+
+      return { payload: { package_id: packageId } }
+    },
+    async normalize(res) {
+      const { data } = res
+
+      let result: any = {
+        packageId: data.package_id,
+        orderInfoList: data.order_info_list.map(itm => {
+          return {
+            orderId: itm.order_id,
+            skuList: itm.sku_list.map(sku => {
+              return {
+                skuId: sku.sku_id,
+                skuName: sku.sku_name,
+                skuImage: sku.sku_image,
+                quantity: sku.quantity
+              }
+            })
+          }
+        }),
+        packageStatus: data.package_status,
+        deliveryOption: data.delivery_option,
+        shippingProvider: data.shipping_provider,
+        shippingProviderId: data.shipping_provider_id,
+        trackingNumber: data.tracking_number,
+        orderListIdList: data.order_line_id_list,
+        pickUpType: data.pick_up_type,
+        pickUpStartTime: data.pick_up_start_time,
+        pickupEndTime: data.pick_up_end_time,
+        createTime: data.create_time,
+        updateTime: data.update_time
+      }
+
+      return result
+    }
+  }
+}

package/server/controllers/tiktok/apis/get-store-order-packages.ts

@@ -0,0 +1,43 @@
+/* https://bytedance.feishu.cn/wiki/wikcntMLczW460imZUfYqaa1Dng#jIY8hJ */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreOrderPackages() {
+  return {
+    method: 'post',
+    path: '/api/fulfillment/search',
+    denormalize(req) {
+      var { pagination, fromDate, toDate, nextCursor } = req || {}
+      var { page, limit } = pagination || { page: 0, limit: 100 }
+
+      var create_time_from = Math.floor(new Date(fromDate).getTime() / 1000)
+      var create_time_to = Math.floor(new Date(toDate).getTime() / 1000)
+
+      var payload = {
+        page_size: limit,
+        cursor: nextCursor,
+        create_time_from,
+        create_time_to
+      }
+
+      return { payload }
+    },
+    async normalize(res, { store }) {
+      const { data } = res
+
+      var more: boolean = data?.more || false
+      var nextCursor: string = more ? data.next_cursor : null
+      const packageList: any[] = data?.package_list || []
+
+      let results: any[] = []
+      for (let i = 0; i < packageList.length; i++) {
+        const packageObj: any = packageList[i]
+        const packageDetail: any = await StoreAPI.getStoreOrderPackage(store, { packageId: packageObj.package_id })
+
+        results.push({ ...packageDetail })
+      }
+
+      return { results, more, nextCursor }
+    }
+  }
+}

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

@@ -0,0 +1,176 @@
+/* https://bytedance.feishu.cn/docs/doccnDyz5Bbk26iOdejbBRBlLrb#ytBXoS */
+
+import { StoreAPI } from '../../store-api'
+
+// Delivery Option: STANDARD, EXPRESS, ECONOMY, SEND_BY_SELLER
+
+const documentStatuses = [112]
+
+export function getStoreOrder() {
+  return {
+    method: 'post',
+    path: '/api/orders/detail/query',
+    denormalize(req) {
+      var { orderId } = req || {}
+
+      let orderIds = Array.isArray(orderId) ? orderId : [orderId]
+
+      return { payload: { order_id_list: orderIds } }
+    },
+    async normalize(res, { store }) {
+      const { data } = res
+      const orderList = data.order_list
+      let results: any[] = []
+
+      for (let i = 0; i < orderList.length; i++) {
+        const order: any = orderList[i]
+        const {
+          order_id: name,
+          order_id: orderNo,
+          payment_method: paymentMethod,
+          payment_info: paymentInfo,
+          order_status: status,
+          ext_status: extStatus,
+          create_time,
+          update_time,
+          rts_sla,
+          recipient_address: recipientAddress,
+          item_list: itemList,
+          order_line_list: orderLineList,
+          package_list: packageList,
+          delivery_option: deliveryOption
+        } = order
+
+        let orderStatus: string = `ttk_${status}`
+        switch (extStatus) {
+          case 201:
+          case 203:
+            orderStatus = `ttk_${extStatus}`
+            break
+          default:
+            orderStatus = `ttk_${status}`
+        }
+
+        var orderUpdatedAt = new Date(update_time * 1000)
+        var orderCreatedAt = new Date(Number(create_time))
+        var slaExpiresAt = Boolean(rts_sla) ? new Date(rts_sla * 1000) : null
+        let docRefNo = orderNo
+        let isSOF: boolean = false
+        if (deliveryOption == 'SEND_BY_SELLER') isSOF = true
+
+        let orderItems = itemList.map(item => {
+          var { sku_id, quantity: qty, sku_original_price, sku_sale_price } = item
+
+          return {
+            name: sku_id,
+            variationId: sku_id,
+            qty,
+            paidPrice: sku_sale_price,
+            orderNo,
+            docRefNo,
+            total: sku_original_price,
+            totalTax: 0,
+            subtotal: sku_sale_price,
+            subtotalTax: 0,
+            slaExpiresAt
+          }
+        })
+
+        const { full_address, phone, zipcode, city, region: country, name: firstName } = recipientAddress
+
+        let billing = {
+          address_1: full_address,
+          address_2: null,
+          address_3: null,
+          address_4: null,
+          address_5: null,
+          phone,
+          phone_2: null,
+          postcode: zipcode,
+          city,
+          country,
+          first_name: firstName,
+          last_name: null
+        }
+
+        let shipping = {
+          address_1: full_address,
+          address_2: null,
+          address_3: null,
+          address_4: null,
+          address_5: null,
+          phone,
+          phone_2: null,
+          postcode: zipcode,
+          city,
+          country,
+          first_name: firstName,
+          last_name: null
+        }
+
+        let orderShipping = {
+          address1: shipping.address_1,
+          address2: null,
+          address3: null,
+          address4: null,
+          address5: null,
+          phone1: shipping.phone,
+          phone2: null,
+          postCode: shipping.postcode,
+          city: shipping.city,
+          country: shipping.country,
+          collectionCurrency: paymentInfo.currency,
+          attentionTo: shipping.first_name
+        }
+
+        let result: any = {
+          name,
+          orderNo,
+          status: orderStatus,
+          orderCreatedAt,
+          orderUpdatedAt,
+          totalAmount: paymentInfo.total_amount,
+          itemCount: itemList.length,
+          orderItems,
+          orderShipping,
+          billing,
+          shipping,
+          firstName,
+          lastName: null,
+          isSOF,
+          orderLineList
+        }
+
+        let orderPackage: any = {}
+        try {
+          if (packageList && packageList[0]?.package_id) {
+            let orderPackageDetail: any = await StoreAPI.getStoreOrderPackage(store, {
+              packageId: packageList[0].package_id
+            })
+
+            orderPackage = {
+              ...orderPackageDetail,
+              packageId: packageList[0].package_id,
+              orderId: name
+            }
+
+            if (documentStatuses.indexOf(status) >= 0) {
+              let orderDocument: any = await StoreAPI.getStoreOrderDocument(store, {
+                packageId: packageList[0].package_id,
+                documentType: 1
+              })
+
+              orderPackage.orderDocument = orderDocument || []
+            }
+
+            result.orderPackage = orderPackage
+          }
+        } catch (e) {}
+
+        results.push(result)
+      }
+
+      return results
+    }
+  }
+}

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

@@ -0,0 +1,55 @@
+/* https://bytedance.feishu.cn/wiki/wikcntMLczW460imZUfYqaa1Dng#jIY8hJ */
+
+import { StoreAPI } from '../../store-api'
+
+export function getStoreOrders() {
+  return {
+    method: 'post',
+    path: '/api/orders/search',
+    denormalize(req) {
+      var { pagination, fromCreatedDate, toCreatedDate, fromUpdatedDate, toUpdatedDate, nextCursor } = req || {}
+      var { page, limit } = pagination || { page: 0, limit: 20 }
+
+      let payload: any = { page_size: limit }
+
+      if (fromCreatedDate && toCreatedDate) {
+        const create_time_from = Math.floor(new Date(fromCreatedDate).getTime() / 1000)
+        const create_time_to = Math.floor(new Date(toCreatedDate).getTime() / 1000)
+
+        payload.create_time_from = create_time_from
+        payload.create_time_to = create_time_to
+      }
+
+      if (fromUpdatedDate && toUpdatedDate) {
+        const update_time_from = Math.floor(new Date(fromUpdatedDate).getTime() / 1000)
+        const update_time_to = Math.floor(new Date(toUpdatedDate).getTime() / 1000)
+
+        payload.update_time_from = update_time_from
+        payload.update_time_to = update_time_to
+      }
+
+      if (nextCursor) payload.cursor = nextCursor
+
+      return { payload }
+    },
+    async normalize(res, { store }) {
+      const { data } = res
+
+      var more: boolean = data?.more || false
+      var nextCursor: string = more ? data.next_cursor : null
+      let orderList: any[] = data?.order_list || []
+
+      let results: any[] = []
+      while (orderList.length > 0) {
+        let orderIds = orderList.splice(0, orderList.length >= 20 ? 20 : orderList.length)
+        const orderIdList: any = orderIds.map(orderId => orderId.order_id)
+        const orderDetails: any[] = await StoreAPI.getStoreOrder(store, { orderId: orderIdList })
+        orderDetails.map(orderDetail => {
+          results.push({ ...orderDetail })
+        })
+      }
+
+      return { results, more, nextCursor }
+    }
+  }
+}

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

@@ -0,0 +1,29 @@
+/* https://bytedance.feishu.cn/docs/doccnDyz5Bbk26iOdejbBRBlLrb#WBz4V0 */
+
+export function getStoreProductAttributes() {
+  return {
+    method: 'get',
+    path: '/api/products/attributes',
+    denormalize(req) {
+      const { categoryId } = req
+      return { payload: { category_id: categoryId } }
+    },
+    normalize(res) {
+      const { data } = res
+
+      let results: any = []
+      data.attributes.map(item => {
+        let result: any = {
+          id: item.id,
+          name: item.local_display_name,
+          attributeType: item.attribute_type,
+          parent: !item.is_leaf ? 0 : item.parent_id
+        }
+
+        results.push(result)
+      })
+
+      return results
+    }
+  }
+}

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

@@ -0,0 +1,27 @@
+/* https://bytedance.feishu.cn/docs/doccnDyz5Bbk26iOdejbBRBlLrb#jIY8hJ */
+
+export function getStoreProductCategories() {
+  return {
+    method: 'get',
+    path: '/api/products/categories',
+    denormalize(req) {
+      return { payload: {} }
+    },
+    normalize(res) {
+      const { data } = res
+
+      let results: any = []
+      data.category_list.map(item => {
+        let result: any = {
+          id: item.id,
+          name: item.local_display_name,
+          parent: item.is_leaf ? item.parent_id : 0
+        }
+
+        results.push(result)
+      })
+
+      return { results, total: 1 }
+    }
+  }
+}