Skip to main content

Repairs & Warranty

📄️Save Line Inspection

Saves checklist answers on one unit. Answers merge over earlier ones, so you can send one item at a time; a field left out of a row keeps its earlier value. The checklist is stamped complete (with `completed_at` and `completed_by`) once every required item is answered, and un-stamped if an answer is cleared. A pass/fail item counts as answered when `passed` is set, a note item when `note` is filled, and a photo item when `attachment_id` is set. Requires the Repairs: Bench & timers permission.

📄️Suggest Line Diagnosis

Asks the tenant's configured AI provider to suggest a diagnosis for one unit from the product, the customer's description, the reported issues and up to four photos. It suggests issue types (only from the tenant's active issue types) and a root cause, with a 0–1 confidence and a one-sentence rationale. The suggestion is stored on the unit; nothing is applied to the diagnosis until you save it. No request body. Requires the Repairs: Bench & timers permission, AI assist switched on in repair settings, and AI access for the user.

📄️Resolve Repair Line

Resolves a unit with an outcome and creates whatever the outcome needs: a return shipment, a replacement or parts sales order, a refund or store credit, a discount code, a stock capitalization, or a scrap adjustment. The unit moves to the `resolved` stage and the repair's status rolls up. A unit that is at a repair vendor on an open dispatch can't be resolved (422 on `outcome`) until it is received back, or claimed as missing if the vendor lost it; the line's `resolve_blocked_reason` says why. Resolving an already-resolved unit with a different outcome first undoes the previous resolution.

📄️Create Repair Shipment

Creates a shipment: a draft to buy a label for later, or a label bought elsewhere (manual entry). With a `tracking_number` it starts at `label_created` and fills the matching draft the resolution opened for the same units instead of creating a second one. A `cost` above zero is added to the repair as an inbound or outbound freight cost. Setting `in_transit` or `delivered` applies the custody effects (see Update Repair Shipment Status); shipping units back to the customer requires them to be resolved first. Tracking numbers are registered for tracking updates when a tracking integration is connected.