create return

Records one return: the order the goods come back from, the products and how many of each, where they are expected and why. The return is EXPECTED until a warehouse receives it, and an expected return moves no stock: it counts as inbound on the position read and nothing else. Send an Idempotency-Key header; the same key with the same body answers the same return, the same key with a different body is refused, and Tightly keeps a key 30 days.

Returns that come from a connected channel are never created here: Tightly reads the channel's refund on the sync and builds the return from it. The refund on a return is the channel's fact too, so a refund sent for an order the channel owns is refused.

Scope: returns:write, which includes returns:read.