LIOT/Framework/Senparc.Weixin.MP/AdvancedAPIs/Card/CardCreate/CardCreateData.cs

#region Apache License Version 2.0
/*----------------------------------------------------------------

Copyright 2019 Jeffrey Su & Suzhou Senparc Network Technology Co.,Ltd.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the
License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing permissions
and limitations under the License.

Detail: https://github.com/JeffreySu/WeiXinMPSDK/blob/master/license.md

----------------------------------------------------------------*/
#endregion Apache License Version 2.0

/*----------------------------------------------------------------
    Copyright (C) 2019 Senparc
    
    文件名：CardCreateData.cs
    文件功能描述：所有类型的卡券数据
    
    
    创建标识：Senparc - 20150211
    
    修改标识：Senparc - 20150303
    修改描述：整理接口
    
    修改标识：Senparc - 20150323
    修改描述：添加会议门票类型
    
    修改标识：hello2008zj - 20160502
    修改描述：v13.7.8 添加 Card_MemberCardData.background_pic_url

    修改标识：Senparc - 20170528
    修改描述：v14.4.10  修改Card_CashData属性类型（int）

    修改标识：Senparc - 20170711
    修改描述：v14.5.2 Card_MemberCardData添加wx_activate_after_submit和wx_activate_after_submit_url

    修改标识：Senparc - 20171117
    修改描述：v14.8.6 修改Card_MemberCardData.wx_activate_after_submit_url为string类型

----------------------------------------------------------------*/

using Senparc.CO2NET.Helpers.Serializers;
using Senparc.Weixin.Entities;
using Senparc.Weixin.Helpers;

namespace Senparc.Weixin.MP.AdvancedAPIs.Card
{
    /* 所有类型的卡券数据 */


    /// <summary>
    /// 通用券数据
    /// </summary>
    public class Card_GeneralCouponData : BaseCardInfo
    {
        /// <summary>
        /// 描述文本
        /// 必填
        /// </summary>
        public string default_detail { get; set; }

        public Card_GeneralCouponData()
            : base(CardType.GENERAL_COUPON)
        {
        }
    }

    /// <summary>
    /// 团购券数据
    /// </summary>
    public class Card_GrouponData : BaseCardInfo
    {
        /// <summary>
        /// 团购券专用，团购详情
        /// 必填
        /// </summary>
        public string deal_detail { get; set; }

        public Card_GrouponData()
            : base(CardType.GROUPON)
        {
        }
    }

    /// <summary>
    /// 礼品券数据
    /// </summary>
    public class Card_GiftData : BaseCardInfo
    {
        /// <summary>
        /// 礼品券专用，表示礼品名字
        /// 必填
        /// </summary>
        public string gift { get; set; }

        public Card_GiftData()
            : base(CardType.GIFT)
        {
        }
    }

    /// <summary>
    /// 代金券数据
    /// </summary>
    public class Card_CashData : BaseCardInfo
    {
        /// <summary>
        /// 代金券专用，表示起用金额（单位为分）
        /// 非必填
        /// </summary>
        public int least_cost { get; set; }
        /// <summary>
        /// 代金券专用，表示减免金额（单位为分）
        /// 必填
        /// </summary>
        public int reduce_cost { get; set; }

        public Card_CashData()
            : base(CardType.CASH)
        {
        }
    }

    /// <summary>
    /// 折扣券数据
    /// </summary>
    public class Card_DisCountData : BaseCardInfo
    {
        /// <summary>
        ///折扣券专用，表示打折额度（百分比）。填30 就是七折。
        /// 必填
        /// </summary>
        public float discount { get; set; }

        public Card_DisCountData()
            : base(CardType.DISCOUNT)
        {
        }
    }

