---
id: change/bcapps/10578
type: change
title: "#10578 [Extensibility Request] issue 30429: add events to disambiguate CRM integration table mappings"
summary: Four integration events are added to allow extensions to select the correct CRM integration table mapping when multiple mappings share the same table ID, enabling proper disambiguation in order-status updates, coupling, uncoupling, and match-based coupling scenarios.
tier: official
language: en
tags:
  - feature
  - main
  - bc30
  - codeunit crm order status update job
  - codeunit crm integration management
  - table coupling record buffer
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: 7e9bc152b84253f330141e7191a418832cd45083
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/pull/10578
    title: "microsoft/BCApps#10578: [Extensibility Request] issue 30429: add events to disambiguate CRM integration table mappings"
    date: "2026-08-28"
    commit: 7e9bc152b84253f330141e7191a418832cd45083
    t: null
    quote: null
links:
  learn: []
  objects:
    - object/codeunit/5352
    - object/codeunit/5330
    - object/table/5332
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 10578
repo: microsoft/BCApps
source_id: bcapps-prs
url: https://github.com/microsoft/BCApps/pull/10578
kind: pr
base_branch: main
major: "30"
merged_at: "2026-08-28T11:07:42Z"
author: onbuyuka
author_type: User
community_contribution: false
labels:
  - "Team: Integrations"
change_class: code
change_kind: feature
behavior_change: false
breaking: false
files:
  count: 3
  additions: 25
  deletions: 0
  al: 3
apps:
  - Base Application
objects_touched:
  - key: codeunit/5352
    page: codeunit/5352
    type: codeunit
    id: 5352
    name: CRM Order Status Update Job
    app: Base Application
    status: modified
  - key: codeunit/5330
    page: codeunit/5330
    type: codeunit
    id: 5330
    name: CRM Integration Management
    app: Base Application
    status: modified
  - key: table/5332
    page: table/5332
    type: table
    id: 5332
    name: Coupling Record Buffer
    app: Base Application
    status: modified
objects_unjoined: []
obsoletions: []
backports: []
fixes_issues: []
work_items:
  - 647520
systems:
  - integration
quote: null
joined_against:
  major: "30"
  commit: ecbc028c25dbe83b61313bc566e6c1d41184bb1c
---

# #10578 [Extensibility Request] issue 30429: add events to disambiguate CRM integration table mappings

> Four integration events are added to allow extensions to select the correct CRM integration table mapping when multiple mappings share the same table ID, enabling proper disambiguation in order-status updates, coupling, uncoupling, and match-based coupling scenarios.

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

## What changed

- Four new IntegrationEvent publishers added: OnUpdateSalesOrdersOnBeforeFindIntegrationTableMapping, OnAfterInitialize, OnRemoveCouplingOnBeforeGetIntegrationTableMappingForUncoupling, OnMatchBasedCouplingOnBeforeGetIntegrationTableMappingForMatchBasedCoupling
- Events use read-only RecordRef parameters to allow subscribers to inspect source records without mutating caller state
- Addresses scenario where extensions have multiple same-table mappings (e.g., Sales Header quotes alongside standard orders)
- Thin event publishers marked with [IntegrationEvent(false, false)]
- Enables correct mapping resolution during CRM sync operations

## AL objects touched

- [Codeunit 5352 "CRM Order Status Update Job"](../../objects/codeunit/5352.md), Base Application: modified
- [Codeunit 5330 "CRM Integration Management"](../../objects/codeunit/5330.md), Base Application: modified
- [Table 5332 "Coupling Record Buffer"](../../objects/table/5332.md), Base Application: modified

## Context

- Work items: AB#647520
- Labels: 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).