---
id: change/bcapps/10408
type: change
title: "#10408 Shopify Copilot Tax Matching Agent: matching engine and data model (stack 2/3)"
summary: Shopify Copilot Tax Matching Agent adds a headless matching engine that uses AI to match Shopify tax lines to Business Central tax jurisdictions, creates tax areas, and includes comprehensive unit tests.
tier: official
language: en
tags:
  - feature
  - main
  - bc30
  - codeunit shpfy tma activity log
  - codeunit shpfy tma events
  - codeunit shpfy tma install
  - codeunit shpfy tma matcher
  - codeunit shpfy tma register
  - codeunit shpfy tma upgrade
system: integration
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:07:15.614Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: 283acc8b84a97769b29c61aac5fb547258eea372
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/pull/10408
    title: "microsoft/BCApps#10408: Shopify Copilot Tax Matching Agent: matching engine and data model (stack 2/3)"
    date: "2026-08-28"
    commit: 283acc8b84a97769b29c61aac5fb547258eea372
    t: null
    quote: null
links:
  learn: []
  objects:
    - object/codeunit/30477-ca
    - object/codeunit/30473-ca
    - object/codeunit/30475-ca
    - object/codeunit/30471-ca
    - object/codeunit/30470-ca
    - object/codeunit/30478-ca
    - object/codeunit/30472-ca
    - object/codeunit/30474-ca
    - object/enumextension/30470-ca
    - object/enum/30471-ca
    - object/permissionset/30470-ca
    - object/tableextension/30476-ca
    - object/tableextension/30480-ca
    - object/tableextension/30477-ca
    - object/tableextension/30470-ca
    - object/tableextension/30481-ca
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 10408
repo: microsoft/BCApps
source_id: bcapps-prs
url: https://github.com/microsoft/BCApps/pull/10408
kind: pr
base_branch: main
major: "30"
merged_at: "2026-08-28T09:57:56Z"
author: onbuyuka
author_type: User
community_contribution: false
labels:
  - "AL: Apps (W1)"
  - "Build: scripts & configs"
  - "Team: Integrations"
change_class: code
change_kind: feature
behavior_change: true
breaking: false
files:
  count: 49
  additions: 20256
  deletions: 3
  al: 16
apps:
  - ShopifyNA
objects_touched:
  - key: codeunit/30477
    page: codeunit/30477-ca
    type: codeunit
    id: 30477
    name: Shpfy TMA Activity Log
    app: ShopifyNA
    status: added
  - key: codeunit/30473
    page: codeunit/30473-ca
    type: codeunit
    id: 30473
    name: Shpfy TMA Events
    app: ShopifyNA
    status: added
  - key: codeunit/30475
    page: codeunit/30475-ca
    type: codeunit
    id: 30475
    name: Shpfy TMA Install
    app: ShopifyNA
    status: added
  - key: codeunit/30471
    page: codeunit/30471-ca
    type: codeunit
    id: 30471
    name: Shpfy TMA Matcher
    app: ShopifyNA
    status: added
  - key: codeunit/30470
    page: codeunit/30470-ca
    type: codeunit
    id: 30470
    name: Shpfy TMA Register
    app: ShopifyNA
    status: added
  - key: codeunit/30478
    page: codeunit/30478-ca
    type: codeunit
    id: 30478
    name: Shpfy TMA Upgrade
    app: ShopifyNA
    status: added
  - key: codeunit/30472
    page: codeunit/30472-ca
    type: codeunit
    id: 30472
    name: Shpfy Tax Area Builder
    app: ShopifyNA
    status: added
  - key: codeunit/30474
    page: codeunit/30474-ca
    type: codeunit
    id: 30474
    name: Shpfy Tax Match Function
    app: ShopifyNA
    status: added
  - key: enumextension/30470
    page: enumextension/30470-ca
    type: enumextension
    id: 30470
    name: Shpfy TMA Cap.
    app: ShopifyNA
    status: added
  - key: enum/30471
    page: enum/30471-ca
    type: enum
    id: 30471
    name: Shpfy Tax Match Review Mode
    app: ShopifyNA
    status: added
  - key: permissionset/30470
    page: permissionset/30470-ca
    type: permissionset
    id: 30470
    name: Shpfy TMA
    app: ShopifyNA
    status: added
  - key: tableextension/30476
    page: tableextension/30476-ca
    type: tableextension
    id: 30476
    name: Shpfy TMA Order Header
    app: ShopifyNA
    status: added
  - key: tableextension/30480
    page: tableextension/30480-ca
    type: tableextension
    id: 30480
    name: Shpfy TMA Order Tax Line
    app: ShopifyNA
    status: added
  - key: tableextension/30477
    page: tableextension/30477-ca
    type: tableextension
    id: 30477
    name: Shpfy TMA Sales Header
    app: ShopifyNA
    status: added
  - key: tableextension/30470
    page: tableextension/30470-ca
    type: tableextension
    id: 30470
    name: Shpfy TMA Shop
    app: ShopifyNA
    status: added
  - key: tableextension/30481
    page: tableextension/30481-ca
    type: tableextension
    id: 30481
    name: Shpfy TMA Tax Jurisdiction
    app: ShopifyNA
    status: added
