TimeTrex/classes/GovernmentForms/country/us/940sa.class.php

821 lines
19 KiB
PHP
Raw Permalink Normal View History

2022-12-13 07:10:06 +01:00
<?php
/*********************************************************************************
*
* TimeTrex is a Workforce Management program developed by
* TimeTrex Software Inc. Copyright (C) 2003 - 2021 TimeTrex Software Inc.
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU Affero General Public License version 3 as published by
* the Free Software Foundation with the addition of the following permission
* added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
* WORK IN WHICH THE COPYRIGHT IS OWNED BY TIMETREX, TIMETREX DISCLAIMS THE
* WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
* details.
*
*
* You should have received a copy of the GNU Affero General Public License along
* with this program; if not, see http://www.gnu.org/licenses or write to the Free
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301 USA.
*
*
* You can contact TimeTrex headquarters at Unit 22 - 2475 Dobbin Rd. Suite
* #292 West Kelowna, BC V4T 2E9, Canada or at email address info@timetrex.com.
*
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
*
* In accordance with Section 7(b) of the GNU Affero General Public License
* version 3, these Appropriate Legal Notices must retain the display of the
* "Powered by TimeTrex" logo. If the display of the logo is not reasonably
* feasible for technical reasons, the Appropriate Legal Notices must display
* the words "Powered by TimeTrex".
*
********************************************************************************/
include_once( 'US.class.php' );
/**
* @package GovernmentForms
*/
class GovernmentForms_US_940SA extends GovernmentForms_US {
public $pdf_template = '940sa.pdf';
public $credit_reduction_rates = [ 'VI' => 0.024 ]; //Tax Year: 2018
//public $credit_reduction_rates = array( 'CA' => 0.021, 'VI' => 0.021 ); //Tax Year: 2017
public function getTemplateSchema( $name = null ) {
$template_schema = [
//Initialize page1, replace years on template.
[
'page' => 1,
'template_page' => 1,
'value' => $this->year,
'on_background' => true,
'coordinates' => [
'x' => 233.5,
'y' => 30,
'h' => 28,
'w' => 40,
'halign' => 'C',
'fill_color' => [ 255, 255, 255 ],
],
'font' => [
'size' => 16,
'type' => 'B',
],
],
[
'value' => $this->year, //Page Footer
'on_background' => true,
'coordinates' => [
'x' => 559,
'y' => 746,
'h' => 11,
'w' => 18,
'halign' => 'C',
'fill_color' => [ 255, 255, 255 ],
],
'font' => [
'size' => 7,
],
],
//Finish initializing page 1.
'ein' => [
'page' => 1,
'template_page' => 1,
'function' => [ 'prefilter' => [ 'stripNonNumeric', 'isNumeric' ], 'draw' => 'drawChars' ], //custom drawing function.
'coordinates' => [
[
'type' => 'static', //static or relative
'x' => 181,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
[
'x' => 206,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
[
'x' => 244,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
[
'x' => 269,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
[
'x' => 294,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
[
'x' => 320,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
[
'x' => 344,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
[
'x' => 369,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
[
'x' => 395,
'y' => 97,
'h' => 17,
'w' => 19,
'halign' => 'C',
],
],
'font' => [
'size' => 12,
'type' => 'B',
],
],
'name' => [
'coordinates' => [
'x' => 136,
'y' => 119,
'h' => 18,
'w' => 246,
'halign' => 'L',
],
],
'state_amounts' => [
'function' => [ 'calc' => 'calcStateCheckBoxes', 'draw' => [ 'drawSplitDecimalFloatGrid' ] ], //Calculate the state checkboxes as early as possible, otherwise the below state_checkboxes variable won't exist and it can't be calculated at that point.
'coordinates' => [
//Column 1
//'CA' => [
// [
// 'x' => 89,
// 'y' => 301,
// 'h' => 14,
// 'w' => 66,
// 'halign' => 'R',
// ],
// [
// 'x' => 157,
// 'y' => 301,
// 'h' => 14,
// 'w' => 15,
// 'halign' => 'C',
// ],
//],
////Column 2
//'NY' => [ //Used for unit tests
// [
// 'x' => 361,
// 'y' => 357,
// 'h' => 14,
// 'w' => 66,
// 'halign' => 'R',
// ],
// [
// 'x' => 430,
// 'y' => 357,
// 'h' => 14,
// 'w' => 15,
// 'halign' => 'C',
// ],
//],
'VI' => [
[
'x' => 361,
'y' => 679,
'h' => 14,
'w' => 66,
'halign' => 'R',
],
[
'x' => 430,
'y' => 679,
'h' => 14,
'w' => 15,
'halign' => 'C',
],
],
],
],
'state_credit_reduction_rate' => [
'function' => [ 'calc' => 'calcStateCreditReductionRate', 'draw' => [ 'drawNormalGrid' ] ],
'coordinates' => [
//Column 1
// 'CA' => array(
// ),
//Column 2
'VI' => [
'x' => 420,
'y' => 679,
'h' => 14,
'w' => 66,
'halign' => 'R',
],
],
],
'state_credit_reduction' => [
'function' => [ 'calc' => 'calcStateCreditReduction', 'draw' => [ 'drawSplitDecimalFloatGrid' ] ],
'coordinates' => [
//Column 1
'CA' => [
[
'x' => 219, //189
'y' => 301,
'h' => 14,
'w' => 66,
'halign' => 'R',
],
[
'x' => 287,
'y' => 301,
'h' => 14,
'w' => 15,
'halign' => 'C',
],
],
//Column 2
'NY' => [ //Used for unit tests.
[
'x' => 491,
'y' => 357,
'h' => 14,
'w' => 66,
'halign' => 'R',
],
[
'x' => 560,
'y' => 357,
'h' => 14,
'w' => 15,
'halign' => 'C',
],
],
'VI' => [
[
'x' => 491,
'y' => 679,
'h' => 14,
'w' => 66,
'halign' => 'R',
],
[
'x' => 560,
'y' => 679,
'h' => 14,
'w' => 15,
'halign' => 'C',
],
],
],
],
'state_checkboxes' => [
'function' => [ 'draw' => 'drawCheckBox' ],
'coordinates' => [
//State codes must be lower case.
//Column 1
'ak' => [
'x' => 40,
'y' => 230,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'al' => [
'x' => 40,
'y' => 249,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ar' => [
'x' => 40,
'y' => 267,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'az' => [
'x' => 40,
'y' => 285,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ca' => [
'x' => 40,
'y' => 303,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'co' => [
'x' => 40,
'y' => 321,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ct' => [
'x' => 40,
'y' => 339,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'dc' => [
'x' => 40,
'y' => 357,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'de' => [
'x' => 40,
'y' => 375,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'fl' => [
'x' => 40,
'y' => 393,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ga' => [
'x' => 40,
'y' => 411,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'hi' => [
'x' => 40,
'y' => 429,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ia' => [
'x' => 40,
'y' => 447,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'id' => [
'x' => 40,
'y' => 465,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'il' => [
'x' => 40,
'y' => 483,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'in' => [
'x' => 40,
'y' => 501,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ks' => [
'x' => 40,
'y' => 519,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ky' => [
'x' => 40,
'y' => 537,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'la' => [
'x' => 40,
'y' => 555,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ma' => [
'x' => 40,
'y' => 573,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'md' => [
'x' => 40,
'y' => 591,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'me' => [
'x' => 40,
'y' => 609,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'mi' => [
'x' => 40,
'y' => 627,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'mn' => [
'x' => 40,
'y' => 645,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'mo' => [
'x' => 40,
'y' => 663,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ms' => [
'x' => 40,
'y' => 681,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'mt' => [
'x' => 40,
'y' => 699,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
//Column 2
'nc' => [
'x' => 306,
'y' => 230,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'nd' => [
'x' => 306,
'y' => 249,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ne' => [
'x' => 306,
'y' => 267,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'nh' => [
'x' => 306,
'y' => 285,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'nj' => [
'x' => 306,
'y' => 303,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'nm' => [
'x' => 306,
'y' => 321,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'nv' => [
'x' => 306,
'y' => 339,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ny' => [
'x' => 306,
'y' => 357,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'oh' => [
'x' => 306,
'y' => 375,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ok' => [
'x' => 306,
'y' => 393,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'or' => [
'x' => 306,
'y' => 411,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'pa' => [
'x' => 306,
'y' => 429,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ri' => [
'x' => 306,
'y' => 447,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'sc' => [
'x' => 306,
'y' => 465,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'sd' => [
'x' => 306,
'y' => 483,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'tn' => [
'x' => 306,
'y' => 501,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'tx' => [
'x' => 306,
'y' => 519,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'ut' => [
'x' => 306,
'y' => 537,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'va' => [
'x' => 306,
'y' => 555,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'vt' => [
'x' => 306,
'y' => 573,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'wa' => [
'x' => 306,
'y' => 591,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'wi' => [
'x' => 306,
'y' => 609,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'wv' => [
'x' => 306,
'y' => 627,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'wy' => [
'x' => 306,
'y' => 645,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'pr' => [
'x' => 306,
'y' => 663,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
'vi' => [
'x' => 306,
'y' => 681,
'h' => 12,
'w' => 13,
'halign' => 'C',
],
],
'font' => [
'size' => 10,
'type' => 'B',
],
],
'total' => [
'function' => [ 'calc' => 'calcTotal', 'draw' => [ 'drawSplitDecimalFloat' ] ],
'coordinates' => [
[
'x' => 455,
'y' => 722,
'h' => 14,
'w' => 95,
'halign' => 'R',
],
[
'x' => 553,
'y' => 722,
'h' => 14,
'w' => 20,
'halign' => 'C',
],
],
],
];
if ( isset( $template_schema[$name] ) ) {
return $name;
} else {
return $template_schema;
}
}
function calcStateCheckBoxes() {
if ( is_array( $this->state_amounts ) ) {
foreach ( $this->state_amounts as $state => $amount ) {
if ( $amount > 0 ) {
$state_checkboxes[] = strtolower( $state ); //strtolower is required for handling checkboxes.
}
}
$this->state_checkboxes = $state_checkboxes;
}
return $this->state_amounts; //Must return $state_amounts, *not* the state_checkboxes, otherwise FUTA taxable wages won't be printed.
}
function calcStateCreditReductionRate() {
$state_credit_reduction_rate = [];
if ( isset( $this->state_amounts ) && is_array( $this->state_amounts ) ) {
foreach ( $this->state_amounts as $state => $amount ) {
if ( isset( $this->credit_reduction_rates[$state] ) ) {
$state_credit_reduction_rate[$state] = $this->credit_reduction_rates[$state];
}
}
$this->state_credit_reduction_rate = $state_credit_reduction_rate;
}
return $this->state_credit_reduction_rate;
}
function calcStateCreditReduction() {
$state_credit_reduction = [];
if ( isset( $this->state_amounts ) && is_array( $this->state_amounts ) ) {
foreach ( $this->state_amounts as $state => $amount ) {
if ( isset( $this->credit_reduction_rates[$state] ) ) {
$state_credit_reduction[$state] = round( bcmul( $amount, $this->credit_reduction_rates[$state] ), 2 );
}
}
$this->state_credit_reduction = $state_credit_reduction;
}
Debug::Arr( $this->state_credit_reduction, 'Form 940SA State Credit Reduction Amounts: ', __FILE__, __LINE__, __METHOD__, 10 );
return $this->state_credit_reduction;
}
function calcTotal() {
$this->calcStateCreditReduction(); //Make sure state credit reduction is calculated first.
$this->total = 0;
if ( isset( $this->state_credit_reduction ) && is_array( $this->state_credit_reduction ) ) {
foreach ( $this->state_credit_reduction as $state => $amount ) {
$this->total = bcadd( $this->total, $amount );
}
}
$this->total = round( $this->total, 2 );
Debug::Text( 'Form 940SA Total: ' . $this->total, __FILE__, __LINE__, __METHOD__, 10 );
return $this->total;
}
function _outputPDF( $type ) {
//Initialize PDF with template.
$pdf = $this->getPDFObject();
if ( $this->getShowBackground() == true ) {
$pdf->setSourceFile( $this->getTemplateDirectory() . DIRECTORY_SEPARATOR . $this->pdf_template );
$this->template_index[1] = $pdf->ImportPage( 1 );
}
if ( $this->year == '' ) {
$this->year = $this->getYear();
}
//Get location map, start looping over each variable and drawing
$template_schema = $this->getTemplateSchema();
if ( is_array( $template_schema ) ) {
$template_page = null;
foreach ( $template_schema as $field => $schema ) {
$this->Draw( $this->$field, $schema );
}
}
return true;
}
}
?>