Download OpenAPI specification:Download
API for managing asset part transfers between locations
Retrieve a list of all asset part transfers with optional filtering and pagination
| limit | integer [ 1 .. 100 ] Default: 50 Maximum number of records to return |
| offset | integer >= 0 Default: 0 Number of records to skip for pagination |
| sort | string Field to sort by |
| order | string Default: "desc" Enum: "asc" "desc" Sort order (asc or desc) |
| filter | string Filter conditions in JSON format |
| search | string Search term for text fields |
{- "success": true,
- "data": [
- {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "transferNumber": "TRF-2023-001",
- "fromLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "toLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "requestedBy": "60f7b1b3e4b0e8b3f8b3f8b4",
- "approvedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "transferredBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "requestDate": "2023-01-15T08:00:00Z",
- "approvalDate": "2023-01-15T09:00:00Z",
- "transferDate": "2023-01-15T10:00:00Z",
- "scheduledDate": "2023-01-15T10:00:00Z",
- "status": "requested",
- "priority": "low",
- "reason": "string",
- "items": [
- {
- "assetPartUnit": "string",
- "assetPart": "string",
- "serialNumber": "string",
- "quantity": 1,
- "condition": "new",
- "notes": "string"
}
], - "totalItems": 0,
- "transportMethod": "manual",
- "carrier": "string",
- "trackingNumber": "string",
- "estimatedArrival": "2019-08-24T14:15:22Z",
- "actualArrival": "2019-08-24T14:15:22Z",
- "cost": 0,
- "currency": "USD",
- "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
], - "total": 0
}Create a new asset part transfer with the provided data
| transferNumber required | string Unique transfer number |
required | object |
required | object |
| requestedBy required | string User who requested the transfer |
| approvedBy | string User who approved the transfer |
| transferredBy | string User who executed the transfer |
| requestDate | string <date-time> Date when transfer was requested |
| approvalDate | string <date-time> Date when transfer was approved |
| transferDate | string <date-time> Date when transfer was executed |
| scheduledDate | string <date-time> Scheduled transfer date |
| status | string Default: "requested" Enum: "requested" "approved" "in-progress" "completed" "cancelled" Status of the transfer |
| priority | string Default: "medium" Enum: "low" "medium" "high" "urgent" Priority of the transfer |
| reason | string Reason for the transfer |
required | Array of objects |
| totalItems | integer >= 0 Total number of items being transferred |
| transportMethod | string Default: "manual" Enum: "manual" "vehicle" "courier" "automated" Method of transport |
| carrier | string Carrier/transporter name |
| trackingNumber | string Tracking number if applicable |
| estimatedArrival | string <date-time> Estimated arrival time |
| actualArrival | string <date-time> Actual arrival time |
| cost | number <double> >= 0 Transfer cost |
| currency | string Currency code |
Array of objects | |
| notes | string General notes |
object Additional metadata |
{- "transferNumber": "TRF-2023-001",
- "fromLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "toLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "requestedBy": "60f7b1b3e4b0e8b3f8b3f8b4",
- "approvedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "transferredBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "requestDate": "2023-01-15T08:00:00Z",
- "approvalDate": "2023-01-15T09:00:00Z",
- "transferDate": "2023-01-15T10:00:00Z",
- "scheduledDate": "2023-01-15T10:00:00Z",
- "status": "requested",
- "priority": "low",
- "reason": "string",
- "items": [
- {
- "assetPartUnit": "string",
- "assetPart": "string",
- "serialNumber": "string",
- "quantity": 1,
- "condition": "new",
- "notes": "string"
}
], - "totalItems": 0,
- "transportMethod": "manual",
- "carrier": "string",
- "trackingNumber": "string",
- "estimatedArrival": "2019-08-24T14:15:22Z",
- "actualArrival": "2019-08-24T14:15:22Z",
- "cost": 0,
- "currency": "USD",
- "notes": "string",
- "metadata": { }
}{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "transferNumber": "TRF-2023-001",
- "fromLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "toLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "requestedBy": "60f7b1b3e4b0e8b3f8b3f8b4",
- "approvedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "transferredBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "requestDate": "2023-01-15T08:00:00Z",
- "approvalDate": "2023-01-15T09:00:00Z",
- "transferDate": "2023-01-15T10:00:00Z",
- "scheduledDate": "2023-01-15T10:00:00Z",
- "status": "requested",
- "priority": "low",
- "reason": "string",
- "items": [
- {
- "assetPartUnit": "string",
- "assetPart": "string",
- "serialNumber": "string",
- "quantity": 1,
- "condition": "new",
- "notes": "string"
}
], - "totalItems": 0,
- "transportMethod": "manual",
- "carrier": "string",
- "trackingNumber": "string",
- "estimatedArrival": "2019-08-24T14:15:22Z",
- "actualArrival": "2019-08-24T14:15:22Z",
- "cost": 0,
- "currency": "USD",
- "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Retrieve a specific asset part transfer by its ID
| id required | string Asset part transfer ID |
{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "transferNumber": "TRF-2023-001",
- "fromLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "toLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "requestedBy": "60f7b1b3e4b0e8b3f8b3f8b4",
- "approvedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "transferredBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "requestDate": "2023-01-15T08:00:00Z",
- "approvalDate": "2023-01-15T09:00:00Z",
- "transferDate": "2023-01-15T10:00:00Z",
- "scheduledDate": "2023-01-15T10:00:00Z",
- "status": "requested",
- "priority": "low",
- "reason": "string",
- "items": [
- {
- "assetPartUnit": "string",
- "assetPart": "string",
- "serialNumber": "string",
- "quantity": 1,
- "condition": "new",
- "notes": "string"
}
], - "totalItems": 0,
- "transportMethod": "manual",
- "carrier": "string",
- "trackingNumber": "string",
- "estimatedArrival": "2019-08-24T14:15:22Z",
- "actualArrival": "2019-08-24T14:15:22Z",
- "cost": 0,
- "currency": "USD",
- "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Update an existing asset part transfer with new data
| id required | string Asset part transfer ID |
| transferNumber required | string Unique transfer number |
required | object |
required | object |
| requestedBy required | string User who requested the transfer |
| approvedBy | string User who approved the transfer |
| transferredBy | string User who executed the transfer |
| requestDate | string <date-time> Date when transfer was requested |
| approvalDate | string <date-time> Date when transfer was approved |
| transferDate | string <date-time> Date when transfer was executed |
| scheduledDate | string <date-time> Scheduled transfer date |
| status | string Default: "requested" Enum: "requested" "approved" "in-progress" "completed" "cancelled" Status of the transfer |
| priority | string Default: "medium" Enum: "low" "medium" "high" "urgent" Priority of the transfer |
| reason | string Reason for the transfer |
required | Array of objects |
| totalItems | integer >= 0 Total number of items being transferred |
| transportMethod | string Default: "manual" Enum: "manual" "vehicle" "courier" "automated" Method of transport |
| carrier | string Carrier/transporter name |
| trackingNumber | string Tracking number if applicable |
| estimatedArrival | string <date-time> Estimated arrival time |
| actualArrival | string <date-time> Actual arrival time |
| cost | number <double> >= 0 Transfer cost |
| currency | string Currency code |
Array of objects | |
| notes | string General notes |
object Additional metadata |
{- "transferNumber": "TRF-2023-001",
- "fromLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "toLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "requestedBy": "60f7b1b3e4b0e8b3f8b3f8b4",
- "approvedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "transferredBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "requestDate": "2023-01-15T08:00:00Z",
- "approvalDate": "2023-01-15T09:00:00Z",
- "transferDate": "2023-01-15T10:00:00Z",
- "scheduledDate": "2023-01-15T10:00:00Z",
- "status": "requested",
- "priority": "low",
- "reason": "string",
- "items": [
- {
- "assetPartUnit": "string",
- "assetPart": "string",
- "serialNumber": "string",
- "quantity": 1,
- "condition": "new",
- "notes": "string"
}
], - "totalItems": 0,
- "transportMethod": "manual",
- "carrier": "string",
- "trackingNumber": "string",
- "estimatedArrival": "2019-08-24T14:15:22Z",
- "actualArrival": "2019-08-24T14:15:22Z",
- "cost": 0,
- "currency": "USD",
- "notes": "string",
- "metadata": { }
}{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "transferNumber": "TRF-2023-001",
- "fromLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "toLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "requestedBy": "60f7b1b3e4b0e8b3f8b3f8b4",
- "approvedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "transferredBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "requestDate": "2023-01-15T08:00:00Z",
- "approvalDate": "2023-01-15T09:00:00Z",
- "transferDate": "2023-01-15T10:00:00Z",
- "scheduledDate": "2023-01-15T10:00:00Z",
- "status": "requested",
- "priority": "low",
- "reason": "string",
- "items": [
- {
- "assetPartUnit": "string",
- "assetPart": "string",
- "serialNumber": "string",
- "quantity": 1,
- "condition": "new",
- "notes": "string"
}
], - "totalItems": 0,
- "transportMethod": "manual",
- "carrier": "string",
- "trackingNumber": "string",
- "estimatedArrival": "2019-08-24T14:15:22Z",
- "actualArrival": "2019-08-24T14:15:22Z",
- "cost": 0,
- "currency": "USD",
- "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Mark an asset part transfer as completed
| id required | string Asset part transfer ID |
{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "transferNumber": "TRF-2023-001",
- "fromLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "toLocation": {
- "warehouse": "string",
- "section": "string",
- "shelf": "string",
- "position": "string"
}, - "requestedBy": "60f7b1b3e4b0e8b3f8b3f8b4",
- "approvedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "transferredBy": "60f7b1b3e4b0e8b3f8b3f8b6",
- "requestDate": "2023-01-15T08:00:00Z",
- "approvalDate": "2023-01-15T09:00:00Z",
- "transferDate": "2023-01-15T10:00:00Z",
- "scheduledDate": "2023-01-15T10:00:00Z",
- "status": "requested",
- "priority": "low",
- "reason": "string",
- "items": [
- {
- "assetPartUnit": "string",
- "assetPart": "string",
- "serialNumber": "string",
- "quantity": 1,
- "condition": "new",
- "notes": "string"
}
], - "totalItems": 0,
- "transportMethod": "manual",
- "carrier": "string",
- "trackingNumber": "string",
- "estimatedArrival": "2019-08-24T14:15:22Z",
- "actualArrival": "2019-08-24T14:15:22Z",
- "cost": 0,
- "currency": "USD",
- "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}