Create Inventory Movement
POST
inventory-movements
Creates a new Inventory Movement.
Resource Information
| Method and URI | POST https://api.aps.autodesk.com/fusion-operations/v2/inventory-movements |
| Authentication Context | No security required |
| Required OAuth Scopes | data:read data:write |
| Data Format | JSON |
Request
Headers
| Authorization* string | JWT Access Token |
| Content-Type* string | Must be application/json |
* Required
Request
Body Structure
The inventory movement object to be created, conforming to the specified schema.
Expand all
| date* datetime: ISO 8601 | Date of the inventory movement (e.g. 2025-06-21T14:07:17Z) |
| product* | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf* | |
| 0* | |
| 1* | |
| quantity* number | The quantity of the Product moved |
| receiving | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| shipping | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| type* string | Type of inventory movement. PRODUCTION and CONSUMPTION stock movements cannot be created. They are automatically created in the Production endpoints. The TRANSIT type cannot be used to create inventory movements. |
| lot | |
| code string | Max length: 255 |
| expirationDate string | Expiration date of the lot (e.g. 2025-06-21) |
| supplierLot string | Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| warehouseLocation | Warehouse location associated with the inventory movement. If null the Production warehouse is considered |
| anyOf | Warehouse location associated with the inventory movement. If null the Production warehouse is considered |
| 0 object | |
| 1 all of | |
| 0 all of | |
| 0 | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| 1 all of | |
| 0 object | |
| code string | Max length: 255 |
| name string | Max length: 255 |
| site all of | Site associated with the Inventory Movement. |
| 0 all of | |
| 0 | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| comment string | Max length: 255 |
| cost number | |
| worker | |
| id int | |
| number int | |
| anyOf | |
| 0 | |
| 1 | |
| site | Site associated with the Inventory Movement. |
| anyOf | Site associated with the Inventory Movement. |
| 0 object | |
| 1 all of | |
| 0 all of | |
| 0 | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 |
* Required
Response
HTTP Status Code Summary
| 201 Created | Inventory Movement successfully created. |
| 400 Bad Request | Bad request due to invalid data. |
| 401 Unauthorized | The access token is invalid. It may have either expired or may not be a three-legged access token. Please verify the token and retry the request. |
| 403 Forbidden | The request was successfully validated but lacked required permission. Please verify your token permissions and retry the request. |
| 429 Too Many Requests | Rate limit exceeded; wait some time before retrying. |
| 500 Internal Server Error | An unknown server-side error occurred. Please try again later. If the problem persists, please contact support. |
Response
Header (429)
| Retry-After integer | The number of seconds to wait before retrying the request. |
Response
Body Structure (201)
Expand all
| id int | Unique identifier of the inventory movement. |
| date datetime: ISO 8601 | Date of the inventory movement (e.g. 2025-06-21T14:07:17Z) |
| product | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| quantity number | The quantity of the Product moved |
| unitOfMeasurement | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| receiving | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| shipping | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| production object | |
| id int | Unique identifier of the Production linked to the inventory movement. Applies only for consumptions and produced materials during Production. |
| maintenanceOrder object | |
| id int | Unique identifier of the Maintenance Order linked to the inventory movement. Applies only for consumptions in Maintenance Orders. |
| type string | Type of inventory movement. PRODUCTION and CONSUMPTION stock movements cannot be created. They are automatically created in the Production endpoints. The TRANSIT type cannot be used to create inventory movements. |
| lot | |
| id int | Unique identifier of the lot. |
| code string | Max length: 255 |
| expirationDate string | Expiration date of the lot (e.g. 2025-06-21) |
| supplierLot string | Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| warehouseLocation | Warehouse location associated with the inventory movement. If null the Production warehouse is considered |
| anyOf | Warehouse location associated with the inventory movement. If null the Production warehouse is considered |
| 0 object | |
| 1 all of | |
| 0 all of | |
| 0 | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| 1 all of | |
| 0 object | |
| id int | Unique identifier of the warehouse. |
| code string | Max length: 255 |
| name string | Max length: 255 |
| site all of | Site associated with the Inventory Movement. |
| 0 all of | |
| 0 | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| comment string | Max length: 255 |
| cost number | |
| worker | |
| id int | |
| number int | |
| name string | Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| site | Site associated with the Inventory Movement. |
| anyOf | Site associated with the Inventory Movement. |
| 0 object | |
| 1 all of | |
| 0 all of | |
| 0 | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 |
Example
Inventory Movement successfully created.
Example single inventory movement request with codes
Request
curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/inventory-movements' \
-X 'POST' \
-H 'Authorization: ' \
-H 'Content-Type: application/json' \
-d '{
"date": "2024-04-27T10:00:00Z",
"product": {
"code": "Johannes"
},
"quantity": 100,
"type": "RECEIVING",
"worker": {
"number": 66
},
"comment": "My wonderful inventory Movement note with less than 255 characters",
"warehouseLocation": {
"code": "Main Warehouse",
"warehouse": {
"code": "Central Warehouse"
}
}
}'
Show More
Example single inventory movement request with ids
Request
curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/inventory-movements' \
-X 'POST' \
-H 'Authorization: ' \
-H 'Content-Type: application/json' \
-d '{
"date": "2024-04-27T10:00:00Z",
"product": {
"id": 21
},
"quantity": 100,
"type": "RECEIVING",
"worker": {
"id": 12
},
"comment": "My wonderful inventory Movement note with less than 255 characters",
"warehouseLocation": {
"id": 5,
"warehouse": {
"id": 2
}
}
}'
Show More
Example of create inventory movement to production warehouse location
Request
curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/inventory-movements' \
-X 'POST' \
-H 'Authorization: ' \
-H 'Content-Type: application/json' \
-d '{
"date": "2024-04-27T10:00:00Z",
"product": {
"id": 21
},
"quantity": 100,
"type": "RECEIVING",
"worker": {
"id": 12
},
"comment": "My wonderful inventory Movement note with less than 255 characters"
}'
Show More
Response
{
"id": 382,
"date": "2024-04-27T10:00:00Z",
"product": {
"id": 21,
"code": "ProductA",
"name": "Product A 204"
},
"quantity": 100,
"type": "RECEIVING",
"worker": {
"id": 12,
"number": 66,
"name": "Peter"
},
"comment": "My wonderful inventory Movement note with less than 255 characters",
"warehouseLocation": {
"id": 5,
"code": "Main Warehouse",
"name": "Main Warehouse",
"warehouse": {
"id": 2,
"code": "Central Warehouse",
"name": "Central Warehouse"
},
"site": {
"id": 12,
"code": "SITE-01"
}
}
}
Show More