@motionpicture/coa-service 9.4.0 → 9.5.0

package/example/couponTicket.js

@@ -0,0 +1,30 @@
+/**
+ * 販売可能チケット抽出の例
+ */
+const COA = require('../');
+const fs = require('fs');
+
+const service = new COA.service.Reserve(
+    {
+        endpoint: process.env.COA_ENDPOINT,
+        auth: new COA.auth.RefreshToken({
+            endpoint: process.env.COA_ENDPOINT,
+            refreshToken: process.env.COA_REFRESH_TOKEN
+        })
+    }
+);
+
+service.couponTicket({
+    theaterCode: '120',
+    couponCode: '12345abcde',
+    dateJouei: '20240827',
+    titleCode: '99511',
+    titleBranchNum: '0',
+    timeBegin: '2200',
+    flgMember: '0'
+}).then((result) => {
+    fs.writeFileSync(`${__dirname}/output/couponTicket.json`, JSON.stringify(result, null, '    '));
+    console.log(result);
+}).catch((err) => {
+    console.error(err);
+});

package/example/findPerformances.js

@@ -11,14 +11,14 @@ const service = new COA.service.Master(
             endpoint: process.env.COA_ENDPOINT,
             refreshToken: process.env.COA_REFRESH_TOKEN
         })
-    },
+    }
     // { timeout: 1000 }
 );
 
 service.schedule({
-    theaterCode: '120',
-    begin: '20200213',
-    end: '20200218'
+    theaterCode: '020',
+    begin: '20240426',
+    end: '20240428'
 }).then((result) => {
     fs.writeFileSync(`${__dirname}/output/schedule.json`, JSON.stringify(result, null, '    '));
     console.log(result);

package/example/salesTicket.js

@@ -16,11 +16,11 @@ const service = new COA.service.Reserve(
 
 service.salesTicket({
     theaterCode: '120',
-    dateJouei: '20230309',
-    titleCode: '99100',
+    dateJouei: '20240827',
+    titleCode: '99511',
     titleBranchNum: '0',
-    timeBegin: '1720',
-    flgMember: '1'
+    timeBegin: '2200',
+    flgMember: '0'
 }).then((result) => {
     fs.writeFileSync(`${__dirname}/output/salesTicket2.json`, JSON.stringify(result, null, '    '));
     console.log(result);

package/lib/factory/master.d.ts

@@ -125,6 +125,12 @@ export interface ITitleResult {
      * ※2024/02/09追加
      */
     dateMgtkBegin?: string;
+    /**
+     * 割引対象外フラグ
+     * 1：割引対象外
+     * ※2024/08/19追加
+     */
+    flgNotDiscount?: string;
 }
 /**
  * スクリーンマスター抽出in

package/lib/factory/reserve.d.ts

@@ -670,3 +670,137 @@ export interface ISalesTicketResult {
      */
     addGlasses: number;
 }
+/**
+ * クーポンチケット情報in
+ */
+export interface ICouponTicketArgs {
+    /**
+     * 施設コード
+     */
+    theaterCode: string;
+    /**
+     * クーポンコード
+     * ※英数字10桁
+     */
+    couponCode: string;
+    /**
+     * 上映日
+     */
+    dateJouei: string;
+    /**
+     * 作品コード
+     */
+    titleCode: string;
+    /**
+     * 作品枝番
+     */
+    titleBranchNum: string;
+    /**
+     * 上映開始時刻
+     */
+    timeBegin: string;
+    /**
+     * 会員用フラグ
+     * 1：会員専用チケットも表示する。会員以外の場合は0をセット
+     */
+    flgMember: FlgMember;
+}
+export interface ICouponTicket {
+    /**
+     * チケットコード
+     */
+    ticketCode: string;
+    /**
+     * チケット名
+     */
+    ticketName: string;
+    /**
+     * チケット名（カナ）
+     */
+    ticketNameKana: string;
+    /**
+     * チケット名（英）
+     */
+    ticketNameEng: string;
+    /**
+     * 標準単価
+     */
+    stdPrice: number;
+    /**
+     * 加算単価
+     * ３Ｄ，ＩＭＡＸ、４ＤＸ等の加算料金
+     */
+    addPrice: number;
+    /**
+     * 割引金額
+     * 割引券区分=000（定額割引）の場合のみ、以外は0
+     * ※2024/08/22訂正
+     */
+    disPrice: number;
+    /**
+     * 販売単価
+     * 標準単価＋加算単価－割引金額
+     */
+    salePrice: number;
+    /**
+     * 人数制限
+     * 制限が無い場合は１
+     */
+    limitCount: number;
+    /**
+     * 制限単位
+     * １：ｎ人単位、２：ｎ人以上
+     */
+    limitUnit: string;
+    /**
+     * チケット備考
+     * 注意事項等
+     */
+    ticketNote: string;
+    /**
+     * メガネ単価
+     * ３Dの場合、メガネ代をセット。それ以外は０をセット
+     */
+    addGlasses: number;
+}
+/**
+ * クーポンチケット情報out
+ */
+export interface ICouponTicketResult {
+    /**
+     * ステータス
+     * 0：認証OK、0以外は認証失敗
+     */
+    status: string;
+    /**
+     * メッセージ
+     * ステータスに対するメッセージ
+     */
+    message?: string;
+    /**
+     * 回数制限
+     * 利用できる回数（0：制限なし）
+     * ※将来的な項目です。現時点では未使用（固定値「0」を返却）
+     */
+    cntLimit: number;
+    /**
+     * 割引券区分
+     * 000：定額割引、001：額面割引
+     * ※2024/08/22訂正
+     */
+    kbnDiscount: string;
+    /**
+     * 枚数制限
+     * 同時に利用できる枚数（0：制限なし）
+     */
+    cntDiscount: number;
+    /**
+     * 有効期限
+     * ※日付は西暦8桁 "YYYYMMDD"、無期限の場合は日付なし
+     */
+    dateExpiration: string;
+    /**
+     * 利用可能チケット情報リスト
+     */
+    listTicket: ICouponTicket[];
+}

package/lib/service/master.js

@@ -45,8 +45,8 @@ class MasterService extends service_1.Service {
                 method: 'GET'
             }, [http_status_1.OK]);
             return (Array.isArray(body.list_title))
-                ? body.list_title.map(({ title_code, title_branch_num, title_name, title_name_kana, title_name_eng, title_name_short, title_name_orig, kbn_eirin, kbn_eizou, kbn_joueihousiki, kbn_jimakufukikae, show_time, date_begin, date_end, flg_mvtk_use, date_mvtk_begin, flg_mgtk_use, date_mgtk_begin }) => {
-                    return Object.assign(Object.assign({ titleCode: title_code, titleBranchNum: title_branch_num, titleName: title_name, titleNameKana: title_name_kana, titleNameEng: title_name_eng, titleNameShort: title_name_short, titleNameOrig: title_name_orig, kbnEirin: kbn_eirin, kbnEizou: kbn_eizou, kbnJoueihousiki: kbn_joueihousiki, kbnJimakufukikae: kbn_jimakufukikae, showTime: show_time, dateBegin: date_begin, dateEnd: date_end, flgMvtkUse: flg_mvtk_use, dateMvtkBegin: date_mvtk_begin }, (typeof flg_mgtk_use === 'string') ? { flgMgtkUse: flg_mgtk_use } : /* istanbul ignore next */ undefined), (typeof date_mgtk_begin === 'string') ? { dateMgtkBegin: date_mgtk_begin } : /* istanbul ignore next */ undefined);
+                ? body.list_title.map(({ title_code, title_branch_num, title_name, title_name_kana, title_name_eng, title_name_short, title_name_orig, kbn_eirin, kbn_eizou, kbn_joueihousiki, kbn_jimakufukikae, show_time, date_begin, date_end, flg_mvtk_use, date_mvtk_begin, flg_mgtk_use, date_mgtk_begin, flg_not_discount }) => {
+                    return Object.assign(Object.assign(Object.assign({ titleCode: title_code, titleBranchNum: title_branch_num, titleName: title_name, titleNameKana: title_name_kana, titleNameEng: title_name_eng, titleNameShort: title_name_short, titleNameOrig: title_name_orig, kbnEirin: kbn_eirin, kbnEizou: kbn_eizou, kbnJoueihousiki: kbn_joueihousiki, kbnJimakufukikae: kbn_jimakufukikae, showTime: show_time, dateBegin: date_begin, dateEnd: date_end, flgMvtkUse: flg_mvtk_use, dateMvtkBegin: date_mvtk_begin }, (typeof flg_mgtk_use === 'string') ? { flgMgtkUse: flg_mgtk_use } : /* istanbul ignore next */ undefined), (typeof date_mgtk_begin === 'string') ? { dateMgtkBegin: date_mgtk_begin } : /* istanbul ignore next */ undefined), (typeof flg_not_discount === 'string') ? { flgNotDiscount: flg_not_discount } : /* istanbul ignore next */ undefined);
                 })
                 : /* istanbul ignore next */ [];
         });

package/lib/service/reserve.d.ts

@@ -1,4 +1,4 @@
-import * as ReserveFactory from '../factory/reserve';
+import { ICountFreeSeatArgs, ICountFreeSeatResult, ICouponTicketArgs, ICouponTicketResult, IDelReserveArgs, IDelTmpReserveArgs, ISalesTicketArgs, ISalesTicketResult, IStateReserveArgs, IStateReserveResult, IStateReserveSeatArgs, IStateReserveSeatResult, IUpdReserveArgs, IUpdReserveResult, IUpdTmpReserveSeatArgs, IUpdTmpReserveSeatResult } from '../factory/reserve';
 import { Service } from '../service';
 /**
  * 予約サービス
@@ -10,7 +10,7 @@ export declare class ReserveService extends Service {
      * @param args.begin 空席情報を抽出する上映日の開始日 ※日付は西暦8桁 'YYYYMMDD'
      * @param args.end 空席情報を抽出する上映日の終了日 ※日付は西暦8桁 'YYYYMMDD'
      */
-    countFreeSeat(args: ReserveFactory.ICountFreeSeatArgs): Promise<ReserveFactory.ICountFreeSeatResult>;
+    countFreeSeat(args: ICountFreeSeatArgs): Promise<ICountFreeSeatResult>;
     /**
      * 座席予約状態抽出
      * @param args.theaterCode 施設コード
@@ -20,7 +20,7 @@ export declare class ReserveService extends Service {
      * @param args.timeBegin 上映時刻
      * @param args.screenCode スクリーンコード
      */
-    stateReserveSeat(args: ReserveFactory.IStateReserveSeatArgs): Promise<ReserveFactory.IStateReserveSeatResult>;
+    stateReserveSeat(args: IStateReserveSeatArgs): Promise<IStateReserveSeatResult>;
     /**
      * 座席仮予約
      * @param args.theaterCode 劇場コード
@@ -33,7 +33,7 @@ export declare class ReserveService extends Service {
      * @param args.screenCode.seatSection 座席セクション
      * @param args.screenCode.seatNum 座席番号
      */
-    updTmpReserveSeat(args: ReserveFactory.IUpdTmpReserveSeatArgs): Promise<ReserveFactory.IUpdTmpReserveSeatResult>;
+    updTmpReserveSeat(args: IUpdTmpReserveSeatArgs): Promise<IUpdTmpReserveSeatResult>;
     /**
      * 座席仮予約削除
      * @param args.theaterCode 施設コード
@@ -43,7 +43,7 @@ export declare class ReserveService extends Service {
      * @param args.timeBegin 上映時刻
      * @param args.tmpReserveNum 座席チケット仮予約番号
      */
-    delTmpReserve(args: ReserveFactory.IDelTmpReserveArgs): Promise<void>;
+    delTmpReserve(args: IDelTmpReserveArgs): Promise<void>;
     /**
      * 座席本予約
      * @param args.theaterCode 施設コード
@@ -79,7 +79,7 @@ export declare class ReserveService extends Service {
      * @param args.listTicket.mvtkSalesPrice ムビチケ・ＭＧ販売単価
      * @param args.listTicket.kbnMgtk ＭＧチケット区分
      */
-    updReserve(args: ReserveFactory.IUpdReserveArgs): Promise<ReserveFactory.IUpdReserveResult>;
+    updReserve(args: IUpdReserveArgs): Promise<IUpdReserveResult>;
     /**
      * 購入チケット取り消し
      * @param args.theaterCode 施設コード
@@ -94,14 +94,14 @@ export declare class ReserveService extends Service {
      * @param args.screenCode.seatSection 座席セクション
      * @param args.screenCode.seatNum 座席番号
      */
-    delReserve(args: ReserveFactory.IDelReserveArgs): Promise<void>;
+    delReserve(args: IDelReserveArgs): Promise<void>;
     /**
      * 購入チケット内容抽出
      * @param args.theaterCode 施設コード
      * @param args.reserveNum 座席チケット購入番号
      * @param args.telNum 電話番号
      */
-    stateReserve(args: ReserveFactory.IStateReserveArgs): Promise<ReserveFactory.IStateReserveResult | null>;
+    stateReserve(args: IStateReserveArgs): Promise<IStateReserveResult | null>;
     /**
      * 販売可能チケット情報
      * @param args.theaterCode 施設コード
@@ -111,5 +111,9 @@ export declare class ReserveService extends Service {
      * @param args.timeBegin 上映時刻
      * @param args.flgMember 会員用フラグ
      */
-    salesTicket(args: ReserveFactory.ISalesTicketArgs): Promise<ReserveFactory.ISalesTicketResult[]>;
+    salesTicket(args: ISalesTicketArgs): Promise<ISalesTicketResult[]>;
+    /**
+     * クーポンチケット情報
+     */
+    couponTicket(args: ICouponTicketArgs): Promise<ICouponTicketResult>;
 }

package/lib/service/reserve.js

@@ -11,7 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReserveService = void 0;
 const http_status_1 = require("http-status");
-const ReserveFactory = require("../factory/reserve");
+const reserve_1 = require("../factory/reserve");
 const service_1 = require("../service");
 /**
  * 予約サービス
@@ -339,7 +339,7 @@ class ReserveService extends service_1.Service {
                     title_branch_num: args.titleBranchNum,
                     time_begin: args.timeBegin,
                     // 念のため互換性を保つ次期アップデートでデフォルト値削除
-                    flg_member: (args.flgMember === undefined) ? ReserveFactory.FlgMember.NonMember : args.flgMember
+                    flg_member: (args.flgMember === undefined) ? reserve_1.FlgMember.NonMember : args.flgMember
                 }
             }, [http_status_1.OK]);
             return body.list_ticket.map((value) => {
@@ -359,5 +359,50 @@ class ReserveService extends service_1.Service {
             });
         });
     }
+    /**
+     * クーポンチケット情報
+     */
+    couponTicket(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const body = yield this.request({
+                uri: `/api/v1/theater/${args.theaterCode}/coupon_ticket/`,
+                method: 'GET',
+                qs: {
+                    coupon_code: args.couponCode,
+                    date_jouei: args.dateJouei,
+                    title_code: args.titleCode,
+                    title_branch_num: args.titleBranchNum,
+                    time_begin: args.timeBegin,
+                    flg_member: args.flgMember
+                }
+            }, [http_status_1.OK]);
+            return {
+                status: String(body.status),
+                message: body.message,
+                cntLimit: body.cnt_limit,
+                kbnDiscount: body.kbn_discount,
+                cntDiscount: body.cnt_discount,
+                dateExpiration: body.date_expiration,
+                listTicket: (Array.isArray(body.list_ticket))
+                    ? body.list_ticket.map((value) => {
+                        return {
+                            ticketCode: value.ticket_code,
+                            ticketName: value.ticket_name,
+                            ticketNameKana: value.ticket_name_kana,
+                            ticketNameEng: value.ticket_name_eng,
+                            stdPrice: value.std_price,
+                            addPrice: value.add_price,
+                            disPrice: value.dis_price,
+                            salePrice: value.sale_price,
+                            limitCount: value.limit_count,
+                            limitUnit: value.limit_unit,
+                            ticketNote: value.ticket_note,
+                            addGlasses: value.add_glasses
+                        };
+                    })
+                    : /* istanbul ignore next */ []
+            };
+        });
+    }
 }
 exports.ReserveService = ReserveService;

package/package.json

@@ -76,5 +76,5 @@
     "postversion": "git push origin --tags",
     "prepublishOnly": "npm run clean && npm run build && npm test && npm run doc"
   },
-  "version": "9.4.0"
+  "version": "9.5.0"
 }