@yolo-croket-dev/entity-v2 0.3.31-hj-1 → 0.3.31

package/bundle-purchased-info/bundle-purchased-info.entity.d.ts

@@ -15,6 +15,8 @@ export interface PInfoOfBundle {
     process: string;
     process_v2?: string;
     pInfoType?: PInfoTypeEnum;
+    /** 추가금 결제 Child가 연결된 Parent PInfo ID. 셀러 거래내역 관계 그룹화에 사용한다. */
+    additionalPaymentOriginalPInfoId?: Types.ObjectId;
     /** 상품 유형 (BundlePInfo Atlas Search 필터 및 주문 배지 노출용) */
     itemType?: StoreItemTypeEnum;
     /** 분할 배송 여부 (PurchasedInfo.isSplitDelivery의 비정규화 필드, BundlePInfo Atlas Search 필터용) */
@@ -60,6 +62,8 @@ export default interface BundlePurchasedInfoEntity {
     isAbroadShipping: boolean;
     /** 묶음이 2개이상이면 true */
     isBundle: boolean;
+    /** 대표 parentPInfoId가 추가금 결제 Child인지 여부. 셀러 거래내역 기본 조회의 제외 조건이다. */
+    isAdditionalPayment?: boolean;
     PInfoList: PInfoOfBundle[];
     buyerId: Types.ObjectId;
     pastBuyerName: string;

package/index.d.ts

@@ -78,4 +78,3 @@ export * from './seller-image-asset';
 export * from './crawler-proxy-order-slack-event';
 export * from './crawler-proxy-order-payment-request-slack-event';
 export * from './chat.modules/message-template.entity';
-export * from './customs';

package/index.js

@@ -92,4 +92,3 @@ __exportStar(require("./seller-image-asset"), exports);
 __exportStar(require("./crawler-proxy-order-slack-event"), exports);
 __exportStar(require("./crawler-proxy-order-payment-request-slack-event"), exports);
 __exportStar(require("./chat.modules/message-template.entity"), exports);
-__exportStar(require("./customs"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolo-croket-dev/entity-v2",
-  "version": "0.3.31-hj-1",
+  "version": "0.3.31",
   "main": "index.js",
   "author": "Yolo Co., Ltd.",
   "description": "크로켓 nest 용 entity-v3",
@@ -23,4 +23,4 @@
   },
   "license": "UNLICENSED",
   "dependencies": {}
-}
+}

package/purchase-receipt/purchase-receipt.entity.d.ts

@@ -46,6 +46,10 @@ export default interface PurchaseReceiptEntity {
     paymentDate: Date;
     /** @description 정산 정보 */
     receiveInfo: PurchaseReceiptReceiveInfo;
+    /** @description 추가금 결제 Child 주문서 여부. 구매자 일반 배송내역 제외에 사용한다. */
+    isAdditionalPayment?: boolean;
+    /** @description 추가금 결제 Child가 연결된 Parent PInfo ID */
+    additionalPaymentOriginalPInfoId?: Types.ObjectId | string;
     /** @description 개인통관고유부호 나중에 입력 여부 */
     isPcccDeferred?: boolean;
 }

package/purchased-info/purchased-info-for-seller.entity.d.ts

@@ -12,7 +12,9 @@ export default interface PurchasedInfoForSeller {
 }
 export type RefundInfoPickedForSeller = Pick<RefundEntity, '_id' | 'reg_date' | 'acceptInfo' | 'process' | '_authorType' | 'openInfo' | 'refundVersion' | 'returnInfo' | 'rejectInfo' | 'PInfoLastProcess'>;
 export type UserInfoPickedForSeller = Pick<UserEntity, '_id' | 'username' | 'phoneCountry' | 'phoneNumber' | 'photos' | 'subContactList'>;
-export type PInfoPickedForSeller = Pick<PurchasedInfoEntity, '_id' | 'publicId' | 'process' | 'pOptionInfo' | 'proceedsInfo' | 'itemId' | 'pastName' | 'pastImg' | 'pastPrice' | 'deliveryMethod' | 'deliveryData' | 'paymentDate' | 'pastSellingInfo' | 'PCCCInfo' | 'cancelInfo' | 'requirement' | 'originPrice' | 'buyerInfo' | 'lastPartialRefundProcess' | 'lastPartialRefundId' | 'waitingReceiveInfo' | 'cancelledDate' | 'process_v2' | 'isPOptionChanged' | 'pInfoType' | 'isSplitDelivery' | 'splitDeliveryDataList' | 'remainingShipQuantity' | 'refundWaitingInfo'> & {
+export type PInfoPickedForSeller = Pick<PurchasedInfoEntity, '_id' | 'publicId' | 'process' | 'pOptionInfo' | 'proceedsInfo' | 'itemId' | 'pastName' | 'pastImg' | 'pastPrice' | 'deliveryMethod' | 'deliveryData' | 'paymentDate' | 'pastSellingInfo' | 'PCCCInfo' | 'cancelInfo' | 'requirement' | 'originPrice' | 'buyerInfo' | 'lastPartialRefundProcess' | 'lastPartialRefundId' | 'waitingReceiveInfo' | 'cancelledDate' | 'process_v2' | 'isPOptionChanged' | 'pInfoType' | 'isSplitDelivery' | 'splitDeliveryDataList' | 'remainingShipQuantity' | 'refundWaitingInfo' | 
+/** Parent/Child를 목록 UI에서 물리적 Bundle 병합 없이 묶기 위한 관계 정보 */
+'additionalPaymentRequestInfo' | 'additionalPaymentInfo'> & {
     /** 주문 당시 상품 키워드 스냅샷 */
     itemKeywords?: StoreItemKeyword[];
     isPcccDeferred?: boolean;
@@ -24,6 +26,8 @@ export type PInfoPickedForSeller = Pick<PurchasedInfoEntity, '_id' | 'publicId'
      * - Pick 대상에서 transferSellerInfo를 제외해야 Omit한 history가 교차 타입으로 다시 필수가 되지 않는다.
      */
     transferSellerInfo?: Omit<NonNullable<PurchasedInfoEntity['transferSellerInfo']>, 'history'>;
+    /** Original 거래 내부에서만 노출하는 Additional 결제건이다. */
+    additionalPaymentPurchasedInfo?: Omit<PInfoPickedForSeller, 'additionalPaymentPurchasedInfo'>;
 };
 export type PurchasedInfoForSellerDetail = {
     pInfo: PInfoPickedForSeller;

package/purchased-info/purchased-info.entity.d.ts

@@ -36,7 +36,9 @@ export declare enum ReservationCancelReasonEnum {
 export declare enum PInfoTypeEnum {
     normal = "normal",
     card = "card",
-    reservation = "reservation"
+    reservation = "reservation",
+    /** 관리자가 생성한 비공개 상품으로 결제한 주문 연계 추가금 결제건 */
+    additionalPayment = "additionalPayment"
 }
 export declare enum POptionTypeEnum {
     single = "single",
@@ -87,6 +89,8 @@ export declare enum RefundWaitingStatusEnum {
     PENDING = "PENDING",
     /** 구매자가 타 셀러 이관을 기다리기로 선택한 상태 */
     WAITING_FOR_ITEM = "WAITING_FOR_ITEM",
+    /** 관리자가 생성한 추가금 결제 상품의 실제 결제 완료를 기다리는 상태 */
+    WAITING_FOR_ADDITIONAL_PAYMENT = "WAITING_FOR_ADDITIONAL_PAYMENT",
     /** 이관 대기 중 구매자 환불 요청이 완료된 상태. 이관/환불 재처리는 허용하지 않는다. */
     WAITING_FOR_ITEM_REFUNDING = "WAITING_FOR_ITEM_REFUNDING",
     /** 관리자 이관 불가 확정 후 실제 환불을 시작하기 전 상태 */
@@ -170,6 +174,57 @@ export interface RefundWaitingInfo {
     /** 마지막 구매자 응답 만기 전 알림 발송 실패 코드 */
     buyerResponseReminderLastErrorCode?: string;
 }
+/**
+ * @author sj
+ * @description Original PInfo에 저장하는 추가금 결제 요청 정보다.
+ * @process 관리자 요청 생성 → Additional 결제건 연결에 사용한다.
+ */
+export interface AdditionalPaymentRequestInfo {
+    storeItemId: Types.ObjectId | string;
+    targetSellerId: Types.ObjectId | string;
+    additionalPaymentAmount: number;
+    additionalPaymentCalculationGuide: string;
+    requestedManagerId: Types.ObjectId | string;
+    requestedDate: Date;
+    /** 현재 유효한 추가금 결제 시도의 PTL. Original 환불 시 이 시도만 무효화한다. */
+    activeAdditionalPaymentPayTryLogId?: Types.ObjectId | string;
+    /** Original 환불로 활성 Additional PTL을 무효화한 시각. */
+    activeAdditionalPaymentInvalidatedDate?: Date;
+    /**
+     * Additional 결제 완료 뒤 Original/Additional 이관을 실행 중인 lease 시각.
+     * 환불 요청 lease와 상호 배제하여 환불과 이관이 동시에 상태를 변경하지 않게 한다.
+     */
+    transferProcessingDate?: Date;
+    additionalPInfoId?: Types.ObjectId | string;
+}
+/**
+ * @author sj
+ * @description Additional PInfo에 저장하는 Original 추가금 결제 관계 정보다.
+ * @process 기존 결제 흐름으로 생성된 Additional을 Original 및 대상 셀러와 연결한다.
+ */
+export interface AdditionalPaymentInfo {
+    originalPInfoId: Types.ObjectId | string;
+    /** Additional 이관 완료 callback의 중복 실행을 막는 임시 lease 시각 */
+    transferProcessingDate?: Date;
+    targetSellerId: Types.ObjectId | string;
+    requestedManagerId: Types.ObjectId | string;
+    requestedDate: Date;
+    /** Additional과 Original 이관이 3회 모두 실패한 경우 Additional을 재처리 대상으로 식별한다. */
+    transferErrorInfo?: {
+        code?: string;
+        message: string;
+        failedDate: Date;
+    };
+    /** Original 환불 후 Additional 취소·환불을 완료하지 못한 경우의 마지막 실패 정보다. */
+    linkedRefundErrorInfo?: {
+        operation: 'VBANK_CANCEL' | 'REFUND_CREATE' | 'PG_REFUND';
+        code?: string;
+        message: string;
+        failedDate: Date;
+    };
+    /** 관리자 연관 환불 재처리의 중복 실행을 막는 5분 lease 시각이다. */
+    linkedRefundProcessingDate?: Date;
+}
 export interface PastSellingInfoShippingTermsInfo {
     /** 조건 배송 종류 <shippingFeeBySection, > */
     shippingTermsType: string;
@@ -1361,6 +1416,10 @@ export default interface PurchasedInfoEntity {
     /** @description 가격비교 제휴 유입 정산 정보 */
     priceCompareAffiliateInfo?: PriceCompareAffiliateInfo;
     pInfoType?: PInfoTypeEnum;
+    /** Original에만 저장하는 추가금 결제 요청 정보 */
+    additionalPaymentRequestInfo?: AdditionalPaymentRequestInfo;
+    /** Additional에만 저장하는 추가금 결제 Original 관계 정보 */
+    additionalPaymentInfo?: AdditionalPaymentInfo;
     reservationInfo?: PurchasedReservationInfo;
     /** @description 셀러 귀책 환불 대기 워크플로 정보 */
     refundWaitingInfo?: RefundWaitingInfo;

package/purchased-info/purchased-info.entity.js

@@ -33,6 +33,8 @@ var PInfoTypeEnum;
     PInfoTypeEnum["normal"] = "normal";
     PInfoTypeEnum["card"] = "card";
     PInfoTypeEnum["reservation"] = "reservation";
+    /** 관리자가 생성한 비공개 상품으로 결제한 주문 연계 추가금 결제건 */
+    PInfoTypeEnum["additionalPayment"] = "additionalPayment";
 })(PInfoTypeEnum || (exports.PInfoTypeEnum = PInfoTypeEnum = {}));
 var POptionTypeEnum;
 (function (POptionTypeEnum) {
@@ -89,6 +91,8 @@ var RefundWaitingStatusEnum;
     RefundWaitingStatusEnum["PENDING"] = "PENDING";
     /** 구매자가 타 셀러 이관을 기다리기로 선택한 상태 */
     RefundWaitingStatusEnum["WAITING_FOR_ITEM"] = "WAITING_FOR_ITEM";
+    /** 관리자가 생성한 추가금 결제 상품의 실제 결제 완료를 기다리는 상태 */
+    RefundWaitingStatusEnum["WAITING_FOR_ADDITIONAL_PAYMENT"] = "WAITING_FOR_ADDITIONAL_PAYMENT";
     /** 이관 대기 중 구매자 환불 요청이 완료된 상태. 이관/환불 재처리는 허용하지 않는다. */
     RefundWaitingStatusEnum["WAITING_FOR_ITEM_REFUNDING"] = "WAITING_FOR_ITEM_REFUNDING";
     /** 관리자 이관 불가 확정 후 실제 환불을 시작하기 전 상태 */

package/store-item/additional-payment-store-item.constant.d.ts

@@ -0,0 +1,6 @@
+/** @author sj */
+/** 서버가 생성하는 추가금 결제 전용 비공개 StoreItem의 고정 식별값이다. */
+export declare const ADDITIONAL_PAYMENT_STORE_ITEM_NAME = "\uCD94\uAC00\uAE08 \uACB0\uC81C";
+export declare const ADDITIONAL_PAYMENT_STORE_ITEM_OPTION_NAME = "\uCD94\uAC00\uAE08";
+export declare const ADDITIONAL_PAYMENT_STORE_ITEM_OPTION_SKU = "SYSTEM_ADDITIONAL_PAYMENT";
+export declare const ADDITIONAL_PAYMENT_STORE_ITEM_NAME_KEY_PREFIX = "system-additional-payment-";

package/store-item/additional-payment-store-item.constant.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADDITIONAL_PAYMENT_STORE_ITEM_NAME_KEY_PREFIX = exports.ADDITIONAL_PAYMENT_STORE_ITEM_OPTION_SKU = exports.ADDITIONAL_PAYMENT_STORE_ITEM_OPTION_NAME = exports.ADDITIONAL_PAYMENT_STORE_ITEM_NAME = void 0;
+/** @author sj */
+/** 서버가 생성하는 추가금 결제 전용 비공개 StoreItem의 고정 식별값이다. */
+exports.ADDITIONAL_PAYMENT_STORE_ITEM_NAME = '추가금 결제';
+exports.ADDITIONAL_PAYMENT_STORE_ITEM_OPTION_NAME = '추가금';
+exports.ADDITIONAL_PAYMENT_STORE_ITEM_OPTION_SKU = 'SYSTEM_ADDITIONAL_PAYMENT';
+exports.ADDITIONAL_PAYMENT_STORE_ITEM_NAME_KEY_PREFIX = 'system-additional-payment-';

package/store-item/index.d.ts

@@ -1 +1,2 @@
 export * from './store-item.entity';
+export * from './additional-payment-store-item.constant';

package/store-item/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./store-item.entity"), exports);
+__exportStar(require("./additional-payment-store-item.constant"), exports);

package/customs/customs.entity.d.ts

@@ -1,70 +0,0 @@
-import { Types } from 'mongoose';
-/** @description 관세청 개인통관고유부호 검증 처리 상태 */
-export declare enum CustomsPcccVerificationStatusEnum {
-    REQUESTING = "REQUESTING",
-    USER_INPUT_REQUIRED = "USER_INPUT_REQUIRED",
-    VERIFIED = "VERIFIED",
-    FAILED = "FAILED",
-    UNKNOWN_RESULT = "UNKNOWN_RESULT"
-}
-/** @description 관세청 거래정보 제출 처리 상태 */
-export declare enum CustomsTradeSubmissionStatusEnum {
-    SUBMITTING = "SUBMITTING",
-    SUBMITTED_ACK = "SUBMITTED_ACK",
-    VALIDATING = "VALIDATING",
-    REGISTERED = "REGISTERED",
-    PARTIAL_REJECTED = "PARTIAL_REJECTED",
-    FULL_REJECTED = "FULL_REJECTED",
-    UNKNOWN_RESULT = "UNKNOWN_RESULT",
-    FAILED = "FAILED"
-}
-export interface CustomsPcccVerificationEntity {
-    _id: Types.ObjectId | string;
-    reqtNo: string;
-    orderNo?: string;
-    status: CustomsPcccVerificationStatusEnum;
-    requestType: '01' | '02';
-    phoneLastFour: string;
-    otpPrefix?: string;
-    responseType?: '01' | '02' | '03';
-    validationPeriod?: string;
-    issuedAt?: string;
-    externalResponseCode?: string;
-    externalResponseUuid?: string;
-    maskedEmail?: string;
-    failureCode?: string;
-    requestedAt: Date;
-    verifiedAt?: Date;
-}
-export interface CustomsTradeSubmissionEntity {
-    _id: Types.ObjectId | string;
-    txifSbmtNo: string;
-    status: CustomsTradeSubmissionStatusEnum;
-    payloadHash: string;
-    orderNumbers: string[];
-    submittedAt?: Date;
-    lastResultQueriedAt?: Date;
-    nextResultQueryAt?: Date;
-    externalResponseCode?: string;
-    externalResponseUuid?: string;
-    result?: Record<string, unknown>;
-    failureCode?: string;
-    failureMessage?: string;
-    attemptCount: number;
-    createdAt: Date;
-    updatedAt: Date;
-}
-export interface CustomsAccessTokenEntity {
-    _id: Types.ObjectId | string;
-    credentialKey: string;
-    accessToken?: string;
-    expiresAt?: Date;
-    refreshLockUntil?: Date;
-    updatedAt: Date;
-}
-export interface CustomsSequenceEntity {
-    _id: Types.ObjectId | string;
-    key: string;
-    value: number;
-    updatedAt: Date;
-}

package/customs/customs.entity.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CustomsTradeSubmissionStatusEnum = exports.CustomsPcccVerificationStatusEnum = void 0;
-/** @description 관세청 개인통관고유부호 검증 처리 상태 */
-var CustomsPcccVerificationStatusEnum;
-(function (CustomsPcccVerificationStatusEnum) {
-    CustomsPcccVerificationStatusEnum["REQUESTING"] = "REQUESTING";
-    CustomsPcccVerificationStatusEnum["USER_INPUT_REQUIRED"] = "USER_INPUT_REQUIRED";
-    CustomsPcccVerificationStatusEnum["VERIFIED"] = "VERIFIED";
-    CustomsPcccVerificationStatusEnum["FAILED"] = "FAILED";
-    CustomsPcccVerificationStatusEnum["UNKNOWN_RESULT"] = "UNKNOWN_RESULT";
-})(CustomsPcccVerificationStatusEnum || (exports.CustomsPcccVerificationStatusEnum = CustomsPcccVerificationStatusEnum = {}));
-/** @description 관세청 거래정보 제출 처리 상태 */
-var CustomsTradeSubmissionStatusEnum;
-(function (CustomsTradeSubmissionStatusEnum) {
-    CustomsTradeSubmissionStatusEnum["SUBMITTING"] = "SUBMITTING";
-    CustomsTradeSubmissionStatusEnum["SUBMITTED_ACK"] = "SUBMITTED_ACK";
-    CustomsTradeSubmissionStatusEnum["VALIDATING"] = "VALIDATING";
-    CustomsTradeSubmissionStatusEnum["REGISTERED"] = "REGISTERED";
-    CustomsTradeSubmissionStatusEnum["PARTIAL_REJECTED"] = "PARTIAL_REJECTED";
-    CustomsTradeSubmissionStatusEnum["FULL_REJECTED"] = "FULL_REJECTED";
-    CustomsTradeSubmissionStatusEnum["UNKNOWN_RESULT"] = "UNKNOWN_RESULT";
-    CustomsTradeSubmissionStatusEnum["FAILED"] = "FAILED";
-})(CustomsTradeSubmissionStatusEnum || (exports.CustomsTradeSubmissionStatusEnum = CustomsTradeSubmissionStatusEnum = {}));

package/customs/index.d.ts

@@ -1 +0,0 @@
-export * from './customs.entity';

package/customs/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./customs.entity"), exports);