CapaCqpEntry

One failed Inline CQP: the CQP as captured on the inspection, the inspector result, the PPM stage it was inherited from, and the root cause, corrective and preventive actions recorded in the CAPA.

addedOnSiteboolean

true when the inspector added the CQP during the inspection instead of inheriting it

Example: false

attachments object[]

Self-assessment attachments

Array [

idstring<uuid>required

Regenerated when the aggregate is replaced with PUT.

fileUrlstring<uri>

Possible values: <= 500 characters

fileNamestring

Possible values: <= 255 characters

fileContentTypestring

Possible values: <= 200 characters

createdAtstring<date-time>required

updatedAtstring<date-time>required

]

commentstringnullable

Supplier self-assessment note

Example: Pull test passed on pre-production samples.

comments object[]

Comments on the CQP in the CAPA

Array [

attachments object[]

List of attachments on the comment

Array [

fileNamestringnullable

File name of the attachment

Example: photo.jpg

fileUrlstringnullable

URL of the attachment

Example: https://.../file.jpg

]

createdDatestring<date-time>nullable

Date the comment was created

Example: 2021-05-25T13:58:26+00:00

emailstringnullable

Email of the user who posted the comment

Example: [email protected]

firstNamestringnullable

First name of the user who posted the comment

Example: John

lastNamestringnullable

Last name of the user who posted the comment

Example: Doe

messagestringnullable

Comment message

organizationNamestringnullable

Organization of the user who posted the comment

Example: Acme Corp

]

correctiveAction object

Corrective action recorded in the CAPA

detailsstringnullable

Details on the corrective action

Example: Rework on the defective units

valuestringnullable

An action in the corrective list

Example: Rework Units

cqcsstring[]

Names of the linked CQCs (CQP groups), as the CQP Integration API returns them

Example: ["Trims"]

cqpTypeCQPType

CQP type

Possible values: [safety, functional, regulation]

descriptionstringnullable

CQP description

Example: Zipper pull must withstand 70 N pull test.

executionResult objectnullable

Inspector result captured during inspection execution; null until the result is uploaded

attachments object[]

Inspector evidence (photos, videos)

Array [

fileContentTypestringnullable

MIME type of the file

Example: image/jpeg

fileNamestringnullable

File name

Example: evidence-1.jpg

fileUrlstring<uri>

URL of the file

Example: https://.../evidence-1.jpg

mediaTypestringnullable

Kind of evidence

Possible values: [photo, video]

Example: photo

]

capturedAtstring<date-time>nullable

When the result was captured

Example: 2026-09-24T03:00:00+00:00

commentstringnullable

Inspector comment

Example: Zipper pull detached on 2 of 8 samples.

inspectionTypestringnullable

Inspection type code of the inspection the result was captured on

Example: INLINE

naReasonstringnullable

Reason given when the outcome is na; null otherwise

outcomeCqpOutcome

Recorded outcome

Possible values: [pass, fail, customer_requirement_fail, na]

idstring<uuid>

Identifier of this CQP entry on the inspection; the key the corrective actions and comments are attached to

Example: 11aa2bb3-4cc5-4dd6-8ee7-9ff0a1b2c3d4

mitigations object[]

Mitigations as captured on the inspection

Array [

idstring<uuid>required

Regenerated when the aggregate is replaced with PUT.

controlLayerTypeControlLayerType

Possible values: [product_spec, material, production_process]

productionStepProductionStep

Possible values: [material_preparation, cutting, forming_molding, printing_dyeing, sewing, assembly, surface_finishing, washing, finishing, labeling, packing, other]

specificationstring

productionControlCheckstring

qualityControlCheckstring

createdAtstring<date-time>required

updatedAtstring<date-time>required

]

namestringnullable

CQP name as captured on the inspection

Example: Zipper pull strength

preventativeActionstringnullable

Preventive action recorded in the CAPA

Example: Add calibration to the shift checklist.

previousStageResult objectnullable

The PPM stage this CQP was inherited from; null when it was not inherited or the PPM inspection is not visible to the caller

inspectionDatestring<date-time>nullable

Date the PPM inspection was uploaded

Example: 2026-08-20T00:00:00+00:00

inspectionIdstring<uuid>

Identifier of the PPM inspection (usable with the report endpoints)

Example: c04a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c

inspectionTypestringnullable

Inspection type code of the PPM inspection

Example: PPM

outcomestringnullable

Outcome recorded on the PPM entry, if any; the values of CqpOutcome. PPM rows normally carry a review status, not an outcome, so this is usually null

Possible values: [pass, fail, customer_requirement_fail, na, null]

statusCQPStatus

Review status of the PPM entry

Possible values: [pending, reviewed]

reviewNote objectnullable

Brand / retailer review note recorded on the CQP

attachments object[]

Review note attachments

