Skip to main content

Set item stock to an exact quantity

PUT 
/inventory/snapshots/:item_type/:item_id

Counts one item at the outlet in X-Outlet-ID as the acting user: the stock ends at quantity, whatever it was before. Sending the same count again changes nothing.

Request​

  • item_type is product (item_id is a variant id) or raw_material (item_id is a raw material id; needs the raw material plan feature, otherwise 403 PLAN_FEATURE_REQUIRED).
  • reason is one of damaged, defective, expired, theft, natural_shrinkage, sample_tester, staff_consumption, production_use, found_stock, supplier_bonus, return_to_stock, recount_adjustment, system_correction, initial_stock_entry; any other value answers 400 VALIDATION_FAILED.
  • unit_cost is ignored for a raw material.
  • An unknown field is ignored.

Behaviour​

  • If another system is also your stock master, the two writers can overwrite each other.

Request​

Responses​

The recorded count