Create Single Shipment

Create Purchase Order Shipment

This API endpoint is used to create PO Shipment lines within the CMiC system. It allows users to submit detailed information regarding shipments, including vendor details, shipment dates, and quantities received.

UI Location

This functionality can be accessed in the CMiC user interface at:
ASSET MANAGEMENT - Purchase Order - Receipt- Enter Wareshouse/Job Receipt

Method: POST
Endpoint: po-rest-api/jersey/v1/shipmentReceiving

Request Body Format

The request should be sent as a JSON object containing the following structure:

{
  "data": {
    "shipment": [
      {
        "poshpShipmRecLoc": "string",      // Location of shipment receiving
        "poshpReceiver": "string",          // Receiver's name
        "poshpVendorCode": "string",        // Vendor code
        "poshpShipmRecDate": "YYYY-MM-DD",  // Shipment receiving date
        "poshpPoNum": "string",              // Purchase order number
        "poshpPoRelNum": "integer",          // Purchase order release number
        "poshpShipmNum": "string",           // Shipment number
        "poshpShiplistNum": "string",        // Shipment list number
        "poshpRemarks": "string",            // Additional remarks
        "poshpVUuid": "string",              // UUID for the shipment
        "detail": [
          {
            "poshpdPoLineNum": "integer",    // Purchase order line number
            "poshpdPoNum": "string",          // Purchase order number
            "poshpdPoRelNum": "integer",      // Purchase order release number
            "poshpdShipmNum": "string",       // Shipment number
            "poshpdShiplistNum": "string",    // Ship list number
            "poshpdWmCode": "string",         // WM code
            "poshpdReceivQty": "integer",     // Quantity received
            "poshpdClaimQty": "integer|null", // Quantity claimed
            "poshpdRejectQty": "integer|null",// Quantity rejected
            "poshpdVUuid": "string"           // UUID for the detail
          }
        ]
      }
    ]
  },
  "company": "string",                     // Company code
  "postFlag": "Y/N",                      // Flag to indicate posting
  "postDate": "YYYY-MM-DD",               // Posting date
  "batchNum": "integer",                  // Batch number
  "batchName": "string"                   // Name of the batch
}

Expected Response

Upon successful execution, the API will return a response with a status code of 201. The response will be in JSON format, indicating the success of the operation. The response bod will typically confirm the successful creation of the purchase order shipment lines