code change · featureAL Developmentofficial - Microsoftreviewed - checked by Opus

#203 knowledge(data-modeling): Prices Including VAT decides the basis of sales/purchase/service line amounts

A knowledge article clarifies how the Prices Including VAT header flag affects the basis of line amount fields in sales, purchase, and service documents, distinguishing fields that follow the flag from those with fixed net or gross basis.

Pull request · merged into main on 2026-10-02 by pri-kise · 5 files (+139 -3), 4 AL · feature · tier official · reviewed (checked by Opus)

What changed

  • Identifies which line amount fields follow the Prices Including VAT header flag and which have fixed net or gross basis
  • Explains that Unit Price, Direct Unit Cost, and Line Amount are affected by the header flag, while Amount and Amount Including VAT always have fixed bases
  • Highlights a misleading function name CalculateOutstandingAmountExclTax that is based on Line Amount and includes VAT when Prices Including VAT is enabled
  • Warns against reconverting prices from Price List lines since they are already converted to the document’s setting
  • Includes good and bad code examples and is registered in the review skill

AL objects touched

  • microsoft/knowledge/data-modeling/document-line-prices-follow-prices-including-vat.bad.al: added, not in the BC? snapshot yet
  • microsoft/knowledge/data-modeling/document-line-prices-follow-prices-including-vat.good.al: added, not in the BC? snapshot yet
  • microsoft/knowledge/data-modeling/document-line-prices-follow-prices-including-vat.md: added, not in the BC? snapshot yet
  • microsoft/skills/review/al-data-modeling-review.md: modified, not in the BC? snapshot

Context

Source: metadata of a merged pull request in microsoft/BCQuality (bcquality): title, labels, changed paths and counts, with a summary in our words. No source text and no description beyond one short quote (D10, D61).