Add Custom Powder Order line item and fix CSV import FinalPrice crash

Custom powder/incoming powder material cost now flows into a separate
auto-generated 'Custom Powder Order' line item instead of rolling into
individual item prices, so users can add shipping charges before the
customer sees the total. A dashed yellow preview card in the wizard
shows the material cost and lets users edit the total (including shipping)
before saving. After first save the price is user-owned.

Also fixes a fatal CSV import crash when FinalPrice contains a non-numeric
value (e.g. 'false' from a spreadsheet formula): the job CSV importer now
streams rows one at a time with a lenient decimal converter, treating bad
values as $0 with a per-row warning instead of aborting the entire import.

Updated HelpKnowledgeBase.cs and Help articles (Jobs, Quotes) with
Custom Powder Order behavior and a new Data Import / Export section.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-25 23:37:46 -04:00
parent e476b4744d
commit a7ad0e1de8
19 changed files with 721 additions and 78 deletions
@@ -170,6 +170,35 @@
prep services &mdash; sandblasting, masking, and/or cleaning &mdash; that will be performed before coating.
</p>
<h3 class="h6 fw-semibold mt-4 mb-2"><i class="bi bi-truck me-1 text-warning"></i>Custom Powder Order</h3>
<p>
When a coat uses a <strong>custom powder</strong> (you enter a cost per lb manually without selecting
an inventory item) or an <strong>incoming powder</strong> (a color you need to order that is not yet
in stock), the powder material cost is <strong>not</strong> added to the individual item price.
Instead, the system auto-generates a separate <strong>Custom Powder Order</strong> line item that
collects all ordering costs in one place &mdash; so you can include shipping and freight before
presenting the quote to the customer.
</p>
<ul class="mb-3">
<li class="mb-2">
While building the quote, a dashed yellow <strong>Powder Order</strong> preview card appears
below the item cards showing the calculated material cost. The price field is editable &mdash;
type the total you want to charge (material&nbsp;+&nbsp;any shipping) before saving.
</li>
<li class="mb-2">
On the saved quote, the Custom Powder Order appears as its own line item with the color
name(s) in the description (e.g. <em>Custom Powder Order (Gloss Black, Satin Silver)</em>).
</li>
<li class="mb-2">
A yellow banner on the Quote Details page reminds you when a Custom Powder Order is present
so you don&rsquo;t forget to confirm the shipping amount.
</li>
<li>
The Custom Powder Order is created <strong>once</strong> on first save. After that the price
is yours &mdash; the system will not overwrite it on subsequent saves.
</li>
</ul>
<h3 class="h6 fw-semibold mt-3 mb-2">Save to Product Catalog</h3>
<p>
After completing the prep services step, Calculated and AI Photo items display one final step: