Pricing & documents
A weighed catch-weight line is priced as weight × price per weight unit, rounded to the cent. Everywhere it's printed (invoice, PDF and email), it shows the weight, the per-pound (or per-kilo) price with up to 4 decimals, and the box count.
Who uses it
- Supplier staff check the priced line on the order and invoice before sending.
- Restaurants read it on the invoice PDF and the invoice email, and compare it with what arrived.
Calculations
Line total = line weight × unit price, rounded half up to the cent. The box count never enters the price. The general rules (4-decimal unit prices, round each line, half up) are in Money & rounding.
| Line | Boxes | Weight | Unit price | Exact | Line total |
|---|---|---|---|---|---|
| Lamb rack | 1 CS | 3.2 LB | $16.299 / LB | 52.1568 | $52.16 |
| Lamb rack | 6 CS | 21.4 LB | $16.299 / LB | 348.7986 | $348.80 |
| Chicken thigh | 2 CS | 10 LB | $2.599 / LB | 25.99 | $25.99 |
| Whole Fish | 3 EA | (not weighed) | $6.00 / LB | $0.00 |
Edge cases
| Situation | Result |
|---|---|
| Not weighed yet | $0.00 on the order, the invoice preview and the PDF. Never priced by box count |
| A weight of 0 | Can't be entered ("Must be > 0") |
| Price changed after weighing | Re-prices from the stored weight |
Before #2160, an unweighed line could fall back to boxes × price per pound, billing 3 boxes of fish as "3 LB". A per-pound price times a box count is never a real amount, so an unweighed line is $0.00 until weighed.
How a catch-weight line prints
Example line: 6 cases of lamb rack, 21.40 LB at $16.299/LB, where the boxes weigh the same.
| Surface | Quantity | Weight | Price | Total |
|---|---|---|---|---|
| Invoice PDF (QTY, SIZE/UNIT, WEIGHT, PRICE, TOTAL columns) | 6 · CS | 21.40 LB | $16.299/LB | $348.80 |
| Invoice PDF, line not weighed | 6 · CS | (blank) | $16.299/LB | $0.00 |
| Packing slip (same-weight boxes) | 6 · CS | 21.40 LB, plus a blank grid to write box weights | (hidden if the supplier hides prices on packing slips) | |
| Invoice email (verify the wording on current orders) | "21.40 LB (6 CS)" | $16.299/LB | $348.80 | |
| Invoice email, line not weighed | "0.00 LB (6 CS)" (verify) | $16.299/LB | "--" | |
| On-screen invoice preview, line not weighed | 0 | $0.00 |
- The WEIGHT column only appears when at least one line on the document is catch-weight. (#2335)
- Per-box weights print under the line only when the boxes weigh different amounts. When every box weighs the same, the total says it all.
- The footer shows "Total Weight: …" across the catch-weight lines.
- Weights print with 2 decimals (21.40 LB). Unit prices print with 2 to 4 (
$16.299,$9.00).
Where it shows up
Order items table · Invoice preview · Invoice PDF and packing slip · Order and invoice emails · Restaurant app.
Permissions
Display only. Who can change a weight or price is on Ordering & weighing.
Decisions
- Priced on weight, printed with the weight and the per-unit price. A buyer can check weight × rate = total on every document. (#2341)
- One price format on every surface. The invoice, PDF and email never disagree on the per-pound rate. (#2341)
- The WEIGHT column is hidden when nothing on the document is catch-weight. (#2335)
Known limitations
- An unweighed line shows $0.00 and may look different on each surface: blank weight on the PDF, "0" on the on-screen invoice preview, "0.00 LB" on the PO invoice PDF, "--" as the total in the email.
- Card checkout doesn't show the weight. The card payment page lists one line, "Invoice ICE-000042", for the amount owed, so a buyer can't check weight × rate there. They use the invoice.
- The restaurant app rounds the per-pound price to the cent ("$16.30 / LB"). Its line total is still right.
FAQ
Why does the invoice show 21.40 LB but the boxes say 6? The line is priced on weight. The box count is shown so the restaurant can check what arrived.
Weight × price on my calculator is $348.7986. The invoice says $348.80. Line totals are rounded to the nearest cent, half up. See Money & rounding.
Why doesn't the invoice list each box's weight? It lists them only when the boxes weigh different amounts. If they're all the same, the total weight is enough.
Specs
Scenarios CWO-002 to CWO-006 cover pricing. They're on Ordering & weighing.