Array [

idstring<uuid>required

Regenerated when the aggregate is replaced with PUT.

fileUrlstring<uri>

Possible values: <= 500 characters

fileNamestring

Possible values: <= 255 characters

fileContentTypestring

Possible values: <= 200 characters

createdAtstring<date-time>required

updatedAtstring<date-time>required

]

commentstringnullable

Review note text

Example: Reviewed at PPM, mitigation accepted.

rootCausestringnullable

Root cause recorded in the CAPA

Example: Bar-tack machine out of calibration.

sourceCqpIdstring<uuid>nullable

Identifier of the Style / Item library CQP this entry was created from (id of the CQP Integration API); null for a CQP added on site

Example: 00ff1ee2-3dd4-4cc5-9bb6-7aa8f9e0d1c2

sourceSnapshotIdstring<uuid>nullable

Identifier of the PPM CQP entry this entry was inherited from; null when it was not inherited

Example: b31d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f

statusCQPStatus

Review status of the CQP entry

Possible values: [pending, reviewed]

verifications object[]

Verifications as captured on the inspection

Array [

idstring<uuid>required

Regenerated when the aggregate is replaced with PUT.

stageTypeVerificationStage

Possible values: [pre_production, during_production, post_production]

methodTypeVerificationMethod

Possible values: [certified_lab_test, process_verification_checklist, inspection]

inspectionTypesstring[]

Possible values: <= 50 characters

acceptanceCriteriastring

assignedToVerificationAssignedTo

Possible values: [third_party, brand_retailer, supplier_factory]

createdAtstring<date-time>required

updatedAtstring<date-time>required

]

CapaCqpEntry

{
  "addedOnSite": false,
  "attachments": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fileUrl": "string",
      "fileName": "string",
      "fileContentType": "string",
      "createdAt": "2024-07-29T15:51:28.071Z",
      "updatedAt": "2024-07-29T15:51:28.071Z"
    }
  ],
  "comment": "Pull test passed on pre-production samples.",
  "comments": [
    {
      "attachments": [
        {
          "fileName": "photo.jpg",
          "fileUrl": "https://.../file.jpg"
        }
      ],
      "createdDate": "2021-05-25T13:58:26+00:00",
      "email": "[email protected]",
      "firstName": "John",
      "lastName": "Doe",
      "message": "string",
      "organizationName": "Acme Corp"
    }
  ],
  "correctiveAction": {
    "details": "Rework on the defective units",
    "value": "Rework Units"
  },
  "cqcs": [
    "Trims"
  ],
  "cqpType": "safety",
  "description": "Zipper pull must withstand 70 N pull test.",
  "executionResult": {
    "attachments": [
      {
        "fileContentType": "image/jpeg",
        "fileName": "evidence-1.jpg",
        "fileUrl": "https://.../evidence-1.jpg",
        "mediaType": "photo"
      }
    ],
    "capturedAt": "2026-09-24T03:00:00+00:00",
    "comment": "Zipper pull detached on 2 of 8 samples.",
    "inspectionType": "INLINE",
    "naReason": "string",
    "outcome": "pass"
  },
  "id": "11aa2bb3-4cc5-4dd6-8ee7-9ff0a1b2c3d4",
  "mitigations": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "controlLayerType": "product_spec",
      "productionStep": "material_preparation",
      "specification": "string",
      "productionControlCheck": "string",
      "qualityControlCheck": "string",
      "createdAt": "2024-07-29T15:51:28.071Z",
      "updatedAt": "2024-07-29T15:51:28.071Z"
    }
  ],
  "name": "Zipper pull strength",
  "preventativeAction": "Add calibration to the shift checklist.",
  "previousStageResult": {
    "inspectionDate": "2026-08-20T00:00:00+00:00",
    "inspectionId": "c04a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c",
    "inspectionType": "PPM",
    "outcome": "pass",
    "status": "pending"
  },
  "reviewNote": {
    "attachments": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "fileUrl": "string",
        "fileName": "string",
        "fileContentType": "string",
        "createdAt": "2024-07-29T15:51:28.071Z",
        "updatedAt": "2024-07-29T15:51:28.071Z"
      }
    ],
    "comment": "Reviewed at PPM, mitigation accepted."
  },
  "rootCause": "Bar-tack machine out of calibration.",
  "sourceCqpId": "00ff1ee2-3dd4-4cc5-9bb6-7aa8f9e0d1c2",
  "sourceSnapshotId": "b31d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
  "status": "pending",
  "verifications": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "stageType": "pre_production",
      "methodType": "certified_lab_test",
      "inspectionTypes": [
        "string"
      ],
      "acceptanceCriteria": "string",
      "assignedTo": "third_party",
      "createdAt": "2024-07-29T15:51:28.071Z",
      "updatedAt": "2024-07-29T15:51:28.071Z"
    }
  ]
}