Download OpenAPI specification:Download
API for managing asset part receivals (receiving inventory)
Retrieve a list of all asset part receivals 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",
- "receivalNumber": "RCV-2023-001",
- "purchaseOrder": "PO-2023-001",
- "supplier": "60f7b1b3e4b0e8b3f8b3f8b4",
- "receivalDate": "2023-01-15T10:00:00Z",
- "expectedDate": "2023-01-14T10:00:00Z",
- "receivedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "warehouse": "60f7b1b3e4b0e8b3f8b3f8b6",
- "status": "pending",
- "items": [
- {
- "assetPart": "string",
- "orderedQuantity": 1,
- "receivedQuantity": 0,
- "unitCost": 0,
- "totalCost": 0,
- "condition": "new",
- "batchNumber": "string",
- "serialNumbers": [
- "string"
], - "expiryDate": "2019-08-24",
- "notes": "string"
}
], - "totalValue": 0,
- "currency": "USD",
- "shippingCost": 0,
- "taxAmount": 0,
- "discountAmount": 0,
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "amount": 0
}, - "qualityCheck": {
- "performed": false,
- "checkedBy": "string",
- "checkDate": "2019-08-24T14:15:22Z",
- "passed": true,
- "notes": "string"
}, - "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
], - "total": 0
}Create a new asset part receival with the provided data
| receivalNumber required | string Unique receival number |
| purchaseOrder | string Purchase order reference |
| supplier required | string Supplier ID |
| receivalDate required | string <date-time> Date and time of receival |
| expectedDate | string <date-time> Expected delivery date |
| receivedBy | string User who received the parts |
| warehouse | string Warehouse ID where parts were received |
| status | string Default: "pending" Enum: "pending" "partial" "complete" "cancelled" Status of the receival |
required | Array of objects |
| totalValue | number <double> >= 0 Total value of the receival |
| currency | string Currency code |
| shippingCost | number <double> >= 0 Shipping cost |
| taxAmount | number <double> >= 0 Tax amount |
| discountAmount | number <double> >= 0 Discount amount |
object | |
object | |
Array of objects | |
| notes | string General notes |
object Additional metadata |
{- "receivalNumber": "RCV-2023-001",
- "purchaseOrder": "PO-2023-001",
- "supplier": "60f7b1b3e4b0e8b3f8b3f8b4",
- "receivalDate": "2023-01-15T10:00:00Z",
- "expectedDate": "2023-01-14T10:00:00Z",
- "receivedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "warehouse": "60f7b1b3e4b0e8b3f8b3f8b6",
- "status": "pending",
- "items": [
- {
- "assetPart": "string",
- "orderedQuantity": 1,
- "receivedQuantity": 0,
- "unitCost": 0,
- "totalCost": 0,
- "condition": "new",
- "batchNumber": "string",
- "serialNumbers": [
- "string"
], - "expiryDate": "2019-08-24",
- "notes": "string"
}
], - "totalValue": 0,
- "currency": "USD",
- "shippingCost": 0,
- "taxAmount": 0,
- "discountAmount": 0,
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "amount": 0
}, - "qualityCheck": {
- "performed": false,
- "checkedBy": "string",
- "checkDate": "2019-08-24T14:15:22Z",
- "passed": true,
- "notes": "string"
}, - "notes": "string",
- "metadata": { }
}{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "receivalNumber": "RCV-2023-001",
- "purchaseOrder": "PO-2023-001",
- "supplier": "60f7b1b3e4b0e8b3f8b3f8b4",
- "receivalDate": "2023-01-15T10:00:00Z",
- "expectedDate": "2023-01-14T10:00:00Z",
- "receivedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "warehouse": "60f7b1b3e4b0e8b3f8b3f8b6",
- "status": "pending",
- "items": [
- {
- "assetPart": "string",
- "orderedQuantity": 1,
- "receivedQuantity": 0,
- "unitCost": 0,
- "totalCost": 0,
- "condition": "new",
- "batchNumber": "string",
- "serialNumbers": [
- "string"
], - "expiryDate": "2019-08-24",
- "notes": "string"
}
], - "totalValue": 0,
- "currency": "USD",
- "shippingCost": 0,
- "taxAmount": 0,
- "discountAmount": 0,
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "amount": 0
}, - "qualityCheck": {
- "performed": false,
- "checkedBy": "string",
- "checkDate": "2019-08-24T14:15:22Z",
- "passed": true,
- "notes": "string"
}, - "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Retrieve a specific asset part receival by its ID
| id required | string Asset part receival ID |
{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "receivalNumber": "RCV-2023-001",
- "purchaseOrder": "PO-2023-001",
- "supplier": "60f7b1b3e4b0e8b3f8b3f8b4",
- "receivalDate": "2023-01-15T10:00:00Z",
- "expectedDate": "2023-01-14T10:00:00Z",
- "receivedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "warehouse": "60f7b1b3e4b0e8b3f8b3f8b6",
- "status": "pending",
- "items": [
- {
- "assetPart": "string",
- "orderedQuantity": 1,
- "receivedQuantity": 0,
- "unitCost": 0,
- "totalCost": 0,
- "condition": "new",
- "batchNumber": "string",
- "serialNumbers": [
- "string"
], - "expiryDate": "2019-08-24",
- "notes": "string"
}
], - "totalValue": 0,
- "currency": "USD",
- "shippingCost": 0,
- "taxAmount": 0,
- "discountAmount": 0,
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "amount": 0
}, - "qualityCheck": {
- "performed": false,
- "checkedBy": "string",
- "checkDate": "2019-08-24T14:15:22Z",
- "passed": true,
- "notes": "string"
}, - "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Update an existing asset part receival with new data
| id required | string Asset part receival ID |
| receivalNumber required | string Unique receival number |
| purchaseOrder | string Purchase order reference |
| supplier required | string Supplier ID |
| receivalDate required | string <date-time> Date and time of receival |
| expectedDate | string <date-time> Expected delivery date |
| receivedBy | string User who received the parts |
| warehouse | string Warehouse ID where parts were received |
| status | string Default: "pending" Enum: "pending" "partial" "complete" "cancelled" Status of the receival |
required | Array of objects |
| totalValue | number <double> >= 0 Total value of the receival |
| currency | string Currency code |
| shippingCost | number <double> >= 0 Shipping cost |
| taxAmount | number <double> >= 0 Tax amount |
| discountAmount | number <double> >= 0 Discount amount |
object | |
object | |
Array of objects | |
| notes | string General notes |
object Additional metadata |
{- "receivalNumber": "RCV-2023-001",
- "purchaseOrder": "PO-2023-001",
- "supplier": "60f7b1b3e4b0e8b3f8b3f8b4",
- "receivalDate": "2023-01-15T10:00:00Z",
- "expectedDate": "2023-01-14T10:00:00Z",
- "receivedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "warehouse": "60f7b1b3e4b0e8b3f8b3f8b6",
- "status": "pending",
- "items": [
- {
- "assetPart": "string",
- "orderedQuantity": 1,
- "receivedQuantity": 0,
- "unitCost": 0,
- "totalCost": 0,
- "condition": "new",
- "batchNumber": "string",
- "serialNumbers": [
- "string"
], - "expiryDate": "2019-08-24",
- "notes": "string"
}
], - "totalValue": 0,
- "currency": "USD",
- "shippingCost": 0,
- "taxAmount": 0,
- "discountAmount": 0,
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "amount": 0
}, - "qualityCheck": {
- "performed": false,
- "checkedBy": "string",
- "checkDate": "2019-08-24T14:15:22Z",
- "passed": true,
- "notes": "string"
}, - "notes": "string",
- "metadata": { }
}{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "receivalNumber": "RCV-2023-001",
- "purchaseOrder": "PO-2023-001",
- "supplier": "60f7b1b3e4b0e8b3f8b3f8b4",
- "receivalDate": "2023-01-15T10:00:00Z",
- "expectedDate": "2023-01-14T10:00:00Z",
- "receivedBy": "60f7b1b3e4b0e8b3f8b3f8b5",
- "warehouse": "60f7b1b3e4b0e8b3f8b3f8b6",
- "status": "pending",
- "items": [
- {
- "assetPart": "string",
- "orderedQuantity": 1,
- "receivedQuantity": 0,
- "unitCost": 0,
- "totalCost": 0,
- "condition": "new",
- "batchNumber": "string",
- "serialNumbers": [
- "string"
], - "expiryDate": "2019-08-24",
- "notes": "string"
}
], - "totalValue": 0,
- "currency": "USD",
- "shippingCost": 0,
- "taxAmount": 0,
- "discountAmount": 0,
- "invoice": {
- "number": "string",
- "date": "2019-08-24",
- "amount": 0
}, - "qualityCheck": {
- "performed": false,
- "checkedBy": "string",
- "checkDate": "2019-08-24T14:15:22Z",
- "passed": true,
- "notes": "string"
}, - "notes": "string",
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}