Skip to content

[Shopify] Add HS Code sync and External URL extension for Agentic Plan#7414

Draft
onbuyuka wants to merge 1 commit intomainfrom
private/onbuyuka/shpfyagenticplan
Draft

[Shopify] Add HS Code sync and External URL extension for Agentic Plan#7414
onbuyuka wants to merge 1 commit intomainfrom
private/onbuyuka/shpfyagenticplan

Conversation

@onbuyuka
Copy link
Contributor

@onbuyuka onbuyuka commented Mar 26, 2026

Summary

Addresses gaps identified in the Shopify Agentic Plan Product Sync Guide to ensure BC product catalogs meet the data requirements for AI channel distribution.

Main Connector Changes

  • Harmonized System Code: Sync Item."Tariff No." as harmonizedSystemCode on variant export (both create and update paths)
  • Country of Origin: Sync Item."Country/Region of Origin Code" as countryCodeOfOrigin on variant export
  • New fields added to Shpfy Variant table and populated in CreateTempProduct (4 code paths) and FillInProductVariantData (3 overloads)

External URL Extension (open-source PTE)

  • New extension app (src/Apps/W1/Shopify/ExternalURL/) that syncs external_url variant metafields required by the Agentic Plan
  • Configurable URL template on the Shop Card with placeholder substitution ({item-no}, {variant-code}, {sku}, etc.)
  • Per-variant URL override via table/page extension on Shopify Variants
  • Subscribes to OnBeforeUpdateProductMetafields event - sets metafield on product sync
  • Shipped as source code, not compiled into the main connector (namespace: OpenSource.Shopify.ExternalURL, PTE ID range 50100+)

Fixes AB#

@github-actions github-actions bot added the AL: Apps (W1) Add-on apps for W1 label Mar 26, 2026
@github-actions
Copy link

Could not find a linked ADO work item. Please link one by using the pattern 'AB#' followed by the relevant work item number. You may use the 'Fixes' keyword to automatically resolve the work item when the pull request is merged. E.g. 'Fixes AB#1234'

- Add Tariff No. and Country/Region of Origin Code fields to Shpfy Variant table
- Populate HS code and country of origin from Item during product creation and export
- Include harmonizedSystemCode and countryCodeOfOrigin in variant CREATE and UPDATE GraphQL mutations
- Add open-source ExternalURL extension app that syncs external_url variant metafields via configurable URL template
- Add tests for HS code and country of origin on product creation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@onbuyuka onbuyuka force-pushed the private/onbuyuka/shpfyagenticplan branch from a6adf52 to c4f49ff Compare March 26, 2026 20:52
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AL Documentation Audit

Documentation gaps were detected in the following apps:

  • Shopify-Connector-Test: 0% documentation coverage
  • Shopify-External-URL: 0% documentation coverage

To generate documentation, run /al-docs init or /al-docs update using GitHub Copilot CLI or Claude Code.
This review is for awareness to help keep documentation in sync with code changes. It is okay to dismiss this request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AL: Apps (W1) Add-on apps for W1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant