Merge Columbia Coatings catalog integration

Full integration with the Columbia Coatings product catalog API: scheduled +
manual sync of the 2,410-product catalog, multi-manufacturer mapping (Columbia/
PPG/KP Pigments), additives categorization, swatch/tester/sample exclusion, and
tolerant cure/price/HTML parsing. Inventory tie-in (catalog link, discontinued
badge, auto-receive-from-catalog), right-to-delete purge, and quote-at-current-
catalog-price propagation with the cost basis kept separate for accounting.
Shared upsert across API sync and file import, lazy TDS spec enrichment, and
self-healing inventory links. 278 unit tests green.

src/PowderCoating.Application/Constants/ColumbiaIntegrationConstants.cs

@@ -0,0 +1,46 @@
+namespace PowderCoating.Application.Constants;
+
+/// <summary>
+/// Central constants for the Columbia Coatings catalog integration — config keys, platform-setting
+/// keys, and the derived provenance/manufacturer/category values the mapper assigns. Kept in one
+/// place so the API client, sync mapper, scheduled job, and purge logic all agree on the strings.
+/// </summary>
+public static class ColumbiaIntegrationConstants
+{
+    // ── Configuration keys (appsettings.json / environment) ───────────────
+    /// <summary>API key — secret, lives in config not the platform-settings DB.</summary>
+    public const string ConfigApiKey = "Columbia:ApiKey";
+    public const string ConfigBaseUrl = "Columbia:BaseUrl";
+
+    /// <summary>Configurable API namespace/base path, so an API version bump is a config change.</summary>
+    public const string ConfigApiBasePath = "Columbia:ApiBasePath";
+
+    public const string DefaultBaseUrl = "https://columbiacoatings.com";
+    public const string DefaultApiBasePath = "/wp-json/cca/v1";
+
+    /// <summary>Resource segment appended to the API base path for product endpoints.</summary>
+    public const string ProductsResource = "/products";
+
+    /// <summary>API caps per_page at 100.</summary>
+    public const int MaxPerPage = 100;
+
+    // ── Platform setting keys (SuperAdmin-managed, non-secret) ────────────
+    public const string SettingEnabled = "ColumbiaSyncEnabled";
+    public const string SettingIntervalDays = "ColumbiaSyncIntervalDays";
+    public const string SettingLastSyncedAt = "ColumbiaLastSyncedAt";
+    public const string SettingLastResult = "ColumbiaLastSyncResult";
+
+    public const int DefaultSyncIntervalDays = 7;
+
+    // ── Provenance ────────────────────────────────────────────────────────
+    /// <summary>Stored in <c>PowderCatalogItem.Source</c> — the purge key for right-to-delete.</summary>
+    public const string SourceName = "Columbia Coatings API";
+
+    // ── Derived manufacturers (PowderCatalogItem.VendorName) ──────────────
+    public const string ManufacturerColumbia = "Columbia Coatings";
+    public const string ManufacturerPpg = "PPG";
+    public const string ManufacturerKp = "KP Pigments";
+
+    // ── Derived category (PowderCatalogItem.Category) ─────────────────────
+    public const string CategoryPowderAdditives = "Powder Additives";
+}

src/PowderCoating.Application/DTOs/Columbia/ColumbiaImageJsonConverter.cs

@@ -0,0 +1,49 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace PowderCoating.Application.DTOs.Columbia;
+
+/// <summary>
+/// Tolerant converter for Columbia image fields. WordPress/WooCommerce returns an object
+/// (<c>{id,src,name,alt}</c>) when an image is present, but an empty array (<c>[]</c>) — or
+/// sometimes <c>false</c>/empty string — when it is not. A single <see cref="ColumbiaImage"/>
+/// can't bind to those non-object forms, so this converter reads the object when present and
+/// yields null for anything else (consuming the token so deserialization continues).
+/// </summary>
+public class ColumbiaImageJsonConverter : JsonConverter<ColumbiaImage?>
+{
+    public override ColumbiaImage? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+    {
+        switch (reader.TokenType)
+        {
+            case JsonTokenType.StartObject:
+                using (var doc = JsonDocument.ParseValue(ref reader))
+                {
+                    var el = doc.RootElement;
+                    return new ColumbiaImage
+                    {
+                        Id = el.TryGetProperty("id", out var id) && id.TryGetInt32(out var i) ? i : 0,
+                        Src = GetString(el, "src"),
+                        Name = GetString(el, "name"),
+                        Alt = GetString(el, "alt"),
+                    };
+                }
+
+            case JsonTokenType.StartArray:
+                reader.Skip(); // empty/non-empty array form means "no image"
+                return null;
+
+            default:
+                // Primitive (false / "" / null / number): nothing to consume further.
+                return null;
+        }
+    }
+
+    public override void Write(Utf8JsonWriter writer, ColumbiaImage? value, JsonSerializerOptions options)
+        => throw new NotSupportedException("Columbia image fields are read-only.");
+
+    private static string GetString(JsonElement el, string property) =>
+        el.TryGetProperty(property, out var v) && v.ValueKind == JsonValueKind.String
+            ? v.GetString() ?? string.Empty
+            : string.Empty;
+}

src/PowderCoating.Application/DTOs/Columbia/ColumbiaProductDtos.cs

@@ -0,0 +1,142 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace PowderCoating.Application.DTOs.Columbia;
+
+/// <summary>
+/// One page of the Columbia Coatings <c>GET /products</c> response: a list of products plus
+/// pagination metadata. Property names are snake_case in the API and bound via the snake-case
+/// naming policy configured on the client's <see cref="JsonSerializerOptions"/>.
+/// </summary>
+public class ColumbiaProductsResponse
+{
+    public List<ColumbiaProduct> Items { get; set; } = new();
+    public ColumbiaPagination? Pagination { get; set; }
+}
+
+/// <summary>Pagination block returned alongside a product page.</summary>
+public class ColumbiaPagination
+{
+    public int Page { get; set; }
+    public int PerPage { get; set; }
+    public int Total { get; set; }
+    public int TotalPages { get; set; }
+}
+
+/// <summary>
+/// A single Columbia Coatings product as returned by the API. This mirrors the wire shape, not our
+/// catalog model — mapping into <c>PowderCatalogItem</c> happens in the sync mapper. Prices arrive
+/// as strings; cure/spec fields are free text; documents are direct URLs.
+/// </summary>
+public class ColumbiaProduct
+{
+    public int Id { get; set; }
+
+    /// <summary>"simple" or "variable". Variable products carry packaging/size variants in
+    /// <see cref="VariationPricing"/> and leave <see cref="TieredPricing"/> as an empty array.</summary>
+    public string ProductType { get; set; } = string.Empty;
+
+    public string Name { get; set; } = string.Empty;
+    public string Slug { get; set; } = string.Empty;
+    public string Sku { get; set; } = string.Empty;
+    public string Permalink { get; set; } = string.Empty;
+    public string Status { get; set; } = string.Empty;
+
+    /// <summary>Columbia-specific values seen include "In Stock"/"instock", "formulated",
+    /// "drop_shipped", "multiple_variations", "outofstock", "onbackorder" — mixed casing.</summary>
+    public string StockStatus { get; set; } = string.Empty;
+
+    // ── Pricing (all strings on the wire) ─────────────────────────────────
+    public string Price { get; set; } = string.Empty;
+    public string RegularPrice { get; set; } = string.Empty;
+    public string SalePrice { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Quantity-break pricing. POLYMORPHIC on the wire: an object
+    /// (<c>{type, minimum_quantity, tiers:[...]}</c>) on simple products, but an empty ARRAY
+    /// (<c>[]</c>) on variable products. Captured as a nullable raw <see cref="JsonElement"/> so
+    /// deserialization never throws on the type mismatch and an absent value is null (not an
+    /// invalid <c>Undefined</c> element); the mapper interprets it.
+    /// </summary>
+    public JsonElement? TieredPricing { get; set; }
+
+    /// <summary>Per-variant pricing for variable products (e.g. Bulk vs 1 lb Bags, or gram sizes).
+    /// Each variant has its own SKU and price. Empty for simple products.</summary>
+    public List<ColumbiaVariationPricing>? VariationPricing { get; set; }
+
+    // ── Documents (direct URLs) ───────────────────────────────────────────
+    public string SafetyDataSheet { get; set; } = string.Empty;
+    public string TechnicalDataSheet { get; set; } = string.Empty;
+    public string ProductFlyer { get; set; } = string.Empty;
+    public string ProductBrochure { get; set; } = string.Empty;
+
+    // ── Coating spec free-text ────────────────────────────────────────────
+    public string CureSchedule { get; set; } = string.Empty;
+    public string MilThickness { get; set; } = string.Empty;
+
+    /// <summary>Resin chemistry (e.g. "Polyester/TGIC", "TGIC", "Epoxy"). NOT finish/gloss.</summary>
+    public string Type { get; set; } = string.Empty;
+
+    public string ReleaseDate { get; set; } = string.Empty;
+    public string FormulationDate { get; set; } = string.Empty;
+
+    /// <summary>Free-text reformulation log, e.g. "Formulation Change: 05/22/26".</summary>
+    public string FormulationDateChanges { get; set; } = string.Empty;
+
+    // ── Content ───────────────────────────────────────────────────────────
+    /// <summary>HTML product description (WordPress markup).</summary>
+    public string Description { get; set; } = string.Empty;
+    public string ShortDescription { get; set; } = string.Empty;
+
+    public ColumbiaImage? FeaturedImage { get; set; }
+
+    // ── Taxonomy (arrays of {name}) — used at import to derive manufacturer/category, not stored raw ──
+    public List<ColumbiaNamed> Categories { get; set; } = new();
+    public List<ColumbiaNamed> Tags { get; set; } = new();
+    public List<ColumbiaNamed> PaColorGroup { get; set; } = new();
+    public List<ColumbiaAttribute> Attributes { get; set; } = new();
+}
+
+/// <summary>A pricing variant of a variable product (own SKU, own price/tiers).</summary>
+public class ColumbiaVariationPricing
+{
+    public int Id { get; set; }
+    public string Sku { get; set; } = string.Empty;
+    public List<ColumbiaAttributeValue> Attributes { get; set; } = new();
+    public string StockStatus { get; set; } = string.Empty;
+    public string Price { get; set; } = string.Empty;
+    public string RegularPrice { get; set; } = string.Empty;
+    public string SalePrice { get; set; } = string.Empty;
+
+    /// <summary>Same polymorphic object-or-array shape as the parent; captured raw (nullable).</summary>
+    public JsonElement? TieredPricing { get; set; }
+}
+
+/// <summary>An image object — featured or gallery.</summary>
+public class ColumbiaImage
+{
+    public int Id { get; set; }
+    public string Src { get; set; } = string.Empty;
+    public string Name { get; set; } = string.Empty;
+    public string Alt { get; set; } = string.Empty;
+}
+
+/// <summary>A simple <c>{name}</c> taxonomy entry (category, tag, or color group).</summary>
+public class ColumbiaNamed
+{
+    public string Name { get; set; } = string.Empty;
+}
+
+/// <summary>A product attribute with its option list, e.g. Color Group → [Blue], Packaging → [Bulk, 1 lb Bags].</summary>
+public class ColumbiaAttribute
+{
+    public string Name { get; set; } = string.Empty;
+    public List<ColumbiaNamed> Options { get; set; } = new();
+}
+
+/// <summary>A resolved attribute value on a specific variation, e.g. Packaging → "Bulk".</summary>
+public class ColumbiaAttributeValue
+{
+    public string Name { get; set; } = string.Empty;
+    public string Value { get; set; } = string.Empty;
+}

src/PowderCoating.Application/DTOs/Inventory/InventoryDtos.cs

@@ -37,6 +37,8 @@ public class InventoryItemDto
     public decimal AverageCost { get; set; }
     public decimal LastPurchasePrice { get; set; }
     public DateTime? LastPurchaseDate { get; set; }
+    public decimal? CatalogReferencePrice { get; set; }
+    public DateTime? CatalogPriceUpdatedAt { get; set; }
     public int? PrimaryVendorId { get; set; }
     public string? PrimaryVendorName { get; set; }
     public string? VendorPartNumber { get; set; }

src/PowderCoating.Application/Interfaces/IColumbiaCatalogSyncService.cs

@@ -0,0 +1,41 @@
+namespace PowderCoating.Application.Interfaces;
+
+/// <summary>
+/// Orchestrates a full Columbia Coatings catalog sync: pull every product, map and upsert it, then
+/// (only on a complete pull) reconcile discontinuations. Used by both the scheduled background job
+/// and the manual "Sync now" admin action.
+/// </summary>
+public interface IColumbiaCatalogSyncService
+{
+    /// <summary>
+    /// Runs one full sync. Assumes the caller has already decided it should run (enabled / due).
+    /// Returns a result describing the outcome; never throws for an expected failure (not
+    /// configured, partial pull, HTTP error) — those are reported on the result instead.
+    /// </summary>
+    Task<ColumbiaSyncResult> RunSyncAsync(CancellationToken cancellationToken = default);
+}
+
+/// <summary>Outcome of a Columbia catalog sync run.</summary>
+public class ColumbiaSyncResult
+{
+    public bool Success { get; set; }
+    public string? ErrorMessage { get; set; }
+
+    public int TotalFetched { get; set; }
+    public int Inserted { get; set; }
+    public int Updated { get; set; }
+    public int Unchanged { get; set; }
+    public int Skipped { get; set; }
+    public int Discontinued { get; set; }
+    public int Reactivated { get; set; }
+
+    public DateTime StartedAt { get; set; }
+    public TimeSpan Duration { get; set; }
+
+    /// <summary>One-line summary suitable for storing in the last-result platform setting / UI.</summary>
+    public string Summary =>
+        Success
+            ? $"{TotalFetched} fetched: {Inserted} new, {Updated} updated, {Unchanged} unchanged, " +
+              $"{Discontinued} discontinued, {Reactivated} reactivated ({Duration.TotalSeconds:F0}s)"
+            : $"Failed: {ErrorMessage}";
+}

src/PowderCoating.Application/Interfaces/IColumbiaCoatingsApiClient.cs

@@ -0,0 +1,47 @@
+using PowderCoating.Application.DTOs.Columbia;
+
+namespace PowderCoating.Application.Interfaces;
+
+/// <summary>
+/// Typed client for the Columbia Coatings product catalog API (<c>/wp-json/cca/v1</c>).
+/// Read-only: lists products via the paged <c>GET /products</c> endpoint.
+/// <para>
+/// We deliberately page <c>/products</c> rather than using the bulk <c>export.json</c> download:
+/// the export returns a temporary <c>download_url</c> to a static file under <c>/wp-content/uploads</c>,
+/// which sits behind Cloudflare bot protection and 403s for non-browser clients. The
+/// <c>/wp-json</c> API routes are allowlisted via the API key, so paging is the only path that
+/// works reliably from a server.
+/// </para>
+/// </summary>
+public interface IColumbiaCoatingsApiClient
+{
+    /// <summary>
+    /// True when an API key is configured (<c>Columbia:ApiKey</c>). When false, callers should
+    /// skip the sync entirely rather than issue unauthenticated requests.
+    /// </summary>
+    bool IsConfigured { get; }
+
+    /// <summary>
+    /// Retrieves a single page of products. <paramref name="perPage"/> is capped at 100 by the API.
+    /// </summary>
+    Task<ColumbiaProductsResponse> GetProductsPageAsync(int page, int perPage, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Pages through the entire catalog and returns every product. Honors rate limiting
+    /// (429 / Retry-After). THROWS if any page fails after retries — callers must treat an
+    /// exception as "incomplete pull" and NOT run discontinuation logic against a partial set.
+    /// </summary>
+    Task<IReadOnlyList<ColumbiaProduct>> GetAllProductsAsync(CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Fetches a single product by exact SKU (<c>GET /products?sku=...</c>), or null if not found.
+    /// For ad-hoc refresh of one record without pulling the whole catalog.
+    /// </summary>
+    Task<ColumbiaProduct?> GetProductBySkuAsync(string sku, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Fetches a single product by WooCommerce product ID (<c>GET /products/{id}</c>), or null if
+    /// not found. Useful when we already store the catalog product's ID and want to refresh it.
+    /// </summary>
+    Task<ColumbiaProduct?> GetProductByIdAsync(int id, CancellationToken cancellationToken = default);
+}

src/PowderCoating.Application/Interfaces/IInventoryAiLookupService.cs

@@ -59,9 +59,17 @@ public interface IInventoryAiLookupService
     Task<InventoryAiLookupResult> ScanLabelAsync(string base64Image, string mediaType);
 
     /// <summary>
-    /// Fetches a Technical Data Sheet URL and extracts cure temperature and cure time.
-    /// Called when the main lookup found a TDS URL but cure specs are still missing.
+    /// Fetches a Technical Data Sheet URL and extracts cure temperature, cure time, and specific
+    /// gravity. Called when the main lookup found a TDS URL but specs are still missing.
     /// Returns Success=false silently (no UI error) when the TDS is a PDF or unreachable.
     /// </summary>
     Task<InventoryAiLookupResult> FetchTdsCureSpecsAsync(string tdsUrl, string? colorName);
+
+    /// <summary>
+    /// Lazily fills a powder catalog item's specific gravity (and any missing cure specs) from its
+    /// TDS the first time it's needed, then derives theoretical coverage. No-op when specific
+    /// gravity is already known or no TDS URL is present. Persists the enrichment to the catalog so
+    /// it's done once and benefits every future use. Returns true if anything was filled.
+    /// </summary>
+    Task<bool> EnsureCatalogTdsSpecsAsync(PowderCoating.Core.Entities.PowderCatalogItem catalog);
 }

src/PowderCoating.Application/Interfaces/IPowderCatalogUpsertService.cs

@@ -0,0 +1,32 @@
+using PowderCoating.Core.Entities;
+
+namespace PowderCoating.Application.Interfaces;
+
+/// <summary>
+/// Shared upsert for the platform powder catalog: matches incoming records to existing rows by
+/// (VendorName, SKU), inserts new ones, and updates changed ones in place. Used by BOTH the manual
+/// JSON file import and the Columbia API sync so there is a single upsert path, only the mapping
+/// differs. Does NOT handle discontinuation — that is a sync-specific concern.
+/// </summary>
+public interface IPowderCatalogUpsertService
+{
+    /// <summary>
+    /// Applies <paramref name="incoming"/> mapped catalog items. Only fields sourced from the feed
+    /// are copied on update; enrichment fields (specific gravity, coverage, transfer efficiency,
+    /// finish) are preserved so they are not wiped by a feed that never carries them. Changed and
+    /// inserted rows get <paramref name="runTimestamp"/> stamped on LastSyncedAt/UpdatedAt.
+    /// </summary>
+    Task<PowderCatalogUpsertResult> UpsertAsync(
+        IReadOnlyList<PowderCatalogItem> incoming,
+        DateTime runTimestamp,
+        CancellationToken cancellationToken = default);
+}
+
+/// <summary>Counts from an upsert run.</summary>
+public class PowderCatalogUpsertResult
+{
+    public int Inserted { get; set; }
+    public int Updated { get; set; }
+    public int Unchanged { get; set; }
+    public int Skipped { get; set; }
+}

src/PowderCoating.Application/Services/PricingCalculationService.cs

@@ -149,9 +149,12 @@ public class PricingCalculationService : IPricingCalculationService
             try
             {
                 var inventoryItem = await _unitOfWork.InventoryItems.GetByIdAsync(coat.InventoryItemId.Value);
-                if (inventoryItem != null && inventoryItem.UnitCost > 0)
+                // Prefer the current catalog price (replacement cost) so quotes reflect the latest
+                // price; fall back to the item's own cost when it isn't catalog-linked.
+                var effectiveCostPerLb = inventoryItem?.CatalogReferencePrice ?? inventoryItem?.UnitCost ?? 0m;
+                if (inventoryItem != null && effectiveCostPerLb > 0)
                 {
-                    costPerLb = inventoryItem.UnitCost;
+                    costPerLb = effectiveCostPerLb;
                     isIncomingPowder = inventoryItem.IsIncoming;
                     var coverage = coat.CoverageSqFtPerLb;
                     var transferEfficiency = coat.TransferEfficiency;
@@ -160,8 +163,8 @@ public class PricingCalculationService : IPricingCalculationService
                     var actualPoundsPerSqFt = poundsPerSqFt / (transferEfficiency / 100m);
                     powderCostPerSqFt = actualPoundsPerSqFt * costPerLb;
 
-                    _logger.LogInformation("Coat {CoatName}: Using inventory item: {InventoryItem} (IsIncoming={IsIncoming}), UnitCost={UnitCost}/lb, Coverage={Coverage}sqft/lb, Efficiency={Efficiency}%, Calculated={CalcCost}/sqft",
-                        coat.CoatName, inventoryItem.Name, isIncomingPowder, inventoryItem.UnitCost, coverage, transferEfficiency, powderCostPerSqFt);
+                    _logger.LogInformation("Coat {CoatName}: Using inventory item: {InventoryItem} (IsIncoming={IsIncoming}), CostPerLb={CostPerLb}/lb (catalog ref={CatalogRef}), Coverage={Coverage}sqft/lb, Efficiency={Efficiency}%, Calculated={CalcCost}/sqft",
+                        coat.CoatName, inventoryItem.Name, isIncomingPowder, costPerLb, inventoryItem.CatalogReferencePrice, coverage, transferEfficiency, powderCostPerSqFt);
                 }
             }
             catch (Exception ex)
@@ -691,7 +694,8 @@ public class PricingCalculationService : IPricingCalculationService
                         var invItem = await _unitOfWork.InventoryItems.GetByIdAsync(c.InventoryItemId.Value);
                         if (invItem?.IsIncoming == true)
                         {
-                            customPowderOrderAmount += c.PowderToOrder.Value * invItem.UnitCost;
+                            // Bill the powder-to-order at the current catalog price when linked.
+                            customPowderOrderAmount += c.PowderToOrder.Value * (invItem.CatalogReferencePrice ?? invItem.UnitCost);
                             var colorName = !string.IsNullOrWhiteSpace(c.ColorName) ? c.ColorName : invItem.Name;
                             if (!string.IsNullOrWhiteSpace(colorName))
                                 customPowderOrderColors.Add(colorName);

src/PowderCoating.Core/Entities/InventoryItem.cs

@@ -31,6 +31,27 @@ public class InventoryItem : BaseEntity
     public string? SdsUrl { get; set; }         // Safety Data Sheet URL (from powder catalog or manual entry)
     public string? TdsUrl { get; set; }         // Technical Data Sheet URL (from powder catalog or manual entry)
 
+    /// <summary>
+    /// Optional link to the platform powder catalog record this item was created from.
+    /// Populated when an item is added via the catalog lookup, or back-filled by Manufacturer+SKU.
+    /// Lets the inventory detail screen surface manufacturer-level status (e.g. "discontinued by
+    /// manufacturer — cannot reorder") and future price/reformulation change flags. Nulled — not
+    /// cascaded — if the source catalog data is purged (the shop's own stock record must survive).
+    /// </summary>
+    public int? PowderCatalogItemId { get; set; }
+
+    /// <summary>
+    /// Latest list price from the linked powder catalog, refreshed by the catalog sync. This is the
+    /// QUOTING price (current replacement cost) and is kept deliberately SEPARATE from
+    /// <see cref="UnitCost"/>/<see cref="AverageCost"/> (the actual paid cost basis that drives
+    /// inventory valuation and COGS). Quoting prefers this when present so quotes reflect the
+    /// current price; accounting never reads it. Null for manual/non-catalog powders.
+    /// </summary>
+    public decimal? CatalogReferencePrice { get; set; }
+
+    /// <summary>Timestamp (UTC) when <see cref="CatalogReferencePrice"/> was last refreshed by the sync.</summary>
+    public DateTime? CatalogPriceUpdatedAt { get; set; }
+
     // Sample Panel Tracking (coating category items only)
     public bool HasSamplePanel { get; set; } = false;
 

src/PowderCoating.Core/Entities/PowderCatalogItem.cs

@@ -40,9 +40,30 @@ public class PowderCatalogItem
     /// <summary>Cure hold time at cure temperature, in minutes.</summary>
     public int? CureTimeMinutes { get; set; }
 
+    /// <summary>
+    /// Raw cure schedule text exactly as supplied by the vendor — e.g. "10 minutes @ 400°F".
+    /// Preserved verbatim because vendor formats vary wildly and some carry application notes
+    /// that don't reduce to a single temp/time pair (partial cures, clear-coat steps).
+    /// </summary>
+    public string? CureScheduleText { get; set; }
+
+    /// <summary>
+    /// All parsed cure curves as JSON — e.g. [{"tempF":400,"minutes":10},{"tempF":350,"minutes":20}].
+    /// Many powders list alternate lower-temperature curves; these matter for heat-sensitive
+    /// substrates that cannot take the standard 400°F cure, so we keep every curve, not just the
+    /// primary one in <see cref="CureTemperatureF"/>/<see cref="CureTimeMinutes"/>.
+    /// </summary>
+    public string? CureCurvesJson { get; set; }
+
     /// <summary>Finish type — e.g. Gloss, Matte, Satin, Metallic, Texture.</summary>
     public string? Finish { get; set; }
 
+    /// <summary>Resin chemistry — e.g. "Polyester", "TGIC", "Epoxy", "Hybrid". Distinct from <see cref="Finish"/>.</summary>
+    public string? ChemistryType { get; set; }
+
+    /// <summary>Recommended film build (mil thickness) as free text from the vendor — e.g. "2.0-3.0 Mils".</summary>
+    public string? MilThickness { get; set; }
+
     /// <summary>Comma-separated color family tags — e.g. "Blue,Purple".</summary>
     public string? ColorFamilies { get; set; }
 
@@ -60,6 +81,29 @@ public class PowderCatalogItem
 
     // ── Catalog management ────────────────────────────────────────────────
 
+    /// <summary>
+    /// Our internal product category — e.g. "Powder Additives" for pigments/additives that are
+    /// sold by weight in grams and mixed into clear rather than sprayed as a standalone powder.
+    /// Null/empty for standard powders. Derived at import from the vendor's taxonomy, NOT stored
+    /// from their raw category list.
+    /// </summary>
+    public string? Category { get; set; }
+
+    /// <summary>
+    /// Provenance of this record — e.g. "Columbia Coatings API". Kept SEPARATE from
+    /// <see cref="VendorName"/> (which holds the derived manufacturer) so we can honor a
+    /// distributor's right-to-delete by purging every record that came from their feed,
+    /// regardless of which manufacturer made the product.
+    /// </summary>
+    public string? Source { get; set; }
+
+    /// <summary>
+    /// Reformulation history as supplied by the vendor — e.g. "Formulation Change: 05/22/26".
+    /// Not a reliable modified-date (free text, reformulations only) but a useful signal that a
+    /// product's formula — and therefore its cure specs — may have changed.
+    /// </summary>
+    public string? FormulationChanges { get; set; }
+
     /// <summary>True when the vendor has discontinued this product. Kept for historical lookups.</summary>
     public bool IsDiscontinued { get; set; } = false;
 

src/PowderCoating.Infrastructure/Data/ApplicationDbContext.cs

@@ -1511,6 +1511,9 @@ modelBuilder.Entity<Job>()
         modelBuilder.Entity<InventoryItem>()
             .HasIndex(i => new { i.CompanyId, i.SKU })
             .IsUnique()
+            // Filter on IsDeleted so soft-deleted items don't reserve their SKU and block a new
+            // (or re-created) item from reusing it — matching the app's soft-delete semantics.
+            .HasFilter("[IsDeleted] = 0")
             .HasDatabaseName("IX_InventoryItems_CompanyId_SKU");
 
         modelBuilder.Entity<Company>()

src/PowderCoating.Infrastructure/Migrations/20260617142130_AddColumbiaCatalogIntegrationFields.cs

@@ -0,0 +1,141 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace PowderCoating.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddColumbiaCatalogIntegrationFields : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "Category",
+                table: "PowderCatalogItems",
+                type: "nvarchar(max)",
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "ChemistryType",
+                table: "PowderCatalogItems",
+                type: "nvarchar(max)",
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "CureCurvesJson",
+                table: "PowderCatalogItems",
+                type: "nvarchar(max)",
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "CureScheduleText",
+                table: "PowderCatalogItems",
+                type: "nvarchar(max)",
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "FormulationChanges",
+                table: "PowderCatalogItems",
+                type: "nvarchar(max)",
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "MilThickness",
+                table: "PowderCatalogItems",
+                type: "nvarchar(max)",
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "Source",
+                table: "PowderCatalogItems",
+                type: "nvarchar(max)",
+                nullable: true);
+
+            migrationBuilder.AddColumn<int>(
+                name: "PowderCatalogItemId",
+                table: "InventoryItems",
+                type: "int",
+                nullable: true);
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 1,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 21, 27, 126, DateTimeKind.Utc).AddTicks(6644));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 2,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 21, 27, 126, DateTimeKind.Utc).AddTicks(6651));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 3,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 21, 27, 126, DateTimeKind.Utc).AddTicks(6652));
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "Category",
+                table: "PowderCatalogItems");
+
+            migrationBuilder.DropColumn(
+                name: "ChemistryType",
+                table: "PowderCatalogItems");
+
+            migrationBuilder.DropColumn(
+                name: "CureCurvesJson",
+                table: "PowderCatalogItems");
+
+            migrationBuilder.DropColumn(
+                name: "CureScheduleText",
+                table: "PowderCatalogItems");
+
+            migrationBuilder.DropColumn(
+                name: "FormulationChanges",
+                table: "PowderCatalogItems");
+
+            migrationBuilder.DropColumn(
+                name: "MilThickness",
+                table: "PowderCatalogItems");
+
+            migrationBuilder.DropColumn(
+                name: "Source",
+                table: "PowderCatalogItems");
+
+            migrationBuilder.DropColumn(
+                name: "PowderCatalogItemId",
+                table: "InventoryItems");
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 1,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 14, 1, 21, 46, 131, DateTimeKind.Utc).AddTicks(4191));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 2,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 14, 1, 21, 46, 131, DateTimeKind.Utc).AddTicks(4196));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 3,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 14, 1, 21, 46, 131, DateTimeKind.Utc).AddTicks(4197));
+        }
+    }
+}

