well_create_stock_correction

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

Record a stock correction for a product: reverse a movement recorded by mistake. The old movement stays and a reversing one is added; the stock level follows in the same step. Use this tool when the user says a stock entry was a mistake. Find the product_id first with well_list_products or well_get_product. REQUIRED: product_id, reverses_movement_id, the movement to reverse, and nothing else; the location and the quantity come from the movement it reverses. 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.