@etsoo/smarterp-crm 1.0.11 → 1.0.13

package/src/rq/financeTransaction/FinanceTransactionCurrencyExchangeRQ.ts

@@ -0,0 +1,59 @@
+/**
+ * Finance transaction currency exchange request data
+ * 财务交易货币兑换请求数据
+ */
+export type FinanceTransactionCurrencyExchangeRQ = {
+  /**
+   * Source account id
+   * 转出账户编号
+   */
+  sourceAccountId: number;
+
+  /**
+   * Destination account id
+   * 转入账户编号
+   */
+  destinationAccountId: number;
+
+  /**
+   * Amount
+   * 金额
+   */
+  amount: number;
+
+  /**
+   * Exchange currency
+   * 兑换货币
+   */
+  currency: string;
+
+  /**
+   * Exchange rate
+   * 汇率
+   */
+  exchangeRate: number;
+
+  /**
+   * Exchange amount
+   * 兑换金额
+   */
+  exchangeAmount: number;
+
+  /**
+   * Exchange fee, charged by source currency
+   * 兑换手续费，按源币种收取
+   */
+  exchangeFee: number;
+
+  /**
+   * Description
+   * 描述
+   */
+  description?: string;
+
+  /**
+   * Reference id
+   * 参考编号
+   */
+  referenceId?: string;
+};

package/src/rq/financeTransaction/FinanceTransactionListRQ.ts

@@ -0,0 +1,56 @@
+import { QueryRQ } from "@etsoo/appscript";
+import { FinanceTransactionKind } from "../../dto/financeTransaction/FinanceTransactionKind";
+
+/**
+ * Finance transaction list request data
+ * 财务交易列表请求数据
+ */
+export type FinanceTransactionListRQ = QueryRQ & {
+  /**
+   * Person (owner) id
+   * 人员（所有者）编号
+   */
+  personId?: number;
+
+  /**
+   * Currency
+   * 币种
+   */
+  currency?: string;
+
+  /**
+   * Account id
+   * 账号
+   */
+  accountId?: number;
+
+  /**
+   * Kind
+   * 类型
+   */
+  kind?: FinanceTransactionKind;
+
+  /**
+   * Kinds
+   * 类型列表
+   */
+  kinds?: FinanceTransactionKind[];
+
+  /**
+   * Order id
+   * 订单编号
+   */
+  orderId?: number;
+
+  /**
+   * Inner Reference id
+   * 内部引用编号
+   */
+  innerRef?: string;
+
+  /**
+   * Author id
+   * 作者编号
+   */
+  authorId?: number;
+};

package/src/rq/financeTransaction/FinanceTransactionOffsetRQ.ts

@@ -0,0 +1,23 @@
+/**
+ * Finance transaction offset request data
+ * 财务交易冲销请求数据
+ */
+export type FinanceTransactionOffsetRQ = {
+  /**
+   * Id
+   * 编号
+   */
+  id: number;
+
+  /**
+   * Description
+   * 描述
+   */
+  description: string;
+
+  /**
+   * All
+   * 全部
+   */
+  all?: boolean;
+};

package/src/rq/financeTransaction/FinanceTransactionPayOrderRQ.ts

@@ -0,0 +1,37 @@
+import { FinanceTransactionPayItem } from "../../dto/financeTransaction/FinanceTransactionPayItem";
+
+/**
+ * Pay order request data
+ * 订单付款请求数据
+ */
+export type FinanceTransactionPayOrderRQ = {
+  /**
+   * Order id
+   * 订单编号
+   */
+  orderId: number;
+
+  /**
+   * Amount
+   * 金额
+   */
+  amount: number;
+
+  /**
+   * Pay items
+   * 付款项目
+   */
+  items: FinanceTransactionPayItem[];
+
+  /**
+   * Description
+   * 描述
+   */
+  description?: string;
+
+  /**
+   * Happen date
+   * 发生日期
+   */
+  happenDate?: string | Date;
+};

package/src/rq/financeTransaction/FinanceTransactionPayPORQ.ts

