Table of Contents

• About Withholding32
• Using Withholding32
  • Visual Basic
  • Visual C++ Dynamic Loading
  • Visual C++ Static Loading
  • Visual C#
  • Linux
• Data Structures
• Public Functions
• Federal Withholding Calculations
• State Withholding Calculations
  • Alabama
  • Arizona
  • Arkansas
  • California
  • Colorado
  • Connecticut
  • District of Columbia
  • Delaware
  • Georgia
  • Hawaii
  • Idaho
  • Illinois
  • Indiana
  • Iowa
  • Kansas
  • Kentucky
  • Louisiana
  • Maine
  • Maryland
  • Massachusetts
  • Michigan
  • Minnesota
  • Mississippi
  • Missouri
  • Montana
  • Nebraska
  • New Jersey
  • New Mexico
  • New York
  • North Carolina
  • North Dakota
  • Ohio
  • Oklahoma
  • Oregon
  • Pennsylvania
  • Puerto Rico
  • Rhode Island
  • South Carolina
  • Utah
  • Vermont
  • Virginia
  • Guam
  • Northern Mariana Islands
  • Virgin Islands
  • West Virginia
  • Wisconsin
• Local Withholding Calculations
  • WH32_Get_Prompt
  • Alabama Local
  • Colorado Local
  • Delaware Local
  • Indiana Local
  • Kentucky Local
  • Maryland Local
  • Michigan Local
  • Missouri Local
  • New York Local
  • Ohio Local
  • Pennsylvania Local
• Canadian Withholding Calculations
• State Disability Insurance Calculations
• Federal Unemployment Calculations
• State Unemployment Calculations
• California EET Calculations
• Oregon Transportation Tax Calculations
• Family Leave Calculations
• Workers Compensation Calculations
• Various state specific calculations
• Gross-Up Calculations
• Error Codes

• Overview
  Withholding 32 allows calculation of Federal, State and Local Payroll Withholding. It also calculates family leave, SUI, SDI, FICA and Medicare Payroll Withholding. Various specialized state taxes are also supported. The Windows version is available as both a 32bit and 64bit Windows DLL and as a Linux Shared Object file.
  
  Functions are provided to return local tax body names and id's to facilitate creating prompts for users to select from.

  Hint: On the Withholding32 webpage go to the tab Samples for actual code!
  The code snippets used throughout this manual are not complete executable programs, but are used only to illustrate particular items. The Withholding32 website has complete packages which can be downloaded.