src/PowderCoating.Infrastructure/Migrations/20260617144443_SeedColumbiaSyncSettings.cs

@@ -0,0 +1,88 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace PowderCoating.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class SeedColumbiaSyncSettings : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            // Seed the SuperAdmin-managed platform settings for the Columbia Coatings catalog sync.
+            // Idempotent so it is safe against a DB where keys were added manually. The API key
+            // itself is NOT here — secrets live in configuration (Columbia:ApiKey), not this table.
+            migrationBuilder.Sql(@"
+                IF NOT EXISTS (SELECT 1 FROM PlatformSettings WHERE [Key] = 'ColumbiaSyncEnabled')
+                    INSERT INTO PlatformSettings ([Key],[Value],[Label],[Description],[GroupName])
+                    VALUES ('ColumbiaSyncEnabled','false','Columbia Coatings Sync Enabled','Master switch for the scheduled Columbia Coatings catalog sync. When off, no automatic or manual sync runs regardless of the configured API key.','Integrations');
+
+                IF NOT EXISTS (SELECT 1 FROM PlatformSettings WHERE [Key] = 'ColumbiaSyncIntervalDays')
+                    INSERT INTO PlatformSettings ([Key],[Value],[Label],[Description],[GroupName])
+                    VALUES ('ColumbiaSyncIntervalDays','7','Columbia Sync Interval (days)','How many days between automatic Columbia catalog syncs. A full sync is cheap (~25 API calls), so daily (1) or weekly (7) keeps pricing fresh.','Integrations');
+
+                IF NOT EXISTS (SELECT 1 FROM PlatformSettings WHERE [Key] = 'ColumbiaLastSyncedAt')
+                    INSERT INTO PlatformSettings ([Key],[Value],[Label],[Description],[GroupName])
+                    VALUES ('ColumbiaLastSyncedAt',NULL,'Columbia Last Synced At','Timestamp (UTC) of the last successful Columbia catalog sync. Set automatically by the sync job.','Integrations');
+
+                IF NOT EXISTS (SELECT 1 FROM PlatformSettings WHERE [Key] = 'ColumbiaLastSyncResult')
+                    INSERT INTO PlatformSettings ([Key],[Value],[Label],[Description],[GroupName])
+                    VALUES ('ColumbiaLastSyncResult',NULL,'Columbia Last Sync Result','Summary of the last Columbia catalog sync run (inserted/updated/discontinued counts or error). Set automatically by the sync job.','Integrations');
+            ");
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 1,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 44, 40, 147, DateTimeKind.Utc).AddTicks(5997));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 2,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 44, 40, 147, DateTimeKind.Utc).AddTicks(6002));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 3,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 44, 40, 147, DateTimeKind.Utc).AddTicks(6003));
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.Sql(@"
+                DELETE FROM PlatformSettings WHERE [Key] IN (
+                    'ColumbiaSyncEnabled','ColumbiaSyncIntervalDays','ColumbiaLastSyncedAt','ColumbiaLastSyncResult'
+                );
+            ");
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 1,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 21, 27, 126, DateTimeKind.Utc).AddTicks(6644));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 2,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 21, 27, 126, DateTimeKind.Utc).AddTicks(6651));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 3,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 21, 27, 126, DateTimeKind.Utc).AddTicks(6652));
+        }
+    }
+}

src/PowderCoating.Infrastructure/Migrations/20260617163309_FilterInventorySkuUniqueIndexOnSoftDelete.cs

@@ -0,0 +1,82 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace PowderCoating.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class FilterInventorySkuUniqueIndexOnSoftDelete : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_InventoryItems_CompanyId_SKU",
+                table: "InventoryItems");
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 1,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 16, 33, 6, 662, DateTimeKind.Utc).AddTicks(4251));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 2,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 16, 33, 6, 662, DateTimeKind.Utc).AddTicks(4258));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 3,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 16, 33, 6, 662, DateTimeKind.Utc).AddTicks(4259));
+
+            migrationBuilder.CreateIndex(
+                name: "IX_InventoryItems_CompanyId_SKU",
+                table: "InventoryItems",
+                columns: new[] { "CompanyId", "SKU" },
+                unique: true,
+                filter: "[IsDeleted] = 0");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_InventoryItems_CompanyId_SKU",
+                table: "InventoryItems");
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 1,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 44, 40, 147, DateTimeKind.Utc).AddTicks(5997));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 2,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 44, 40, 147, DateTimeKind.Utc).AddTicks(6002));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 3,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 14, 44, 40, 147, DateTimeKind.Utc).AddTicks(6003));
+
+            migrationBuilder.CreateIndex(
+                name: "IX_InventoryItems_CompanyId_SKU",
+                table: "InventoryItems",
+                columns: new[] { "CompanyId", "SKU" },
+                unique: true);
+        }
+    }
+}

src/PowderCoating.Infrastructure/Migrations/20260617192646_AddInventoryCatalogReferencePrice.cs

@@ -0,0 +1,81 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace PowderCoating.Infrastructure.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddInventoryCatalogReferencePrice : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<DateTime>(
+                name: "CatalogPriceUpdatedAt",
+                table: "InventoryItems",
+                type: "datetime2",
+                nullable: true);
+
+            migrationBuilder.AddColumn<decimal>(
+                name: "CatalogReferencePrice",
+                table: "InventoryItems",
+                type: "decimal(18,2)",
+                nullable: true);
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 1,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 19, 26, 43, 161, DateTimeKind.Utc).AddTicks(2051));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 2,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 19, 26, 43, 161, DateTimeKind.Utc).AddTicks(2056));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 3,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 19, 26, 43, 161, DateTimeKind.Utc).AddTicks(2057));
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "CatalogPriceUpdatedAt",
+                table: "InventoryItems");
+
+            migrationBuilder.DropColumn(
+                name: "CatalogReferencePrice",
+                table: "InventoryItems");
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 1,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 16, 33, 6, 662, DateTimeKind.Utc).AddTicks(4251));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 2,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 16, 33, 6, 662, DateTimeKind.Utc).AddTicks(4258));
+
+            migrationBuilder.UpdateData(
+                table: "PricingTiers",
+                keyColumn: "Id",
+                keyValue: 3,
+                column: "CreatedAt",
+                value: new DateTime(2026, 6, 17, 16, 33, 6, 662, DateTimeKind.Utc).AddTicks(4259));
+        }
+    }
+}

src/PowderCoating.Infrastructure/Migrations/ApplicationDbContextModelSnapshot.cs

@@ -4075,6 +4075,12 @@ namespace PowderCoating.Infrastructure.Migrations
                     b.Property<decimal>("AverageCost")
                         .HasColumnType("decimal(18,2)");
 
+                    b.Property<DateTime?>("CatalogPriceUpdatedAt")
+                        .HasColumnType("datetime2");
+
+                    b.Property<decimal?>("CatalogReferencePrice")
+                        .HasColumnType("decimal(18,2)");
+
                     b.Property<string>("Category")
                         .IsRequired()
                         .HasColumnType("nvarchar(max)");
@@ -4173,6 +4179,9 @@ namespace PowderCoating.Infrastructure.Migrations
                     b.Property<string>("Notes")
                         .HasColumnType("nvarchar(max)");
 
+                    b.Property<int?>("PowderCatalogItemId")
+                        .HasColumnType("int");
+
                     b.Property<int?>("PrimaryVendorId")
                         .HasColumnType("int");
 
@@ -4241,7 +4250,8 @@ namespace PowderCoating.Infrastructure.Migrations
 
                     b.HasIndex("CompanyId", "SKU")
                         .IsUnique()
-                        .HasDatabaseName("IX_InventoryItems_CompanyId_SKU");
+                        .HasDatabaseName("IX_InventoryItems_CompanyId_SKU")
+                        .HasFilter("[IsDeleted] = 0");
 
                     b.HasIndex("CompanyId", "QuantityOnHand", "ReorderPoint")
                         .HasDatabaseName("IX_InventoryItems_CompanyId_Quantity_Reorder");
@@ -6936,6 +6946,12 @@ namespace PowderCoating.Infrastructure.Migrations
                     b.Property<string>("ApplicationGuideUrl")
                         .HasColumnType("nvarchar(max)");
 
+                    b.Property<string>("Category")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("ChemistryType")
+                        .HasColumnType("nvarchar(max)");
+
                     b.Property<string>("ColorFamilies")
                         .HasColumnType("nvarchar(max)");
 
@@ -6949,6 +6965,12 @@ namespace PowderCoating.Infrastructure.Migrations
                     b.Property<DateTime>("CreatedAt")
                         .HasColumnType("datetime2");
 
+                    b.Property<string>("CureCurvesJson")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("CureScheduleText")
+                        .HasColumnType("nvarchar(max)");
+
                     b.Property<decimal?>("CureTemperatureF")
                         .HasColumnType("decimal(18,2)");
 
@@ -6961,6 +6983,9 @@ namespace PowderCoating.Infrastructure.Migrations
                     b.Property<string>("Finish")
                         .HasColumnType("nvarchar(max)");
 
+                    b.Property<string>("FormulationChanges")
+                        .HasColumnType("nvarchar(max)");
+
                     b.Property<string>("ImageUrl")
                         .HasColumnType("nvarchar(max)");
 
@@ -6973,6 +6998,9 @@ namespace PowderCoating.Infrastructure.Migrations
                     b.Property<DateTime?>("LastSyncedAt")
                         .HasColumnType("datetime2");
 
+                    b.Property<string>("MilThickness")
+                        .HasColumnType("nvarchar(max)");
+
                     b.Property<string>("PriceTiersJson")
                         .HasColumnType("nvarchar(max)");
 
@@ -6989,6 +7017,9 @@ namespace PowderCoating.Infrastructure.Migrations
                         .IsRequired()
                         .HasColumnType("nvarchar(450)");
 
+                    b.Property<string>("Source")
+                        .HasColumnType("nvarchar(max)");
+
                     b.Property<decimal?>("SpecificGravity")
                         .HasColumnType("decimal(18,2)");
 