@@ -0,0 +1,37 @@
+import { FinanceTransactionPayItem } from "../../dto/financeTransaction/FinanceTransactionPayItem";
+
+/**
+ * Pay PO request data
+ * 采购订单付款请求数据
+ */
+export type FinanceTransactionPayPORQ = {
+  /**
+   * PO id
+   * 采购订单编号
+   */
+  orderId: number;
+
+  /**
+   * Amount
+   * 金额
+   */
+  amount: number;
+
+  /**
+   * Pay items
+   * 付款项目
+   */
+  items: FinanceTransactionPayItem[];
+
+  /**
+   * Description
+   * 描述
+   */
+  description?: string;
+
+  /**
+   * Happen date
+   * 发生日期
+   */
+  happenDate?: string | Date;
+};

package/src/rq/financeTransaction/FinanceTransactionQueryRQ.ts

@@ -0,0 +1,43 @@
+import { FinanceTransactionListRQ } from "./FinanceTransactionListRQ";
+
+/**
+ * Finance transaction query request data
+ * 财务交易查询请求数据
+ */
+export type FinanceTransactionQueryRQ = FinanceTransactionListRQ & {
+  /**
+   * Creation start
+   * 登记时间开始
+   */
+  creationStart?: Date | string;
+
+  /**
+   * Creation end
+   * 登记时间结束
+   */
+  creationEnd?: Date | string;
+
+  /**
+   * Happen date start
+   * 发生日期开始
+   */
+  happenDateStart?: Date | string;
+
+  /**
+   * Happen date end
+   * 发生日期结束
+   */
+  happenDateEnd?: Date | string;
+
+  /**
+   * Amount start
+   * 金额开始
+   */
+  amountStart?: number;
+
+  /**
+   * Amount end
+   * 金额结束
+   */
+  amountEnd?: number;
+};

package/src/rq/financeTransaction/FinanceTransactionReimburseRQ.ts

@@ -0,0 +1,55 @@
+import { FinanceTransactionPayItem } from "../../dto/financeTransaction/FinanceTransactionPayItem";
+
+/**
+ * Finance transaction reimburse request data
+ * 财务交易报销请求数据
+ */
+export type FinanceTransactionReimburseRQ = {
+  /**
+   * Currency
+   * 币种
+   */
+  currency: string;
+
+  /**
+   * Reimbursement person id
+   * 报销人人员编号
+   */
+  targetPersonId: number;
+
+  /**
+   * Reimbursement person account id
+   * 报销人账户
+   */
+  targetAccountId?: number;
+
+  /**
+   * Amount
+   * 金额
+   */
+  amount: number;
+
+  /**
+   * Pay items
+   * 付款项目
+   */
+  items: FinanceTransactionPayItem[];
+
+  /**
+   * Reference id
+   * 参考编号
+   */
+  referenceId?: string;
+
+  /**
+   * Description
+   * 描述
+   */
+  description: string;
+
+  /**
+   * Order / PO id
+   * 订单或采购订单编号
+   */
+  orderId?: number;
+};

package/src/rq/financeTransaction/FinanceTransactionTransferRQ.ts

@@ -0,0 +1,35 @@
+/**
+ * Finance transaction transfer request data
+ * 财务交易转账请求数据
+ */
+export type FinanceTransactionTransferRQ = {
+  /**
+   * Source account id
+   * 转出账户编号
+   */
+  sourceAccountId: number;
+
+  /**
+   * Destination account id
+   * 转入账户编号
+   */
+  destinationAccountId: number;
+
+  /**
+   * Amount
+   * 金额
+   */
+  amount: number;
+
+  /**
+   * Description
+   * 描述
+   */
+  description: string;
+
+  /**
+   * Reference id
+   * 参考编号
+   */
+  referenceId?: string;
+};

package/src/utils/Finance.ts

@@ -0,0 +1,54 @@
+import { ICrmApp } from "../CrmApp";
+import { FinanceAccountKind } from "../dto/financeAccount/FinanceAccountKind";
+import { FinanceTransactionKind } from "../dto/financeTransaction/FinanceTransactionKind";
+
+/**
+ * Finance
+ * 财务
+ */
+export class Finance {
+  constructor(private crm: ICrmApp) {}
+
+  /**
+   * Get account kind label
+   * 获取账户类型标签
+   * @param kind Kind
+   * @returns Result
+   */
+  getAccountKind(kind?: FinanceAccountKind) {
+    if (kind == null) return undefined;
+    const key = FinanceAccountKind[kind];
+    return this.crm.app.get("financeAccountKind" + key) ?? key;
+  }
+
+  /**
+   * Get account kinds
+   * 获取账户类型
+   */
+  getAccountKinds() {
+    return this.crm.app.getEnumList(FinanceAccountKind, "financeAccountKind");
+  }
+
+  /**
+   * Get transaction kind label
+   * 获取交易类型标签
+   * @param kind Kind
+   * @returns Result
+   */
+  getTransactionKind(kind?: FinanceTransactionKind) {
+    if (kind == null) return undefined;
+    const key = FinanceTransactionKind[kind];
+    return this.crm.app.get("financeTransactionKind" + key) ?? key;
+  }
+
+  /**
+   * Get transaction kinds
+   * 获取交易类型
+   */
+  getTransactionKinds() {
+    return this.crm.app.getEnumList(
+      FinanceTransactionKind,
+      "financeTransactionKind"
+    );
+  }
+}

package/src/utils/Order.ts

@@ -143,6 +143,56 @@ export class Order {
     return this.crm.app.getEnumList(OrderKind, "orderKind");
   }
 
+  /**
+   * Get modifiers
+   * 获取定制选项
+   * @param data Modifiers data
+   */
+  getModifiers(data?: Record<string, unknown>) {
+    if (
+      data == null ||
+      data.modifiers == null ||
+      typeof data.modifiers !== "object"
+    )
+      return;
+
+    const modifiers = data.modifiers as Record<string, unknown>;
+
+    return Object.values(modifiers)
+      .reduce<string[]>((acc, val) => {
+        if (typeof val === "string" && !!val) acc.push(val);
+        return acc;
+      }, [])
+      .join(", ");
+  }
+
+  /**
+   * Get modifier SN
+   * 获取定制选项中的唯一编号
+   * @param data Modifiers data
+   */
+  getModifierSn(data?: Record<string, unknown>) {
+    if (
+      data == null ||
+      data.modifiers == null ||
+      typeof data.modifiers !== "object"
+    )
+      return;
+
+    const m = data.modifiers as Record<string, unknown>;
+
+    const snItem = [m.sn, m.Sn, m.SN, m.domain, m.Domain].find(
+      (d) => typeof d === "string" && !!d
+    ) as string | undefined;
+
+    if (snItem) {
+      const url = URL.parse(snItem);
+      if (url != null) return url.hostname;
+    }
+
+    return snItem;
+  }
+
   /**
    * Get order payment kind label
    * 获取订单付款方式标签

package/src/utils/System.ts

@@ -25,6 +25,34 @@ export class System {
     );
   }
 
+  /**
+   * Get asset expiration notice
+   * 获取资产过期通知
+   */
+  getAssetExpirationNotice() {
+    const notice = this.crm.app.userData?.system?.assetExpirationNotice;
+
+    const expiryCheck = notice != null && notice > 0;
+    const noticeOwner = notice != null && notice > 1;
+
+    return { expiryCheck, noticeOwner };
+  }
+
+  /**
+   * Get asset expiration notices
+   * 获取资产过期通知
+   */
+  getAssetExpirationNotices(): ListType[] {
+    const { noticeOwner, noticeInternalOnly } = this.crm.app.getLabels(
+      "noticeOwner",
+      "noticeInternalOnly"
+    );
+    return [
+      { id: 1, label: noticeInternalOnly },
+      { id: 2, label: noticeOwner }
+    ];
+  }
+
   /**
    * Get customer type label
    * 获取客户类型标签