Inspection Order Detail Guide

Latest Update Time: 2026-07-02 00:00:00

Use the inspection order detail API to retrieve complete information for a specific inspection order — booking info, factory/supplier, pricing, and product details.

See the Inspection Introduction for base URL, authentication, and required headers.

Endpoint

GET https://ppapi.qima.com/user/{userId}/inspection-order/{orderId}

Prerequisites

In addition to the required headers and authentication setup:

Permission to view inspection orders for the target client
An orderId obtained from Search Orders, Create Booking, or Async Booking Result

Path Parameters

Parameter	Required	Description
`userId`	Yes	QIMA client user login ID.
`orderId`	Yes	Inspection order ID.

Request Example

curl --location --request GET 'https://ppapi.qima.com/user/<qima-user-id>/inspection-order/<order-id>' \
  --header 'Ai-Api-Access-Token: {your api access token}' \
  --header 'Ai-User-Id: {your user ID}' \
  --header 'Authorization: Bearer {your token}' \
  --header 'Referer: https://preprodmy.qima.com/'

Successful Response

HTTP 200 OK returns the full order. The response is large (booking info, factory, supplier, pricing, and one entry per product) — trimmed to the key sections here.

{
    "message": null,
    "content": {
        "draft": {
            "draftId": null,
            "isAnOrderNotADraft": true,
            "draftSteps": null
        },
        "orderGeneralInfo": {
            "orderId": "8D21A68F78124F828E2232051E2712FD",
            "orderPlacer": "louispp001",
            "status": "20",
            "statusText": "WAITING_FOR_VALIDATION",
            "serviceType": "1",
            "serviceTypeText": "PSI",
            "bookingDate": "02-Jul-2026",
            "orderNumber": "Q2600368591-PP",
            "companyId": "23EC09AB0F3C46BBA4F79718DCED16D0",
            "userId": "4C6E94072DFC4918B60752F701DE544A",
            "clientRefNb": "2107-0-041",
            "expectedInspectionDate": "21-Dec-2026",
            "actualInspectionDate": "21-Dec-2026",
            "expectedShipDate": "21-Dec-2026",
            "confirmed": false
        },
        "orderExtra": {
            "orderId": "8D21A68F78124F828E2232051E2712FD",
            "cancelable": true,
            "editable": true,
            "isReInspection": false,
            "nbOfInspectors": 1
        },
        "orderFactory": {
            "factoryId": "22904F91A04A41E09EABD465E165152F",
            "factoryName": "JiXieChang-Factory",
            "factoryMGRName": "louis.yi",
            "factoryMGRNumber": "13512345678",
            "factoryMGREmail": ["manager@factory.com"],
            "factoryAddress": "LuoHuQu ChunFenglu 999",
            "factoryCity": "12687656",
            "factoryProvince": "12578016",
            "factoryCountry": "23424781",
            "factoryContinent": "24865671",
            "factoryProductLines": ["bigCat1_s2", "bigCat1_s3"]
        },
        "orderSupplier": {
            "orderId": "8D21A68F78124F828E2232051E2712FD",
            "supplierName": "JiXieChang-Supplier",
            "supplierMGRName": "louis.yi",
            "supplierMGRNumber": "18576710214",
            "supplierMGREmail": ["louis.yi@qima.com"],
            "supplierAddress": "LuoHuQu ChunFenglu 999",
            "supplierId": "9CB3F02222CA46FC8791D790D5422582",
            "supplierProductLines": ["bigCat1_s2", "bigCat1_s3"]
        },
        "orderPrice": {
            "orderId": "8D21A68F78124F828E2232051E2712FD",
            "totalManday": 1.0,
            "totalCharge": 332.79,
            "inspectionChargeType": "MAN_DAY",
            "inspUnitPrice": 309.0,
            "inspectionCharge": 309.0,
            "totalQuantity": 4260.0,
            "sampleLevel": "II",
            "sampleSizeTotal": 200.0,
            "taxAmount": 23.79,
            "otherChargeName": "Laboratory test cost",
            "productPriceMandayViews": [
                {
                    "productId": "FF672B8C7E4249E5B09285ABE83A23E1",
                    "productName": "Dumbbell Kaytan 2kg",
                    "productManday": 1.0,
                    "inspUnitPrice": 309.0
                }
            ]
        },
        "products": [
            {
                "productBean": {
                    "orderId": "8D21A68F78124F828E2232051E2712FD",
                    "productId": "FF672B8C7E4249E5B09285ABE83A23E1",
                    "prodName": "Dumbbell Kaytan 2kg",
                    "prodCategoryClient": "bigCat2",
                    "prodFamilyClient": "bigCat2_s2",
                    "prodType": "bigCat2_s2_t200",
                    "prodQuantity": 4260,
                    "poNumber": "6111"
                },
                "productChecklistBean": {
                    "productId": "FF672B8C7E4249E5B09285ABE83A23E1",
                    "prodSampleLevel": "II",
                    "aqlCritical": "0",
                    "aqlMajor": "1",
                    "aqlMinor": "3",
                    "prodSampleSize": 125
                },
                "sampleCollection": {
                    "id": "D99FCF9EBC5B4D7FB78B95E5E371647D",
                    "productId": "FF672B8C7E4249E5B09285ABE83A23E1"
                },
                "productSpec": {
                    "productId": "FF672B8C7E4249E5B09285ABE83A23E1",
                    "performDropTest": true
                },
                "completed": false
            }
        ],
        "orderSpecialRequests": []
    }
}

Response Field Notes

Field	Notes
`orderGeneralInfo` / `orderExtra` / `orderFactory` / `orderSupplier` / `products`	Same shape as the Inspection Booking response `content`.
`orderPrice`	Pricing breakdown for the order — total charge, per-product man-day pricing, sample/tax details. Not present on the booking-creation response; only available once the order has been priced.
`orderSpecialRequests`	List of special requests attached to the order. Empty array when none.

Common Errors

See common authentication errors for 401 and 403 responses.

Status	Meaning	Recommended Action
`500 Internal Server Error`	Order not found, for example `"PSI_0001:The order is not existing!"`.	Confirm the `orderId` is correct and belongs to the authenticated user's account.

Next Steps

Cancel the order if it's no longer needed and orderExtra.cancelable is true.

Documents