Product Notification

Send product information notifications to keep the warehouse management system updated with current product data.

Single Product Notification

HTTP Method POST

Path /inbound/productNotification

Request Body

{
  "productId": "PROD-ABC123",
  "sku": "COFFEE-BEANS-1KG",
  "title": "Premium Coffee Beans 1kg",
  "description": "High-quality Arabica coffee beans",
  "category": "FOOD_BEVERAGE",
  "brand": "Premium Coffee Co.",
  "barcodes": [
    "1234567890123",
    "9876543210987"
  ],
  "weight": {
    "value": 1000,
    "unit": "grams"
  },
  "dimensions": {
    "length": 20.5,
    "width": 15.0,
    "height": 8.0,
    "unit": "cm"
  },
  "storageRequirements": {
    "temperature": "AMBIENT",
    "humidity": "LOW",
    "specialHandling": "FRAGILE"
  },
  "packagingInfo": {
    "packType": "BAG",
    "unitsPerCase": 12,
    "casesPerPallet": 80
  },
  "qualityRequirements": {
    "expiryRequired": true,
    "batchTracking": true,
    "serialTracking": false
  },
  "costPrice": 12.50,
  "currency": "GBP",
  "status": "ACTIVE"
}

Response Codes

200: Product notification processed

400: Invalid product data

401: Authentication required

Success Response (200)

{
  "success": true,
  "message": "Product notification successfully processed",
  "productId": "PROD-ABC123",
  "processedAt": "2024-01-20T16:30:00Z"
}

Bulk Product Notifications

HTTP Method POST

Path /inbound/productNotifications

Request Body

[
  {
    "productId": "PROD-ABC123",
    "sku": "COFFEE-BEANS-1KG",
    "title": "Premium Coffee Beans 1kg",
    "status": "ACTIVE"
  },
  {
    "productId": "PROD-DEF456",
    "sku": "TEA-BAGS-100CT",
    "title": "Premium Tea Bags 100 Count",
    "status": "ACTIVE"
  }
]

Response Codes

200: All notifications processed

207: Partial success (multi-status)

400: Invalid request data

401: Authentication required

Success Response (200)

{
  "success": true,
  "message": "All product notifications successfully processed",
  "processedCount": 2,
  "processedAt": "2024-01-20T16:30:00Z",
  "results": [
    {
      "productId": "PROD-ABC123",
      "status": "SUCCESS"
    },
    {
      "productId": "PROD-DEF456",
      "status": "SUCCESS"
    }
  ]
}

Partial Success Response (207)

{
  "success": true,
  "message": "Product notifications processed with some failures",
  "processedCount": 1,
  "failedCount": 1,
  "processedAt": "2024-01-20T16:30:00Z",
  "results": [
    {
      "productId": "PROD-ABC123",
      "status": "SUCCESS"
    },
    {
      "productId": "PROD-DEF456",
      "status": "FAILED",
      "error": "Invalid SKU format"
    }
  ]
}

Product Status Values

• ACTIVE - Product is available for operations
• INACTIVE - Product is temporarily unavailable
• DISCONTINUED - Product is permanently discontinued
• PENDING - Product is awaiting approval