Tax codes, tax groups, and posting definitions [AX 2012]

Updated: September 12, 2014

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2

This topic answers questions you might have when you work with tax codes and tax groups, and when you use tax groups together with posting definitions. Tax groups let you designate transaction posting definitions for multiple tax codes at the same time. If you use tax groups to do this and you’re not getting the posting results that you want, the questions in this topic can help you resolve the issues.

This topic describes functionality that is available only if the Payroll - USA configuration key is selected.


This topic does not apply to versions of Microsoft Dynamics AX 2012 prior to cumulative update 7 for AX 2012 R2.

Yes, you can update all the tax codes in a tax group at the same time.

The financial information for each tax code is set up separately for each legal entity. If you change the values for one legal entity, the values for other legal entities aren’t affected.

When you update a tax code by using the mass-update functionality, the changes are effective immediately. To make date-effective changes to a tax code, use the Maintain versions button in the Tax codes form.

  1. Click Payroll > Setup > Taxes > Tax groups.

  2. Select a tax group, and then click Mass update.

  3. Select the legal entity to update the tax group for.

  4. Select one or more of the following fields to update:

    • Vendor

    • Project category

    • Default financial dimensions

    • Main account

  5. Enter the new values for the selected fields.

    Caution noteCaution

    If you select a field and you don’t enter a value, the field is cleared on all the tax codes in the tax group.

  6. Review the list of affected tax codes to make sure that you want to change every tax code in the list.

  7. Click Update.

Yes. When you set up Payroll, you automatically create a set of system-defined tax groups the first time that you click the Update tax data link on the Payroll area page. Each system-defined tax group contains tax codes of a particular type. For example, all tax codes for school districts are included in the SCHL tax group, and all tax codes for state income tax are in the SIT tax group. These tax groups are updated every time that you run the Update tax data process.

You can manually create additional tax groups. For more information, see Tax information tasks.

There are two reasons this might occur:

  • The Employer tax check box for the tax code in the Tax codes form is incorrect for the line type in the Transaction posting definitions form.

    If some tax codes in a tax group have the correct employer tax setting for the line type and some don’t, the tax codes that have the correct setting use the posting definition for the tax group. The other tax codes use the posting definition that is specified for the All code for their line type. The correct relationships of line types and employer tax settings are shown in the following table.

    Line type

    Required setting for the Employer tax check box

    Tax - contribution


    Tax - deduction


  • The tax code is entered on a line in the Transaction posting definitions form that uses the Table code. Table lines take precedence over group lines. The following table shows what you can enter in Payroll code field based on what is in the Code field, and what occurs from the combination of code and payroll code.


    Payroll code



    A tax code

    The tax code uses the specified transaction posting definition, even if the tax code is in a tax group that uses a different posting definition.


    A tax group

    All tax codes in the tax group use the specified transaction posting definition, except any tax codes that are on a Table line.



    Any tax code that does not post according to a Table line or a Group line uses the transaction posting definition that is specified for All.

You can’t delete a tax group that is system-defined or that is enabled for posting definitions.

You can’t remove a tax code from a system-defined tax group.

In the Transaction posting definitions form, the Group option is available only for line types of Tax - contribution and Tax - deduction.

Yes, you can. In the Tax codes form, clear the Enable posting definitions check box, delete the tax code, and then select the check box again.

Yes, but you can’t disable posting definitions for a tax group that is used in a transaction posting definition. If you open the Transaction posting definitions form and delete the line that uses the tax group, you can clear the Enable posting definitions check box in the Tax codes form.

A tax code can belong to only one tax group that is enabled for posting definitions to make sure that the tax is posted to the correct account.

If a tax code were included in two groups, the system would use the posting definition for whichever group was processed first. For example, you could include the Colorado state income tax in both the state income tax group and the Colorado tax group. If both groups were enabled for posting definitions, the system would not consistently use the same posting definition for the Colorado state income tax. Sometimes, the tax might be posted by using the posting definition for the state income tax group. Other times, the tax might by posted by using the posting definition for the Colorado tax group. You would never know which posting definition was used.

We're working to include as many questions as we can, so that Microsoft Dynamics AX Help will be more useful to people just like you.

Tell us what question you would like to add to this topic. Send email to

Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).