@@ -7210,7 +7241,7 @@ namespace PowderCoating.Infrastructure.Migrations
                         {
                             Id = 1,
                             CompanyId = 0,
-                            CreatedAt = new DateTime(2026, 6, 14, 1, 21, 46, 131, DateTimeKind.Utc).AddTicks(4191),
+                            CreatedAt = new DateTime(2026, 6, 17, 19, 26, 43, 161, DateTimeKind.Utc).AddTicks(2051),
                             Description = "Standard pricing for regular customers",
                             DiscountPercent = 0m,
                             IsActive = true,
@@ -7221,7 +7252,7 @@ namespace PowderCoating.Infrastructure.Migrations
                         {
                             Id = 2,
                             CompanyId = 0,
-                            CreatedAt = new DateTime(2026, 6, 14, 1, 21, 46, 131, DateTimeKind.Utc).AddTicks(4196),
+                            CreatedAt = new DateTime(2026, 6, 17, 19, 26, 43, 161, DateTimeKind.Utc).AddTicks(2056),
                             Description = "5% discount for preferred customers",
                             DiscountPercent = 5m,
                             IsActive = true,
@@ -7232,7 +7263,7 @@ namespace PowderCoating.Infrastructure.Migrations
                         {
                             Id = 3,
                             CompanyId = 0,
-                            CreatedAt = new DateTime(2026, 6, 14, 1, 21, 46, 131, DateTimeKind.Utc).AddTicks(4197),
+                            CreatedAt = new DateTime(2026, 6, 17, 19, 26, 43, 161, DateTimeKind.Utc).AddTicks(2057),
                             Description = "10% discount for premium customers",
                             DiscountPercent = 10m,
                             IsActive = true,

src/PowderCoating.Infrastructure/Services/Columbia/ColumbiaCatalogMapper.cs

@@ -0,0 +1,299 @@
+using System.Globalization;
+using System.Net;
+using System.Text.Json;
+using System.Text.RegularExpressions;
+using PowderCoating.Application.Constants;
+using PowderCoating.Application.DTOs.Columbia;
+using PowderCoating.Core.Entities;
+
+namespace PowderCoating.Infrastructure.Services.Columbia;
+
+/// <summary>
+/// Maps a Columbia Coatings API product onto our platform <see cref="PowderCatalogItem"/>.
+/// Pure, static, side-effect free so the tricky bits (manufacturer derivation, the free-text
+/// cure-schedule parser, HTML stripping) can be unit tested directly against captured fixtures.
+/// <para>
+/// Columbia is a distributor reselling multiple brands, so <see cref="PowderCatalogItem.VendorName"/>
+/// holds the DERIVED manufacturer (PPG / KP Pigments / Columbia) while
+/// <see cref="PowderCatalogItem.Source"/> records the feed ("Columbia Coatings API") for
+/// right-to-delete purges. The vendor's own categories/tags are read here only to derive the
+/// manufacturer and additive flag — they are never stored raw.
+/// </para>
+/// </summary>
+public static class ColumbiaCatalogMapper
+{
+    /// <summary>A single parsed cure curve — hold <see cref="Minutes"/> at <see cref="TempF"/>.</summary>
+    public readonly record struct CureCurve(int TempF, int Minutes);
+
+    // Resin chemistries that mean "polyester + TGIC" but arrive formatted three different ways.
+    private static readonly Regex PolyesterTgic =
+        new(@"^\s*(polyester\s*[/ ]\s*tgic|tgic\s*[/ ]\s*polyester)\s*$", RegexOptions.IgnoreCase | RegexOptions.Compiled);
+
+    // "10 minutes @ 400°F", "7 minutes at 375 F", "Metal Temperature: 10 minutes at 400°F (204°C)".
+    // Degree glyph is optional and may be ° (U+00B0), ˚ (U+02DA), or º (U+00BA).
+    private static readonly Regex CureCurveRegex =
+        new(@"(\d+)\s*min(?:ute)?s?\.?\s*(?:@|at)\s*(\d{2,3})\s*[°˚º]?\s*F",
+            RegexOptions.IgnoreCase | RegexOptions.Compiled);
+
+    private static readonly Regex HtmlTag = new("<[^>]+>", RegexOptions.Compiled);
+    private static readonly Regex WhitespaceRun = new(@"\s{2,}", RegexOptions.Compiled);
+
+    private static readonly JsonSerializerOptions JsonOut = new() { WriteIndented = false };
+
+    /// <summary>
+    /// True for products that should not be in the powder catalog as standalone colors:
+    /// physical swatch cards (not powder at all), and tester (4 oz) / sample (5 lb) listings that
+    /// are just smaller SIZES of a parent powder that already exists as its own product. Detected
+    /// by specific SKU suffixes (-SW / -04) and unambiguous name markers ("SWATCH", "Tester",
+    /// "Sample ("). The sample-size "-S" SKU suffix is intentionally NOT used on its own — the
+    /// "Sample (" name marker catches every sample without risking a real SKU that ends in -S.
+    /// </summary>
+    public static bool IsExcludedProduct(ColumbiaProduct p)
+    {
+        var sku = p.Sku ?? string.Empty;
+        if (sku.EndsWith("-SW", StringComparison.OrdinalIgnoreCase)
+            || sku.EndsWith("-04", StringComparison.OrdinalIgnoreCase))
+            return true;
+
+        var name = p.Name ?? string.Empty;
+        return name.Contains("SWATCH", StringComparison.OrdinalIgnoreCase)
+            || name.Contains("Tester", StringComparison.OrdinalIgnoreCase)
+            || name.Contains("Sample (", StringComparison.OrdinalIgnoreCase);
+    }
+
+    /// <summary>Maps a Columbia product into a fully populated (unsaved) catalog item.</summary>
+    public static PowderCatalogItem Map(ColumbiaProduct p)
+    {
+        var curves = ParseCureCurves(p.CureSchedule);
+        var primary = curves.Count > 0 ? curves[0] : (CureCurve?)null;
+
+        return new PowderCatalogItem
+        {
+            VendorName = DeriveManufacturer(p),
+            Sku = p.Sku.Trim(),
+            ColorName = p.Name.Trim(),
+            Source = ColumbiaIntegrationConstants.SourceName,
+            Category = IsAdditive(p) ? ColumbiaIntegrationConstants.CategoryPowderAdditives : null,
+
+            Description = StripHtml(p.Description),
+            UnitPrice = ParseBasePrice(p),
+            PriceTiersJson = BuildPriceTiersJson(p),
+
+            ImageUrl = NullIfBlank(p.FeaturedImage?.Src),
+            SdsUrl = NullIfBlank(p.SafetyDataSheet),
+            TdsUrl = NullIfBlank(p.TechnicalDataSheet),
+            ApplicationGuideUrl = NullIfBlank(FirstNonBlank(p.ProductFlyer, p.ProductBrochure)),
+            ProductUrl = NullIfBlank(p.Permalink),
+
+            ChemistryType = NormalizeChemistry(p.Type),
+            MilThickness = NullIfBlank(p.MilThickness),
+            CureScheduleText = NullIfBlank(p.CureSchedule),
+            CureCurvesJson = curves.Count > 0 ? JsonSerializer.Serialize(curves, JsonOut) : null,
+            CureTemperatureF = primary?.TempF,
+            CureTimeMinutes = primary?.Minutes,
+            RequiresClearCoat = DetectRequiresClearCoat(p),
+
+            ColorFamilies = BuildColorFamilies(p),
+            FormulationChanges = NullIfBlank(p.FormulationDateChanges),
+
+            // Coverage / specific gravity / transfer efficiency are not in the API — left null for
+            // lazy TDS/AI enrichment on first use. IsDiscontinued is handled by the sync sweep.
+        };
+    }
+
+    // ── Manufacturer derivation ───────────────────────────────────────────
+
+    /// <summary>
+    /// Derives the manufacturer from the product's taxonomy/SKU. Columbia resells PPG powders and
+    /// KP Pigments additives through the same feed; everything else is Columbia's own brand.
+    /// </summary>
+    public static string DeriveManufacturer(ColumbiaProduct p)
+    {
+        if (IsKpPigments(p))
+            return ColumbiaIntegrationConstants.ManufacturerKp;
+        if (IsPpg(p))
+            return ColumbiaIntegrationConstants.ManufacturerPpg;
+        return ColumbiaIntegrationConstants.ManufacturerColumbia;
+    }
+
+    private static bool IsKpPigments(ColumbiaProduct p) =>
+        p.Sku.StartsWith("ADD-", StringComparison.OrdinalIgnoreCase)
+        || CategoryStartsWith(p, "KP");
+
+    private static bool IsPpg(ColumbiaProduct p) =>
+        CategoryStartsWith(p, "PPG");
+
+    /// <summary>
+    /// True for pigments/additives sold by weight (grams) rather than sprayed powders. These get
+    /// forced into the "Powder Additives" category. Keyed off the broad Additives category and the
+    /// ADD- SKU prefix, not just the KP brand (there are ~98 non-KP additives).
+    /// </summary>
+    public static bool IsAdditive(ColumbiaProduct p) =>
+        p.Sku.StartsWith("ADD-", StringComparison.OrdinalIgnoreCase)
+        || p.Categories.Any(c => c.Name.Equals("Additives", StringComparison.OrdinalIgnoreCase))
+        || CategoryStartsWith(p, "KP");
+
+    private static bool CategoryStartsWith(ColumbiaProduct p, string prefix) =>
+        p.Categories.Any(c => c.Name.StartsWith(prefix, StringComparison.OrdinalIgnoreCase));
+
+    // ── Pricing ───────────────────────────────────────────────────────────
+
+    /// <summary>
+    /// Base unit price = the top-level <c>price</c> (falling back to <c>regular_price</c>). For
+    /// variable products the parent <c>price</c> already carries the lead variant's price, while
+    /// <c>regular_price</c> is often "0", so price is preferred.
+    /// </summary>
+    public static decimal ParseBasePrice(ColumbiaProduct p)
+    {
+        if (TryParseMoney(p.Price, out var price) && price > 0)
+            return price;
+        if (TryParseMoney(p.RegularPrice, out var regular) && regular > 0)
+            return regular;
+
+        // Variable product with a zero parent price: fall back to the lowest variant price.
+        var variantPrices = (p.VariationPricing ?? new List<ColumbiaVariationPricing>())
+            .Select(v => TryParseMoney(v.Price, out var vp) ? vp : 0m)
+            .Where(v => v > 0)
+            .ToList();
+        return variantPrices.Count > 0 ? variantPrices.Min() : 0m;
+    }
+
+    /// <summary>
+    /// Captures quantity-break / variant pricing as JSON for later use. For variable products this
+    /// is the per-variant pricing (Bulk vs 1 lb Bags, gram sizes); for simple products it's the
+    /// tiered_pricing object. Null when neither is present.
+    /// </summary>
+    public static string? BuildPriceTiersJson(ColumbiaProduct p)
+    {
+        if (p.VariationPricing is { Count: > 0 })
+            return JsonSerializer.Serialize(p.VariationPricing, JsonOut);
+
+        if (p.TieredPricing is { ValueKind: JsonValueKind.Object } tiered)
+        {
+            // Only keep it if it actually carries tiers (avoid storing empty {type,...} shells).
+            if (tiered.TryGetProperty("tiers", out var tiers)
+                && tiers.ValueKind == JsonValueKind.Array
+                && tiers.GetArrayLength() > 0)
+            {
+                return tiered.GetRawText();
+            }
+        }
+
+        return null;
+    }
+
+    private static bool TryParseMoney(string? s, out decimal value) =>
+        decimal.TryParse(s, NumberStyles.Any, CultureInfo.InvariantCulture, out value);
+
+    // ── Cure schedule parsing ─────────────────────────────────────────────
+
+    /// <summary>
+    /// Extracts every "N minutes at/@ TTT°F" curve from a free-text cure schedule, in document
+    /// order. The first is treated as the primary/standard curve; the rest are alternate (often
+    /// lower-temperature) curves preserved for heat-sensitive substrates. Returns an empty list for
+    /// schedules with no parseable temp/time pair (partial-cure / clear-coat instructions).
+    /// </summary>
+    public static List<CureCurve> ParseCureCurves(string? cureSchedule)
+    {
+        var result = new List<CureCurve>();
+        if (string.IsNullOrWhiteSpace(cureSchedule))
+            return result;
+
+        foreach (Match m in CureCurveRegex.Matches(cureSchedule))
+        {
+            if (int.TryParse(m.Groups[1].Value, out var minutes)
+                && int.TryParse(m.Groups[2].Value, out var tempF)
+                && tempF is >= 150 and <= 600 // sanity: real cure temps
+                && minutes is > 0 and <= 120)
+            {
+                var curve = new CureCurve(tempF, minutes);
+                if (!result.Contains(curve))
+                    result.Add(curve);
+            }
+        }
+
+        return result;
+    }
+
+    // Powders that genuinely REQUIRE a clear coat say so explicitly. A casual "apply a clear coat
+    // for added durability" must NOT trip this — that over-flagged ~half the catalog and would pad
+    // quotes with unnecessary clear-coat steps.
+    private static readonly string[] RequiresClearPhrases =
+    {
+        "requires a clear", "requires clear", "require a clear",
+        "must be clear coated", "must be cleared", "needs a clear",
+        "clear coat is required", "clear coat required", "requires a clearcoat",
+        "requires a top coat", "clear coat to activate", "clear coat to achieve",
+        "requires a clear coat",
+    };
+
+    /// <summary>
+    /// Flags powders that genuinely need a clear coat: multi-step partial-cure (Illusion-style)
+    /// schedules, Columbia's named "Illusion" line, or explicit requirement phrasing. Casual
+    /// "you can clear coat this" mentions are intentionally ignored.
+    /// </summary>
+    public static bool DetectRequiresClearCoat(ColumbiaProduct p)
+    {
+        var cure = p.CureSchedule ?? string.Empty;
+        var name = p.Name ?? string.Empty;
+
+        // Partial-cure / multi-step instructions are the "apply this, then clear" case.
+        if (cure.Contains("partial cure", StringComparison.OrdinalIgnoreCase))
+            return true;
+
+        // Columbia's Illusion line needs a clear top coat to develop the effect.
+        if (name.Contains("Illusion", StringComparison.OrdinalIgnoreCase))
+            return true;
+
+        var text = $"{name} {cure} {p.Description}";
+        return RequiresClearPhrases.Any(phrase => text.Contains(phrase, StringComparison.OrdinalIgnoreCase));
+    }
+
+    // ── Misc field helpers ────────────────────────────────────────────────
+
+    /// <summary>Joins the color-group taxonomy ({name} entries) into a comma-separated families string.</summary>
+    public static string? BuildColorFamilies(ColumbiaProduct p)
+    {
+        var groups = p.PaColorGroup.Select(g => g.Name.Trim()).Where(n => n.Length > 0).Distinct().ToList();
+
+        if (groups.Count == 0)
+        {
+            // Fall back to the "Color Group" attribute options when the taxonomy is empty.
+            groups = p.Attributes
+                .Where(a => a.Name.Equals("Color Group", StringComparison.OrdinalIgnoreCase))
+                .SelectMany(a => a.Options.Select(o => o.Name.Trim()))
+                .Where(n => n.Length > 0)
+                .Distinct()
+                .ToList();
+        }
+
+        return groups.Count > 0 ? string.Join(",", groups) : null;
+    }
+
+    /// <summary>Normalizes resin chemistry — trims, and collapses the three Polyester/TGIC spellings.</summary>
+    public static string? NormalizeChemistry(string? type)
+    {
+        if (string.IsNullOrWhiteSpace(type))
+            return null;
+        var trimmed = type.Trim();
+        return PolyesterTgic.IsMatch(trimmed) ? "Polyester/TGIC" : trimmed;
+    }
+
+    /// <summary>Strips HTML tags/entities from a description and collapses whitespace to plain text.</summary>
+    public static string? StripHtml(string? html)
+    {
+        if (string.IsNullOrWhiteSpace(html))
+            return null;
+
+        var text = HtmlTag.Replace(html, " ");
+        text = WebUtility.HtmlDecode(text);
+        text = text.Replace("\r", " ").Replace("\n", " ").Replace("\t", " ");
+        text = WhitespaceRun.Replace(text, " ").Trim();
+        return text.Length > 0 ? text : null;
+    }
+
+    private static string? NullIfBlank(string? s) => string.IsNullOrWhiteSpace(s) ? null : s.Trim();
+
+    private static string? FirstNonBlank(params string?[] values) =>
+        values.FirstOrDefault(v => !string.IsNullOrWhiteSpace(v));
+}

src/PowderCoating.Infrastructure/Services/Columbia/ColumbiaCatalogSyncService.cs

@@ -0,0 +1,187 @@
+using System.Diagnostics;
+using System.Globalization;
+using Microsoft.Extensions.Logging;
+using PowderCoating.Application.Constants;
+using PowderCoating.Application.Interfaces;
+using PowderCoating.Core.Entities;
+using PowderCoating.Core.Interfaces;
+
+namespace PowderCoating.Infrastructure.Services.Columbia;
+
+/// <summary>
+/// Full Columbia Coatings catalog sync: pages the API, maps each product, upserts via the shared
+/// <see cref="IPowderCatalogUpsertService"/>, then reconciles discontinuations against the complete
+/// pull. The discontinuation sweep runs ONLY after a successful full fetch — a partial pull (any
+/// page failure throws from the client) aborts before the sweep so a transient error can never mass
+/// flag the catalog as discontinued.
+/// </summary>
+public class ColumbiaCatalogSyncService : IColumbiaCatalogSyncService
+{
+    private readonly IColumbiaCoatingsApiClient _client;
+    private readonly IPowderCatalogUpsertService _upsert;
+    private readonly IUnitOfWork _unitOfWork;
+    private readonly IPlatformSettingsService _settings;
+    private readonly ILogger<ColumbiaCatalogSyncService> _logger;
+
+    public ColumbiaCatalogSyncService(
+        IColumbiaCoatingsApiClient client,
+        IPowderCatalogUpsertService upsert,
+        IUnitOfWork unitOfWork,
+        IPlatformSettingsService settings,
+        ILogger<ColumbiaCatalogSyncService> logger)
+    {
+        _client = client;
+        _upsert = upsert;
+        _unitOfWork = unitOfWork;
+        _settings = settings;
+        _logger = logger;
+    }
+
+    /// <inheritdoc />
+    public async Task<ColumbiaSyncResult> RunSyncAsync(CancellationToken cancellationToken = default)
+    {
+        var result = new ColumbiaSyncResult { StartedAt = DateTime.UtcNow };
+        var stopwatch = Stopwatch.StartNew();
+
+        if (!_client.IsConfigured)
+        {
+            result.ErrorMessage = "Columbia API key is not configured.";
+            await RecordResultAsync(result);
+            return result;
+        }
+
+        try
+        {
+            // Full pull — throws on any page failure, which we treat as an incomplete sync.
+            var products = await _client.GetAllProductsAsync(cancellationToken);
+            result.TotalFetched = products.Count;
+
+            // Map and de-duplicate by (VendorName, SKU) in case the feed repeats a SKU.
+            // Exclude swatch cards and tester/sample size-variants — not standalone powder colors.
+            var mapped = products
+                .Where(p => !ColumbiaCatalogMapper.IsExcludedProduct(p))
+                .Select(ColumbiaCatalogMapper.Map)
+                .Where(m => !string.IsNullOrWhiteSpace(m.Sku))
+                .GroupBy(m => $"{m.VendorName}|{m.Sku}", StringComparer.OrdinalIgnoreCase)
+                .Select(g => g.First())
+                .ToList();
+
+            var upsertResult = await _upsert.UpsertAsync(mapped, result.StartedAt, cancellationToken);
+            result.Inserted = upsertResult.Inserted;
+            result.Updated = upsertResult.Updated;
+            result.Unchanged = upsertResult.Unchanged;
+            result.Skipped = upsertResult.Skipped;
+
+            // Remove any excluded records (swatches) that were synced before the exclusion existed,
+            // so they're deleted outright rather than lingering as "discontinued" powders.
+            await RemoveExcludedRecordsAsync();
+
+            // Complete pull succeeded — safe to reconcile discontinuations.
+            var incomingKeys = mapped
+                .Select(m => $"{m.VendorName}|{m.Sku}")
+                .ToHashSet(StringComparer.OrdinalIgnoreCase);
+            (result.Discontinued, result.Reactivated) =
+                await ReconcileDiscontinuationsAsync(incomingKeys, result.StartedAt);
+
+            result.Success = true;
+        }
+        catch (OperationCanceledException)
+        {
+            throw;
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Columbia catalog sync failed; skipping discontinuation sweep.");
+            result.Success = false;
+            result.ErrorMessage = ex.Message;
+        }
+
+        stopwatch.Stop();
+        result.Duration = stopwatch.Elapsed;
+        await RecordResultAsync(result);
+        return result;
+    }
+
+    /// <summary>
+    /// Flags catalog items sourced from Columbia that were NOT in this complete pull as discontinued,
+    /// and reactivates any previously-discontinued item that has reappeared. Returns (discontinued,
+    /// reactivated) counts.
+    /// </summary>
+    private async Task<(int Discontinued, int Reactivated)> ReconcileDiscontinuationsAsync(
+        HashSet<string> incomingKeys, DateTime runTimestamp)
+    {
+        var sourced = await _unitOfWork.PowderCatalog.FindAsync(
+            p => p.Source == ColumbiaIntegrationConstants.SourceName);
+
+        var discontinued = 0;
+        var reactivated = 0;
+
+        foreach (var item in sourced)
+        {
+            var present = incomingKeys.Contains($"{item.VendorName}|{item.Sku}");
+
+            if (!present && !item.IsDiscontinued)
+            {
+                item.IsDiscontinued = true;
+                item.UpdatedAt = runTimestamp;
+                await _unitOfWork.PowderCatalog.UpdateAsync(item);
+                discontinued++;
+            }
+            else if (present && item.IsDiscontinued)
+            {
+                item.IsDiscontinued = false;
+                item.UpdatedAt = runTimestamp;
+                await _unitOfWork.PowderCatalog.UpdateAsync(item);
+                reactivated++;
+            }
+        }
+
+        if (discontinued > 0 || reactivated > 0)
+            await _unitOfWork.CompleteAsync();
+
+        return (discontinued, reactivated);
+    }
+
+    /// <summary>
+    /// Deletes Columbia-sourced catalog rows that should not be in the catalog (swatch cards and
+    /// tester/sample size-variants). Mirrors <see cref="ColumbiaCatalogMapper.IsExcludedProduct"/>
+    /// on the stored columns. A no-op once the catalog is clean; guards against records synced
+    /// before the exclusion rule and ensures excluded items are removed, not flagged discontinued.
+    /// </summary>
+    private async Task RemoveExcludedRecordsAsync()
+    {
+        var excluded = (await _unitOfWork.PowderCatalog.FindAsync(p =>
+            p.Source == ColumbiaIntegrationConstants.SourceName
+            && (p.Sku.EndsWith("-SW")
+                || p.Sku.EndsWith("-04")
+                || p.ColorName.Contains("SWATCH")
+                || p.ColorName.Contains("Tester")
+                || p.ColorName.Contains("Sample (")))).ToList();
+
+        if (excluded.Count == 0)
+            return;
+
+        foreach (var e in excluded)
+            await _unitOfWork.PowderCatalog.DeleteAsync(e);
+        await _unitOfWork.CompleteAsync();
+
+        _logger.LogInformation("Columbia sync: removed {Count} excluded record(s) (swatch/tester/sample) from the catalog.", excluded.Count);
+    }
+
+    /// <summary>Persists the run outcome to the last-synced / last-result platform settings.</summary>
+    private async Task RecordResultAsync(ColumbiaSyncResult result)
+    {
+        if (result.Success)
+        {
+            await _settings.SetAsync(
+                ColumbiaIntegrationConstants.SettingLastSyncedAt,
+                result.StartedAt.ToString("O", CultureInfo.InvariantCulture),
+                updatedBy: "Columbia Sync");
+        }
+
+        await _settings.SetAsync(
+            ColumbiaIntegrationConstants.SettingLastResult,
+            result.Summary,
+            updatedBy: "Columbia Sync");
+    }
+}

src/PowderCoating.Infrastructure/Services/ColumbiaCoatingsApiClient.cs

@@ -0,0 +1,199 @@
+using System.Net;
+using System.Text.Json;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Logging;
+using PowderCoating.Application.Constants;
+using PowderCoating.Application.DTOs.Columbia;
+using PowderCoating.Application.Interfaces;
+
+namespace PowderCoating.Infrastructure.Services;
+
+/// <summary>
+/// HTTP client for the Columbia Coatings product catalog API. Reads the API key and base URL from
+/// configuration (<c>Columbia:ApiKey</c> / <c>Columbia:BaseUrl</c>), sends the <c>X-API-Key</c>
+/// header, and pages the catalog via <c>GET /products</c>. Honors the documented rate limit
+/// (120 requests / 60s) by retrying on HTTP 429 after the <c>Retry-After</c> interval.
+/// </summary>
+public class ColumbiaCoatingsApiClient : IColumbiaCoatingsApiClient
+{
+    private const int MaxRetriesPer429 = 5;
+    private const int DefaultRetryAfterSeconds = 5;
+    private const int MaxPagesSafetyCap = 1000; // guards against a server that never reports last page
+
+    private readonly IHttpClientFactory _httpClientFactory;
+    private readonly IConfiguration _config;
+    private readonly ILogger<ColumbiaCoatingsApiClient> _logger;
+
+    /// <summary>
+    /// Columbia returns snake_case JSON; the snake-case naming policy binds it to our PascalCase DTOs
+    /// without per-property attributes. Case-insensitive as a belt-and-braces fallback.
+    /// </summary>
+    private static readonly JsonSerializerOptions JsonOptions = new()
+    {
+        PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower,
+        PropertyNameCaseInsensitive = true,
+        Converters = { new ColumbiaImageJsonConverter() },
+    };
+
+    public ColumbiaCoatingsApiClient(
+        IHttpClientFactory httpClientFactory,
+        IConfiguration config,
+        ILogger<ColumbiaCoatingsApiClient> logger)
+    {
+        _httpClientFactory = httpClientFactory;
+        _config = config;
+        _logger = logger;
+    }
+
+    private string? ApiKey => _config[ColumbiaIntegrationConstants.ConfigApiKey];
+
+    private string BaseUrl =>
+        (_config[ColumbiaIntegrationConstants.ConfigBaseUrl] ?? ColumbiaIntegrationConstants.DefaultBaseUrl)
+            .TrimEnd('/');
+
+    private string ApiBasePath =>
+        (_config[ColumbiaIntegrationConstants.ConfigApiBasePath] ?? ColumbiaIntegrationConstants.DefaultApiBasePath)
+            .Trim('/');
+
+    /// <summary>Fully-qualified products endpoint: host + configurable API base path + /products.</summary>
+    private string ProductsUrl => $"{BaseUrl}/{ApiBasePath}{ColumbiaIntegrationConstants.ProductsResource}";
+
+    public bool IsConfigured => !string.IsNullOrWhiteSpace(ApiKey);
+
+    /// <inheritdoc />
+    public async Task<ColumbiaProductsResponse> GetProductsPageAsync(
+        int page, int perPage, CancellationToken cancellationToken = default)
+    {
+        EnsureConfigured();
+        perPage = Math.Clamp(perPage, 1, ColumbiaIntegrationConstants.MaxPerPage);
+        var url = $"{ProductsUrl}?page={page}&per_page={perPage}";
+
+        var json = await SendWithRetryAsync(url, $"page {page}", cancellationToken);
+        if (json == null)
+            return new ColumbiaProductsResponse();
+
+        return JsonSerializer.Deserialize<ColumbiaProductsResponse>(json, JsonOptions) ?? new ColumbiaProductsResponse();
+    }
+
+    /// <inheritdoc />
+    public async Task<ColumbiaProduct?> GetProductBySkuAsync(string sku, CancellationToken cancellationToken = default)
+    {
+        EnsureConfigured();
+        if (string.IsNullOrWhiteSpace(sku))
+            return null;
+
+        var url = $"{ProductsUrl}?sku={Uri.EscapeDataString(sku)}&per_page=1";
+        var json = await SendWithRetryAsync(url, $"sku {sku}", cancellationToken);
+        if (json == null)
+            return null;
+
+        var response = JsonSerializer.Deserialize<ColumbiaProductsResponse>(json, JsonOptions);
+        return response?.Items.FirstOrDefault();
+    }
+
+    /// <inheritdoc />
+    public async Task<ColumbiaProduct?> GetProductByIdAsync(int id, CancellationToken cancellationToken = default)
+    {
+        EnsureConfigured();
+        // The by-id endpoint returns a bare product object (not the {items,pagination} envelope).
+        var url = $"{ProductsUrl}/{id}";
+        var json = await SendWithRetryAsync(url, $"id {id}", cancellationToken);
+        if (json == null)
+            return null;
+
+        return JsonSerializer.Deserialize<ColumbiaProduct>(json, JsonOptions);
+    }
+
+    /// <inheritdoc />
+    public async Task<IReadOnlyList<ColumbiaProduct>> GetAllProductsAsync(
+        CancellationToken cancellationToken = default)
+    {
+        EnsureConfigured();
+
+        var all = new List<ColumbiaProduct>();
+
+        for (var page = 1; page <= MaxPagesSafetyCap; page++)
+        {
+            var response = await GetProductsPageAsync(page, ColumbiaIntegrationConstants.MaxPerPage, cancellationToken);
+
+            if (response.Items.Count == 0)
+                break;
+
+            all.AddRange(response.Items);
+
+            // Stop when the pagination block says we've reached the last page.
+            if (response.Pagination is { TotalPages: > 0 } p && page >= p.TotalPages)
+                break;
+        }
+
+        _logger.LogInformation("Columbia API: retrieved {Count} products across paged requests.", all.Count);
+        return all;
+    }
+
+    /// <summary>Throws when no API key is configured so callers fail fast rather than 401.</summary>
+    private void EnsureConfigured()
+    {
+        if (!IsConfigured)
+            throw new InvalidOperationException("Columbia Coatings API key is not configured (Columbia:ApiKey).");
+    }
+
+    /// <summary>
+    /// Issues a GET with the API key header and returns the response body. Retries on HTTP 429
+    /// (honoring Retry-After) up to <see cref="MaxRetriesPer429"/>. Returns null on 404 so
+    /// single-product lookups surface "not found" without throwing; throws on any other non-success.
+    /// <paramref name="describe"/> is a short label (e.g. "page 3", "sku ABC") for log/error context.
+    /// </summary>
+    private async Task<string?> SendWithRetryAsync(string url, string describe, CancellationToken cancellationToken)
+    {
+        for (var attempt = 1; ; attempt++)
+        {
+            using var request = new HttpRequestMessage(HttpMethod.Get, url);
+            request.Headers.Add("X-API-Key", ApiKey);
+
+            var client = _httpClientFactory.CreateClient();
+            using var response = await client.SendAsync(request, cancellationToken);
+
+            if (response.StatusCode == HttpStatusCode.TooManyRequests)
+            {
+                if (attempt > MaxRetriesPer429)
+                    throw new HttpRequestException(
+                        $"Columbia API still rate-limiting after {MaxRetriesPer429} retries ({describe}).");
+
+                var delaySeconds = GetRetryAfterSeconds(response) ?? DefaultRetryAfterSeconds;
+                _logger.LogWarning(
+                    "Columbia API returned 429 ({Describe}, attempt {Attempt}); waiting {Delay}s before retry.",
+                    describe, attempt, delaySeconds);
+                await Task.Delay(TimeSpan.FromSeconds(delaySeconds), cancellationToken);
+                continue;
+            }
+
+            if (response.StatusCode == HttpStatusCode.NotFound)
+                return null;
+
+            response.EnsureSuccessStatusCode();
+            return await response.Content.ReadAsStringAsync(cancellationToken);
+        }
+    }
+
+    /// <summary>
+    /// Parses the <c>Retry-After</c> header (delta-seconds or HTTP-date form) into whole seconds,
+    /// or null when absent/unparseable so the caller can fall back to a default.
+    /// </summary>
+    private static int? GetRetryAfterSeconds(HttpResponseMessage response)
+    {
+        var retryAfter = response.Headers.RetryAfter;
+        if (retryAfter == null)
+            return null;
+
+        if (retryAfter.Delta is { } delta)
+            return Math.Max(1, (int)Math.Ceiling(delta.TotalSeconds));
+
+        if (retryAfter.Date is { } date)
+        {
+            var seconds = (int)Math.Ceiling((date - DateTimeOffset.UtcNow).TotalSeconds);
+            return seconds > 0 ? seconds : 1;
+        }
+
+        return null;
+    }
+}

src/PowderCoating.Infrastructure/Services/InventoryAiLookupService.cs

@@ -6,6 +6,7 @@ using Anthropic.SDK.Messaging;
 using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.Logging;
 using PowderCoating.Application.Interfaces;
+using PowderCoating.Core.Entities;
 using PowderCoating.Core.Interfaces;
 
 namespace PowderCoating.Infrastructure.Services;
@@ -541,18 +542,20 @@ Rules:
 
             // Targeted prompt: we only need cure specs from this document
             const string curePrompt = @"You are reading a Technical Data Sheet (TDS) for a powder coating product.
-Extract ONLY the cure schedule. Respond with a valid JSON object — no markdown, no explanation:
+Extract the cure schedule and the specific gravity. Respond with a valid JSON object — no markdown, no explanation:
 
 {
   ""cureTemperatureF"": number or null,
   ""cureTimeMinutes"": number or null,
-  ""reasoning"": ""one sentence: what cure schedule you found""
+  ""specificGravity"": number or null,
+  ""reasoning"": ""one sentence: what cure schedule and specific gravity you found""
 }
 
 Rules:
 - cureTemperatureF: the recommended cure temperature in °F. Convert from °C if needed (multiply by 1.8 + 32). If a range is given use the midpoint. Most powders cure 325–400 °F.
 - cureTimeMinutes: the hold time at cure temperature in minutes (NOT total oven time). Typically 10–20 min.
-- If neither value can be found in the document, return null for both.";
+- specificGravity: the specific gravity / density value from the TDS (often labeled ""Specific Gravity"" or ""Density""). Typically 1.2–1.8. Null if not stated.
+- Return null for any value not found in the document.";
 
             var sb = new StringBuilder();
             sb.AppendLine("Technical Data Sheet content:");
@@ -603,11 +606,12 @@ Rules:
                 Success          = true,
                 CureTemperatureF = GetDecimal(parsed, "cureTemperatureF"),
                 CureTimeMinutes  = GetInt(parsed,     "cureTimeMinutes"),
+                SpecificGravity  = GetDecimal(parsed, "specificGravity"),
                 Reasoning        = GetString(parsed,  "reasoning"),
             };
 
-            _logger.LogInformation("TDS cure lookup for {Url}: temp={Temp}°F, time={Time}min ({Reasoning})",
-                tdsUrl, result.CureTemperatureF, result.CureTimeMinutes, result.Reasoning);
+            _logger.LogInformation("TDS spec lookup for {Url}: temp={Temp}°F, time={Time}min, sg={Sg} ({Reasoning})",
+                tdsUrl, result.CureTemperatureF, result.CureTimeMinutes, result.SpecificGravity, result.Reasoning);
             return result;
         }
         catch (Exception ex)
@@ -617,6 +621,58 @@ Rules:
         }
     }
 
