---
id: object/table/318
type: object
title: Table 318 "Tax Area"
summary: Table 318 "Tax Area" in Base Application (Microsoft.Finance.SalesTax). 3 fields, 2 public procedures. Present since at least BC23, still in BC30, changed in BC24, BC26, BC29.
tier: official
language: en
tags:
  - table
  - base application
versions:
  introduced: null
  last_changed: "29"
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 05907869c9a2c8025786525217971eb05eb043408156b2611e0055077e684287
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/SalesTax/TaxArea.Table.al
    title: src/Layers/W1/BaseApp/Finance/SalesTax/TaxArea.Table.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/how-to-set-up-unrealized-sales-tax-and-sales-payment-discounts
    - https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/how-to-set-up-use-tax-and-purchase-tax
    - https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/tax-1099-changes
    - https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/united-states-local-functionality
    - https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/us-sales-tax
    - https://learn.microsoft.com/dynamics365/business-central/sales-tax-concept
  objects: []
  features: []
  topics:
    - topic/business-central/business-functionality/finance/manage-receivables
    - topic/business-central/business-functionality/local-functionality/united-states
    - topic/business-central/business-functionality/local-functionality/united-states/tax
  localizations:
    - localization/ca
    - localization/mx
    - localization/us
  videos: []
  posts: []
  guidelines: []
object_type: table
object_id: 318
name: Tax Area
namespace: Microsoft.Finance.SalesTax
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "24"
  - "26"
  - "29"
source_major: "29"
obsolete: null
countries:
  - ca
  - mx
  - us
ms_search_form_ids: []
counts:
  fields: 3
  procedures: 5
  events: 0
  subscribers: 0
relations:
  out: 1
  referenced_by: 76
  pages: 2
  extended_by: 0
  event_subscribers: 0
  calls: 1
  called_by: 0
  implements: 0
---

# Table 318 "Tax Area"

> Table 318 "Tax Area" in Base Application (Microsoft.Finance.SalesTax). 3 fields, 2 public procedures. Present since at least BC23, still in BC30, changed in BC24, BC26, BC29.

Base Application · Microsoft.Finance.SalesTax · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/SalesTax/TaxArea.Table.al) · facts from BC29

Learn documents this table through its pages: [Page 469 "Tax Area List"](../page/469.md) (6 Learn pages).

## Properties

| Property | Value |
|---|---|
| Caption | Tax Area |
| DataClassification | CustomerContent |

## Fields

Explanation: the field's ToolTip in the code; without one, the ToolTip of a page control bound to the field (marked via the page); without that, its Caption (marked caption) when that differs from the name.

| No. | Name | Type | Explanation | Notes |
|---|---|---|---|---|
| 1 | Code | Code[20] | Specifies the code you want to assign to this tax area. You can enter up to 20 characters, both numbers and letters. It is a good idea to enter a code that is easy to remember. | NotBlank |
| 2 | Description | Text[100] | Specifies a description of the tax area. If you use a number as the tax code, you might want to describe the tax area in this field. |  |
| 10 | Last Modified Date Time | DateTime | — | not editable |

## Keys

- Key1: Code (clustered)

## Procedures

- `CreateTaxArea(NewTaxAreaCode: Code[20]; City: Text[50]; State: Text[50])`: Creates a new tax area with associated tax jurisdictions for city and state.
- `GetDescriptionInCurrentLanguageFullLength(): Text[100]`: Returns the tax area description in the user's current language. Falls back to the default description if no translation is available.

Plus 3 local procedures.

## Triggers

OnDelete, OnInsert, OnModify, OnRename

## Relations

- lookup page [Page 469 "Tax Area List"](../page/469.md)

## Referenced by

76 fields in 69 objects relate to this table (TableRelation or CalcFormula).

