Alabama

Alabama

Use this endpoint to submit Alabama's Form A-3 reconciliation details along with your W-2 filing. You can provide these parameters in the Object StateReconData while using the Create or Update endpoints of W-2, if applicable.

Note: Since Alabama requires the reconciliation to be filed together with the W-2 submission, this data must be included whenever state filing is enabled for Alabama, or the filing will not go through.

Request Body

Field	Type	Description
AL	Object	Alabama state recon details.
FormA3	Object	Contains Alabama Recon Form A-3 details.
AccountNumber	String	Alabama state withholding ID number. Allowed values "0000123456", "R007999999"
NumberOf1099W2	Int	Total number of W-2 & 1099.
IncomeTaxWithheldAndRemitt	Object[]	Must Have Tool Feature 1099 Transactions Recipients List.
Month	String	Alabama state withholding ID number. Allowed values "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
TaxWithheld	Number	Alabama tax withheld for the month. Size Range: 0-999999999.99
TaxPaid	Number	Alabama tax remitted for the month. Size Range: 0-999999999.99
PaymentDetails	Object	Contains Alabama payment details.
TotTaxRemitt	Number	Total Alabama tax remited. Size Range: 0-999999999.99
TotalTaxWithheld1099W2	Number	Total Alabama tax withheld. Size Range: 0-999999999.99
TotalTaxDue	Number	Enter Tax Due if total tax withheld is more than total tax remitted. Size Range: 0-999999999.99
TotalOverpayment	Number	Enter Overpayment if total tax remitted is more than total tax withheld. Size Range: 0-999999999.99
OverPaymentType	String	Overpayment recovery type, whether to refund the excess amount or apply it as a credit for the next return. If the overpayment is less than $100 overpayment recovery type should be "Credit". Allowed values "Refund", "Credit"
PaymentMethod	String	Payment method to pay the balance due. Allowed values "EFT_DEBIT", "EFT_CREDIT"
IsInternationalACHTxn	Boolean	When TRUE, it identifies that it is a ACH Transactions.
EFTDebitInfo	Object	Contains payment source info if the payment method is EFT Debit.
BankAccountType	String	Bank account type. Allowed values "Checking", "Savings"
BankAccountNumber	Int	Bank account number. Size Range: 0-18
BankRoutingNumber	Int	Bank routing number. Size Range: 0-9
PaymentDate	String	Enter the date on which the payment should be debited. Size Range: 10
FundingSource	Object	Contains the information on whether or not an EFT payment is an International ACH Transaction (IAT), when the payment method is EFT Debit.
Address	String	Employer/Payer's address (street address or post office box of that locality) Size Range: ..35
City	String	Employer/Payer's city. Size Range: ..27
State	String	Employer/Payer's state code. Refer Static values. Size Range: 2 Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"
ZipCd	String	Employer/Payer's zip code.
ZipExtn	String	Employer/Payer's zip code Extension.

Payload

Request JSON

Sample	Description	Action
Sample 1	Provides a standalone Alabama state reconciliation payload using Form A-3 details only.
Sample 2	Provides a complete Form W-2 create payload together with Alabama state reconciliation details in `StateReconData`.

Request JSON (Sample -01 (Alabama State Recon Payload))

{
  "AL": {
    "FormA3": {
      "AccountNumber": "0000123456",
      "NumberOf1099W2": 23,
      "IncomeTaxWithheldAndRemitt": [
        {
          "Month": "Jan",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "Feb",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "Mar",
          "TaxWithheld": 200,
          "TaxPaid": 200
        },
        {
          "Month": "Apr",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "May",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "Jun",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "Jul",
          "TaxWithheld": 200,
          "TaxPaid": 200
        },
        {
          "Month": "Aug",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "Sep",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "Oct",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "Nov",
          "TaxWithheld": 200,
          "TaxPaid": 100
        },
        {
          "Month": "Dec",
          "TaxWithheld": 200,
          "TaxPaid": 100
        }
      ],
      "PaymentDetails": {
        "TotTaxRemitt": 1400,
        "TotalTaxWithheld1099W2": 2400,
        "TotalTaxDue": 1000,
        "TotalOverpayment": 0,
        "OverPaymentType": null,
        "PaymentMethod": "EFT_DEBIT",
        "IsInternationalACHTxn": true,
        "EFTDebitInfo": {
          "BankAccountType": "Checking",
          "BankAccountNumber": "326554215487545123",
          "BankRoutingNumber": "983265858",
          "PaymentDate": "01/12/2024",
          "FundingSource": {
            "Address": "123 Main Road",
            "City": "Doltan",
            "State": "AL",
            "ZipCd": "12345",
            "ZipExtn": "2334"
          }
        }
      }
    }
  }
}