Materials Management | Item Adjustment
Service to manage entities of type 'ItemAdjustment'.
Overview
URL | api/{tenantKey}/{orgKey}/materialsManagement/itemAdjustments |
Methods Supported | GET, POST, PUT, DELETE |
All Operations
This service includes the following operations:
- GET:
- POST:
- PUT:
- DELETE:
All Resources
This service uses the following resources:
- ApiItemAdjustmentDocumentLinesResource
- ApiItemAdjustmentResource
- ItemAdjustmentResource
- MoneyResource
All Enumerations
This service uses the following enumerations:
GET ItemAdjustments (odata)
Returns a page of the list of all the entity records available.
The following elements are optional:
opts | (ODataQueryOptions) OData query option. |
Response:
When successful, the response body contains the list of records available. See ItemAdjustmentResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
GET ItemAdjustment by identifier
Returns the entity record that matches the specified identifier.
The following elements are required:
id | (string) The record identifier. |
Response:
When successful, the response body contains the entity record. See ItemAdjustmentResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET ItemAdjustment by key
Returns the entity record that matches the specified key.
The following elements are required:
companyKey | (string) The company key. |
itemAdjustmentKey | (string) The key for the Item Adjustment. |
Response:
When successful, the response body contains the entity record. See ItemAdjustmentResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
POST ItemAdjustments
Creates a new entity record.
The following elements are required:
itemAdjustmentResource | (ApiItemAdjustmentResource) The request body should contain the entity record that should be created. See ApiItemAdjustmentResource. |
Response:
When successful, the response body contains the new entity record identifier. The resource header location property contains the URL for the new entity record. See ApiItemAdjustmentResource. |
Response status codes:
201 | Created. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
POST Item Adjustment Line
Inserts a new 'Item Adjustment Line' in the 'Item Adjustment'.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
companyKey | (string) The company key. |
value | (ApiItemAdjustmentDocumentLinesResource) The ApiItemAdjustmentDocumentLinesResource instance. See ApiItemAdjustmentDocumentLinesResource. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | NoContent. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set IsActive ItemAdjustment
Updates the value of attribute 'IsActive' in the specified entity record.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
companyKey | (string) The company key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
PUT Set MaterialsItem ItemAdjustmentLine
Updates the value of attribute 'MaterialsItem' in the specified entity record.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Note ItemAdjustment
Updates the value of attribute 'Note' in the specified entity record.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set PostingDate ItemAdjustment
Updates the value of attribute 'PostingDate' in the specified entity record.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
companyKey | (string) The company key. |
value | (DateTime) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Quantity ItemAdjustmentLine
Updates the value of attribute 'Quantity' in the specified entity record.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (decimal) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Remarks ItemAdjustment
Updates the value of attribute 'Remarks' in the specified entity record.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Unit ItemAdjustmentLine
Updates the value of attribute 'Unit' in the specified entity record.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set UnitPrice ItemAdjustmentLine
Updates the value of attribute 'UnitPrice' in the specified entity record.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (decimal) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
DELETE Item Adjustment Line by identifier
Deletes the entity record that matches the specified identifier.
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
companyKey | (string) The company key. |
lineId | (string) The line identifier. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | NoContent. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
DELETE ItemAdjustment by identifier
Deletes the entity record that matches the specified identifier.
The following elements are required:
id | (string) The record identifier. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | Deleted. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
DELETE ItemAdjustment by key
Deletes the entity record that matches the specified key.
The following elements are required:
companyKey | (string) The company key. |
itemAdjustmentKey | (string) The key for the Item Adjustment. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | Deleted. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
Resources
ApiItemAdjustmentDocumentLinesResource
The following elements are required:
quantity | (decimal) The quantity for the Item Adjustment Line. |
unitPrice | (MoneyResource) The unit price for the Item Adjustment Line.
See MoneyResource . |
unit | (string) The unit for the Item Adjustment Line. |
materialsItem | (string) The materials item for the Item Adjustment Line. |
ApiItemAdjustmentResource
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
documentDate | (DateTime) The document date for the Item Adjustment. |
postingDate | (DateTime) The posting date for the Item Adjustment. |
warehouse | (string) The warehouse for the Item Adjustment. |
company | (string) The company for the Item Adjustment. |
adjustmentReason | (string) The adjustment reason for the Item Adjustment. |
The following elements are optional:
documentLines | (List of ApiItemAdjustmentDocumentLinesResource) The document lines for the Item Adjustment.
See ApiItemAdjustmentDocumentLinesResource. |
remarks | (string) The remarks for the Item Adjustment. |
note | (string) The note for the Item Adjustment. |
ItemAdjustmentResource
The following elements are required:
itemAdjustmentKey | (string) The key for the Item Adjustment. |
documentDate | (DateTime) The document date for the Item Adjustment. |
totalValue | (MoneyResource) The total value for the Item Adjustment.
See MoneyResource . |
postingDate | (DateTime) The posting date for the Item Adjustment. |
isExternallyManaged | (bool) Indicates whether the Item Adjustment is externally managed. |
warehouse | (string) The warehouse for the Item Adjustment.
(fk) Allowed value: the natural key of a record of type Warehouse. These records are accessibly through the Warehouses service. |
company | (string) The company for the Item Adjustment.
(fk) Allowed value: the natural key of a record of type Company. These records are accessibly through the Companies service. |
currency | (string) The currency for the Item Adjustment.
(fk) Allowed value: the natural key of a record of type Currency. These records are accessibly through the Currencies service. |
adjustmentReason | (string) The adjustment reason for the Item Adjustment.
(fk) Allowed value: the natural key of a record of type AdjustmentReason. These records are accessibly through the AdjustmentReasons service. |
isInValue | (bool) Indicates whether the Item Adjustment is in value. |
The following elements are optional:
documentLines | (List of ItemAdjustmentLineResource) The document lines for the Item Adjustment.
See ItemAdjustmentLineResource. |
remarks | (string) The remarks for the Item Adjustment. |
note | (string) The note for the Item Adjustment. |
isPrinted | (bool) Indicates if the Item Adjustment has been printed. Internally determined. |
externalId | (string) The external identification for the Item Adjustment. |
externalVersion | (string) The external version for the Item Adjustment. |
adjustmentType | (enum AdjustmentType) The adjustment's type for the Item Adjustment.
See AdjustmentType. |
MoneyResource
The following elements are required:
amount | (decimal) The amount. |
The following elements are optional:
baseAmount | (decimal) The base amount. |
reportingAmount | (decimal) The reporting amount. |
fractionDigits | (int) The fraction digits. |
symbol | (string) The symbol. |
Notes: For the POST operation it is not necessary to send the fields: BaseAmount, ReportingAmount, FractionDigits and Symbol. Will be ignored.