    /// <summary>
    /// 会员卡数据
    /// </summary>
    public class Card_MemberCardData : BaseCardInfo
    {
        /// <summary>
        /// 是否支持积分，填写true 或false，如填写true，积分相关字段均为必填。
        /// 必填
        /// </summary>
        public bool supply_bonus { get; set; }
        /// <summary>
        /// 是否支持储值，填写true 或false。
        /// 必填
        /// </summary>
        public bool supply_balance { get; set; }
        /// <summary>
        /// 设置为true时用户领取会员卡后系统自动将其激活，无需调用激活接口。
        /// 非必填
        /// </summary>
        [JsonSetting.IgnoreValueAttribute(false)]
        public bool auto_activate { get; set; }
        /// <summary>
        /// 设置为true时会员卡支持一键激活，不允许同时传入activate_url字段，否则设置wx_activate失效。
        /// 非必填
        /// </summary>
        [JsonSetting.IgnoreValueAttribute(false)]
        public bool wx_activate { get; set; }
        /// <summary>
        /// 积分清零规则
        /// 非必填
        /// </summary>
        public string bonus_cleared { get; set; }
        /// <summary>
        /// 积分规则
        /// 非必填
        /// </summary>
        public string bonus_rules { get; set; }
        /// <summary>
        /// 储值说明
        /// 非必填
        /// </summary>
        public string balance_rules { get; set; }
        /// <summary>
        /// 特权说明
        /// 必填
        /// </summary>
        public string prerogative { get; set; }
        /// <summary>
        /// 绑定旧卡的url，与“activate_url”字段二选一必填。
        /// </summary>
        public string bind_old_card_url { get; set; }
        /// <summary>
        /// 激活会员卡的url，与“bind_old_card_url”字段二选一必填。
        /// </summary>
        public string activate_url { get; set; }
        /// <summary>
        /// 设置跳转外链查看积分详情。仅适用于积分无法通过激活接口同步的情况下使用该字段。
        /// 非必填
        /// </summary>
        public string bonus_url { get; set; }
        /// <summary>
        /// 积分信息类目对应的小程序 user_name，格式为原始id+@app 小程序原始id可以在小程序的设置页面底部查看到
        /// </summary>
        public string bonus_app_brand_user_name { get; set; }
        /// <summary>
        /// 积分入口小程序的页面路径 
        /// </summary>
        public string bonus_app_brand_pass { get; set; }
        /// <summary>
        /// 设置跳转外链查看余额详情。仅适用于余额无法通过激活接口同步的情况下使用该字段。
        /// 非必填
        /// </summary>
        public string balance_url { get; set; }
        /// <summary>
        /// 余额信息类目对应的小程序 user_name，格式为原始id+@app 小程序原始id可以在小程序的设置页面底部查看到
        /// </summary>
        public string balance_app_brand_user_name { get; set; }
        /// <summary>
        /// 余额入口小程序的页面路径
        /// </summary>
        public string balance_app_brand_pass { get; set; }
        /// <summary>
        /// 自定义会员信息类目，会员卡激活后显示。
        /// 非必填
        /// </summary>
        public CustomField custom_field1 { get; set; }
        /// <summary>
        /// 自定义会员信息类目，会员卡激活后显示。
        /// 非必填
        /// </summary>
        public CustomField custom_field2 { get; set; }
        /// <summary>
        /// 自定义会员信息类目，会员卡激活后显示。
        /// 非必填
        /// </summary>
        public CustomField custom_field3 { get; set; }
        /// <summary>
        /// 自定义会员信息类目，会员卡激活后显示
        /// 非必填
        /// </summary>
        public CustomCell custom_cell1 { get; set; }
        /// <summary>
        /// 会员卡背景图片，非必填
        /// </summary>
        public string background_pic_url { get; set; }

        //以下增加
        /// <summary>
        /// 积分规则结构体
        /// </summary>
        public BonusRule bonus_rule { get; set; }
        /// <summary>
        /// 折扣
        /// </summary>
        [JsonSetting.IgnoreValueAttribute(0)]
        public int discount { get; set; }


        //[JsonSetting.IgnoreValue()]
        /// <summary>
        /// 是否支持跳转型一键激活，填true或lse    
        /// </summary>
        public bool? wx_activate_after_submit { get; set; }
        /// <summary>
        /// 跳转型一键激活跳转的地址链接，请填写http://或者https://开头的链接（官方文档为bool类型：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1451025283）
        /// <para>如果是使用小程序页面激活则不填此字段，填写activate_app_brand_user_name和activate_app_brand_pass字段</para>
        /// </summary>
        public string wx_activate_after_submit_url { get; set; }
        /// <summary>
        /// 激活会员卡跳转的小程序user_name，格式为小程序原始id+@app  小程序原始id可以在小程序的设置页面底部查看到
        /// </summary>
        public string activate_app_brand_user_name { get; set; }
        /// <summary>
        /// 激活会员卡跳转的小程序页面路径
        /// </summary>
        public string activate_app_brand_pass { get; set; }

        public Card_MemberCardData()
            : base(CardType.MEMBER_CARD)
        {
        }
    }

    public class CustomField /*: IJsonEnumString*/
    {
        /// <summary>
        /// 会员信息类目名称。FIELD_NAME_TYPE_LEVEL等级；FIELD_NAME_TYPE_COUPON优惠券；FIELD_NAME_TYPE_STAMP印花；FIELD_NAME_TYPE_DISCOUNT折扣；FIELD_NAME_TYPE_ACHIEVEMEN成就；FIELD_NAME_TYPE_MILEAGE里程。
        /// </summary>
        [JsonSetting.EnumString]
        public MemberCard_CustomField_NameType name_type { get; set; }
        /// <summary>
        /// 点击类目跳转外链url
        /// </summary>
        public string url { get; set; }
        /// <summary>
        /// 自定义入口小程序user_name，格式为原始id+@app 小程序原始id可以在小程序的设置页面底部查看到
        /// </summary>
        public string app_brand_user_name { get; set; }
        /// <summary>
        /// 自定义入口小程序的页面路径 如：API/cardPage
        /// </summary>
        public string app_brand_pass { get; set; }
    }

    public class CustomCell
    {
        /// <summary>
        /// 入口名称
        /// 必填
        /// </summary>
        public string name { get; set; }
        /// <summary>
        /// 入口右侧提示语，6个汉字内
        /// 必填
        /// </summary>
        public string tips { get; set; }
        /// <summary>
        /// 入口跳转链接
        /// 必填
        /// </summary>
        public string url { get; set; }
        /// <summary>
        /// 自定义入口小程序user_name，格式为原始id+@app 小程序原始id可以在小程序的设置页面底部查看到
        /// </summary>
        public string app_brand_user_name { get; set; }
        /// <summary>
        /// 自定义入口小程序的页面路径 如：API/cardPage
        /// </summary>
        public string app_brand_pass { get; set; }
    }
    /// <summary>
    /// 积分规则，新增加
    /// </summary>
    public class BonusRule
    {
        [JsonSetting.IgnoreValueAttribute(0)]
        public int cost_money_unit { get; set; }
        [JsonSetting.IgnoreValueAttribute(0)]
        public int increase_bonus { get; set; }
        [JsonSetting.IgnoreValueAttribute(0)]
        public int max_increase_bonus { get; set; }
        [JsonSetting.IgnoreValueAttribute(0)]
        public int init_increase_bonus { get; set; }
        [JsonSetting.IgnoreValueAttribute(0)]
        public int cost_bonus_unit { get; set; }
        [JsonSetting.IgnoreValueAttribute(0)]
        public int reduce_money { get; set; }
        [JsonSetting.IgnoreValueAttribute(0)]
        public int least_money_to_use_bonus { get; set; }
        [JsonSetting.IgnoreValueAttribute(0)]
        public int max_reduce_bonus { get; set; }
    }

    /// <summary>
    /// 门票数据
    /// </summary>
    public class Card_ScenicTicketData : BaseCardInfo
    {
        /// <summary>
        /// 票类型，例如平日全票，套票等
        /// 非必填
        /// </summary>
        public string ticket_class { get; set; }
        /// <summary>
        /// 导览图url
        /// 非必填
        /// </summary>
        public string guide_url { get; set; }

        public Card_ScenicTicketData()
            : base(CardType.SCENIC_TICKET)
        {
        }
    }

    /// <summary>
    /// 电影票数据
    /// </summary>
    public class Card_MovieTicketData : BaseCardInfo
    {
        /// <summary>
        /// 电影票详请
        /// 非必填
        /// </summary>
        public string detail { get; set; }

        public Card_MovieTicketData()
            : base(CardType.MOVIE_TICKET)
        {
        }
    }

    /// <summary>
    /// 飞机票数据
    /// </summary>
    public class Card_BoardingPassData : BaseCardInfo
    {
        /// <summary>
        /// 起点，上限为18 个汉字
        /// 必填
        /// </summary>
        public string from { get; set; }
        /// <summary>
        /// 终点，上限为18 个汉字
        /// 必填
        /// </summary>
        public string to { get; set; }
        /// <summary>
        /// 航班
        /// 必填
        /// </summary>
        public string flight { get; set; }
        /// <summary>
        /// 起飞时间，上限为17 个汉字
        /// 非必填
        /// </summary>
        public string departure_time { get; set; }
        /// <summary>
        /// 降落时间，上限为17 个汉字
        /// 非必填
        /// </summary>
        public string landing_time { get; set; }
        /// <summary>
        /// 在线值机的链接
        /// 非必填
        /// </summary>
        public string check_in_url { get; set; }
        /// <summary>
        /// 登机口。如发生登机口变更，建议商家实时调用该接口变更
        /// </summary>
        public string gate { get; set; }
        /// <summary>
        /// 登机时间，只显示“时分”不显示日期，按时间戳格式填写。如发生登机时间变更，建议商家实时调用该接口变更
        /// </summary>
        public string boarding_time { get; set; }
        /// <summary>
        /// 机型，上限为8 个汉字
        /// 非必填
        /// </summary>
        public string air_model { get; set; }

        public Card_BoardingPassData()
            : base(CardType.BOARDING_PASS)
        {
        }
    }

    /// <summary>
    /// 红包数据
    /// </summary>
    public class Card_LuckyMoneyData : BaseCardInfo
    {
        public Card_LuckyMoneyData()
            : base(CardType.LUCKY_MONEY)
        {
        }
    }

    /// <summary>
    /// 会议门票数据
    /// </summary>
    public class Card_MeetingTicketData : BaseCardInfo
    {
        /// <summary>
        /// 会议详情
        /// </summary>
        public string meeting_detail { get; set; }

        /// <summary>
        /// 会场导览图
        /// </summary>
        public string map_url { get; set; }

        public Card_MeetingTicketData()
            : base(CardType.MEETING_TICKET)
        {
        }
    }
}