FS/FS/part_pkg/discount_Mixin.pm

   1 package FS::part_pkg::discount_Mixin;
   2
   3 use strict;
   4 use vars qw(@ISA %info);
   5 use FS::part_pkg;
   6 use FS::cust_pkg;
   7 use FS::cust_bill_pkg_discount;
   8 use Time::Local qw(timelocal);
   9 use List::Util 'min';
  10
  11 @ISA = qw(FS::part_pkg);
  12 %info = ( 'disabled' => 1 );
  13
  14 =head1 NAME
  15
  16 FS::part_pkg::discount_Mixin - Mixin class for part_pkg:: classes that
  17 can be discounted.
  18
  19 =head1 SYNOPSIS
  20
  21 package FS::part_pkg::...;
  22 use base qw( FS::part_pkg::discount_Mixin );
  23
  24 sub calc_recur {
  25   ...
  26   my $discount = $self->calc_discount($cust_pkg, $$sdate, $details, $param);
  27   $charge -= $discount;
  28   ...
  29 }
  30
  31 =head METHODS
  32
  33 =item calc_discount
  34
  35 Takes all the arguments of calc_recur.  Calculates and returns  the amount
  36 by which to reduce the recurring fee; also increments months used on the
  37 discount and generates an invoice detail describing it.
  38
  39 =cut
  40
  41 sub calc_discount {
  42   my($self, $cust_pkg, $sdate, $details, $param ) = @_;
  43
  44   my $br = $self->base_recur($cust_pkg, $sdate);
  45   $br += $param->{'override_charges'} if $param->{'override_charges'};
  46
  47   return 0 if defined $param->{'setup_charge'} && $param->{'setup_charge'} == 0;
  48
  49   my $tot_discount = 0;
  50   #UI enforces just 1 for now, will need ordering when they can be stacked
  51
  52   if ( $param->{freq_override} ) {
  53     # When a customer pays for more than one month at a time to receive a
  54     # term discount, freq_override is set to the number of months.
  55     my $real_part_pkg = new FS::part_pkg { $self->hash };
  56     $real_part_pkg->pkgpart($param->{real_pkgpart} || $self->pkgpart);
  57     # Find a discount with that duration...
  58     my @discount = grep { $_->months == $param->{freq_override} }
  59                     map { $_->discount } $real_part_pkg->part_pkg_discount;
  60     my $discount = shift @discount;
  61     # and default to bill that many months at once.
  62     $param->{months} = $param->{freq_override} unless $param->{months};
  63     my $error;
  64     if ($discount) {
  65       # Then set the cust_pkg discount.
  66       if ($discount->months == $param->{months}) {
  67         $cust_pkg->discountnum($discount->discountnum);
  68         $error = $cust_pkg->insert_discount;
  69       } else {
  70         $cust_pkg->discountnum(-1);
  71         foreach ( qw( amount percent months ) ) {
  72           my $method = "discountnum_$_";
  73           $cust_pkg->$method($discount->$_);
  74         }
  75         $error = $cust_pkg->insert_discount;
  76       }
  77       die "error discounting using part_pkg_discount: $error" if $error;
  78     }
  79   }
  80
  81   my @cust_pkg_discount = $cust_pkg->cust_pkg_discount_active;
  82   foreach my $cust_pkg_discount ( @cust_pkg_discount ) {
  83     my $discount = $cust_pkg_discount->discount;
  84     #UI enforces one or the other (for now?  probably for good)
  85     my $amount = 0;
  86     $amount += $discount->amount
  87     if $cust_pkg->pkgpart == $param->{real_pkgpart};
  88     $amount += sprintf('%.2f', $discount->percent * $br / 100 );
  89     my $chg_months = $param->{'months'} || $cust_pkg->part_pkg->freq;
  90
  91     my $months = $discount->months
  92     ? min( $chg_months,
  93       $discount->months - $cust_pkg_discount->months_used )
  94     : $chg_months;
  95
  96     if(defined $param->{'setup_charge'}) {
  97         next unless $discount->setup;
  98
  99         if ( $discount->percent ) {
 100             $amount = sprintf('%.2f', $discount->percent * $param->{'setup_charge'} / 100 );
 101             $months = 1;
 102         }
 103     }
 104
 105     my $error = $cust_pkg_discount->increment_months_used($months)
 106         if ($cust_pkg->pkgpart == $param->{real_pkgpart}
 107             && ! defined $param->{'setup_charge'});
 108     die "error discounting: $error" if $error;
 109
 110     $amount *= $months;
 111     $amount = sprintf('%.2f', $amount);
 112
 113     next unless $amount > 0;
 114
 115     #record details in cust_bill_pkg_discount
 116     my $cust_bill_pkg_discount = new FS::cust_bill_pkg_discount {
 117       'pkgdiscountnum' => $cust_pkg_discount->pkgdiscountnum,
 118       'amount'         => $amount,
 119       'months'         => $months,
 120     };
 121     push @{ $param->{'discounts'} }, $cust_bill_pkg_discount;
 122
 123     #add details on discount to invoice
 124     my $conf = new FS::Conf;
 125     my $money_char = $conf->config('money_char') || '$';
 126     $months = sprintf('%.2f', $months) if $months =~ /\./;
 127
 128     my $d = 'Includes ';
 129     $d .= 'setup ' if defined $param->{'setup_charge'};
 130     $d .= 'discount of '. $discount->description_short;
 131     $d .= " for $months month". ( $months!=1 ? 's' : '' ) unless defined $param->{'setup_charge'};
 132     $d .= ": $money_char$amount" if $months != 1 || $discount->percent;
 133     push @$details, $d;
 134
 135     $tot_discount += $amount;
 136   }
 137
 138   sprintf('%.2f', $tot_discount);
 139 }
 140
 141 1;