---
id: change/bcapps/10256
type: change
title: "#10256 [Shopify] Fix customer matching when phone numbers contain spaces"
summary: When exporting customers to Shopify, the connector now strips phone numbers down to the plus sign and digits before searching. It accepts a search result only if the phone or email matches exactly. Formatted phone numbers no longer match unrelated Shopify customers, which used to make the export get skipped with a misleading 'already exists' message.
tier: official
language: en
tags:
  - fix
  - main
  - bc30
  - codeunit shpfy customer api
system: integration
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:08:14.095Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: a7478057a83c5e7be5c4ad640e9c5864b2095ce5
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/pull/10256
    title: "microsoft/BCApps#10256: [Shopify] Fix customer matching when phone numbers contain spaces"
    date: "2026-08-19"
    commit: a7478057a83c5e7be5c4ad640e9c5864b2095ce5
    t: null
    quote: Normalize the phone to + and digits before sending it to Shopify
links:
  learn: []
  objects:
    - object/codeunit/30114
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 10256
repo: microsoft/BCApps
source_id: bcapps-prs
url: https://github.com/microsoft/BCApps/pull/10256
kind: pr
base_branch: main
major: "30"
merged_at: "2026-08-19T10:59:07Z"
author: onbuyuka
author_type: User
community_contribution: false
labels:
  - "AL: Apps (W1)"
  - "Team: Integrations"
change_class: code
change_kind: fix
behavior_change: true
breaking: false
files:
  count: 4
  additions: 188
  deletions: 9
  al: 1
apps:
  - Shopify
objects_touched:
  - key: codeunit/30114
    page: codeunit/30114
    type: codeunit
    id: 30114
    name: Shpfy Customer API
    app: Shopify
    status: modified
objects_unjoined: []
obsoletions: []
backports: []
fixes_issues: []
work_items:
  - 646794
systems:
  - integration
quote: Normalize the phone to + and digits before sending it to Shopify
joined_against:
  major: "30"
  commit: ecbc028c25dbe83b61313bc566e6c1d41184bb1c
---

# #10256 [Shopify] Fix customer matching when phone numbers contain spaces

> When exporting customers to Shopify, the connector now strips phone numbers down to the plus sign and digits before searching. It accepts a search result only if the phone or email matches exactly. Formatted phone numbers no longer match unrelated Shopify customers, which used to make the export get skipped with a misleading 'already exists' message.

[Pull request](https://github.com/microsoft/BCApps/pull/10256) · merged into `main` (BC30) on 2026-08-19 by onbuyuka · 4 files (+188 -9), 1 AL · fix · tier official · reviewed (checked by Opus)

## What changed

- Phone numbers are normalized to digits and plus sign before Shopify search
- Search results are validated for exact phone and email matches
- GraphQL queries now return phone and email fields for verification
- Test coverage added for phone normalization and partial match rejection
- Behaviour changes for users or extensions.

## AL objects touched

- [Codeunit 30114 "Shpfy Customer API"](../../objects/codeunit/30114.md), Shopify: modified

## Context

- Work items: AB#646794
- Labels: AL: Apps (W1), Team: Integrations
- Systems: integration
- From the description: "Normalize the phone to + and digits before sending it to Shopify"

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).