---
title: "Open a new NCR in status New. An affected job and/or item become the NCR's single impact; the job's customer and sales order are recorded from the job itself. The NCR number is assigned by the server. Creates are not idempotent: a retried request opens a second NCR."
method: POST
path: "/api/ncrs"
tags: ["NCRs"]
---

# Open a new NCR in status New. An affected job and/or item become the NCR's single impact; the job's customer and sales order are recorded from the job itself. The NCR number is assigned by the server. Creates are not idempotent: a retried request opens a second NCR.

`POST /api/ncrs`

## Request body

- NCRRequestNcrCreateDto — Request body for opening an NCR. The NCR is created in status New; the quality team classifies and works it in the app. An affected job and/or item become the NCR's single impact.
  - `title` string, nullable — Short title for the NCR
  - `type` string, required — The NCR type, one of the shop's configured NCR types (for example Quality, Quantity, Customer Complaint, Return, Warranty)
  - `detail` string, required — What was found: the required description of the non-conformance
  - `cause` string, nullable — The cause, one of the shop's configured NCR causes
  - `reason` string, nullable — The reason, one of the shop's configured NCR reasons
  - `disposition` string, nullable — Disposition, when already decided. One of: Acceptable - Customer, Acceptable - Engineer, Conforming, Hold, Return To Customer, Return To Vendor, Return To Fulcrum, Rework, Remake/Replace, Scrap - Customer
  - `jobId` string, nullable — The affected job's id. The job's customer and sales order are recorded on the impact from the job
  - `itemId` string, nullable — The affected item's id. Defaults to the job's parent item when only a job is given
  - `quantityImpacted` number, double, nullable — How many units are affected. Requires jobId or itemId. Zero or greater
  - `quantityImpactedDisposition` string, nullable — Whether the impacted quantity is All, Partial, or Unknown. Defaults to Partial

## Response `200`

The created NCR

- NCRNcrDto — Represents an NCR
  - `id` string, required — Unique id associated to this entity.
  - `number` integer, required — Number
  - `type` string, required — NCR Type
  - `cause` string, required — Cause
  - `detail` string, required — Detail - required notes on the NCR
  - `departmentId` string, nullable — Department key identifier. Please reference /api/departments endpoint.
  - `department` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `vendorId` string, nullable — Vendor key identifier. Please reference /api/vendors endpoint.
  - `vendor` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `workCenters` string, nullable — The work centers assigned to this NCR.
  - `scheduledEquipment` string, nullable — Affected Equipment
  - `reason` string, nullable — Reason
  - `operator` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `status` string, nullable — NCR Status
  - `quantityImpacted` number, double, nullable — Quantity Impacted
  - `incrementalCost` number, double, nullable — Incremental Cost
  - `createdUtc` string, date-time, nullable — Created Date
  - `completedUtc` string, date-time, nullable — Completed Date
  - `jobIds` string[] — Impacted Job IDs
  - `customFields` object, nullable — Custom fields that have been defined on this entity.
  - `completedBy` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `analyzedBy` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `impacts` CommonImpactDto[], nullable — Impact information.
    - `id` string, uuid, required — The ID for this object.
    - `operation` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `workCenter` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `scheduledEquipment` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `job` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `salesOrder` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `quantityImpacted` number, double, nullable — Quantity Impacted
    - `incrementalCost` number, double, nullable — Incremental Cost

## Other responses

- `400` — Validation issues with input
- `404` — The job or item does not exist

## Changes

- **2026-09-18** `bae242bf0067` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/ncrs/post.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/bae242bf0067?raw)