Expose Stock Adjustment API as a documented endpoint

[jmiranda]

See https://community.openboxes.com/t/adjustmenttransaction/959/2

• Test the existing endpoint in Postman to ensure it works
• Document endpoint in our API Guide
• Add entry to URL Mapping to expose the endpoint on our current API
• Add document re: naming convention

Possible URLs

/openboxes/api/adjustments
/openboxes/api/stockAdjustments
/openboxes/api/inventoryItems/:id/adjustments

[jmiranda]

Should probably consider backporting any change to 0.8.x since 0.9.x is not officially released yet.

[jmiranda]

So I was able to test this, but unfortunately there's a bug that's going to prevent this from working for the time being.

The error message

{
    "errorCode": 500,
    "cause": "groovy.lang.MissingPropertyException",
    "errorMessage": "No such property: quantity for class: org.pih.warehouse.inventory.AdjustStockCommand"
}

And the Stock Adjustment API code with the bug

  // FIXME Forgot there was already a command object for this
  stockAdjustments.each { StockAdjustment stockAdjustment ->
    AdjustStockCommand adjustStockCommand = new AdjustStockCommand()
    adjustStockCommand.inventoryItem = stockAdjustment.inventoryItem
  > adjustStockCommand.quantity = stockAdjustment.quantityAdjusted 
    adjustStockCommand.comment = stockAdjustment.comments
    adjustStockCommand.location = location
    adjustStockCommand.binLocation = stockAdjustment.binLocation
    inventoryService.adjustStock(adjustStockCommand)
  }

Thankfully this should be an easy fix.