well_create_stock_adjustment

io.github.WellApp-ai/well-mcp · Verify this server

Record a stock adjustment for a product at a location of the current workspace: a recount that raises or lowers the level. The stock level of the product at that location follows in the same step. Use this tool when the user says the counted stock differs from the recorded level. Find the product_id first with well_list_products or well_get_product. A location_id is the id of a location of the workspace. REQUIRED: product_id, location_id, quantity (a positive decimal string), direction (increase or decrease). OPTIONAL: occurred_at (ISO 8601 with an offset; the current time when absent). Send the same occurred_at when retrying: the same movement sent twice is recognised and adds nothing. A level below zero is stored and flagged, never refused. When a connected tool owns the stock of the location, the call fails: tell the user to change the stock in that tool. A workspace routine approved for this tool runs it unattended and writes stock with no one watching. Returns { success: true, movement, replayed, location_id, location_quantity, negative_level, stock_quantity } on success, or { success: false, error } on failure.