{
 "openapi": "3.1.0",
 "info": {
  "title": "Bin Utilization (Supply Chain)",
  "version": "20261030b",
  "description": "How full each bin is against what it will take. The number the warehouse map colors by, and the one a putaway strategy checks before it proposes anything."
 },
 "servers": [
  {
   "url": "https://{tenant}.tranxact.ai",
   "variables": {
    "tenant": {
     "default": "demo"
    }
   }
  }
 ],
 "components": {
  "securitySchemes": {
   "bearer": {
    "type": "http",
    "scheme": "bearer"
   }
  },
  "schemas": {
   "bin-utilization": {
    "type": "object",
    "required": [],
    "properties": {
     "bin_id": {
      "type": "string",
      "format": "uuid",
      "description": "Bin id",
      "readOnly": true
     },
     "org_id": {
      "type": "string",
      "format": "uuid",
      "description": "Org id",
      "readOnly": true
     },
     "warehouse_id": {
      "type": "string",
      "format": "uuid",
      "description": "Warehouse id",
      "readOnly": true
     },
     "bin_code": {
      "type": "string",
      "description": "Bin code",
      "readOnly": true
     },
     "zone": {
      "type": "string",
      "description": "Zone",
      "readOnly": true
     },
     "storage_type_id": {
      "type": "string",
      "format": "uuid",
      "description": "Storage type id",
      "readOnly": true
     },
     "x_mm": {
      "type": "string",
      "format": "decimal",
      "description": "X mm",
      "readOnly": true
     },
     "y_mm": {
      "type": "string",
      "format": "decimal",
      "description": "Y mm",
      "readOnly": true
     },
     "z_mm": {
      "type": "string",
      "format": "decimal",
      "description": "Z mm",
      "readOnly": true
     },
     "is_blocked": {
      "type": "boolean",
      "description": "Is blocked",
      "readOnly": true
     },
     "storage_type_code": {
      "type": "string",
      "description": "Storage type code",
      "readOnly": true
     },
     "storage_type_name": {
      "type": "string",
      "description": "Storage type name",
      "readOnly": true
     },
     "storage_class": {
      "type": "string",
      "description": "Storage class",
      "readOnly": true
     },
     "is_pick_face": {
      "type": "boolean",
      "description": "Is pick face",
      "readOnly": true
     },
     "is_reserve": {
      "type": "boolean",
      "description": "Is reserve",
      "readOnly": true
     },
     "full_address": {
      "type": "string",
      "description": "Full address",
      "readOnly": true
     },
     "warehouse_code": {
      "type": "string",
      "description": "Warehouse code",
      "readOnly": true
     },
     "lane_code": {
      "type": "string",
      "description": "Lane code",
      "readOnly": true
     },
     "shelf_code": {
      "type": "string",
      "description": "Shelf code",
      "readOnly": true
     },
     "on_hand": {
      "type": "string",
      "format": "decimal",
      "description": "On hand",
      "readOnly": true
     },
     "item_count": {
      "type": "integer",
      "description": "Item count",
      "readOnly": true
     },
     "capacity_qty": {
      "type": "string",
      "format": "decimal",
      "description": "Capacity qty",
      "readOnly": true
     },
     "max_weight_kg": {
      "type": "string",
      "format": "decimal",
      "description": "Max weight kg",
      "readOnly": true
     },
     "max_volume_l": {
      "type": "string",
      "format": "decimal",
      "description": "Max volume l",
      "readOnly": true
     },
     "fill_pct": {
      "type": "string",
      "format": "decimal",
      "description": "Fill pct",
      "readOnly": true
     },
     "handling_units": {
      "type": "integer",
      "description": "Handling units",
      "readOnly": true
     },
     "occupancy": {
      "type": "string",
      "description": "Occupancy",
      "readOnly": true
     }
    }
   }
  }
 },
 "security": [
  {
   "bearer": []
  }
 ],
 "paths": {
  "/api/scm/bin-utilization": {
   "get": {
    "summary": "list bin-utilization",
    "operationId": "list_bin_utilization_0_4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Post bin utilization",
    "operationId": "action_bin_utilization_1_4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/scm/bin-utilization/{bin_id}": {
   "get": {
    "summary": "get bin-utilization",
    "operationId": "get_bin_utilization_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/scm/bin-utilization/{id}/copy": {
   "post": {
    "summary": "Copy",
    "operationId": "action_bin_utilization_0_6",
    "description": "Body keys: overrides, preview, withLines",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/scm/bin-utilization/{id}": {
   "put": {
    "summary": "Put bin utilization",
    "operationId": "action_bin_utilization_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "delete": {
    "summary": "Delete bin utilization",
    "operationId": "action_bin_utilization_1_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  }
 }
}