Scenario: Purchase order receipt

This scenario walks you through a significant set of tasks that explains the purchase order receipt business use case.

As a System Integrator (SI) or customer developer, complete the following steps:
  1. A purchase order is created for the item SKU1024 in Sterling Order Management System Software. You can adjust supply in Inventory Visibility for a receiving location so that you can expect inventory to arrive at a future date.
    POST https://api.watsoncommerce.ibm.com/inventory/business/supplies
    {
      "supplies": [{
        "changedQuantity": 1.0,
        "eta": "2019-01-01T00:00:00Z",
        "itemId": "SKU1024",
        "productClass": "NEW",
        "shipByDate": "2500-01-01T00:00:00Z",
        "shipNode": "Matrix-Store-001",
        "type": "PO_PLACED",
        "unitOfMeasure": "EACH"
      }]
    }
  2. A supplier confirms the shipment and provides the tracking number. Based on this information, you can adjust the supply in Inventory Visibility to reflect the current state, type and ETA.
    POST https://api.watsoncommerce.ibm.com/inventory/business/supplies
    {
      "supplies": [{
        "changedQuantity": -1.0,
        "eta": "2019-01-01T00:00:00Z",
        "itemId": "SKU1024",
        "productClass": "NEW",
        "shipByDate": "2500-01-01T00:00:00Z",
        "shipNode": "Matrix-Store-001",
        "type": "PO_PLACED",
        "unitOfMeasure": "EACH"
      },{
        "changedQuantity": 1.0,
        "eta": "2019-01-01T00:00:00Z",
        "itemId": "SKU1024",
        "productClass": "NEW",
        "shipByDate": "2500-01-01T00:00:00Z",
        "shipNode": "Matrix-Store-001",
        "type": "INTRANSIT",
        "unitOfMeasure": "EACH"
      }]
    }
  3. After receipt of the item SKU1024, it is stocked in the appropriate location within the store.
    POST https://api.watsoncommerce.ibm.com/inventory/business/supplies
    {
      "supplies": [{
        "changedQuantity": -1.0,
        "eta": "2019-01-01T00:00:00Z",
        "itemId": "SKU1024",
        "productClass": "NEW",
        "shipByDate": "2500-01-01T00:00:00Z",
        "shipNode": "Matrix-Store-001",
        "type": "INTRANSIT",
        "unitOfMeasure": "EACH"
      },{
        "changedQuantity": 1.0,
        "eta": "2019-01-01T00:00:00Z",
        "itemId": "SKU1024",
        "productClass": "NEW",
        "shipByDate": "2500-01-01T00:00:00Z",
        "shipNode": "Matrix-Store-001",
        "type": "ONHAND",
        "unitOfMeasure": "EACH"
      }]
    }