Skip to content
D365 Reference

CustGroup

group

Customer group master — one row per posting/reporting group of customers, carrying default payment terms and the settle-period used to derive due dates

Module: Sales & MarketingCompany-partitioned (DataAreaId)
What the badges mean
main
Table group: how F&O categorizes the table's role — main entity, group/header, transaction, worksheet header, worksheet line, reference, parameter, or framework.
Shared across companies
The table carries no DataAreaId— rows aren’t partitioned per company, so a query never needs (and can’t use) a company filter here (see the quirks guide).
Date-effective
The table carries a ValidFrom/ValidTo effectivity window — a join without a date filter multiplies every key by its history (see the quirks guide).
In field listings, K marks a key field.

Fields

7 fields · 1 key

7 fields.

Table fields: key flag, field name, extended data type, description, data type, length, and quirk flags. 7 fields.
KeyFieldEDTDescriptionTypeLengthFlags
KeyCustGroupCustGroupIdThe customer group code — the natural key CustTable.CustGroup joins onstring10
NameDescriptive name of the customer groupstring60
PaymTermIdDefault terms of payment applied to customers in the groupstring
ClearingPeriodTerms of payment used to suggest the settle period for payments from customers in the groupstring
TaxGroupIdTaxGroupDefault sales tax group for customers in the groupstring10
PriceIncludeSalesTaxWhether prices for the group are entered inclusive of sales taxenum
DefaultDimensionRecIdRecId of the group's default financial-dimension value set in DimensionAttributeValueSetint64

Field provenance: hand-curated.

Boilerplate SQL

Starting point for reading CustGroup on Databricks — enums are decoded, 1900-01-01 dates are wrapped to NULL, and the DataAreaId anchor is in place. Set your Unity Catalog location, company, and filter values below; they’re substituted into the SQL and the copy button.

Query parameters

3 parameters not filled: <catalog>, <schema>, <company>

-- ============================================================
-- Table  : CustGroup Customer group master — one row per posting/reporting group of customers, carrying default payment terms and the settle-period used to derive due dates
-- Purpose: Column-selected read of CustGroup — auto-generated from field metadata
-- Grain  : One row per company (dataareaid) + CustGroup
-- Notes  : Auto-generated skeleton for Synapse Link / Fabric Link-landed F&O data (lowercase column names). Enums decoded inline where verified; datetimes stored in UTC; 1900-01-01 dates are sentinels mapped to NULL. System/audit columns omitted — see the quirks guide.
-- ============================================================
SELECT
  c.custgroup AS "The customer group code — the natural key CustTable.CustGroup joins on",
  c.name AS "Descriptive name of the customer group",
  c.paymtermid AS "Default terms of payment applied to customers in the group",
  c.clearingperiod AS "Terms of payment used to suggest the settle period for payments from customers in the group",
  c.taxgroupid AS "Default sales tax group for customers in the group",
  c.priceincludesalestax AS "Whether prices for the group are entered inclusive of sales tax",  -- enum: decode c.priceincludesalestax via GlobalOptionsetMetadata join — see quirks guide #enums
  c.defaultdimension AS "RecId of the group's default financial-dimension value set in DimensionAttributeValueSet"
FROM <catalog>.<schema>.custgroup c
-- Resolve DimensionAttributeValueSet (via DefaultDimension): uncomment to join on its RecId surrogate key
-- LEFT JOIN <catalog>.<schema>.dimensionattributevalueset dim ON dim.recid = c.defaultdimension
WHERE
  c.dataareaid = '<company>'
ORDER BY c.custgroup;

Verified September 2026

Relationships

Diagram of 1-hop neighbors — join details below. RecId and InventDim edges are highlighted; they’re the joins newcomers most often get wrong.

Join details

  • CustTableCustGroupforeign key · N:1
    ON custtable.custgroup = custgroup.custgroup AND custtable.dataareaid = custgroup.dataareaid
  • CustGroupDimensionAttributeValueSetRecId ref · N:1
    ON custgroup.defaultdimension = dimensionattributevalueset.recid

Data Entities That Expose This Table

More Sales & Marketing tables

Maintained by Summit Analytics, a supply chain analytics practice. The tools and references are free — the consulting is selective.

Part of the Summit Analytics reference library.

Work with the practice

Not affiliated with or endorsed by Microsoft. Microsoft, Dynamics 365, and Microsoft Fabric are trademarks of the Microsoft group of companies.