objects_unjoined: []
obsoletions: []
backports: []
fixes_issues: []
work_items:
  - 445769
systems:
  - integration
quote: null
joined_against:
  major: "30"
  commit: a4406cfa9e57437fedc49c53c327a199a854491e
---

# #10408 Shopify Copilot Tax Matching Agent: matching engine and data model (stack 2/3)

> Shopify Copilot Tax Matching Agent adds a headless matching engine that uses AI to match Shopify tax lines to Business Central tax jurisdictions, creates tax areas, and includes comprehensive unit tests.

[Pull request](https://github.com/microsoft/BCApps/pull/10408) · merged into `main` (BC30) on 2026-08-28 by onbuyuka · 49 files (+20256 -3), 16 AL · feature · tier official · reviewed (checked by Opus)

## What changed

- Registers a Copilot capability and calls GPT-4.1 to match Shopify tax-line titles to Business Central Tax Jurisdictions
- Builds or reuses a Tax Area and seeds Tax Details
- Tracks provenance (Created by Agent, Verified) and handles low-confidence matches deterministically
- Configurable review-mode gate can hold Sales Document creation
- Adds a test app with AITest suites, unit tests and accuracy datasets; the review UI ships in part 3
- Behaviour changes for users or extensions.

## AL objects touched

- [Codeunit 30477 "Shpfy TMA Activity Log"](../../objects/codeunit/30477-ca.md), ShopifyNA (CA layer): added
- [Codeunit 30473 "Shpfy TMA Events"](../../objects/codeunit/30473-ca.md), ShopifyNA (CA layer): added
- [Codeunit 30475 "Shpfy TMA Install"](../../objects/codeunit/30475-ca.md), ShopifyNA (CA layer): added
- [Codeunit 30471 "Shpfy TMA Matcher"](../../objects/codeunit/30471-ca.md), ShopifyNA (CA layer): added
- [Codeunit 30470 "Shpfy TMA Register"](../../objects/codeunit/30470-ca.md), ShopifyNA (CA layer): added
- [Codeunit 30478 "Shpfy TMA Upgrade"](../../objects/codeunit/30478-ca.md), ShopifyNA (CA layer): added
- [Codeunit 30472 "Shpfy Tax Area Builder"](../../objects/codeunit/30472-ca.md), ShopifyNA (CA layer): added
- [Codeunit 30474 "Shpfy Tax Match Function"](../../objects/codeunit/30474-ca.md), ShopifyNA (CA layer): added
- [Enum extension 30470 "Shpfy TMA Cap."](../../objects/enumextension/30470-ca.md), ShopifyNA (CA layer): added
- [Enum 30471 "Shpfy Tax Match Review Mode"](../../objects/enum/30471-ca.md), ShopifyNA (CA layer): added
- [Permission set 30470 "Shpfy TMA"](../../objects/permissionset/30470-ca.md), ShopifyNA (CA layer): added
- [Table extension 30476 "Shpfy TMA Order Header"](../../objects/tableextension/30476-ca.md), ShopifyNA (CA layer): added
- [Table extension 30480 "Shpfy TMA Order Tax Line"](../../objects/tableextension/30480-ca.md), ShopifyNA (CA layer): added
- [Table extension 30477 "Shpfy TMA Sales Header"](../../objects/tableextension/30477-ca.md), ShopifyNA (CA layer): added
- [Table extension 30470 "Shpfy TMA Shop"](../../objects/tableextension/30470-ca.md), ShopifyNA (CA layer): added
- [Table extension 30481 "Shpfy TMA Tax Jurisdiction"](../../objects/tableextension/30481-ca.md), ShopifyNA (CA layer): added

## Context

- Work items: AB#445769
- Labels: AL: Apps (W1), Build: scripts & configs, Team: Integrations
- Systems: integration

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