How to Perform a Material Change during Delivery

Within this guide you are going to learn how you can issue an article differing from the ordered one. This may happen, when the stock for a certain article ran out..

Context

  • A user ordered an article A (e.g. DELL Latitude)
  • The support delivered an article B (e.g. MacBook)
  • The delivery of B was a valid decision and is going to persist.
  • The stock transfer item is in the status Ordered.
  • You already obtained the BProc Context Id XYZ (e.g. from the BProc Error Incident, BProc - Reference History, Order Management Registration Entry), the Order Id ORD01 and the Basket Item Id BO01

Fix

  1. It is crucial that the manual delivery is performed against the BProc Gateway and not directly the Order Management service. The reason for this is, that the BProc Gateway introduces the Command and Event pattern, required for the Matrix42 workflows.
  2. Open Postman or a similiar program within which you have configured the authorization required for the BProc gateway.
  3. Perform a manual delivery of the basket item and supply the updated material id in the body.

    POST {{baseUrl}}/Orders/ORD01/deliver
{    "Context": {        "Id": "XYZ"    },    "Id": "BO01",    "SerialNumbers": [      "SerialForMaterialB"    ],    "MaterialId": "B"}