- [Table 181 "Posted Gen. Journal Line"](../table/181.md): Bal. Tax Area Code, Tax Area Code
- [Table 37 "Sales Line"](../table/37.md): Prepayment Tax Area Code, Tax Area Code
- [Table 39 "Purchase Line"](../table/39.md): Prepayment Tax Area Code, Tax Area Code
- [Table 5108 "Sales Line Archive"](../table/5108.md): Prepayment Tax Area Code, Tax Area Code
- [Table 5110 "Purchase Line Archive"](../table/5110.md): Prepayment Tax Area Code, Tax Area Code
- [Table 751 "Standard General Journal Line"](../table/751.md): Bal. Tax Area Code, Tax Area Code
- [Table 81 "Gen. Journal Line"](../table/81.md): Bal. Tax Area Code, Tax Area Code
- [Table 110 "Sales Shipment Header"](../table/110.md): Tax Area Code
- [Table 111 "Sales Shipment Line"](../table/111.md): Tax Area Code
- [Table 112 "Sales Invoice Header"](../table/112.md): Tax Area Code
- [Table 113 "Sales Invoice Line"](../table/113.md): Tax Area Code
- [Table 114 "Sales Cr.Memo Header"](../table/114.md): Tax Area Code
- [Table 115 "Sales Cr.Memo Line"](../table/115.md): Tax Area Code
- [Table 120 "Purch. Rcpt. Header"](../table/120.md): Tax Area Code
- [Table 121 "Purch. Rcpt. Line"](../table/121.md): Tax Area Code
- [Table 122 "Purch. Inv. Header"](../table/122.md): Tax Area Code
- [Table 123 "Purch. Inv. Line"](../table/123.md): Tax Area Code
- [Table 124 "Purch. Cr. Memo Hdr."](../table/124.md): Tax Area Code
- [Table 125 "Purch. Cr. Memo Line"](../table/125.md): Tax Area Code
- [Table 1381 "Customer Templ."](../table/1381.md): Tax Area Code
- [Table 1383 "Vendor Templ."](../table/1383.md): Tax Area Code
- [Table 15 "G/L Account"](../table/15.md): Tax Area Code
- [Table 1570 "G/L Entry Posting Preview"](../table/1570.md): Tax Area Code
- [Table 1571 "VAT Entry Posting Preview"](../table/1571.md): Tax Area Code
- [Table 17 "G/L Entry"](../table/17.md): Tax Area Code
- [Table 1706 "Deferral Posting Buffer"](../table/1706.md): Tax Area Code
- [Table 18 "Customer"](../table/18.md): Tax Area Code
- [Table 221 "Gen. Jnl. Allocation"](../table/221.md): Tax Area Code
- [Table 222 "Ship-to Address"](../table/222.md): Tax Area Code
- [Table 23 "Vendor"](../table/23.md): Tax Area Code
- [Table 254 "VAT Entry"](../table/254.md): Tax Area Code
- [Table 295 "Reminder Header"](../table/295.md): Tax Area Code
- [Table 297 "Issued Reminder Header"](../table/297.md): Tax Area Code
- [Table 30102 "Shpfy Shop"](../table/30102.md): Tax Area Code
- [Table 30109 "Shpfy Tax Area"](../table/30109.md): Tax Area Code
- [Table 30118 "Shpfy Order Header"](../table/30118.md): Tax Area Code
- [Table 30152 "Shpfy Catalog"](../table/30152.md): Tax Area Code
- [Table 302 "Finance Charge Memo Header"](../table/302.md): Tax Area Code
- [Table 304 "Issued Fin. Charge Memo Header"](../table/304.md): Tax Area Code
- [Table 316 "Tax Area Translation"](../table/316.md): Tax Area Code
- [Table 319 "Tax Area Line"](../table/319.md): Tax Area
- [Table 36 "Sales Header"](../table/36.md): Tax Area Code
- [Table 376 "G/L Account (Analysis View)"](../table/376.md): Tax Area Code
- [Table 38 "Purchase Header"](../table/38.md): Tax Area Code
- [Table 383 "Detailed CV Ledg. Entry Buffer"](../table/383.md): Tax Area Code
- [Table 461 "Prepayment Inv. Line Buffer"](../table/461.md): Tax Area Code
- [Table 49 "Invoice Post. Buffer"](../table/49.md): Tax Area Code
- [Table 5107 "Sales Header Archive"](../table/5107.md): Tax Area Code
- [Table 5109 "Purchase Header Archive"](../table/5109.md): Tax Area Code
- [Table 5475 "Sales Invoice Entity Aggregate"](../table/5475.md): Tax Area Code
- and 19 more objects (19 fields): data/code/relations/29.json

## Pages and codeunits on this table

- [Page 464 "Tax Area"](../page/464.md) (source table)
- [Page 469 "Tax Area List"](../page/469.md) (source table)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 43 "Language"](../codeunit/43.md) (1 call: `GetDescriptionInCurrentLanguageFullLength → GetUserLanguageCode`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC24, BC26, BC29

## Countries that replace it

[CA](../../localizations/ca.md), [MX](../../localizations/mx.md), [US](../../localizations/us.md)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "table", object_name: "Tax Area")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.