+    /// <inheritdoc />
+    public async Task<bool> EnsureCatalogTdsSpecsAsync(PowderCatalogItem catalog)
+    {
+        // Already enriched, or nothing to read from. Specific gravity is the trigger: it's never in
+        // the API feed, so its absence means this item hasn't been TDS-enriched yet.
+        if (catalog == null || catalog.SpecificGravity.HasValue || string.IsNullOrWhiteSpace(catalog.TdsUrl))
+            return false;
+
+        var tds = await FetchTdsCureSpecsAsync(catalog.TdsUrl, catalog.ColorName);
+        if (!tds.Success)
+            return false;
+
+        var changed = false;
+
+        if (tds.SpecificGravity is > 0)
+        {
+            catalog.SpecificGravity = tds.SpecificGravity;
+            changed = true;
+        }
+        if (!catalog.CureTemperatureF.HasValue && tds.CureTemperatureF.HasValue)
+        {
+            catalog.CureTemperatureF = tds.CureTemperatureF;
+            changed = true;
+        }
+        if (!catalog.CureTimeMinutes.HasValue && tds.CureTimeMinutes.HasValue)
+        {
+            catalog.CureTimeMinutes = tds.CureTimeMinutes;
+            changed = true;
+        }
+        // Derive theoretical coverage once specific gravity is known.
+        if (!catalog.CoverageSqFtPerLb.HasValue && catalog.SpecificGravity is > 0)
+        {
+            catalog.CoverageSqFtPerLb = Math.Round(
+                TheoreticalCoverageConstant / (catalog.SpecificGravity.Value * DefaultCoverageThicknessMils),
+                2, MidpointRounding.AwayFromZero);
+            changed = true;
+        }
+
+        if (changed)
+        {
+            catalog.UpdatedAt = DateTime.UtcNow;
+            await _unitOfWork.PowderCatalog.UpdateAsync(catalog);
+            await _unitOfWork.CompleteAsync();
+            _logger.LogInformation(
+                "Lazily enriched catalog item {Vendor} {Sku} from TDS: sg={Sg}, cure={Temp}F/{Time}min, coverage={Cov}",
+                catalog.VendorName, catalog.Sku, catalog.SpecificGravity, catalog.CureTemperatureF,
+                catalog.CureTimeMinutes, catalog.CoverageSqFtPerLb);
+        }
+
+        return changed;
+    }
+
     // ── Manufacturer URL pattern: build direct product page URL ───────────────
 
     /// <summary>

src/PowderCoating.Infrastructure/Services/PowderCatalogUpsertService.cs

