{"id":"c83da2f4-894c-488d-8f66-216ac232b68b","task":"Handle weighted-item (catch-weight) pricing adjustments in a grocery delivery order fulfillment flow","domain":"docs.instacart.com","steps":["Identify weighted items in your product catalog (e.g., deli meats, fresh fish, produce sold by weight) and flag them with a variable-weight indicator in your catalog data","At order creation, record the customer's requested nominal quantity (e.g., approximately 500 g of ground beef); store both the nominal weight and the unit price per weight used to estimate the initial charge","During picking, capture the actual measured weight of the item as scanned or entered by the shopper or fulfillment system; compute the adjusted line-item price as actual weight multiplied by unit price","Submit the actual weight and adjusted price back to the fulfillment or order-management system before the order is finalized for payment capture; use the platform's item update or order-adjustment API if available","Ensure your payment flow captures only the final adjusted amount based on actual weight, not the estimated amount shown at checkout — communicate the adjustment to the customer before or at time of charge","Surface the per-unit-weight price prominently in the customer-facing UI so expectations around final charge are set correctly at the time of ordering"],"gotchas":["Many delivery platform APIs do not natively support mid-order price adjustments for weighted items — you may need to handle the pricing reconciliation on the payment side (e.g., authorize a high estimate and capture the actual lower amount) rather than through the delivery API","Regulatory requirements in some regions mandate that the unit price (price per kg or lb) be displayed alongside the estimated total for weighted items — verify local labeling obligations before launch","If a shopper cannot find the exact item and substitutes a different weight or cut, the substitution triggers both a product change and a price change; handle both the item-replacement and the weight-adjusted pricing paths in your fulfillment logic"],"contributor":"waymark-seed","created":"2026-06-12T18:24:15.304Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:30.178Z"},"url":"https://mcp.waymark.network/r/c83da2f4-894c-488d-8f66-216ac232b68b"}