• Using Withholding32
  
  Many structures are mentioned in this manual. Refer to the wh32.h supplied file for complete descriptions of all structures and #defines.
  • Visual Basic
    In Visual Basic you have to declare each of the Withholding32 functions. Here is an example
    

    Declare Function WH32_Calc Lib "wh32.dll" (ByVal command As Long, ByRef wh As FEDERAL_WITHHOLDING_STRUC, ByRef stwh As STATE_WITHHOLDING_STRUC) As Long
    
    command will be (from wh32.h)
    

    WH32_COMMAND_FEDERAL_ONLY
    WH32_COMMAND_FEDERAL_AND_STATE
    WH32_COMMAND_FEDERAL_EMPLOYER_FICA_MEDICARE
    WH32_COMMAND_GROSSUP_REGULAR
    WH32_COMMAND_GROSSUP_SUPPLEMENTAL
    

    There are a number of other functions you will use. These will be detailed in this manual. Notice the library name "wh32.dll". For this declaration to work the 32bit Withholding32 Library would have to be placed in the same folder as your apps executable.
    
    You will also have to setup various structures used by the Withholding32 program. Here is an example for a 64 bit build
    

    Structure MDATE
    month As Long
    day As Long
    year As Long
    End Type

    
    
    Here is an example for a 32 bit build. Notice that all Long variables have been replaced by Integer.
    

    Structure MDATE
    month As Integer
    day As Integer
    year As Integer
    End Type
  • Visual C++ Dynamic Loading
    With Dynamic Loading you explicitly load the dll at runtime using the LoadLibrary function. Here is an example of what you would do.
    

    INSTANCE hGetProcIDDLL =LoadLibrary(TEXT("wh32.dll"));
    DWORD dw=GetLastError();
    
    FARPROC lpfnGetProcessID3 = GetProcAddress(HMODULE (hGetProcIDDLL),"WH32_Get_Prompt");
    typedef long(__stdcall * pICFUNC3)(WITHHOLDING_TAXBODY_INFO *wt,char * c);
    pICFUNC3 WH32_Get_Prompt;
    WH32_Get_Prompt=pICFUNC3(lpfnGetProcessID3);
    dw=GetLastError();
    
  • Visual C++ Load-time Dynamic Linking
    With Load-time Dynamic Linking you link your program with the .lib file we provide. The .lib file does not contain the actual function code, but only a placeholder for it. This allows you program to compile and link and then the DLL functions will be loaded automatically at run time using the .dll. With this method you must modify your build procedure with these two steps.
    

    1)  In your Projects "Properties/Linker/General/Additional Library Directores" add an entry to point to the location of wh32.lib
    2)  In your Projects "Properties/Linker/Input/Additional Dependencies" add the name wh32.lib
    

    You can then call the DLL functions without the LoadLibrary function call.
    Note that there are two different types of .lib files that Microsoft has defined. The first kind actually contains. the code for the functions and this generally considered 'static'. The second type (which we provide) contains the addresses of functions within the .dll file. So you need both the .lib and .dll files.
  • Visual C#
    (Thanks to John M for this C# info
    
    Created an app in Visual Studio:
    
    using System; using System.Runtime.InteropServices;
    
    namespace PlaygroundNET
    {
    class Program
    {
    static void Main(string[] args)
    {
    GetWH32Version();
    Console.ReadKey();
    }
    [DllImport("wh32.dll")] private static extern double WH32_Table_Version();
    public static void GetWH32Version()
    {
    double Version = WH32_Table_Version();
    Console.WriteLine("Tax Table version is {0}", Version.ToString());
    }
    }
    }
    
    I have the DLL as an embedded resource with the Copy To Output Directory set to Copy Always.
    You can then call the DLL functions without the LoadLibrary function call.
    
  • Linux
    Overview

    Our libraries are created to use AMD/Intel processors and are 64bit.
    
    You, the end user, are responsible for any installation script you might require.
    
    We provide both a dynamic library (libwh32.so) and a static library (libwh32static.a).
    
    The current version number is embedded in each library as a text descriptor. You may use a standard Linux utility (such as strings) to find the version number. The Version Number follows the string 'WH32LIBRARYVERSION_'.

    Using Dynamic Libary
    
    If you elect to use the Dynamic Library your application will be smaller since it loads library functions at runtime. You will then have to distribute the dynamic library with your application. It is likely that your application will be the only user of our shared object library. For this reason you might prefer to keep the file libwh32.so in the same folder as your application.

    Here is a simple example of g++ code to build an app using our shared library

    g++ yourapp.c -oyourappname -L. -lwh32

    
    
    Using Static Libary
    
    If you elect to use the Static Library your application will be larger since it contains the library functions. Therefore you do not have to distribute any of our libraries with your application.

    Here is a simple example of g++ code to build an app using our static shared library

    g++ yourapp.c -oyourappname -L. -lwh32static

    
    

    
    
    
  • Data Structures
    We supply a header file (wh32.h) which provides all data structures required for using C++ to call our functions. Always go to the wh32.h included with the distribution package for the required structures.
    
    However, if you are using Visual Basic you will have to convert the wh32.h structures to the corresponding Visual Basic structures.  Our earlier discussion of Visual Basic shows examples for 32 and 64 bit builds.

    
    
    

    
    
    Other structures referenced in this manual can be found in the included file wh32.h
    
    Note that some structure have an element 'struct_size'. It is required that you fill this in before calling any function which used the structure. The length you put in tells the function which version of the structure you are using.
    
    In Visual Basic you might do this: wh.struct_size = Len(wh)
    
    In C++ you might do this: fedwh.struct_size=sizeof(FEDERAL_WITHHOLDING_STRUC);
  • Public Functions
    What follows is a list of prototypes for all public functions in the Withholding32 DLL. The Prototype shown is for "C++".
    • WH32_Version
      Returns the DLL software version.
      
      C Prototype

      extern "C" double WINAPI WH32_Version(void);

      Visual Basic declaration

      Declare Function WH32_Version Lib "wh32.dll" () As Double
    • WH32_Table_Version
      Returns the tax table version. This will change with every new release.
      
      C Prototype

      extern "C" double WINAPI WH32_Table_Version(void);

      Visual Basic declaration

      Declare Function WH32_Table_Version Lib "wh32.dll" () As Double
    • WH32_Calc
      Calculates Federal and State withholding.
      
      C Prototype

      extern "C" long WINAPI WH32_Calc(long command,struct FEDERAL_WITHHOLDING_STRUC *wh,struct STATE_WITHHOLDING_STRUC *stwh);

      Visual Basic declaration

      Declare Function WH32_Calc Lib "libwh32.dll" (ByVal command As Long, ByRef wh As FEDERAL_WITHHOLDING_STRUC, ByRef stwh As STATE_WITHHOLDING_STRUC) As Long
      
      
      Command for this and other CALC functions will be (from wh32.h)
      

      WH32_COMMAND_FEDERAL_ONLY
      WH32_COMMAND_FEDERAL_AND_STATE
      WH32_COMMAND_FEDERAL_EMPLOYER_FICA_MEDICARE
      WH32_COMMAND_GROSSUP_REGULAR
      WH32_COMMAND_GROSSUP_SUPPLEMENTAL
      
      
      
    • WH32_Calc_Local
      Calculates Federal, State, and Local withholding.
      
      C Prototype

      extern "C" long WINAPI WH32_Calc_Local(long command,struct FEDERAL_WITHHOLDING_STRUC *wh,struct STATE_WITHHOLDING_STRUC *stwh,struct LOCAL_WITHHOLDING_STRUC *localwh);

      Visual Basic declaration

      Declare Function WH32_Calc_Local Lib "libwh32.dll" (ByVal command As Long, ByRef wh As FEDERAL_WITHHOLDING_STRUC, ByRef stwh As STATE_WITHHOLDING_STRUC, ByRef ctwh As LOCAL_WITHHOLDING_STRUC) As Long
    • SDI_Calc
      Returns State disability insurance deduction
      
      C Prototype

      extern "C" long WINAPI SDI_CAlc(struct SDI_WITHHOLDING_STRUC *sdi);
    • FUTA_Calc
      Returns Federal unemployment insurance deduction
      
      C Prototype

      extern "C" long WINAPI FUTA_CAlc(struct FUTA_WITHHOLDING_STRUC *futa);
    • SUI_Calc
      Returns State unemployment insurance deduction
      
      C Prototype

      extern "C" long WINAPI SUI_CAlc(struct ETT_WITHHOLDING_STRUC *sui);
    • ETT_Calc
      Returns California ETT
      
      C Prototype

      extern "C" long WINAPI ETT_CAlc(struct ETT_WITHHOLDING_STRUC *ett);
    • TT_Calc
      Returns Oregon Transportaton Taxes
      
      C Prototype

      extern "C" long WINAPI TT_CAlc(struct TT_WITHHOLDING_STRUC *tt);
    • FAMLEAVE_Calc
      Returns Family Leave Tax
      
      C Prototype

      extern "C" long WINAPI FAMLEAVE_CAlc(struct FAMLEAVE_WITHHOLDING_STRUC *famleave);
    • WH32_Get_Prompt
      Returns information (e.g. names) of local taxing bodies. The structure WITHHOLDING_TAXBODY_INFO is defined in wh32.h
      
      C Prototype

      extern "C" long WINAPI WH32_Get_Prompt(struct WITHHOLDING_TAXBODY_INFO *wt,char * buffer);

      Visual Basic declaration

      Declare Function WH32_Get_Prompt Lib "libwh32.dll" (ByRef id As WITHHOLDING_TAXBODY_ID, ByVal ss As String) As Long

      Structure WITHHOLDING_TAXBODY_ID
      Dim struct_size As Integer
      Dim errorx As Integer
      Dim state As Integer
      Dim muni_type As Integer
      Dim prompt_number As Integer
      Dim desired_entry As Integer
      Dim number_of_entries As Integer
      Dim muni_number As Integer
      Dim calc_number As Integer
      End Structure
      
    • WH32_Canada_Calc
      Calculates Canada Federal and Provincial withholding as-well-as ccp and ei withholding amounts. (Currently does not work for Quebec)
      
      C Prototype

      extern "C" long WH32_Canada_Calc(long command,struct CANADA_FEDERAL_WITHHOLDING_STRUC *wh, CANADA_PROVINCIAL_WITHHOLDING_STRUC *whp);
    • WH32_Canada_Get_CC
      Returns Canada claim code amounts for Federal and Provincial
      C Prototype

      extern "C" long WH32_Canada_Get_CC(long command,struct CANADA_CLAIM_CODE_STRUC *ccs);
  • Federal Withholding Calculations
    All elements of the structure FEDERAL_WITHHOLDING_STRUC must be initialized to 0's or a valid value by the application before calling any of the calculation functions. Here are specific instructions for initializing the FEDERAL_WITHHOLDING_STRUC. Items not listed here are returned by the calculation function – but should be initialized to 0 by application.

    Returned by function

    Element	Source	Description
    struct_size	Your Application
    dummy	Not Used
    federal_error	function returns this
    federal_exemptions	W4	Any integer value
    federal_table_date	Your Application This date is used to pick table for all tax (state and local too) calculations
    federal_table	W4	From wh32.h one of FEDERAL_STATUS_SINGLE FEDERAL_STATUS_MARRIED FEDERAL_STATUS_MARRIED_WITHHOLD_AS_SINGLE
    federal_period	W4	Any Long Integer Value
    federal_taxable_pay	Your application	Double value (you subtract non-taxable pay)
    federal_additional_withholding	W4
    table_used
    federal_withhold_amount	Returned by function	Pay Period Federal Withholding (not including supplemental)
    fica_error	Returned by function	Any error in Social Security calculation (see wh32.h for list)
    fica_exempt	Your application	From wh32.h, Social Security option FEDERAL_FICA_ELIGIBLE or FEDERAL_FICA_EXEMPT
    federal_ficamedicare_pay	Your application	Taxable amount for Social Security and Medicare
    previous_fica_wages_this_year	Your application	Pevious Social Security wages not including this paycheck
    fica_withhold_amount	Returned by function	Social Security withholding for this pay period
    medicare_error	Returned by function	Any error in Medicare calculation (see wh32.h for list)
    medicare_exempt	Your application	From wh32.h, Social Security option FEDERAL_MEDICARE_ELIGIBLE or FEDERAL_MEDICARE_EXEMPT
    previous_medicare_wages_this_year	your application	Not including this pay period
    medicare_withhold_amount	Returned by function	Pay period medicare withholding
    supplemental_amount	your application	Taxable supplemental amount
    ytd_supplemental_amount	your application
    supplemental_calc_type	your application	From wh32.h, FEDERAL_SUPPLEMENTAL_FLAT_CALCULATION or FEDERAL_SUPPLEMENTAL_ADD_TO_SALARY
    supplemental_tax	Returned by function	Pay Period supplemental withholding
    withhold_exempt	your application	From wh32.h FEDERAL_WITHHOLD_ELIGIBLE or FEDERAL_WITHHOLD_EXEMPT
    w4_2020	your application	Set to 1 if employee has 2020 w-4 on file
    w4_2020_step2	2020 W-4	Set to 1 if employee has checked checkbox 2c. This is used to select which one of the 2020 tables the calculation function should use.
    w4_2020_step3	2020 W-4	Value from 2020 W-4 Step 3 line 3.  This is the dependent credit (annual amount) and will be subtracted from the withholding amount by the calculation function.
    w4_2020_step4a	2020 W-4	Value from 2020 W-4 Step 4 Line 4(a).  This is other income (annual amount) and will be added to the taxable income by the calculation function.
    w4_2020_step4b	2020 W-4	Value from 2020 W-4 Step 4 Line 4(b).  this is a deduction (annual amount) and will be subtracted from taxable income by the calculation function.
    		Value from 2020 W-4 Step 4 line 4(c) is passed in the structure member 'federal additional withholding'.  This amount (per pay period) is added to the calculated withholding by the calculation function.
    w4_2020_nra	2020 W-4	Set to 1 if employee has written in nonresident alient.  Calculation function will add an additional amount to the withholding amount.

    You can perform regular and supplemental calculations at the same time.
    
    Note: FICA and Medicare tax will automatically be calculated for supplemental income. Care must be taken in the case where pretax retirement is greater than regular pay and less than supplemental payment. In this situation FICA and Medicare could be calculated incorrectly. The safest thing to do in this situation is to calculate FICA/Medicare in a separate call the the engine and then perform the regular calculation but using the FICA/Medicare amount returned in the first calculation.
    
    Sample Code Snippet
    /*It is assumed that various structures should be completely filled out. We just show significan parts of structure here*/
    struct FEDERAL_WITHHOLDING_STRUC wh;
    struct STATE_WITHHOLDING_STRUC stwh;
    struct LOCAL_WITHHOLDING_STRUC lwh;
    struct FEDERAL_WITHHOLDING_STRUC *whpt;
    struct STATE_WITHHOLDING_STRUC *stwhpt;
    struct LOCAL_WITHHOLDING_STRUC *lwhpt;
    whpt=&wh;
    stwhpt=&stwh;
    long l;
    double fedwh;
    /* various inits of wh go here */
    l=WH32_Calc(0,whpt,stwhpt); // command=0
    fedwh=wh.federal_withhold_amount;
    
    
    
    
  • State Withholding Calculations
    You calculate Federal AND State withholding using the WH32_Calc function. Besides passing the Federal withholding information you must fill out the STATE_WITHHOLDING_STRUC to pass state information. The complete up-to-date structure is in the wh32.h file supplied as part of this package.
    
    All  members of the STATE_WITHHOLDING_STRUC should be initialized before calling a calculation function.  For brevity our sample code snippets will not show all members being initialized.

    
    

    
    
    Sample Code Snippet div class="code"> /*It is assumed that various structures should be completely filled out. We just show significan parts of structure here*/
    struct FEDERAL_WITHHOLDING_STRUC wh;
    struct STATE_WITHHOLDING_STRUC stwh;
    struct LOCAL_WITHHOLDING_STRUC lwh;
    struct FEDERAL_WITHHOLDING_STRUC *whpt;
    struct STATE_WITHHOLDING_STRUC *stwhpt;
    struct LOCAL_WITHHOLDING_STRUC *lwhpt;
    whpt=&wh;
    stwhpt=&stwh;
    long l;
    double fedwh;
    double statewh;
    stwh.state_number=WH32_ALABAMA; /* various inits of wh go here */
    l=WH32_Calc(0,whpt,stwhpt); // command=0
    fedwh=wh.federal_withhold_amount;
    statewh=stwh.state_withhold_amount;
    
    
    
    
    • Alabama

      Element	Source	Description
      state_number	your application	from wh32.h WH32_ALABAMA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_MARRIEDSEPARATE STATE_STATUS_HEADOFHOUSEHOLD
      state_allowances	W4	0 means no personal exemptions, 1 means yes to a personal exemption
      alabama_dependents	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    
    Sample Code Snippet
    /*It is assumed that various structures should be completely filled out. We just show significan parts of structure here*/
    struct FEDERAL_WITHHOLDING_STRUC wh;
    struct STATE_WITHHOLDING_STRUC stwh;
    struct LOCAL_WITHHOLDING_STRUC lwh;
    struct FEDERAL_WITHHOLDING_STRUC *whpt;
    struct STATE_WITHHOLDING_STRUC *stwhpt;
    struct LOCAL_WITHHOLDING_STRUC *lwhpt;
    whpt=&wh;
    stwhpt=&stwh;
    long l;
    double fedwh;
    double statewh;
    /* various inits of wh go here */
    /* we show state specific ones only here.*/
    stwh.state_number=WH32_ALABAMA;
    stwh.state_table=STATE_STATUS_MARRIED;
    stwh.state_allowances=2;
    stwh.alabama_dependents=1;
    stwh.state_additional_withholding=0;
    stwh.supplemental_calc_type=STATE_SUPPLEMENTAL_FLAT_CALCULATION;
    l=WH32_Calc(0,whpt,stwhpt); // command=0
    fedwh=wh.federal_withhold_amount;
    statewh=stwh.state_withhold_amount;
    
    
    
    
    • Arizona

      Element	Source	Description
      state_number	your application	from wh32.h WH32_ARIZONA
      arizona_withhold_percentage	W4
      state_additional_withholding	W4

    • Arkansas

      Element	Source	Description
      state_number	your application	from wh32.h WH32_ARKANSAS
      state_table	not used
      state_allowances	W4
      state_additional_withholding	W4

    • California

      Element	Source	Description
      state_number	your application	from wh32.h WH32_CALIFORNIA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD
      state_allowances	W4
      california_estimated_deductions	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY
      supplemental_tax_type	Your application	STATE_SUPPLEMENTAL_CA_BONUS_STOCK STATE_SUPPLEMENTAL_CA_OTHER

    • Colorado

      Element	Source	Description
      state_number	your application	from wh32.h WH32_COLORADO
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED
      stw4l1	W4	Set to 1 if new W4 filled out, 0 else
      stw4l2	W4	Set to 1 if new W4 has value(can be $0) in Line 2, 0 else
      stw4d2	W4	Value entered on line 2 of new W4 by employee
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY
      stw4l1	This value is ignored for year 2019. For 2020 or greater it should be set to 1 to tell the calculation function to use the new Colorado table(which doesn't use allowances). Setting to 0 will result in old table being used. Employer has some latitude here but generally you would set to 1.
      employer_amount	For Colorado this is employer aount of occupational tax for this paycheck

    • Connecticut

      Element	Source	Description
      state_number	your application	from wh32.h WH32_CONNECTICUT
      connecticut_filing_status	W4	Ascii value for 'A', 'B', 'C', 'D', 'F'
      connecticut_reductional_amount	W4	Double value
      state_additional_withholding	W4

    • District of Columbia

      Element	Source	Description
      state_number	your application	from wh32.h WH32_DISTRICTOFCOLUMBIA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIEDSEPARATE STATE_STATUS_HEADOFHOUSEHOLD
      state_allowances	W4
      state_additional_withholding	W4

    • Delaware

      Element	Source	Description
      state_number	your application	from wh32.h WH32_DELAWARE
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIEDSEPARATE
      state_allowances	W4
      state_additional_withholding	W4

    • Georgia

      Element	Source	Description
      state_number	your application	from wh32.h WH32_GEORGIA
      state_table	G-4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED_ONE_WORKING STATE_STATUS_MARRIED_BOTH_WORKING STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIEDSEPARATE
      state_allowances	G-4	not used on/after 2024
      georgia_dependents	G-4	This is sum of G-4 lines 4 and 5
      state_additional_withholding	G-4

    • Hawaii

      Element	Source	Description
      state_number	your application	from wh32.h WH32_HAWAII
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIED_WITHHOLD_SINGLE (version 2020.6) STATE_STATUS_CERTIFIED_DISABLED (version 2020.6) STATE_STATUS_NONRESIDENT_MILITARY_SPOUSE (version 2020.6)
      state_allowances	W4
      state_additional_withholding	W4

    • Idaho

      Element	Source	Description
      state_number	your application	from wh32.h WH32_IDAHO
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_MARRIED_WITHHOLD_SINGLE (version 2020.6)
      state_allowances	For 2018 this is number elegible for child tax credit on Federal W-4 Line 5.
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Illinois

      Element	Source	Description
      state_number	your application	from wh32.h WH32_ILLINOIS
      state_allowances	W4
      illinois_additional_allowances	W4
      state_additional_withholding	W4

    • Indiana
      As of Sept 15, 2023(program version 3.50) two additional fields must be passed: 1) Number of first time dependents and 2) Year of most recent W4-filing. If Year of most recent W4 filing is 0 calculation routine will set to year of calculation.

      Element	Source	Description
      state_number	your application	from wh32.h WH32_INDIANA
      state_allowances	W4
      indiana_dependents	W4	Number of Claimed Dependents (This is all dependents until Oct 1, 2022)
      stw4l2	W4	As of Sept 15, 2023 this is number of First Time Dependents
      stw4l3	W4	Year of most recent W4 Filing
      stw4l1	W4	As of Oct 1, 2022 this is number of claimed ADOPTED dependents
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Iowa
      stw4l2

      Element	Source	Description
      state_number	your application	from wh32.h WH32_IOWA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE(only for IA W-4 pre 2024) STATE_STATUS_MARRIED(only for IA W-4 pre 2024) STATE_STATUS_OTHER(2024 or later IA W-4) STATE_STATUS_HEADOFHOUSEHOLD(2024 or later IA W-4) STATE_STATUS_MARRIED_FILING_JOINT(2024 or later IA W-4)
      stw4l1	W4	1 if IA W-4 2024 (or later) filed by employee>
      W4	1 if spouse has earned income W-4 2024 (or later) filed by employee>
      stw4d1	W4	For 2024 or later this is Allowance dollar amount
      state_allowances	W4	For 2023 or earlier this is number of state allowances
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Kansas

      Element	Source	Description
      state_number	your application	from wh32.h WH32_KANSAS
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Kentucky

      Element	Source	Description
      state_number	your application	from wh32.h WH32_KENTUCKY
      state_additional_withholding	W4

    • Louisiana

      Element	Source	Description
      state_number	your application	from wh32.h WH32_LOUISIANA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_NOEXEMPTION
      state_allowances	W4
      louisiana_dependents	W4
      state_additional_withholding	W4

    • Maine

      Element	Source	Description
      state_number	your application	from wh32.h WH32_MAINE
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_MARRIED_WITHHOLD_SINGLE (version 2020.6)
      state_allowances	W4	0 means no personal exemptions, 1 means yes to a personal exemption
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Maryland

      Element	Source	Description
      state_number	your application	from wh32.h WH32_MARYLAND
      state_table	W4	STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE-STATUS_MARRIED_WITHHOLD_SINGLE
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Massachusetts

      Element	Source	Description
      state_number	your application	from wh32.h WH32_MASSACHUSETTS
      state_allowances	W4
      massachusetts_blind	W4
      special_)field_1	W4	0 = use per pay period maximum fica deduction(default) 2 = use cummulative fica payments for maximum fica deduction
      previous_fica_wages		If special_field_1 equals 2 then uses this field to calculate maximum fica deduction
      massachusetts_spouse_blind		0 = no Spouse blind exemptions 1 = Spouse blind exemptions
      massachusetts_student		0 = no Student exemptions 1 = Student exemptions
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Michigan

      Element	Source	Description
      state_number	your application	from wh32.h WH32_MICHIGAN
      state_allowances	W4
      michigan_special_exemptions	W4
      michigan_claim_as_dependent	W4
      state_additional_withholding	W4

    • Minnesota

      Element	Source	Description
      state_number	your application	from wh32.h WH32_MINNESOTA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_MARRIED_WITHHOLD_SINGLE (2020.6)
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Mississippi

      Element	Source	Description
      state_number	your application	from wh32.h WH32_MISSISSIPPI
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIED_BOTH_WORKING
      mississippi_exemption_amount	W4	Any Double Value
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Missouri

      Element	Source	Description
      state_number	your application	from wh32.h WH32_MISSOURI
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIED_BOTH_WORKING STATE_STATUS_MARRIEDSEPARATE
      special_field_2	W4	state reductional amount (set by employee on w4 to override withholding)
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Montana

      Element	Source	Description
      state_number	your application	from wh32.h WH32_MONTANA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_QUALIFYINGWIDOWER STATE_STATUS_MARRIED_ONE_WORKING STATE_STATUS_HEADOFHOUSEHOLD
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY
      special_field_2	W4 (2024 or later)	Exact Withholding amount set by employee

    • Nebraska

      Element	Source	Description
      state_number	your application	from wh32.h WH32_NEBRASKA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED
      state_allowances	W4	0 means no personal exemptions, 1 means yes to a personal exemption
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • New Jersey

      Element	Source	Description
      state_number	your application	from wh32.h WH32_NEWJERSEY
      newjersey_table	W4	from wh32.h; ASCII value State Table A = 0x41 State Table B = 0x42 State Table C = 0x43 State Table D = 0x44 State Table E = 0x45 (any other value here will force use of the status in state_table)
      state_table	W4	Function uses this if element 'state_table' is blank STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_MARRIED_FILING_SINGLE STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_QUALIFYINGWIDOWER
      state_allowances	W4	0 means no personal exemptions, 1 means yes to a personal exemption
      alabama_dependents	W4
      state_additional_withholding	W4

    • New Mexico

      Element	Source	Description
      state_number	your application	from wh32.h WH32_NEWMEXICO
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIED_WITHHOLD_SINGLE (version 2020.6)
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • New York

      Element	Source	Description
      state_number	your application	from wh32.h WH32_NEWYORK
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIED_WITHHOLD_SINGLE (version 2020.6)
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • North Carolina

      Element	Source	Description
      state_number	your application	from wh32.h WH32_NORTHCAROLINA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_QUALIFYINGWIDOWER
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • North Dakota

      Element	Source	Description
      state_number	your application	from wh32.h WH32_NORTHDAKOTA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD (version 2020.6) STATE_STATUS_MARRIED_WITHHOLD_SINGLE (version 2020.6)
      state_allowances	W4	0 means no personal exemptions, 1 means yes to a personal exemption. This is not used if employee was hired on/after January 1, 2020 or was hired before that date but has filed the new 2020 W-4.
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY
      stw4l1	Your application	Set to 1 if employee has submitted 2020 or later W-4 OR is a new Employee. This check is used to determine table to use.
      stw4d1	2020 or later W-4	Extra Income employee may enter to adjust withholding
      stw4d2	2020 or later W-4	Extra Deductions employee may enter to adjust withholding

    • Ohio

      Element	Source	Description
      state_number	your application	from wh32.h WH32_Ohio
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Oklahoma

      Element	Source	Description
      state_number	your application	from wh32.h WH32_OKLAHOMA
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_HEADOFHOUSEHOLD STATE_STATUS_MARRIED_WITHHOLD_SINGLE (version 2020.6)
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Oregon

      Element	Source	Description
      state_number	your application	from wh32.h WH32_OREGON
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_MARRIED_FILING_SINGLE
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Pennsylvania

      Element	Source	Description
      state_number	your application	from wh32.h WH32_PENNSYLVANIA
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Puerto Rico

      Element	Source	Description
      state_number	your application	from wh32.h WH32_PUERTORICO
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Rhode Island

      Element	Source	Description
      state_number	your application	from wh32.h WH32_RHODEISLAND
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • South Carolina

      Element	Source	Description
      state_number	your application	from wh32.h WH32_SOUTHCAROLINA
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Utah

      Element	Source	Description
      state_number	your application	from wh32.h WH32_UTAH
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED
      state_additional_withholding	W4

    • Vermont

      Element	Source	Description
      state_number	your application	from wh32.h WH32_VERMONT
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED STATE_STATUS_MARRIED_FILING_SINGLE
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Virginia

      Element	Source	Description
      state_number	your application	from wh32.h WH32_VIRGINIA
      state_allowances	W4
      special_field_1	W4	Number of over age 64 or blind allowances
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Guam
      Guam mirrors the Federal Tax. Be sure to fill in all Federal Structures listed below.
      

      Element	Source	Description
      state_number	your application	from wh32.h WH32_VIRGINISLANDS
      federal_exemptions	W4	Any integer value
      federal_table	W4	From wh32.h one of FEDERAL_STATUS_SINGLE FEDERAL_STATUS_MARRIED FEDERAL_STATUS_MARRIED_WITHHOLD_AS_SINGLE
      federal_period	W4	Any Long Integer Value
      w4_2020	your application	Set to 1 if employee has 2020 w-4 on file
      w4_2020_step2	2020 W-4	Set to 1 if employee has checked checkbox 2c. This is used to select which one of the 2020 tables the calculation function should use.
      w4_2020_step3	2020 W-4	Value from 2020 W-4 Step 3 line 3.  This is the dependent credit (annual amount) and will be subtracted from the withholding amount by the calculation function.
      w4_2020_step4a	2020 W-4	Value from 2020 W-4 Step 4 Line 4(a).  This is other income (annual amount) and will be added to the taxable income by the calculation function.
      w4_2020_step4b	2020 W-4	Value from 2020 W-4 Step 4 Line 4(b).  this is a deduction (annual amount) and will be subtracted from taxable income by the calculation function.
      		Value from 2020 W-4 Step 4 line 4(c) is passed in the structure member 'federal additional withholding'.  This amount (per pay period) is added to the calculated withholding by the calculation function.
      w4_2020_nra	2020 W-4	Set to 1 if employee has written in nonresident alient.  Calculation function will add an additional amount to the withholding amount.
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY
      state_withhold_amount	Calculation Function

    • Northern Mariana Islands
      Northern Mariana Islands has two taxes, Chapter 2 and Chapter 7. Chapter 2(also called the Wage & Salary Tax) is calculated from it's own table. Chapter 7 is a mirror of the Federal tax with modifications. We return both taxes. Be sure to fill in all Federal Structures listed below.
      

      Element	Source	Description
      state_number	your application	from wh32.h WH32_VIRGINISLANDS
      federal_exemptions	W4	Any integer value
      federal_table	W4	From wh32.h one of FEDERAL_STATUS_SINGLE FEDERAL_STATUS_MARRIED FEDERAL_STATUS_MARRIED_WITHHOLD_AS_SINGLE
      federal_period	W4	Any Long Integer Value
      w4_2020	your application	Set to 1 if employee has 2020 w-4 on file
      w4_2020_step2	2020 W-4	Set to 1 if employee has checked checkbox 2c. This is used to select which one of the 2020 tables the calculation function should use.
      w4_2020_step3	2020 W-4	Value from 2020 W-4 Step 3 line 3.  This is the dependent credit (annual amount) and will be subtracted from the withholding amount by the calculation function.
      w4_2020_step4a	2020 W-4	Value from 2020 W-4 Step 4 Line 4(a).  This is other income (annual amount) and will be added to the taxable income by the calculation function.
      w4_2020_step4b	2020 W-4	Value from 2020 W-4 Step 4 Line 4(b).  this is a deduction (annual amount) and will be subtracted from taxable income by the calculation function.
      		Value from 2020 W-4 Step 4 line 4(c) is passed in the structure member 'federal additional withholding'.  This amount (per pay period) is added to the calculated withholding by the calculation function.
      w4_2020_nra	2020 W-4	Set to 1 if employee has written in nonresident alient.  Calculation function will add an additional amount to the withholding amount.
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY
      state_withhold_amount	Calculation Function	Chapter 7 withhold amount
      stw4d1 (chapter 2 withhold amount)	Calculation Function	chapter 2 withhold amount

    • Virgin Islands
      Virgin Islands mirrors the Federal Tax. Be sure to fill in all Federal Structures listed below. Effective with version 2025.14 the state inputs are not used.
      

      Element	Source	Description
      state_number	your application	from wh32.h WH32_VIRGINISLANDS
      federal_exemptions	W4	Any integer value
      federal_table	W4	From wh32.h one of FEDERAL_STATUS_SINGLE FEDERAL_STATUS_MARRIED FEDERAL_STATUS_MARRIED_WITHHOLD_AS_SINGLE
      federal_period	W4	Any Long Integer Value
      w4_2020	your application	Set to 1 if employee has 2020 w-4 on file
      w4_2020_step2	2020 W-4	Set to 1 if employee has checked checkbox 2c. This is used to select which one of the 2020 tables the calculation function should use.
      w4_2020_step3	2020 W-4	Value from 2020 W-4 Step 3 line 3.  This is the dependent credit (annual amount) and will be subtracted from the withholding amount by the calculation function.
      w4_2020_step4a	2020 W-4	Value from 2020 W-4 Step 4 Line 4(a).  This is other income (annual amount) and will be added to the taxable income by the calculation function.
      w4_2020_step4b	2020 W-4	Value from 2020 W-4 Step 4 Line 4(b).  this is a deduction (annual amount) and will be subtracted from taxable income by the calculation function.
      		Value from 2020 W-4 Step 4 line 4(c) is passed in the structure member 'federal additional withholding'.  This amount (per pay period) is added to the calculated withholding by the calculation function.
      w4_2020_nra	2020 W-4	Set to 1 if employee has written in nonresident alient.  Calculation function will add an additional amount to the withholding amount.
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY
      state_withhold_amount	Calculation Function

    • West Virginia

      Element	Source	Description
      state_number	your application	from wh32.h WH32_WESTVIRGINIA
      state_allowances	W4
      state_special_1	W4	0=Withhold at Low Rate 1=Withhold at Regular Rate
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY

    • Wisconsin

      Element	Source	Description
      state_number	your application	from wh32.h WH32_WISCONSIN
      state_table	W4	from wh32.h STATE_STATUS_SINGLE STATE_STATUS_MARRIED
      state_allowances	W4
      state_additional_withholding	W4
      supplemental_calc_type	Your application	STATE_SUPPLEMENTAL_FLAT_CALCULATION STATE_SUPPLEMENTAL_ADD_TO_SALARY