@@ -0,0 +1,303 @@
+using Microsoft.Extensions.Logging;
+using PowderCoating.Application.Interfaces;
+using PowderCoating.Core.Entities;
+using PowderCoating.Core.Interfaces;
+
+namespace PowderCoating.Infrastructure.Services;
+
+/// <summary>
+/// Single upsert path for the platform <see cref="PowderCatalogItem"/> master list, shared by the
+/// JSON file import and the Columbia API sync. Match key is (VendorName, SKU), case-insensitive.
+/// </summary>
+public class PowderCatalogUpsertService : IPowderCatalogUpsertService
+{
+    private readonly IUnitOfWork _unitOfWork;
+    private readonly ILogger<PowderCatalogUpsertService> _logger;
+
+    public PowderCatalogUpsertService(IUnitOfWork unitOfWork, ILogger<PowderCatalogUpsertService> logger)
+    {
+        _unitOfWork = unitOfWork;
+        _logger = logger;
+    }
+
+    /// <inheritdoc />
+    public async Task<PowderCatalogUpsertResult> UpsertAsync(
+        IReadOnlyList<PowderCatalogItem> incoming,
+        DateTime runTimestamp,
+        CancellationToken cancellationToken = default)
+    {
+        var result = new PowderCatalogUpsertResult();
+
+        // Load existing rows for just the vendors we're touching, keyed by (vendor|sku) lower-cased.
+        var vendorNames = incoming
+            .Select(i => i.VendorName)
+            .Where(v => !string.IsNullOrWhiteSpace(v))
+            .Distinct(StringComparer.OrdinalIgnoreCase)
+            .ToList();
+
+        var existing = (await _unitOfWork.PowderCatalog.FindAsync(p => vendorNames.Contains(p.VendorName)))
+            .ToDictionary(KeyOf, StringComparer.OrdinalIgnoreCase);
+
+        var toAdd = new List<PowderCatalogItem>();
+
+        foreach (var item in incoming)
+        {
+            if (string.IsNullOrWhiteSpace(item.Sku) || string.IsNullOrWhiteSpace(item.ColorName))
+            {
+                result.Skipped++;
+                continue;
+            }
+
+            if (existing.TryGetValue(KeyOf(item), out var record))
+            {
+                if (ApplyFeedFields(record, item))
+                {
+                    record.UpdatedAt = runTimestamp;
+                    record.LastSyncedAt = runTimestamp;
+                    await _unitOfWork.PowderCatalog.UpdateAsync(record);
+                    result.Updated++;
+                }
+                else
+                {
+                    result.Unchanged++;
+                }
+            }
+            else
+            {
+                item.CreatedAt = runTimestamp;
+                item.LastSyncedAt = runTimestamp;
+                toAdd.Add(item);
+                result.Inserted++;
+            }
+        }
+
+        if (toAdd.Count > 0)
+            await _unitOfWork.PowderCatalog.AddRangeAsync(toAdd);
+
+        await _unitOfWork.CompleteAsync();
+
+        // Push current catalog price + product data down to any tenant inventory linked to these
+        // catalog rows, so quotes reflect the current price.
+        var propagated = await PropagateToLinkedInventoryAsync();
+
+        _logger.LogInformation(
+            "Powder catalog upsert: {Inserted} inserted, {Updated} updated, {Unchanged} unchanged, {Skipped} skipped; {Propagated} linked inventory item(s) refreshed.",
+            result.Inserted, result.Updated, result.Unchanged, result.Skipped, propagated);
+
+        return result;
+    }
+
+    /// <summary>
+    /// Keeps tenant inventory in step with the catalog (across all companies): first self-heals by
+    /// linking any unlinked item to its catalog row by identity, then refreshes every linked item
+    /// with the catalog's current price and product data. Returns the number of items touched.
+    /// </summary>
+    public async Task<int> PropagateToLinkedInventoryAsync()
+    {
+        var linkedCount = await LinkUnlinkedInventoryAsync();
+        var refreshedCount = await RefreshLinkedInventoryAsync();
+        return linkedCount + refreshedCount;
+    }
+
+    /// <summary>
+    /// Self-heals the catalog link: finds inventory items with no <see cref="InventoryItem.PowderCatalogItemId"/>
+    /// that match a catalog row by Manufacturer + ManufacturerPartNumber (the catalog SKU), sets the
+    /// FK, and applies the catalog price/product data. Only links on a confident match (exact SKU,
+    /// matching vendor, or a single unambiguous candidate) so it never mis-links. Returns the count
+    /// newly linked. This backfills items created before linking existed, on every environment, with
+    /// no manual step.
+    /// </summary>
+    private async Task<int> LinkUnlinkedInventoryAsync()
+    {
+        var unlinked = (await _unitOfWork.InventoryItems.FindAsync(
+            i => i.PowderCatalogItemId == null
+                 && i.Manufacturer != null && i.Manufacturer != ""
+                 && i.ManufacturerPartNumber != null && i.ManufacturerPartNumber != "",
+            ignoreQueryFilters: true)).ToList();
+        if (unlinked.Count == 0)
+            return 0;
+
+        var partNumbers = unlinked.Select(i => i.ManufacturerPartNumber!).Distinct().ToList();
+        var bySku = (await _unitOfWork.PowderCatalog.FindAsync(p => partNumbers.Contains(p.Sku)))
+            .GroupBy(c => c.Sku, StringComparer.OrdinalIgnoreCase)
+            .ToDictionary(g => g.Key, g => g.ToList(), StringComparer.OrdinalIgnoreCase);
+        if (bySku.Count == 0)
+            return 0;
+
+        var linked = 0;
+        foreach (var inv in unlinked)
+        {
+            if (!bySku.TryGetValue(inv.ManufacturerPartNumber!, out var candidates))
+                continue;
+
+            var mfr = inv.Manufacturer!.Trim().ToLower();
+            var match = candidates.FirstOrDefault(c => c.VendorName.ToLower().Contains(mfr))
+                        ?? (candidates.Count == 1 ? candidates[0] : null);
+            if (match == null)
+                continue;
+
+            inv.PowderCatalogItemId = match.Id;
+            ApplyCatalogToLinkedInventory(inv, match);
+            await _unitOfWork.InventoryItems.UpdateAsync(inv);
+            linked++;
+        }
+
+        if (linked > 0)
+            await _unitOfWork.CompleteAsync();
+
+        return linked;
+    }
+
+    /// <summary>
+    /// Refreshes every tenant inventory item linked to a powder catalog row (across all companies)
+    /// with the catalog's current list price and product data. Sets
+    /// <see cref="InventoryItem.CatalogReferencePrice"/> (the QUOTING price) and product spec/doc
+    /// fields, but NEVER the cost basis (UnitCost/AverageCost/LastPurchasePrice), quantity, notes,
+    /// image, location, or stock levels — those are tenant-owned. EF persists only items that
+    /// actually changed, so this is a cheap no-op when nothing moved. Returns the number updated.
+    /// </summary>
+    private async Task<int> RefreshLinkedInventoryAsync()
+    {
+        var linked = (await _unitOfWork.InventoryItems.FindAsync(
+            i => i.PowderCatalogItemId != null, ignoreQueryFilters: true)).ToList();
+        if (linked.Count == 0)
+            return 0;
+
+        var catalogIds = linked.Select(i => i.PowderCatalogItemId!.Value).Distinct().ToList();
+        var catalogById = (await _unitOfWork.PowderCatalog.FindAsync(p => catalogIds.Contains(p.Id)))
+            .ToDictionary(p => p.Id);
+
+        var updated = 0;
+        foreach (var inv in linked)
+        {
+            if (!catalogById.TryGetValue(inv.PowderCatalogItemId!.Value, out var cat))
+                continue;
+
+            if (ApplyCatalogToLinkedInventory(inv, cat))
+            {
+                await _unitOfWork.InventoryItems.UpdateAsync(inv);
+                updated++;
+            }
+        }
+
+        if (updated > 0)
+            await _unitOfWork.CompleteAsync();
+
+        return updated;
+    }
+
+    /// <summary>
+    /// Applies the catalog's current price and product data onto a linked inventory item, returning
+    /// true if anything changed. Sets the quoting reference price (only when the catalog has a real
+    /// price &gt; 0) and refreshes product/spec fields where the catalog has a value — never erasing
+    /// tenant data with catalog nulls, and never touching cost basis, quantity, notes, image, or
+    /// stock levels.
+    /// </summary>
+    private static bool ApplyCatalogToLinkedInventory(InventoryItem inv, PowderCatalogItem cat)
+    {
+        var changed = false;
+
+        // Quoting price (the point of this): keep the current catalog list price, separate from cost.
+        if (cat.UnitPrice > 0 && inv.CatalogReferencePrice != cat.UnitPrice)
+        {
+            inv.CatalogReferencePrice = cat.UnitPrice;
+            inv.CatalogPriceUpdatedAt = DateTime.UtcNow;
+            changed = true;
+        }
+
+        // Product data — refresh from the catalog where it has a value (catalog is authoritative on
+        // these); do not null out a tenant value the catalog doesn't carry.
+        changed |= SetStrIfCatalogHas(() => inv.Description, v => inv.Description = v, cat.Description);
+        changed |= SetStrIfCatalogHas(() => inv.Finish, v => inv.Finish = v, cat.Finish);
+        changed |= SetStrIfCatalogHas(() => inv.ColorFamilies, v => inv.ColorFamilies = v, cat.ColorFamilies);
+        changed |= SetStrIfCatalogHas(() => inv.SdsUrl, v => inv.SdsUrl = v, cat.SdsUrl);
+        changed |= SetStrIfCatalogHas(() => inv.TdsUrl, v => inv.TdsUrl = v, cat.TdsUrl);
+        changed |= SetStrIfCatalogHas(() => inv.SpecPageUrl, v => inv.SpecPageUrl = v, cat.ProductUrl);
+
+        if (cat.CureTemperatureF.HasValue && inv.CureTemperatureF != cat.CureTemperatureF)
+        { inv.CureTemperatureF = cat.CureTemperatureF; changed = true; }
+        if (cat.CureTimeMinutes.HasValue && inv.CureTimeMinutes != cat.CureTimeMinutes)
+        { inv.CureTimeMinutes = cat.CureTimeMinutes; changed = true; }
+        if (cat.CoverageSqFtPerLb.HasValue && inv.CoverageSqFtPerLb != cat.CoverageSqFtPerLb)
+        { inv.CoverageSqFtPerLb = cat.CoverageSqFtPerLb; changed = true; }
+        if (cat.SpecificGravity.HasValue && inv.SpecificGravity != cat.SpecificGravity)
+        { inv.SpecificGravity = cat.SpecificGravity; changed = true; }
+        if (cat.TransferEfficiency.HasValue && inv.TransferEfficiency != cat.TransferEfficiency)
+        { inv.TransferEfficiency = cat.TransferEfficiency; changed = true; }
+        if (cat.RequiresClearCoat == true && !inv.RequiresClearCoat)
+        { inv.RequiresClearCoat = true; changed = true; }
+
+        return changed;
+    }
+
+    /// <summary>Sets a string property from the catalog only when the catalog value is non-blank and differs.</summary>
+    private static bool SetStrIfCatalogHas(Func<string?> get, Action<string?> set, string? catalogValue)
+    {
+        if (!string.IsNullOrWhiteSpace(catalogValue) && !string.Equals(get(), catalogValue, StringComparison.Ordinal))
+        {
+            set(catalogValue);
+            return true;
+        }
+        return false;
+    }
+
+    private static string KeyOf(PowderCatalogItem p) => $"{p.VendorName}|{p.Sku}";
+
+    /// <summary>
+    /// Copies feed-sourced fields from <paramref name="src"/> onto <paramref name="dest"/> and
+    /// returns true if anything changed. Deliberately leaves enrichment fields (SpecificGravity,
+    /// CoverageSqFtPerLb, TransferEfficiency, Finish) and lifecycle flags untouched — those are
+    /// owned by lazy TDS/AI enrichment and the discontinuation sweep, not the feed.
+    /// </summary>
+    private static bool ApplyFeedFields(PowderCatalogItem dest, PowderCatalogItem src)
+    {
+        var changed = false;
+
+        changed |= Set(() => dest.ColorName, v => dest.ColorName = v, src.ColorName);
+        changed |= Set(() => dest.Description, v => dest.Description = v, src.Description);
+        changed |= src.UnitPrice > 0 && dest.UnitPrice != src.UnitPrice && Assign(() => dest.UnitPrice = src.UnitPrice);
+        changed |= Set(() => dest.PriceTiersJson, v => dest.PriceTiersJson = v, src.PriceTiersJson);
+        changed |= Set(() => dest.ImageUrl, v => dest.ImageUrl = v, src.ImageUrl);
+        changed |= Set(() => dest.SdsUrl, v => dest.SdsUrl = v, src.SdsUrl);
+        changed |= Set(() => dest.TdsUrl, v => dest.TdsUrl = v, src.TdsUrl);
+        changed |= Set(() => dest.ApplicationGuideUrl, v => dest.ApplicationGuideUrl = v, src.ApplicationGuideUrl);
+        changed |= Set(() => dest.ProductUrl, v => dest.ProductUrl = v, src.ProductUrl);
+        changed |= Set(() => dest.ChemistryType, v => dest.ChemistryType = v, src.ChemistryType);
+        changed |= Set(() => dest.MilThickness, v => dest.MilThickness = v, src.MilThickness);
+        changed |= Set(() => dest.CureScheduleText, v => dest.CureScheduleText = v, src.CureScheduleText);
+        changed |= Set(() => dest.CureCurvesJson, v => dest.CureCurvesJson = v, src.CureCurvesJson);
+        changed |= src.CureTemperatureF.HasValue && dest.CureTemperatureF != src.CureTemperatureF && Assign(() => dest.CureTemperatureF = src.CureTemperatureF);
+        changed |= src.CureTimeMinutes.HasValue && dest.CureTimeMinutes != src.CureTimeMinutes && Assign(() => dest.CureTimeMinutes = src.CureTimeMinutes);
+        changed |= src.RequiresClearCoat.HasValue && dest.RequiresClearCoat != src.RequiresClearCoat && Assign(() => dest.RequiresClearCoat = src.RequiresClearCoat);
+        changed |= Set(() => dest.ColorFamilies, v => dest.ColorFamilies = v, src.ColorFamilies);
+        changed |= Set(() => dest.FormulationChanges, v => dest.FormulationChanges = v, src.FormulationChanges);
+        changed |= Set(() => dest.Category, v => dest.Category = v, src.Category);
+        changed |= Set(() => dest.Source, v => dest.Source = v, src.Source);
+
+        return changed;
+    }
+
+    /// <summary>
+    /// Sets a nullable-string property when the feed provides a non-blank value that differs.
+    /// Merge semantics: a blank incoming value is ignored, so a partial feed (e.g. the Prismatic
+    /// file import, which omits cure/chemistry) never nulls out existing data.
+    /// </summary>
+    private static bool Set(Func<string?> get, Action<string?> set, string? newValue)
+    {
+        if (string.IsNullOrWhiteSpace(newValue))
+            return false;
+        if (!string.Equals(get(), newValue, StringComparison.Ordinal))
+        {
+            set(newValue);
+            return true;
+        }
+        return false;
+    }
+
+    /// <summary>Helper so a value assignment can participate in a boolean OR chain.</summary>
+    private static bool Assign(Action assign)
+    {
+        assign();
+        return true;
+    }
+}

src/PowderCoating.Web/BackgroundServices/ColumbiaCatalogSyncBackgroundService.cs

@@ -0,0 +1,112 @@
+using System.Globalization;
+using PowderCoating.Application.Constants;
+using PowderCoating.Application.Interfaces;
+
+namespace PowderCoating.Web.BackgroundServices;
+
+/// <summary>
+/// Runs the Columbia Coatings catalog sync on a schedule. Wakes hourly and triggers a full sync
+/// only when the master switch (<c>ColumbiaSyncEnabled</c>) is on and the configured interval
+/// (<c>ColumbiaSyncIntervalDays</c>) has elapsed since the last successful run. A full sync is
+/// cheap (~25 API calls), so an hourly due-check is negligible; the actual work runs at most once
+/// per interval. No-ops quietly when disabled or unconfigured.
+/// </summary>
+public class ColumbiaCatalogSyncBackgroundService : BackgroundService
+{
+    private readonly IServiceScopeFactory _scopeFactory;
+    private readonly ILogger<ColumbiaCatalogSyncBackgroundService> _logger;
+
+    private static readonly TimeSpan CheckInterval = TimeSpan.FromHours(1);
+    private static readonly TimeSpan StartupDelay = TimeSpan.FromMinutes(2);
+
+    /// <summary>
+    /// Uses <see cref="IServiceScopeFactory"/> because a <see cref="BackgroundService"/> is a
+    /// singleton and the sync service / platform settings are scoped.
+    /// </summary>
+    public ColumbiaCatalogSyncBackgroundService(
+        IServiceScopeFactory scopeFactory,
+        ILogger<ColumbiaCatalogSyncBackgroundService> logger)
+    {
+        _scopeFactory = scopeFactory;
+        _logger = logger;
+    }
+
+    /// <inheritdoc />
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        _logger.LogInformation("ColumbiaCatalogSyncBackgroundService started.");
+
+        try
+        {
+            await Task.Delay(StartupDelay, stoppingToken);
+
+            while (!stoppingToken.IsCancellationRequested)
+            {
+                await RunIfDueAsync(stoppingToken);
+                await Task.Delay(CheckInterval, stoppingToken);
+            }
+        }
+        catch (OperationCanceledException)
+        {
+            // Shutting down — expected.
+        }
+    }
+
+    /// <summary>
+    /// Checks the enable switch and the elapsed interval, and runs a sync when due. Failures from
+    /// the sync itself are reported on its result (and recorded in platform settings) rather than
+    /// thrown, so a bad run never tears down the loop.
+    /// </summary>
+    private async Task RunIfDueAsync(CancellationToken ct)
+    {
+        using var scope = _scopeFactory.CreateScope();
+        var settings = scope.ServiceProvider.GetRequiredService<IPlatformSettingsService>();
+
+        if (!await settings.GetBoolAsync(ColumbiaIntegrationConstants.SettingEnabled))
+            return; // master switch off
+
+        var intervalDays = Math.Max(1, await settings.GetIntAsync(
+            ColumbiaIntegrationConstants.SettingIntervalDays,
+            ColumbiaIntegrationConstants.DefaultSyncIntervalDays));
+
+        if (!IsDue(await settings.GetAsync(ColumbiaIntegrationConstants.SettingLastSyncedAt), intervalDays))
+            return; // synced recently enough
+
+        var sync = scope.ServiceProvider.GetRequiredService<IColumbiaCatalogSyncService>();
+
+        try
+        {
+            _logger.LogInformation("Columbia scheduled sync starting (interval {Days}d).", intervalDays);
+            var result = await sync.RunSyncAsync(ct);
+
+            if (result.Success)
+                _logger.LogInformation("Columbia scheduled sync complete: {Summary}", result.Summary);
+            else
+                _logger.LogWarning("Columbia scheduled sync did not succeed: {Error}", result.ErrorMessage);
+        }
+        catch (OperationCanceledException)
+        {
+            throw;
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Columbia scheduled sync threw unexpectedly.");
+        }
+    }
+
+    /// <summary>
+    /// A sync is due when there is no recorded last-sync timestamp, or the configured number of
+    /// days has elapsed since it. An unparseable timestamp is treated as "due".
+    /// </summary>
+    private static bool IsDue(string? lastSyncedRaw, int intervalDays)
+    {
+        if (string.IsNullOrWhiteSpace(lastSyncedRaw))
+            return true;
+
+        if (!DateTime.TryParse(lastSyncedRaw, CultureInfo.InvariantCulture,
+                DateTimeStyles.RoundtripKind, out var lastSynced))
+            return true;
+
+        return DateTime.UtcNow - lastSynced.ToUniversalTime() >= TimeSpan.FromDays(intervalDays);
+    }
+}

src/PowderCoating.Web/Controllers/DashboardController.cs

@@ -25,6 +25,7 @@ public class DashboardController : Controller
     private readonly ICompanyConfigHealthService _configHealth;
     private readonly UserManager<ApplicationUser> _userManager;
     private readonly ISubscriptionService _subscriptionService;
+    private readonly IInventoryAiLookupService _aiLookupService;
 
     public DashboardController(
         IUnitOfWork unitOfWork,
@@ -33,7 +34,8 @@ public class DashboardController : Controller
         ITenantContext tenantContext,
         ICompanyConfigHealthService configHealth,
         UserManager<ApplicationUser> userManager,
-        ISubscriptionService subscriptionService)
+        ISubscriptionService subscriptionService,
+        IInventoryAiLookupService aiLookupService)
     {
         _unitOfWork = unitOfWork;
         _logger = logger;
@@ -42,6 +44,7 @@ public class DashboardController : Controller
         _configHealth = configHealth;
         _userManager = userManager;
         _subscriptionService = subscriptionService;
+        _aiLookupService = aiLookupService;
     }
 
     /// <summary>
@@ -765,59 +768,15 @@ public class DashboardController : Controller
                 UpdatedAt            = DateTime.UtcNow,
             };
 
-            await _unitOfWork.InventoryItems.AddAsync(inventoryItem);
-            await _unitOfWork.CompleteAsync(); // flush to get inventoryItem.Id
+            // Enrich from the platform powder catalog so the new inventory record carries the full
+            // spec/doc set (cure schedule, SDS/TDS, sample image, color families) rather than just
+            // the color code/name carried on the quote. Match by the catalog SKU (stored as the
+            // coat's colorCode), preferring the same manufacturer; fall back to color name.
+            await EnrichInventoryFromCatalogAsync(inventoryItem, colorCode, colorName, manufacturer);
 
-            // Opening stock transaction
-            var transaction = new InventoryTransaction
-            {
-                CompanyId       = companyId,
-                InventoryItemId = inventoryItem.Id,
-                TransactionType = InventoryTransactionType.Purchase,
-                Quantity        = lbsReceived,
-                UnitCost        = unitCost ?? 0,
-                TotalCost       = lbsReceived * (unitCost ?? 0),
-                TransactionDate = DateTime.UtcNow,
-                Notes           = $"Initial stock — received from powder order for job {jobItem?.Job?.JobNumber}",
-                BalanceAfter    = lbsReceived,
-                CreatedAt       = DateTime.UtcNow,
-                UpdatedAt       = DateTime.UtcNow,
-            };
-            await _unitOfWork.InventoryTransactions.AddAsync(transaction);
-
-            // Mark coat as received and link to the new inventory item
-            var userId = User.FindFirst(System.Security.Claims.ClaimTypes.NameIdentifier)?.Value;
-            coat.PowderReceived          = true;
-            coat.PowderReceivedAt        = DateTime.UtcNow;
-            coat.PowderReceivedByUserId  = userId;
-            coat.PowderReceivedLbs       = lbsReceived;
-            coat.InventoryItemId         = inventoryItem.Id;
-
-            // Scan for sibling coats with the same custom powder and link them to the new item
-            var candidateCoats = await _unitOfWork.JobItemCoats.GetCandidateCoatsForLinkingAsync(coatId, companyId);
-
-            int linkedCount = 0;
-            foreach (var other in candidateCoats)
-            {
-                bool colorMatch = !string.IsNullOrWhiteSpace(colorCode)
-                    ? string.Equals(other.ColorCode?.Trim(), colorCode.Trim(), StringComparison.OrdinalIgnoreCase)
-                    : !string.IsNullOrWhiteSpace(colorName) &&
-                      string.Equals(other.ColorName?.Trim(), colorName.Trim(), StringComparison.OrdinalIgnoreCase);
-
-                if (!colorMatch) continue;
-
-                if (primaryVendorId.HasValue && other.VendorId.HasValue && other.VendorId != primaryVendorId)
-                    continue;
-
-                other.InventoryItemId = inventoryItem.Id;
-                linkedCount++;
-            }
-
-            if (linkedCount > 0)
-                _logger.LogInformation("Linked {Count} additional coat(s) to new inventory item {ItemId} ({SKU})",
-                    linkedCount, inventoryItem.Id, inventoryItem.SKU);
-
-            await _unitOfWork.CompleteAsync();
+            var linkedCount = await FinalizeReceivedPowderAsync(
+                coat, inventoryItem, lbsReceived, companyId, colorCode, colorName, primaryVendorId,
+                jobItem?.Job?.JobNumber);
 
             return Json(new { success = true, itemName = inventoryItem.Name, sku = inventoryItem.SKU, linkedCount });
         }
@@ -828,6 +787,267 @@ public class DashboardController : Controller
         }
     }
 
+    /// <summary>
+    /// Finds the platform powder catalog row for an inventory/coat identity: by catalog SKU
+    /// (stored as the coat's color code), preferring the same manufacturer, then by color name.
+    /// Returns null when no match is found.
+    /// </summary>
+    private async Task<PowderCatalogItem?> FindCatalogByIdentityAsync(
+        string? colorCode, string? colorName, string? manufacturer)
+    {
+        var code = colorCode?.Trim();
+        if (!string.IsNullOrWhiteSpace(code))
+        {
+            var codeLower = code.ToLower();
+            var hits = (await _unitOfWork.PowderCatalog.FindAsync(p => p.Sku.ToLower() == codeLower)).ToList();
+            var mfr = manufacturer?.Trim().ToLower();
+            var match = (!string.IsNullOrWhiteSpace(mfr)
+                            ? hits.FirstOrDefault(p => p.VendorName.ToLower().Contains(mfr))
+                            : null)
+                        ?? hits.FirstOrDefault();
+            if (match != null)
+                return match;
+        }
+
+        if (!string.IsNullOrWhiteSpace(colorName))
+        {
+            var nameLower = colorName.Trim().ToLower();
+            return (await _unitOfWork.PowderCatalog.FindAsync(p => p.ColorName.ToLower() == nameLower))
+                .FirstOrDefault();
+        }
+
+        return null;
+    }
+
+    /// <summary>
+    /// Copies catalog spec/document fields onto an inventory item — cure schedule, coverage,
+    /// specific gravity, transfer efficiency, SDS/TDS links, sample image, color families, product
+    /// page — and links <see cref="InventoryItem.PowderCatalogItemId"/>. Only fills gaps, so any
+    /// value already set (e.g. entered on the receive form) is preserved.
+    /// </summary>
+    private static void ApplyCatalogToInventory(InventoryItem item, PowderCatalogItem catalog)
+    {
+        item.PowderCatalogItemId = catalog.Id;
+
+        if (string.IsNullOrWhiteSpace(item.ManufacturerPartNumber)) item.ManufacturerPartNumber = catalog.Sku;
+        if (string.IsNullOrWhiteSpace(item.Manufacturer))           item.Manufacturer = catalog.VendorName;
+        if (string.IsNullOrWhiteSpace(item.ColorName))              item.ColorName = catalog.ColorName;
+        if (string.IsNullOrWhiteSpace(item.Finish))                 item.Finish = catalog.Finish;
+        if (string.IsNullOrWhiteSpace(item.ColorFamilies))          item.ColorFamilies = catalog.ColorFamilies;
+        if (string.IsNullOrWhiteSpace(item.ImageUrl))               item.ImageUrl = catalog.ImageUrl;
+        if (string.IsNullOrWhiteSpace(item.SdsUrl))                 item.SdsUrl = catalog.SdsUrl;
+        if (string.IsNullOrWhiteSpace(item.TdsUrl))                 item.TdsUrl = catalog.TdsUrl;
+        if (string.IsNullOrWhiteSpace(item.SpecPageUrl))            item.SpecPageUrl = catalog.ProductUrl;
+
+        item.CureTemperatureF   ??= catalog.CureTemperatureF;
+        item.CureTimeMinutes    ??= catalog.CureTimeMinutes;
+        item.SpecificGravity    ??= catalog.SpecificGravity;
+        item.CoverageSqFtPerLb  ??= catalog.CoverageSqFtPerLb ?? 30m;
+        item.TransferEfficiency ??= catalog.TransferEfficiency ?? 65m;
+
+        if (!item.RequiresClearCoat && catalog.RequiresClearCoat == true)
+            item.RequiresClearCoat = true;
+
+        if (item.UnitCost <= 0 && catalog.UnitPrice > 0)
+        {
+            item.UnitCost = catalog.UnitPrice;
+            item.LastPurchasePrice = catalog.UnitPrice;
+        }
+
+        // Quoting reference price (current catalog list price) — separate from cost basis above.
+        if (catalog.UnitPrice > 0)
+        {
+            item.CatalogReferencePrice = catalog.UnitPrice;
+            item.CatalogPriceUpdatedAt = DateTime.UtcNow;
+        }
+    }
+
+    /// <summary>
+    /// Fills blank spec/document fields on a received custom-powder inventory item from the matching
+    /// platform powder catalog row, so the tenant gets a complete record instead of just the color
+    /// code/name carried on the quote. No-op when the powder isn't in the catalog.
+    /// </summary>
+    private async Task EnrichInventoryFromCatalogAsync(
+        InventoryItem item, string? colorCode, string? colorName, string? manufacturer)
+    {
+        var catalog = await FindCatalogByIdentityAsync(colorCode, colorName, manufacturer);
+        if (catalog == null)
+            return;
+
+        // First use — lazily fill specific gravity / cure from the TDS before copying onto the item.
+        await _aiLookupService.EnsureCatalogTdsSpecsAsync(catalog);
+        ApplyCatalogToInventory(item, catalog);
+    }
+
+    /// <summary>
+    /// Shared finalize for a received powder: saves the inventory item, writes the opening Purchase
+    /// transaction, marks the coat received and links it, then links any sibling coats ordering the
+    /// same color. Returns the number of additional coats linked. Used by both the manual modal
+    /// (<see cref="AddCustomPowderToInventory"/>) and the catalog auto-receive
+    /// (<see cref="ReceivePowderFromCatalog"/>).
+    /// </summary>
+    private async Task<int> FinalizeReceivedPowderAsync(
+        JobItemCoat coat, InventoryItem inventoryItem, decimal lbsReceived, int companyId,
+        string? colorCode, string? colorName, int? primaryVendorId, string? jobNumber)
+    {
+        await _unitOfWork.InventoryItems.AddAsync(inventoryItem);
+        await _unitOfWork.CompleteAsync(); // flush to get inventoryItem.Id
+
+        var transaction = new InventoryTransaction
+        {
+            CompanyId       = companyId,
+            InventoryItemId = inventoryItem.Id,
+            TransactionType = InventoryTransactionType.Purchase,
+            Quantity        = lbsReceived,
+            UnitCost        = inventoryItem.UnitCost,
+            TotalCost       = lbsReceived * inventoryItem.UnitCost,
+            TransactionDate = DateTime.UtcNow,
+            Notes           = $"Initial stock — received from powder order for job {jobNumber}",
+            BalanceAfter    = lbsReceived,
+            CreatedAt       = DateTime.UtcNow,
+            UpdatedAt       = DateTime.UtcNow,
+        };
+        await _unitOfWork.InventoryTransactions.AddAsync(transaction);
+
+        var userId = User.FindFirst(System.Security.Claims.ClaimTypes.NameIdentifier)?.Value;
+        coat.PowderReceived         = true;
+        coat.PowderReceivedAt       = DateTime.UtcNow;
+        coat.PowderReceivedByUserId = userId;
+        coat.PowderReceivedLbs      = lbsReceived;
+        coat.InventoryItemId        = inventoryItem.Id;
+
+        var candidateCoats = await _unitOfWork.JobItemCoats.GetCandidateCoatsForLinkingAsync(coat.Id, companyId);
+
+        var linkedCount = 0;
+        foreach (var other in candidateCoats)
+        {
+            var colorMatch = !string.IsNullOrWhiteSpace(colorCode)
+                ? string.Equals(other.ColorCode?.Trim(), colorCode.Trim(), StringComparison.OrdinalIgnoreCase)
+                : !string.IsNullOrWhiteSpace(colorName) &&
+                  string.Equals(other.ColorName?.Trim(), colorName.Trim(), StringComparison.OrdinalIgnoreCase);
+
+            if (!colorMatch) continue;
+            if (primaryVendorId.HasValue && other.VendorId.HasValue && other.VendorId != primaryVendorId) continue;
+
+            other.InventoryItemId = inventoryItem.Id;
+            linkedCount++;
+        }
+
+        if (linkedCount > 0)
+            _logger.LogInformation("Linked {Count} additional coat(s) to new inventory item {ItemId} ({SKU})",
+                linkedCount, inventoryItem.Id, inventoryItem.SKU);
+
+        await _unitOfWork.CompleteAsync();
+        return linkedCount;
+    }
+
+    /// <summary>
+    /// Generates a unique powder SKU for a company in the form <c>{CODE}-{YYMM}-{####}</c>, where
+    /// CODE is the (padded) inventory category code. Mirrors the inventory SKU pattern used when
+    /// adding catalog-sourced powders.
+    /// </summary>
+    private async Task<string> GeneratePowderSkuAsync(InventoryCategoryLookup category)
+    {
+        var code = category.CategoryCode.Length >= 4
+            ? category.CategoryCode[..4].ToUpperInvariant()
+            : category.CategoryCode.ToUpperInvariant().PadRight(4, 'X');
+        var yearMonth = DateTime.Now.ToString("yyMM");
+        var prefix = $"{code}-{yearMonth}-";
+
+        var allItems = await _unitOfWork.InventoryItems.GetAllAsync(ignoreQueryFilters: true);
+        var maxSeq = allItems
+            .Where(i => i.SKU.StartsWith(prefix))
+            .Select(i => int.TryParse(i.SKU[prefix.Length..], out var n) ? n : 0)
+            .DefaultIfEmpty(0)
+            .Max();
+
+        return $"{prefix}{(maxSeq + 1):D4}";
+    }
+
+    /// <summary>
+    /// Receives an ordered custom powder straight into inventory WITHOUT the manual modal when the
+    /// powder is already in the master catalog — the new record is fully populated from the catalog
+    /// (specs, SDS/TDS, image, pricing). Returns <c>needsDetails = true</c> (without saving) when
+    /// the powder isn't in the catalog or no coating category is configured, signaling the caller to
+    /// fall back to the manual entry modal.
+    /// </summary>
+    [HttpPost]
+    [ValidateAntiForgeryToken]
+    public async Task<IActionResult> ReceivePowderFromCatalog(int coatId, decimal lbsReceived)
+    {
+        try
+        {
+            if (lbsReceived <= 0)
+                return Json(new { success = false, message = "Quantity received must be greater than zero." });
+
+            var coat = await _unitOfWork.JobItemCoats.GetByIdAsync(coatId);
+            if (coat == null)
+                return Json(new { success = false, message = "Coat record not found." });
+
+            var jobItem = await _unitOfWork.JobItems.FirstOrDefaultAsync(
+                i => i.Coats.Any(c => c.Id == coatId), false, i => i.Job);
+            var companyId = jobItem?.Job?.CompanyId ?? _tenantContext.GetCurrentCompanyId() ?? 0;
+
+            // Only auto-receive when the powder resolves in the master catalog; otherwise the caller
+            // opens the manual modal.
+            var catalog = await FindCatalogByIdentityAsync(coat.ColorCode, coat.ColorName, null);
+            if (catalog == null)
+                return Json(new { success = false, needsDetails = true });
+
+            // First use — lazily fill specific gravity / cure from the TDS so the new record is complete.
+            await _aiLookupService.EnsureCatalogTdsSpecsAsync(catalog);
+
+            // Resolve the company's POWDER (coating) inventory category.
+            var categories = await _unitOfWork.InventoryCategoryLookups.FindAsync(c => c.CompanyId == companyId);
+            var coatingCategory = categories.FirstOrDefault(c => c.IsActive && c.IsCoating
+                                      && c.CategoryCode.Equals("POWDER", StringComparison.OrdinalIgnoreCase))
+                               ?? categories.Where(c => c.IsActive && c.IsCoating)
+                                            .OrderBy(c => c.DisplayOrder).FirstOrDefault();
+            if (coatingCategory == null)
+                return Json(new { success = false, needsDetails = true });
+
+            var sku = await GeneratePowderSkuAsync(coatingCategory);
+
+            var inventoryItem = new InventoryItem
+            {
+                CompanyId           = companyId,
+                SKU                 = sku,
+                Name                = catalog.ColorName,
+                ColorName           = catalog.ColorName,
+                ColorCode           = coat.ColorCode,
+                InventoryCategoryId = coatingCategory.Id,
+                Category            = coatingCategory.DisplayName,
+                QuantityOnHand      = lbsReceived,
+                UnitOfMeasure       = "lbs",
+                UnitCost            = catalog.UnitPrice,
+                LastPurchasePrice   = catalog.UnitPrice,
+                LastPurchaseDate    = DateTime.UtcNow,
+                IsActive            = true,
+                CreatedAt           = DateTime.UtcNow,
+                UpdatedAt           = DateTime.UtcNow,
+            };
+            ApplyCatalogToInventory(inventoryItem, catalog);
+
+            var linkedCount = await FinalizeReceivedPowderAsync(
+                coat, inventoryItem, lbsReceived, companyId, coat.ColorCode, coat.ColorName, null,
+                jobItem?.Job?.JobNumber);
+
+            return Json(new
+            {
+                success = true,
+                fromCatalog = true,
+                itemName = inventoryItem.Name,
+                sku = inventoryItem.SKU,
+                linkedCount
+            });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error auto-receiving powder from catalog for coat {CoatId}", coatId);
+            return Json(new { success = false, message = "An error occurred while saving." });
+        }
+    }
+
     /// <summary>
     /// Platform-level dashboard visible only to SuperAdmins who are not impersonating a tenant.
     /// Displays a cross-company overview: total/active/inactive company counts, user count,

src/PowderCoating.Web/Controllers/InventoryController.cs

@@ -240,6 +240,17 @@ public class InventoryController : Controller
             var useMetric = await _tenantContext.UseMetricSystemAsync();
             ViewBag.CoverageUnit = _measurementService.GetCoverageUnitLabel(useMetric);
 
+            // Manufacturer-level catalog status: prefer the linked catalog row, fall back to an
+            // identity match for items added before they were linked. Drives the "discontinued by
+            // manufacturer — cannot reorder" warning. This is distinct from the shop's own
+            // IsActive/DiscontinuedDate (whether the shop still stocks it).
+            var catalogItem = item.PowderCatalogItemId.HasValue
+                ? await _unitOfWork.PowderCatalog.GetByIdAsync(item.PowderCatalogItemId.Value)
+                : await FindCatalogMatchAsync(item.Manufacturer, item.ManufacturerPartNumber);
+            ViewBag.CatalogDiscontinued = catalogItem?.IsDiscontinued ?? false;
+            ViewBag.CatalogVendorName = catalogItem?.VendorName;
+            ViewBag.CatalogProductUrl = catalogItem?.ProductUrl;
+
             return View(itemDto);
         }
         catch (Exception ex)
@@ -302,6 +313,20 @@ public class InventoryController : Controller
                     item.Category = category.DisplayName;
             }
 
+            // Link to the platform catalog row when this item's identity matches one, so the detail
+            // screen can show manufacturer-level status (discontinued / cannot reorder) and quotes
+            // can use the current catalog price.
+            var catalogMatch = await FindCatalogMatchAsync(item.Manufacturer, item.ManufacturerPartNumber);
+            if (catalogMatch != null)
+            {
+                item.PowderCatalogItemId = catalogMatch.Id;
+                if (catalogMatch.UnitPrice > 0)
+                {
+                    item.CatalogReferencePrice = catalogMatch.UnitPrice;
+                    item.CatalogPriceUpdatedAt = DateTime.UtcNow;
+                }
+            }
+
             await _unitOfWork.InventoryItems.AddAsync(item);
             await _unitOfWork.SaveChangesAsync();
 
@@ -763,6 +788,24 @@ public class InventoryController : Controller
     /// Returns (wasInCatalog, addedToCatalog) so callers can surface UI badges.
     /// Mutates <paramref name="result"/> in place.
     /// </summary>
+    /// <summary>
+    /// Finds the platform powder catalog row matching an inventory item's identity
+    /// (Manufacturer + ManufacturerPartNumber), or null. Used to set
+    /// <see cref="InventoryItem.PowderCatalogItemId"/> and to surface manufacturer-level status
+    /// (e.g. discontinued / cannot reorder) on the detail screen.
+    /// </summary>
+    private async Task<PowderCatalogItem?> FindCatalogMatchAsync(string? manufacturer, string? sku)
+    {
+        if (string.IsNullOrWhiteSpace(manufacturer) || string.IsNullOrWhiteSpace(sku))
+            return null;
+
+        var skuLower = sku.Trim().ToLower();
+        var mfrLower = manufacturer.Trim().ToLower();
+        var hits = await _unitOfWork.PowderCatalog.FindAsync(p =>
+            p.Sku.ToLower() == skuLower && p.VendorName.ToLower().Contains(mfrLower));
+        return hits.FirstOrDefault();
+    }
+
     private async Task<(bool wasInCatalog, bool addedToCatalog)> EnrichFromCatalogAsync(
         InventoryAiLookupResult result, bool autoContribute)
     {
@@ -1220,6 +1263,10 @@ public class InventoryController : Controller
             if (catalogItem == null)
                 return Json(new { success = false, error = "Catalog item not found." });
 
+            // First use of this powder — lazily fill specific gravity / cure from its TDS so the new
+            // inventory record (and the catalog) carry complete specs. No-op once already enriched.
+            await _aiLookupService.EnsureCatalogTdsSpecsAsync(catalogItem);
+
             var companyId = _tenantContext.GetCurrentCompanyId() ?? 0;
 
             // Find the default coating category to assign.
@@ -1257,6 +1304,7 @@ public class InventoryController : Controller
                 ColorName             = catalogItem.ColorName,
                 Manufacturer          = catalogItem.VendorName,
                 ManufacturerPartNumber= catalogItem.Sku,
+                PowderCatalogItemId   = catalogItem.Id,
                 Finish                = catalogItem.Finish,
                 ColorFamilies         = catalogItem.ColorFamilies,
                 RequiresClearCoat     = catalogItem.RequiresClearCoat ?? false,
@@ -1272,6 +1320,8 @@ public class InventoryController : Controller
                 UnitCost              = catalogItem.UnitPrice,
                 AverageCost           = catalogItem.UnitPrice,
                 LastPurchasePrice     = catalogItem.UnitPrice,
+                CatalogReferencePrice = catalogItem.UnitPrice > 0 ? catalogItem.UnitPrice : (decimal?)null,
+                CatalogPriceUpdatedAt = catalogItem.UnitPrice > 0 ? DateTime.UtcNow : (DateTime?)null,
                 QuantityOnHand        = 0,
                 UnitOfMeasure         = "lbs",
                 InventoryCategoryId   = coatingCategory.Id,
@@ -1297,7 +1347,7 @@ public class InventoryController : Controller
                 efficiency   = item.TransferEfficiency ?? 65m,
                 unitOfMeasure= item.UnitOfMeasure,
                 categoryName = coatingCategory.DisplayName,
-                costPerLb    = item.UnitCost,
+                costPerLb    = item.CatalogReferencePrice ?? item.UnitCost,
                 colorName    = item.ColorName ?? item.Name,
                 colorCode    = "",
                 isIncoming   = true

src/PowderCoating.Web/Controllers/JobsController.cs

@@ -3492,7 +3492,8 @@ public class JobsController : Controller
                 efficiency = i.TransferEfficiency ?? 65m,
                 unitOfMeasure = i.UnitOfMeasure ?? "lbs",
                 categoryName = i.InventoryCategory!.DisplayName,
-                costPerLb = i.UnitCost,
+                // Quote at the current catalog price when linked; fall back to their cost otherwise.
+                costPerLb = i.CatalogReferencePrice ?? i.UnitCost,
                 colorName = i.ColorName ?? i.Name,
                 colorCode = i.ColorCode ?? "",
                 isIncoming = i.IsIncoming

src/PowderCoating.Web/Controllers/PowderCatalogController.cs

@@ -1,5 +1,6 @@
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
+using PowderCoating.Application.Constants;
 using PowderCoating.Application.DTOs.Common;
 using PowderCoating.Application.DTOs.Inventory;
 using PowderCoating.Application.Interfaces;
@@ -17,17 +18,28 @@ public class PowderCatalogController : Controller
 {
     private const decimal DefaultTransferEfficiency = 65m;
 
+    private const string JsonImportSource = "Manual JSON Import";
+
     private readonly IUnitOfWork _unitOfWork;
     private readonly IInventoryAiLookupService _aiLookupService;
+    private readonly IColumbiaCatalogSyncService _columbiaSyncService;
+    private readonly IPowderCatalogUpsertService _upsertService;
+    private readonly IPlatformSettingsService _platformSettings;
     private readonly ILogger<PowderCatalogController> _logger;
 
     public PowderCatalogController(
         IUnitOfWork unitOfWork,
         IInventoryAiLookupService aiLookupService,
+        IColumbiaCatalogSyncService columbiaSyncService,
+        IPowderCatalogUpsertService upsertService,
+        IPlatformSettingsService platformSettings,
         ILogger<PowderCatalogController> logger)
     {
         _unitOfWork = unitOfWork;
         _aiLookupService = aiLookupService;
+        _columbiaSyncService = columbiaSyncService;
+        _upsertService = upsertService;
+        _platformSettings = platformSettings;
         _logger = logger;
     }
 
@@ -135,6 +147,11 @@ public class PowderCatalogController : Controller
             }
         };
 
+        // Columbia sync status for the admin panel (last run + master switch).
+        ViewBag.ColumbiaSyncEnabled = await _platformSettings.GetBoolAsync(ColumbiaIntegrationConstants.SettingEnabled);
+        ViewBag.ColumbiaLastSyncedAt = await _platformSettings.GetAsync(ColumbiaIntegrationConstants.SettingLastSyncedAt);
+        ViewBag.ColumbiaLastResult = await _platformSettings.GetAsync(ColumbiaIntegrationConstants.SettingLastResult);
+
         return View(vm);
     }
 
@@ -422,6 +439,78 @@ public class PowderCatalogController : Controller
         return Json(results);
     }
 
+    /// <summary>
+    /// Manually triggers a full Columbia Coatings catalog sync (SuperAdmin only). Bypasses the
+    /// scheduled interval. Reports the run outcome via TempData on the catalog index.
+    /// </summary>
+    [HttpPost]
+    [ValidateAntiForgeryToken]
+    public async Task<IActionResult> SyncColumbia(CancellationToken cancellationToken)
+    {
+        var result = await _columbiaSyncService.RunSyncAsync(cancellationToken);
+
+        if (result.Success)
+            TempData["Success"] = $"Columbia sync complete - {result.Summary}";
+        else
+            TempData["Error"] = $"Columbia sync failed: {result.ErrorMessage}";
+
+        return RedirectToAction(nameof(Index));
+    }
+
+    /// <summary>
+    /// Right-to-delete: removes every catalog record sourced from the Columbia Coatings API
+    /// (regardless of derived manufacturer, since PPG/KP products were served through that feed)
+    /// and nulls any inventory links to them across all tenants. The shops' own inventory stock
+    /// records survive — only the catalog link and discontinued badge are lost. SuperAdmin only.
+    /// </summary>
+    [HttpPost]
+    [ValidateAntiForgeryToken]
+    public async Task<IActionResult> PurgeColumbiaData()
+    {
+        var sourced = (await _unitOfWork.PowderCatalog.FindAsync(
+            p => p.Source == ColumbiaIntegrationConstants.SourceName)).ToList();
+
+        if (sourced.Count == 0)
+        {
+            TempData["Error"] = "There is no Columbia Coatings API data to remove.";
+            return RedirectToAction(nameof(Index));
+        }
+
+        var ids = sourced.Select(p => p.Id).ToList();
+
+        // Null the inventory links across ALL tenants (platform-level purge). A tenant's stock
+        // record is their data and must survive — it keeps its add-time snapshot, losing only the
+        // live catalog link.
+        var linked = (await _unitOfWork.InventoryItems.FindAsync(
+            i => i.PowderCatalogItemId.HasValue && ids.Contains(i.PowderCatalogItemId.Value),
+            ignoreQueryFilters: true)).ToList();
+        foreach (var inv in linked)
+        {
+            inv.PowderCatalogItemId = null;
+            await _unitOfWork.InventoryItems.UpdateAsync(inv);
+        }
+
+        foreach (var p in sourced)
+            await _unitOfWork.PowderCatalog.DeleteAsync(p);
+        await _unitOfWork.CompleteAsync();
+
+        // Reset sync tracking so the admin panel reflects the purge.
+        await _platformSettings.SetAsync(ColumbiaIntegrationConstants.SettingLastSyncedAt, null, "Columbia Purge");
+        await _platformSettings.SetAsync(
+            ColumbiaIntegrationConstants.SettingLastResult,
+            $"Purged {sourced.Count:N0} records on {DateTime.UtcNow:yyyy-MM-dd}",
+            "Columbia Purge");
+
+        _logger.LogWarning(
+            "Columbia data purge: deleted {Count} catalog records, unlinked {Linked} inventory items.",
+            sourced.Count, linked.Count);
+
+        TempData["Success"] =
+            $"Removed {sourced.Count:N0} Columbia Coatings catalog record(s) and unlinked " +
+            $"{linked.Count:N0} inventory item(s). Inventory stock was preserved.";
+        return RedirectToAction(nameof(Index));
+    }
+
     // Private helpers
 
     private async Task ApplyTdsCureFallbackAsync(InventoryAiLookupResult result, string? colorName)
@@ -449,13 +538,10 @@ public class PowderCatalogController : Controller
             return new PowderCatalogImportResult { Success = false, ErrorMessage = "JSON must have a top-level 'results' array." };
         }
 
-        // Load existing records for this vendor into a lookup dictionary
-        var existing = (await _unitOfWork.PowderCatalog.FindAsync(p => p.VendorName == vendorName))
-            .ToDictionary(p => p.Sku, StringComparer.OrdinalIgnoreCase);
-
-        var now = DateTime.UtcNow;
-        int inserted = 0, updated = 0, skipped = 0, errors = 0;
-        var toAdd = new List<PowderCatalogItem>();
+        // Map the scrape format to catalog items, then hand off to the shared upsert path (same
+        // one the Columbia API sync uses) so there is a single insert/update/diff implementation.
+        var mapped = new List<PowderCatalogItem>();
+        int skipped = 0, errors = 0;
 
         foreach (var item in resultsEl.EnumerateArray())
         {
@@ -469,49 +555,21 @@ public class PowderCatalogController : Controller
                     continue;
                 }
 
-                var rawDesc = item.GetStringOrNull("description");
-                var cleanDesc = StripBoilerplate(rawDesc);
-                var unitPrice = ExtractBasePrice(item);
-                var priceTiersJson = item.TryGetProperty("price_tiers", out var tiersEl)
-                    ? tiersEl.GetRawText()
-                    : null;
-
-                if (existing.TryGetValue(sku, out var record))
+                mapped.Add(new PowderCatalogItem
                 {
-                    record.ColorName = colorName;
-                    record.Description = cleanDesc;
-                    record.UnitPrice = unitPrice;
-                    record.PriceTiersJson = priceTiersJson;
-                    record.ImageUrl = item.GetStringOrNull("sample_image_url");
-                    record.SdsUrl = item.GetStringOrNull("safety_data_sheet_url");
-                    record.TdsUrl = item.GetStringOrNull("technical_data_sheet_url");
-                    record.ApplicationGuideUrl = item.GetStringOrNull("application_guide_url");
-                    record.ProductUrl = item.GetStringOrNull("product_url");
-                    record.UpdatedAt = now;
-                    record.LastSyncedAt = now;
-                    await _unitOfWork.PowderCatalog.UpdateAsync(record);
-                    updated++;
-                }
-                else
-                {
-                    toAdd.Add(new PowderCatalogItem
-                    {
-                        VendorName = vendorName,
-                        Sku = sku,
-                        ColorName = colorName,
-                        Description = cleanDesc,
-                        UnitPrice = unitPrice,
-                        PriceTiersJson = priceTiersJson,
-                        ImageUrl = item.GetStringOrNull("sample_image_url"),
-                        SdsUrl = item.GetStringOrNull("safety_data_sheet_url"),
-                        TdsUrl = item.GetStringOrNull("technical_data_sheet_url"),
-                        ApplicationGuideUrl = item.GetStringOrNull("application_guide_url"),
-                        ProductUrl = item.GetStringOrNull("product_url"),
-                        CreatedAt = now,
-                        LastSyncedAt = now
-                    });
-                    inserted++;
-                }
+                    VendorName = vendorName,
+                    Source = JsonImportSource,
+                    Sku = sku,
+                    ColorName = colorName,
+                    Description = StripBoilerplate(item.GetStringOrNull("description")),
+                    UnitPrice = ExtractBasePrice(item),
+                    PriceTiersJson = item.TryGetProperty("price_tiers", out var tiersEl) ? tiersEl.GetRawText() : null,
+                    ImageUrl = item.GetStringOrNull("sample_image_url"),
+                    SdsUrl = item.GetStringOrNull("safety_data_sheet_url"),
+                    TdsUrl = item.GetStringOrNull("technical_data_sheet_url"),
+                    ApplicationGuideUrl = item.GetStringOrNull("application_guide_url"),
+                    ProductUrl = item.GetStringOrNull("product_url"),
+                });
             }
             catch (Exception ex)
             {
@@ -520,17 +578,14 @@ public class PowderCatalogController : Controller
             }
         }
 
-        if (toAdd.Any())
-            await _unitOfWork.PowderCatalog.AddRangeAsync(toAdd);
-
-        await _unitOfWork.CompleteAsync();
+        var upsert = await _upsertService.UpsertAsync(mapped, DateTime.UtcNow);
 
         return new PowderCatalogImportResult
         {
             Success = true,
-            Inserted = inserted,
-            Updated = updated,
-            Skipped = skipped,
+            Inserted = upsert.Inserted,
+            Updated = upsert.Updated,
+            Skipped = skipped + upsert.Skipped,
             Errors = errors
         };
     }

src/PowderCoating.Web/Controllers/QuotesController.cs

@@ -2545,7 +2545,8 @@ public class QuotesController : Controller
                 efficiency = i.TransferEfficiency ?? 65m,
                 unitOfMeasure = i.UnitOfMeasure ?? "lbs",
                 categoryName = i.InventoryCategory!.DisplayName,
-                costPerLb = i.UnitCost,
+                // Quote at the current catalog price when linked; fall back to their cost otherwise.
+                costPerLb = i.CatalogReferencePrice ?? i.UnitCost,
                 colorName = i.ColorName ?? i.Name,
                 colorCode = i.ColorCode ?? "",
                 isIncoming = i.IsIncoming

src/PowderCoating.Web/Helpers/HelpKnowledgeBase.cs

@@ -481,6 +481,8 @@ public static class HelpKnowledgeBase
         5. Enter opening quantity on hand — the system automatically records an Initial transaction for audit purposes
         6. Save
 
+        **Manufacturer catalog integration:** The platform is integrated with the Columbia Coatings product catalog. When you add a Columbia powder it auto-fills the color, specs, cure schedule, and SDS/TDS links, and keeps the price current — catalog data refreshes regularly (near real-time). Quotes use the latest catalog price even when your stored cost is older, and a powder's detail page shows the current catalog price (and flags when it has changed since you last bought it). Discontinued powders are flagged "cannot reorder" but stay usable for stock you already have.
+
         **Stock status:** Three states are shown on every item:
         - **In Stock** (green) — quantity is above the reorder point
         - **Low Stock** (red) — quantity is greater than zero but at or below the reorder point; time to reorder

src/PowderCoating.Web/Program.cs

@@ -11,6 +11,7 @@ using PowderCoating.Core.Interfaces.Services;
 using PowderCoating.Infrastructure.Data;
 using PowderCoating.Infrastructure.Repositories;
 using PowderCoating.Infrastructure.Services;
+using PowderCoating.Infrastructure.Services.Columbia;
 using PowderCoating.Application.Interfaces;
 using PowderCoating.Application.Services;
 using PowderCoating.Application.Configuration;
@@ -222,6 +223,9 @@ builder.Services.AddScoped<IInventoryAiLookupService, InventoryAiLookupService>(
 builder.Services.AddScoped<ICustomFormulaAiService, CustomFormulaAiService>();
 builder.Services.AddScoped<IFormulaLibraryService, FormulaLibraryService>();
 builder.Services.AddHttpClient();
+builder.Services.AddScoped<IColumbiaCoatingsApiClient, ColumbiaCoatingsApiClient>();
+builder.Services.AddScoped<IPowderCatalogUpsertService, PowderCatalogUpsertService>();
+builder.Services.AddScoped<IColumbiaCatalogSyncService, ColumbiaCatalogSyncService>();
 builder.Services.AddScoped<ICompanyLogoService, CompanyLogoService>();
 builder.Services.AddScoped<IEquipmentManualService, EquipmentManualService>();
 builder.Services.AddScoped<IPricingCalculationService, PricingCalculationService>();
@@ -255,6 +259,7 @@ builder.Services.AddHostedService<StripeWebhookRetentionBackgroundService>();
 builder.Services.AddHostedService<SetupWizardReminderBackgroundService>();
 builder.Services.AddHostedService<RecurringTransactionService>();
 builder.Services.AddHostedService<AppointmentReminderBackgroundService>();
+builder.Services.AddHostedService<ColumbiaCatalogSyncBackgroundService>();
 builder.Services.AddScoped<ISubscriptionService, SubscriptionService>();
 builder.Services.AddScoped<IStripeService, StripeService>();
 builder.Services.AddScoped<IStripeConnectService, StripeConnectService>();

src/PowderCoating.Web/Views/Dashboard/Index.cshtml

@@ -1041,6 +1041,37 @@
 
             // Custom powder (no inventory item) â†' open modal to add to inventory
             if (!hasInv) {
+                // If the powder is already in the master catalog, receive it straight to inventory
+                // with all its specs/docs — no modal. Only fall back to the modal when it isn't.
+                const tokenAuto = document.querySelector('input[name="__RequestVerificationToken"]')?.value
+                               ?? document.querySelector('meta[name="__RequestVerificationToken"]')?.content;
+                this.disabled = true; qtyInput.disabled = true;
+                this.innerHTML = '<span class="spinner-border spinner-border-sm"></span>';
+                try {
+                    const autoResp = await fetch('@Url.Action("ReceivePowderFromCatalog", "Dashboard")', {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/x-www-form-urlencoded', 'RequestVerificationToken': tokenAuto },
+                        body: `coatId=${coatId}&lbsReceived=${lbs}`
+                    });
+                    const autoData = await autoResp.json();
+                    if (autoData.success) {
+                        fadePlacedRow(row);
+                        showInventoryToast('Added "' + (autoData.itemName || 'powder') + '" to inventory from the catalog.');
+                        return;
+                    }
+                    if (!autoData.needsDetails) {
+                        alert(autoData.message || 'Could not record receipt. Please try again.');
+                        this.disabled = false; qtyInput.disabled = false;
+                        this.innerHTML = '<i class="bi bi-box-arrow-in-down"></i> Got It';
+                        return;
+                    }
+                    // Not in catalog — fall through to the manual entry modal.
+                } catch {
+                    // Network error — fall back to the manual entry modal.
+                }
+                this.disabled = false; qtyInput.disabled = false;
+                this.innerHTML = '<i class="bi bi-box-arrow-in-down"></i> Got It';
+
                 const modal = document.getElementById('addPowderModal');
                 // Pre-fill hidden + text fields
                 modal.querySelector('#apm-coatId').value       = coatId;

src/PowderCoating.Web/Views/Help/Inventory.cshtml

@@ -138,6 +138,18 @@
                 <li class="mb-1">If a vendor name is selected in the Vendor field before searching, results are scoped to that vendor first, then broadened automatically if nothing matches.</li>
             </ul>
 
+            <div class="alert alert-permanent alert-success d-flex gap-2 mb-3" role="alert">
+                <i class="bi bi-cloud-check me-1 flex-shrink-0 mt-1"></i>
+                <div>
+                    <strong>Columbia Coatings integration:</strong> the catalog is connected directly to the Columbia Coatings
+                    product catalog and refreshes regularly (near real-time). Columbia powders auto-fill their full specs, cure
+                    schedule, and SDS/TDS links, and their prices stay current &mdash; quotes use the latest catalog price even
+                    when your stored cost is older. An item&rsquo;s detail page shows the current catalog price and flags when it
+                    has changed since you last bought it. Discontinued powders are flagged &ldquo;cannot reorder&rdquo; but stay
+                    usable for stock you already have.
+                </div>
+            </div>
+
             <h3 class="h6 fw-semibold mt-4 mb-2"><i class="bi bi-camera me-1"></i>Label Scanner (Camera)</h3>
             <p>
                 Click the <strong>camera icon</strong> next to the Lookup button to open the label scanner.

src/PowderCoating.Web/Views/Inventory/Details.cshtml

@@ -69,6 +69,12 @@
                     {
                         <span class="badge bg-danger"><i class="bi bi-x-circle me-1"></i>Inactive</span>
                     }
+                    @if ((bool?)ViewBag.CatalogDiscontinued == true)
+                    {
+                        <span class="badge bg-warning text-dark" title="Discontinued by the manufacturer — cannot reorder">
+                            <i class="bi bi-slash-circle me-1"></i>Discontinued by manufacturer
+                        </span>
+                    }
                 </div>
             </div>
             <div class="d-flex gap-2">
@@ -103,6 +109,20 @@
                 <div><strong>Status:</strong> This item is inactive</div>
             </div>
         }
+        @if ((bool?)ViewBag.CatalogDiscontinued == true)
+        {
+            <div class="alert alert-warning alert-permanent d-flex align-items-center mb-3">
+                <i class="bi bi-slash-circle me-2"></i>
+                <div>
+                    <strong>Discontinued by @(ViewBag.CatalogVendorName ?? "manufacturer"):</strong>
+                    this powder has been discontinued and cannot be reordered. Existing stock can still be used and quoted.
+                    @if (!string.IsNullOrEmpty(ViewBag.CatalogProductUrl as string))
+                    {
+                        <a href="@ViewBag.CatalogProductUrl" target="_blank" rel="noopener" class="alert-link ms-1">View product page</a>
+                    }
+                </div>
+            </div>
+        }
 
         <div class="row g-4">
             <!-- Left Column -->
@@ -411,6 +431,41 @@
                                 <label class="text-muted small mb-1">Total Stock Value</label>
                                 <p class="fw-semibold text-primary mb-0 fs-5">@((Model.QuantityOnHand * Model.UnitCost).ToString("C"))</p>
                             </div>
+                            @if (Model.CatalogReferencePrice.HasValue && Model.CatalogReferencePrice.Value > 0)
+                            {
+                                <div class="col-12"><hr class="my-2" /></div>
+                                <div class="col-12">
+                                    <label class="text-muted small mb-1">
+                                        Current Catalog Price
+                                        <i class="bi bi-info-circle ms-1" role="button" tabindex="0"
+                                           data-bs-toggle="popover" data-bs-trigger="hover focus" data-bs-placement="top"
+                                           data-bs-content="The current list price from the linked manufacturer catalog, refreshed by sync. New quotes use this price. It does not change your Unit Cost or stock value."></i>
+                                    </label>
+                                    <p class="fw-semibold text-success mb-0 fs-5">
+                                        @Model.CatalogReferencePrice.Value.ToString("C")
+                                        <span class="text-muted fs-6 fw-normal">/ @Model.UnitOfMeasure</span>
+                                    </p>
+                                    @{
+                                        var catRef = Model.CatalogReferencePrice.Value;
+                                        var paidPrice = (Model.LastPurchaseDate.HasValue && Model.LastPurchasePrice > 0)
+                                            ? Model.LastPurchasePrice : Model.UnitCost;
+                                    }
+                                    @if (paidPrice > 0 && Math.Abs(catRef - paidPrice) >= 0.01m)
+                                    {
+                                        var priceUp = catRef > paidPrice;
+                                        <div class="mt-1">
+                                            <span class="badge @(priceUp ? "bg-warning text-dark" : "bg-info text-dark")">
+                                                <i class="bi @(priceUp ? "bi-arrow-up-right" : "bi-arrow-down-right") me-1"></i>
+                                                Price @(priceUp ? "up" : "down") from @paidPrice.ToString("C") last paid
+                                            </span>
+                                        </div>
+                                    }
+                                    @if (Model.CatalogPriceUpdatedAt.HasValue)
+                                    {
+                                        <div class="text-muted small mt-1">Updated @Model.CatalogPriceUpdatedAt.Value.ToLocalTime().ToString("MMM d, yyyy")</div>
+                                    }
+                                </div>
+                            }
                             @if (Model.LastPurchaseDate.HasValue)
                             {
                                 <div class="col-6">

src/PowderCoating.Web/Views/PowderCatalog/Index.cshtml

@@ -110,12 +110,49 @@
             <div class="text-muted small">Platform-level lookup library for inventory autofill, SDS/TDS links, and curing specs.</div>
         </div>
         <div class="d-flex gap-2">
+            <form asp-action="SyncColumbia" method="post" class="d-inline"
+                  onsubmit="this.querySelector('button').disabled=true;this.querySelector('button').innerHTML='<span class=\'spinner-border spinner-border-sm me-1\'></span>Syncing&hellip;';">
+                @Html.AntiForgeryToken()
+                <button type="submit" class="btn btn-outline-primary" title="Pull the latest Columbia Coatings catalog now">
+                    <i class="bi bi-cloud-download me-1"></i>Sync Columbia
+                </button>
+            </form>
             <a asp-action="Create" class="btn btn-primary">
                 <i class="bi bi-plus-circle me-1"></i>Add Powder
             </a>
         </div>
     </div>
 
+    @{
+        var columbiaLastSynced = ViewBag.ColumbiaLastSyncedAt as string;
+        var columbiaLastResult = ViewBag.ColumbiaLastResult as string;
+        var columbiaEnabled = ViewBag.ColumbiaSyncEnabled is true;
+    }
+    <div class="alert alert-light border d-flex flex-wrap align-items-center gap-2 small mb-4 alert-permanent">
+        <span class="badge @(columbiaEnabled ? "bg-success" : "bg-secondary")">
+            Scheduled sync @(columbiaEnabled ? "on" : "off")
+        </span>
+        @if (!string.IsNullOrWhiteSpace(columbiaLastSynced) && DateTime.TryParse(columbiaLastSynced, out var lastSyncedAt))
+        {
+            <span class="text-muted">Last synced @lastSyncedAt.ToLocalTime().ToString("MMM d, yyyy h:mm tt")</span>
+        }
+        else
+        {
+            <span class="text-muted">Never synced</span>
+        }
+        @if (!string.IsNullOrWhiteSpace(columbiaLastResult))
+        {
+            <span class="text-muted">&mdash; @columbiaLastResult</span>
+        }
+        <form asp-action="PurgeColumbiaData" method="post" class="ms-auto"
+              onsubmit="return confirm('Remove ALL Columbia Coatings API data from the powder catalog? This deletes every record sourced from their feed (including PPG and KP Pigments products served through it) and unlinks inventory items. Inventory stock is preserved. This cannot be undone.');">
+            @Html.AntiForgeryToken()
+            <button type="submit" class="btn btn-outline-danger btn-sm" title="Right-to-delete: remove all Columbia-sourced catalog data">
+                <i class="bi bi-trash me-1"></i>Remove Columbia data
+            </button>
+        </form>
+    </div>
+
     <div class="row g-3 mb-4 powder-catalog-summary">
         <div class="col-sm-6 col-xl-2">
             <div class="card h-100">

src/PowderCoating.Web/appsettings.json

@@ -42,6 +42,11 @@
       "ApiKey": "25651af3a4829559ef0dfa1758fa3edbf92b6b76"
     }
   },
+  "Columbia": {
+    "ApiKey": "cca_live_ffd5e355809e1d23007d82982684157de5727c226bc2b482",
+    "BaseUrl": "https://columbiacoatings.com",
+    "ApiBasePath": "/wp-json/cca/v1"
+  },
   "SendGrid": {
     "ApiKey": "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",
     "FromEmail": "spouliot@scppowdercoating.com",

tests/PowderCoating.UnitTests/ColumbiaCatalogMapperTests.cs

@@ -0,0 +1,323 @@
+using System.Text.Json;
+using PowderCoating.Application.DTOs.Columbia;
+using PowderCoating.Infrastructure.Services.Columbia;
+
+namespace PowderCoating.UnitTests;
+
+/// <summary>
+/// Tests for the Columbia catalog mapper, focused on the fields that are tricky in the real feed:
+/// the free-text cure parser (multiple glyphs, multi-curve, partial-cure), manufacturer derivation
+/// from a multi-brand distributor, pricing across simple/variable products, and HTML stripping.
+/// Cases mirror records captured from the live API.
+/// </summary>
+public class ColumbiaCatalogMapperTests
+{
+    // ── Cure schedule parsing ─────────────────────────────────────────────
+
+    [Fact]
+    public void ParseCureCurves_SimpleSchedule_ReturnsSingleCurve()
+    {
+        var curves = ColumbiaCatalogMapper.ParseCureCurves("10 minutes @ 400°F");
+        Assert.Single(curves);
+        Assert.Equal(400, curves[0].TempF);
+        Assert.Equal(10, curves[0].Minutes);
+    }
+
+    [Fact]
+    public void ParseCureCurves_MetalTemperaturePrefixWithCelsius_ParsesFahrenheitOnly()
+    {
+        var curves = ColumbiaCatalogMapper.ParseCureCurves("Metal Temperature: 10 minutes at 400°F (204°C)");
+        Assert.Single(curves);
+        Assert.Equal(400, curves[0].TempF);
+        Assert.Equal(10, curves[0].Minutes);
+    }
+
+    [Theory]
+    [InlineData("10 minutes @ 400˚F (204˚C)")]  // U+02DA ring above
+    [InlineData("10 minutes @ 400ºF (204ºC)")]  // U+00BA masculine ordinal
+    [InlineData("Metal temperature: 10 minutes @ 400F (204C)")] // no degree glyph at all
+    public void ParseCureCurves_DegreeGlyphVariants_AllParse(string schedule)
+    {
+        var curves = ColumbiaCatalogMapper.ParseCureCurves(schedule);
+        Assert.Single(curves);
+        Assert.Equal(400, curves[0].TempF);
+    }
+
+    [Fact]
+    public void ParseCureCurves_MultiCurve_CapturesAllInOrder_PrimaryIsFirst()
+    {
+        // Real record S1790085-55: standard high-temp curve first, low-temp alternates after.
+        var schedule = "Metal Temperature: 5 minutes at 400°F (204°C) -or- 10 minutes at 360°F (182°C)* 15 minutes at 340°F (171°C)* *Low-Temp cure curve";
+        var curves = ColumbiaCatalogMapper.ParseCureCurves(schedule);
+
+        Assert.Equal(3, curves.Count);
+        Assert.Equal(new ColumbiaCatalogMapper.CureCurve(400, 5), curves[0]);   // primary
+        Assert.Equal(new ColumbiaCatalogMapper.CureCurve(360, 10), curves[1]);  // alternate
+        Assert.Equal(new ColumbiaCatalogMapper.CureCurve(340, 15), curves[2]);  // alternate
+    }
+
+    [Fact]
+    public void ParseCureCurves_PartialCureInstructions_ReturnsEmpty()
+    {
+        // Illusion powder F1697027 — multi-step, no single temp/time pair.
+        var schedule = "(1) - Apply a basecoat and partial cure. (2) - Apply this powder and partial cure (3). - Apply a clear coat and fully cure.";
+        var curves = ColumbiaCatalogMapper.ParseCureCurves(schedule);
+        Assert.Empty(curves);
+    }
+
+    [Fact]
+    public void Map_MultiCurve_SetsPrimaryTempTimeAndStoresAllCurvesJson()
+    {
+        var product = new ColumbiaProduct
+        {
+            Sku = "S1790085-55",
+            Name = "Multi Cure",
+            CureSchedule = "5 minutes at 400°F -or- 10 minutes at 360°F",
+        };
+
+        var item = ColumbiaCatalogMapper.Map(product);
+
+        Assert.Equal(400m, item.CureTemperatureF);
+        Assert.Equal(5, item.CureTimeMinutes);
+        Assert.False(string.IsNullOrEmpty(item.CureCurvesJson));
+        Assert.Equal("5 minutes at 400°F -or- 10 minutes at 360°F", item.CureScheduleText);
+
+        var curves = JsonSerializer.Deserialize<List<ColumbiaCatalogMapper.CureCurve>>(item.CureCurvesJson!);
+        Assert.Equal(2, curves!.Count);
+    }
+
+    // ── Manufacturer derivation ───────────────────────────────────────────
+
+    [Fact]
+    public void DeriveManufacturer_AddSkuPrefix_IsKpPigments()
+    {
+        var p = new ColumbiaProduct { Sku = "ADD-BRBDS", Name = "Barbados Blue ColorShift Pearl" };
+        Assert.Equal("KP Pigments", ColumbiaCatalogMapper.DeriveManufacturer(p));
+        Assert.True(ColumbiaCatalogMapper.IsAdditive(p));
+    }
+
+    [Fact]
+    public void DeriveManufacturer_PpgCategory_IsPpg()
+    {
+        var p = new ColumbiaProduct
+        {
+            Sku = "PCU75139",
+            Name = "PPG Chrome Shadow",
+            Categories = { new ColumbiaNamed { Name = "PPG Powders" } },
+        };
+        Assert.Equal("PPG", ColumbiaCatalogMapper.DeriveManufacturer(p));
+    }
+
+    [Fact]
+    public void DeriveManufacturer_HouseBrand_IsColumbia()
+    {
+        var p = new ColumbiaProduct
+        {
+            Sku = "X5004124",
+            Name = "Blue Wrinkle",
+            Categories = { new ColumbiaNamed { Name = "Powders" }, new ColumbiaNamed { Name = "New Releases" } },
+        };
+        Assert.Equal("Columbia Coatings", ColumbiaCatalogMapper.DeriveManufacturer(p));
+        Assert.False(ColumbiaCatalogMapper.IsAdditive(p));
+    }
+
+    // ── Excluded products (swatches + tester/sample size variants) ────────
+
+    [Theory]
+    [InlineData("T1696049-SW", "**SWATCH** - Copperhead II", true)]      // swatch card
+    [InlineData("T1696049-SW", "Copperhead II", true)]                   // -SW suffix alone
+    [InlineData("X1", "**SWATCH** - Something", true)]                   // name marker alone
+    [InlineData("T1696049-04", "Copperhead II (4 Ounce Tester)", true)]  // tester = size variant
+    [InlineData("XYZ", "Copperhead II (4 Ounce Tester)", true)]          // tester by name
+    [InlineData("S1760090-S", "Black Beauty Sample (5 lbs)", true)]      // 5lb sample = size variant
+    [InlineData("X5004124", "Blue Wrinkle", false)]                      // normal powder
+    [InlineData("S5704126", "Smokey Blue", false)]                       // normal powder, SKU starts with S
+    public void IsExcludedProduct_DetectsSwatchesTestersAndSamples(string sku, string name, bool expected)
+    {
+        var p = new ColumbiaProduct { Sku = sku, Name = name };
+        Assert.Equal(expected, ColumbiaCatalogMapper.IsExcludedProduct(p));
+    }
+
+    // ── Pricing ───────────────────────────────────────────────────────────
+
+    [Fact]
+    public void ParseBasePrice_SimpleProduct_UsesTopLevelPrice()
+    {
+        var p = new ColumbiaProduct { Price = "18.85", RegularPrice = "18.85" };
+        Assert.Equal(18.85m, ColumbiaCatalogMapper.ParseBasePrice(p));
+    }
+
+    [Fact]
+    public void ParseBasePrice_VariableProductWithZeroRegular_FallsBackToPriceThenVariants()
+    {
+        // Variable parent: price carries the lead variant, regular_price is "0".
+        var p = new ColumbiaProduct
+        {
+            Price = "18.85",
+            RegularPrice = "0",
+            VariationPricing = new List<ColumbiaVariationPricing>
+            {
+                new() { Sku = "X-B", Price = "18.85" },
+                new() { Sku = "X-P", Price = "18.85" },
+            },
+        };
+        Assert.Equal(18.85m, ColumbiaCatalogMapper.ParseBasePrice(p));
+    }
+
+    [Fact]
+    public void BuildPriceTiersJson_VariableProduct_SerializesVariationPricing()
+    {
+        var p = new ColumbiaProduct
+        {
+            VariationPricing = new List<ColumbiaVariationPricing>
+            {
+                new() { Sku = "X-B", Price = "18.85" },
+            },
+        };
+        var json = ColumbiaCatalogMapper.BuildPriceTiersJson(p);
+        Assert.NotNull(json);
+        Assert.Contains("X-B", json);
+    }
+
+    [Fact]
+    public void BuildPriceTiersJson_EmptyTieredPricingArray_ReturnsNull()
+    {
+        // Variable products carry tiered_pricing as an empty array.
+        var p = new ColumbiaProduct { TieredPricing = JsonDocument.Parse("[]").RootElement };
+        Assert.Null(ColumbiaCatalogMapper.BuildPriceTiersJson(p));
+    }
+
+    // ── Chemistry, color, HTML ────────────────────────────────────────────
+
+    [Theory]
+    [InlineData("Polyester/TGIC", "Polyester/TGIC")]
+    [InlineData("Polyester TGIC", "Polyester/TGIC")]
+    [InlineData("TGIC Polyester", "Polyester/TGIC")]
+    [InlineData("TGIC", "TGIC")]
+    [InlineData("", null)]
+    public void NormalizeChemistry_CollapsesPolyesterTgicVariants(string input, string? expected)
+    {
+        Assert.Equal(expected, ColumbiaCatalogMapper.NormalizeChemistry(input));
+    }
+
+    [Fact]
+    public void BuildColorFamilies_JoinsColorGroupNames()
+    {
+        var p = new ColumbiaProduct
+        {
+            PaColorGroup = { new ColumbiaNamed { Name = "Blue" }, new ColumbiaNamed { Name = "Green" } },
+        };
+        Assert.Equal("Blue,Green", ColumbiaCatalogMapper.BuildColorFamilies(p));
+    }
+
+    [Fact]
+    public void BuildColorFamilies_FallsBackToColorGroupAttribute()
+    {
+        var p = new ColumbiaProduct
+        {
+            Attributes =
+            {
+                new ColumbiaAttribute
+                {
+                    Name = "Color Group",
+                    Options = { new ColumbiaNamed { Name = "Black" } },
+                },
+            },
+        };
+        Assert.Equal("Black", ColumbiaCatalogMapper.BuildColorFamilies(p));
+    }
+
+    [Fact]
+    public void StripHtml_RemovesTagsEntitiesAndCollapsesWhitespace()
+    {
+        var html = "<strong>Blue Wrinkle</strong>\r\n\r\nThis is a vibrant &amp; bright coating.";
+        var text = ColumbiaCatalogMapper.StripHtml(html);
+        Assert.Equal("Blue Wrinkle This is a vibrant & bright coating.", text);
+    }
+
+    [Fact]
+    public void DetectRequiresClearCoat_ExplicitRequirement_IsTrue()
+    {
+        var p = new ColumbiaProduct
+        {
+            Description = "This powder requires a clear coat to activate the effect.",
+        };
+        Assert.True(ColumbiaCatalogMapper.DetectRequiresClearCoat(p));
+    }
+
+    [Fact]
+    public void DetectRequiresClearCoat_IllusionLine_IsTrue()
+    {
+        var p = new ColumbiaProduct { Name = "Illusion Cherry", Description = "A translucent red." };
+        Assert.True(ColumbiaCatalogMapper.DetectRequiresClearCoat(p));
+    }
+
+    [Fact]
+    public void DetectRequiresClearCoat_PartialCureSchedule_IsTrue()
+    {
+        var p = new ColumbiaProduct
+        {
+            Name = "Some Base",
+            CureSchedule = "Partial Cure: 15 min total time in oven preheated to 400°F. Then apply clear.",
+        };
+        Assert.True(ColumbiaCatalogMapper.DetectRequiresClearCoat(p));
+    }
+
+    [Fact]
+    public void DetectRequiresClearCoat_CasualMention_IsFalse()
+    {
+        // The over-flagging case: a passing mention is not a requirement.
+        var p = new ColumbiaProduct
+        {
+            Name = "Gloss Black",
+            Description = "Durable gloss black. Apply a clear coat for added protection if desired.",
+        };
+        Assert.False(ColumbiaCatalogMapper.DetectRequiresClearCoat(p));
+    }
+
+    // ── End-to-end mapping invariants ─────────────────────────────────────
+
+    // ── Tolerant image deserialization (WordPress returns [] / false when empty) ──
+
+    private static readonly JsonSerializerOptions ClientJsonOptions = new()
+    {
+        PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower,
+        PropertyNameCaseInsensitive = true,
+        Converters = { new ColumbiaImageJsonConverter() },
+    };
+
+    [Fact]
+    public void Deserialize_FeaturedImageEmptyArray_YieldsNullImage()
+    {
+        // WordPress returns featured_image: [] for products with no image.
+        var json = """{ "sku": "X1", "name": "No Image", "featured_image": [] }""";
+        var product = JsonSerializer.Deserialize<ColumbiaProduct>(json, ClientJsonOptions);
+
+        Assert.NotNull(product);
+        Assert.Null(product!.FeaturedImage);
+        Assert.Null(ColumbiaCatalogMapper.Map(product).ImageUrl);
+    }
+
+    [Fact]
+    public void Deserialize_FeaturedImageObject_ParsesSrc()
+    {
+        var json = """{ "sku": "X1", "name": "Has Image", "featured_image": { "id": 5, "src": "https://x/img.png", "name": "i", "alt": "" } }""";
+        var product = JsonSerializer.Deserialize<ColumbiaProduct>(json, ClientJsonOptions);
+
+        Assert.Equal("https://x/img.png", product!.FeaturedImage!.Src);
+        Assert.Equal("https://x/img.png", ColumbiaCatalogMapper.Map(product).ImageUrl);
+    }
+
+    [Fact]
+    public void Map_AlwaysStampsSource_AndLeavesEnrichmentFieldsNull()
+    {
+        var p = new ColumbiaProduct { Sku = "X5004124", Name = "Blue Wrinkle", Price = "18.85" };
+        var item = ColumbiaCatalogMapper.Map(p);
+
+        Assert.Equal("Columbia Coatings API", item.Source);
+        // Enrichment fields are not in the feed and must stay null for lazy TDS/AI enrichment.
+        Assert.Null(item.SpecificGravity);
+        Assert.Null(item.CoverageSqFtPerLb);
+        Assert.Null(item.TransferEfficiency);
+    }
+}

tests/PowderCoating.UnitTests/PowderCatalogPropagationTests.cs

@@ -0,0 +1,222 @@
+using System.Security.Claims;
+using Microsoft.AspNetCore.Http;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+using Moq;
+using PowderCoating.Core.Entities;
+using PowderCoating.Infrastructure.Data;
+using PowderCoating.Infrastructure.Repositories;
+using PowderCoating.Infrastructure.Services;
+
+namespace PowderCoating.UnitTests;
+
+/// <summary>
+/// Verifies that catalog sync propagation updates a linked inventory item's quoting reference price
+/// and product data, while never touching the tenant-owned cost basis, quantity, notes, or image.
+/// </summary>
+public class PowderCatalogPropagationTests
+{
+    [Fact]
+    public async Task Propagate_UpdatesReferencePriceAndSpecs_ButNotCostQuantityNotesOrImage()
+    {
+        await using var context = CreateContext();
+
+        var catalog = new PowderCatalogItem
+        {
+            VendorName = "Columbia Coatings",
+            Sku = "CS1693053",
+            ColorName = "Joker Jewel",
+            Source = "Columbia Coatings API",
+            UnitPrice = 28m,                // new catalog price
+            SdsUrl = "https://cc/sds.pdf",
+            TdsUrl = "https://cc/tds.pdf",
+            CureTemperatureF = 400m,
+            CureTimeMinutes = 10,
+            ColorFamilies = "Green,Purple",
+        };
+        context.PowderCatalogItems.Add(catalog);
+        await context.SaveChangesAsync();
+
+        var inv = new InventoryItem
+        {
+            CompanyId = 1,
+            SKU = "POWD-2606-0001",
+            Name = "Joker Jewel",
+            PowderCatalogItemId = catalog.Id,
+            UnitCost = 20m,                 // what they actually paid
+            AverageCost = 20m,
+            LastPurchasePrice = 20m,
+            QuantityOnHand = 5m,
+            Notes = "keep my note",
+            ImageUrl = "my-own-photo.jpg",
+            CatalogReferencePrice = null,   // not yet set
+        };
+        context.InventoryItems.Add(inv);
+        await context.SaveChangesAsync();
+
+        var service = new PowderCatalogUpsertService(
+            new UnitOfWork(context),
+            Mock.Of<ILogger<PowderCatalogUpsertService>>());
+
+        var updated = await service.PropagateToLinkedInventoryAsync();
+
+        Assert.Equal(1, updated);
+
+        var refreshed = await context.InventoryItems.FindAsync(inv.Id);
+        Assert.NotNull(refreshed);
+
+        // Quoting reference price + product data refreshed from the catalog.
+        Assert.Equal(28m, refreshed!.CatalogReferencePrice);
+        Assert.NotNull(refreshed.CatalogPriceUpdatedAt);
+        Assert.Equal("https://cc/sds.pdf", refreshed.SdsUrl);
+        Assert.Equal("https://cc/tds.pdf", refreshed.TdsUrl);
+        Assert.Equal(400m, refreshed.CureTemperatureF);
+        Assert.Equal("Green,Purple", refreshed.ColorFamilies);
+
+        // Tenant-owned fields untouched.
+        Assert.Equal(20m, refreshed.UnitCost);
+        Assert.Equal(20m, refreshed.AverageCost);
+        Assert.Equal(20m, refreshed.LastPurchasePrice);
+        Assert.Equal(5m, refreshed.QuantityOnHand);
+        Assert.Equal("keep my note", refreshed.Notes);
+        Assert.Equal("my-own-photo.jpg", refreshed.ImageUrl);
+    }
+
+    [Fact]
+    public async Task Propagate_DoesNotSetReferencePrice_WhenCatalogPriceIsZero()
+    {
+        await using var context = CreateContext();
+
+        var catalog = new PowderCatalogItem
+        {
+            VendorName = "Columbia Coatings",
+            Sku = "X1",
+            ColorName = "No Price",
+            Source = "Columbia Coatings API",
+            UnitPrice = 0m, // unknown price — must not wipe quoting with $0
+        };
+        context.PowderCatalogItems.Add(catalog);
+        await context.SaveChangesAsync();
+
+        var inv = new InventoryItem
+        {
+            CompanyId = 1,
+            SKU = "POWD-2606-0002",
+            Name = "No Price",
+            PowderCatalogItemId = catalog.Id,
+            UnitCost = 15m,
+            CatalogReferencePrice = null,
+        };
+        context.InventoryItems.Add(inv);
+        await context.SaveChangesAsync();
+
+        var service = new PowderCatalogUpsertService(
+            new UnitOfWork(context),
+            Mock.Of<ILogger<PowderCatalogUpsertService>>());
+
+        await service.PropagateToLinkedInventoryAsync();
+
+        var refreshed = await context.InventoryItems.FindAsync(inv.Id);
+        Assert.Null(refreshed!.CatalogReferencePrice); // stays null -> quoting falls back to UnitCost
+    }
+
+    [Fact]
+    public async Task Propagate_LinksUnlinkedItem_ByManufacturerAndPartNumber()
+    {
+        await using var context = CreateContext();
+
+        var catalog = new PowderCatalogItem
+        {
+            VendorName = "Columbia Coatings",
+            Sku = "CS1693053",
+            ColorName = "Joker Jewel",
+            Source = "Columbia Coatings API",
+            UnitPrice = 28m,
+        };
+        context.PowderCatalogItems.Add(catalog);
+        await context.SaveChangesAsync();
+
+        var inv = new InventoryItem
+        {
+            CompanyId = 1,
+            SKU = "POWD-2606-0009",
+            Name = "Joker Jewel",
+            Manufacturer = "Columbia Coatings",
+            ManufacturerPartNumber = "CS1693053", // matches catalog SKU
+            PowderCatalogItemId = null,            // not linked yet (legacy item)
+            UnitCost = 20m,
+        };
+        context.InventoryItems.Add(inv);
+        await context.SaveChangesAsync();
+
+        var service = new PowderCatalogUpsertService(
+            new UnitOfWork(context),
+            Mock.Of<ILogger<PowderCatalogUpsertService>>());
+
+        await service.PropagateToLinkedInventoryAsync();
+
+        var refreshed = await context.InventoryItems.FindAsync(inv.Id);
+        Assert.Equal(catalog.Id, refreshed!.PowderCatalogItemId);   // self-healed link
+        Assert.Equal(28m, refreshed.CatalogReferencePrice);          // and got the price
+        Assert.Equal(20m, refreshed.UnitCost);                       // cost untouched
+    }
+
+    [Fact]
+    public async Task Propagate_DoesNotLink_WhenPartNumberDoesNotMatch()
+    {
+        await using var context = CreateContext();
+
+        context.PowderCatalogItems.Add(new PowderCatalogItem
+        {
+            VendorName = "Columbia Coatings",
+            Sku = "CS1693053",
+            ColorName = "Joker Jewel",
+            UnitPrice = 28m,
+        });
+        await context.SaveChangesAsync();
+
+        var inv = new InventoryItem
+        {
+            CompanyId = 1,
+            SKU = "POWD-2606-0010",
+            Name = "Something Else",
+            Manufacturer = "Columbia Coatings",
+            ManufacturerPartNumber = "NOPE-999", // no catalog match
+            PowderCatalogItemId = null,
+        };
+        context.InventoryItems.Add(inv);
+        await context.SaveChangesAsync();
+
+        var service = new PowderCatalogUpsertService(
+            new UnitOfWork(context),
+            Mock.Of<ILogger<PowderCatalogUpsertService>>());
+
+        await service.PropagateToLinkedInventoryAsync();
+
+        var refreshed = await context.InventoryItems.FindAsync(inv.Id);
+        Assert.Null(refreshed!.PowderCatalogItemId); // stays unlinked
+    }
+
+    private static ApplicationDbContext CreateContext()
+    {
+        var options = new DbContextOptionsBuilder<ApplicationDbContext>()
+            .UseInMemoryDatabase(Guid.NewGuid().ToString())
+            .Options;
+
+        var identity = new ClaimsIdentity([new Claim(ClaimTypes.Role, "SuperAdmin")], "Test");
+        var principal = new ClaimsPrincipal(identity);
+
+        byte[]? noBytes = null;
+        var sessionMock = new Mock<ISession>();
+        sessionMock.Setup(s => s.TryGetValue(It.IsAny<string>(), out noBytes)).Returns(false);
+
+        var httpContextMock = new Mock<HttpContext>();
+        httpContextMock.SetupGet(c => c.User).Returns(principal);
+        httpContextMock.SetupGet(c => c.Session).Returns(sessionMock.Object);
+
+        var accessor = new Mock<IHttpContextAccessor>();
+        accessor.SetupGet(a => a.HttpContext).Returns(httpContextMock.Object);
+
+        return new ApplicationDbContext(options, accessor.Object, null!);
+    }
+}