6 use FS::Record qw( qsearch qsearchs );
7 use FS::Misc qw( csv_from_fixed );
13 FS::tax_class - Object methods for tax_class records
19 $record = new FS::tax_class \%hash;
20 $record = new FS::tax_class { 'column' => 'value' };
22 $error = $record->insert;
24 $error = $new_record->replace($old_record);
26 $error = $record->delete;
28 $error = $record->check;
32 An FS::tax_class object represents a tax class. FS::tax_class
33 inherits from FS::Record. The following fields are currently supported:
43 Vendor of the tax data
51 Human readable description of the tax class
61 Creates a new tax class. To add the tax class to the database, see L<"insert">.
63 Note that this stores the hash reference, not a distinct copy of the hash it
64 points to. You can ask the object for a copy with the I<hash> method.
68 sub table { 'tax_class'; }
72 Adds this record to the database. If there is an error, returns the error,
73 otherwise returns false.
79 Delete this record from the database.
86 return "Can't delete a tax class which has tax rates!"
87 if qsearch( 'tax_rate', { 'taxclassnum' => $self->taxclassnum } );
89 return "Can't delete a tax class which has package tax rates!"
90 if qsearch( 'part_pkg_taxrate', { 'taxclassnum' => $self->taxclassnum } );
92 return "Can't delete a tax class which has package tax rates!"
93 if qsearch( 'part_pkg_taxrate', { 'taxclassnumtaxed' => $self->taxclassnum } );
95 return "Can't delete a tax class which has package tax overrides!"
96 if qsearch( 'part_pkg_taxoverride', { 'taxclassnum' => $self->taxclassnum } );
98 $self->SUPER::delete(@_);
102 =item replace OLD_RECORD
104 Replaces the OLD_RECORD with this one in the database. If there is an error,
105 returns the error, otherwise returns false.
111 Checks all fields to make sure this is a valid tax class. If there is
112 an error, returns the error, otherwise returns false. Called by the insert
121 $self->ut_numbern('taxclassnum')
122 || $self->ut_text('taxclass')
123 || $self->ut_textn('data_vendor')
124 || $self->ut_textn('description')
126 return $error if $error;
133 Loads part_pkg_taxrate records from an external CSV file. If there is
134 an error, returns the error, otherwise returns false.
139 my ($param, $job) = @_;
141 my $fh = $param->{filehandle};
142 my $format = $param->{'format'};
151 my @column_lengths = ();
152 my @column_callbacks = ();
153 if ( $format eq 'cch-fixed' || $format eq 'cch-fixed-update' ) {
154 $format =~ s/-fixed//;
155 push @column_lengths, qw( 8 10 3 2 2 10 100 );
156 push @column_lengths, 1 if $format eq 'cch-update';
160 my ( $count, $last, $min_sec ) = (0, time, 5); #progressbar
161 if ( $job || scalar(@column_lengths) ) {
162 my $error = csv_from_fixed(\$fh, \$count, \@column_lengths);
163 return $error if $error;
166 if ( $format eq 'cch' || $format eq 'cch-update' ) {
167 @fields = qw( table name pos length number value description );
168 push @fields, 'actionflag' if $format eq 'cch-update';
173 if ($hash->{'table'} eq 'DETAIL') {
174 push @{$data->{'taxcat'}}, [ $hash->{'value'}, $hash->{'description'} ]
175 if ($hash->{'name'} eq 'TAXCAT' &&
176 (!exists($hash->{actionflag}) || $hash->{actionflag} eq 'I') );
178 push @{$data->{'taxtype'}}, [ $hash->{'value'}, $hash->{'description'} ]
179 if ($hash->{'name'} eq 'TAXTYPE' &&
180 (!exists($hash->{actionflag}) || $hash->{actionflag} eq 'I') );
182 if (exists($hash->{actionflag}) && $hash->{actionflag} eq 'D') {
183 my $name = $hash->{'name'};
184 my $value = $hash->{'value'};
185 return "Bad value for $name: $value"
186 unless $value =~ /^\d+$/;
188 if ($name eq 'TAXCAT' || $name eq 'TAXTYPE') {
189 my @tax_class = qsearch( 'tax_class',
190 { 'data_vendor' => 'cch' },
192 "AND taxclass LIKE '".
193 ($name eq 'TAXTYPE' ? $value : '%').":".
194 ($name eq 'TAXCAT' ? $value : '%')."'",
196 foreach (@tax_class) {
197 warn "deleting ". $_->taxclass. ' '. $_->description. "\n";
198 my $error = $_->delete;
199 return $error if $error;
207 for qw( data_vendor table name pos length number value description );
208 delete($hash->{actionflag}) if exists($hash->{actionflag});
216 my $sql = "SELECT DISTINCT ".
217 "substring(taxclass from 1 for position(':' in taxclass)-1),".
218 "substring(description from 1 for position(':' in description)-1) ".
219 "FROM tax_class WHERE data_vendor='cch'";
221 my $sth = $dbh->prepare($sql) or die $dbh->errstr;
222 $sth->execute or die $sth->errstr;
223 my @old_types = @{$sth->fetchall_arrayref};
225 $sql = "SELECT DISTINCT ".
226 "substring(taxclass from position(':' in taxclass)+1),".
227 "substring(description from position(':' in description)+1) ".
228 "FROM tax_class WHERE data_vendor='cch'";
230 $sth = $dbh->prepare($sql) or die $dbh->errstr;
231 $sth->execute or die $sth->errstr;
232 my @old_cats = @{$sth->fetchall_arrayref};
234 my $catcount = exists($data->{'taxcat'}) ? scalar(@{$data->{'taxcat'}})
236 my $typecount = exists($data->{'taxtype'}) ? scalar(@{$data->{'taxtype'}})
239 my $count = scalar(@old_types) * $catcount
240 + $typecount * (scalar(@old_cats) + $catcount);
242 $imported = 1 if $format eq 'cch-update'; #empty file ok
244 foreach my $type (@old_types) {
245 foreach my $cat (@{$data->{'taxcat'}}) {
247 if ( $job ) { # progress bar
248 if ( time - $min_sec > $last ) {
249 my $error = $job->update_statustext(
250 int( 100 * $imported / $count ). ",Importing tax classes"
252 die $error if $error;
257 my %hash = ( 'data_vendor' => 'cch',
258 'taxclass' => $type->[0].':'.$cat->[0],
259 'description' => $type->[1].':'.$cat->[1],
261 unless ( qsearchs('tax_class', \%hash) ) {
262 my $tax_class = new FS::tax_class \%hash;
263 my $error = $tax_class->insert;
265 return "can't insert tax_class for ".
266 " old TAXTYPE ". $type->[0].':'.$type->[1].
267 " and new TAXCAT ". $cat->[0].':'. $cat->[1].
277 foreach my $type (@{$data->{'taxtype'}}) {
278 foreach my $cat (@old_cats, @{$data->{'taxcat'}}) {
280 if ( $job ) { # progress bar
281 if ( time - $min_sec > $last ) {
282 my $error = $job->update_statustext(
283 int( 100 * $imported / $count ). ",Importing tax classes"
285 die $error if $error;
291 new FS::tax_class( { 'data_vendor' => 'cch',
292 'taxclass' => $type->[0].':'.$cat->[0],
293 'description' => $type->[1].':'.$cat->[1],
295 my $error = $tax_class->insert;
296 return "can't insert tax_class for new TAXTYPE $type and TAXCAT $cat: $error" if $error;
304 } elsif ( $format eq 'extended' ) {
305 die "unimplemented\n";
309 die "unknown format $format";
312 eval "use Text::CSV_XS;";
315 my $csv = new Text::CSV_XS;
317 local $SIG{HUP} = 'IGNORE';
318 local $SIG{INT} = 'IGNORE';
319 local $SIG{QUIT} = 'IGNORE';
320 local $SIG{TERM} = 'IGNORE';
321 local $SIG{TSTP} = 'IGNORE';
322 local $SIG{PIPE} = 'IGNORE';
324 my $oldAutoCommit = $FS::UID::AutoCommit;
325 local $FS::UID::AutoCommit = 0;
327 while ( defined($line=<$fh>) ) {
329 if ( $job ) { # progress bar
330 if ( time - $min_sec > $last ) {
331 my $error = $job->update_statustext(
332 int( 100 * $imported / $count ). ",Importing tax classes"
334 die $error if $error;
339 $csv->parse($line) or do {
340 $dbh->rollback if $oldAutoCommit;
341 return "can't parse: ". $csv->error_input();
344 my @columns = $csv->fields();
346 my %tax_class = ( 'data_vendor' => $format );
347 foreach my $field ( @fields ) {
348 $tax_class{$field} = shift @columns;
350 if ( scalar( @columns ) ) {
351 $dbh->rollback if $oldAutoCommit;
352 return "Unexpected trailing columns in line (wrong format?) importing tax_class: $line";
355 my $error = &{$hook}(\%tax_class);
357 $dbh->rollback if $oldAutoCommit;
361 next unless scalar(keys %tax_class);
363 my $tax_class = new FS::tax_class( \%tax_class );
364 $error = $tax_class->insert;
366 $dbh->rollback if $oldAutoCommit;
367 return "can't insert tax_class for $line: $error";
373 my $error = &{$endhook}();
375 $dbh->rollback if $oldAutoCommit;
376 return "can't run end hook: $error";
379 $dbh->commit or die $dbh->errstr if $oldAutoCommit;
381 return "Empty File!" unless ($imported || $format eq 'cch-update');
391 batch_import does not handle mixed I and D records in the same file for
396 L<FS::Record>, schema.html from the base documentation.