Quality control triggers
Quality control triggers define when the system automatically creates a quality check. Each trigger links a document type and action (the event that fires the check) to a plan and team (what gets checked and who checks it). Filters on location, item, and source narrow which documents match the trigger.
To open the list, select the Search icon
, enter Quality Control Triggers, and choose the related link.
Trigger points
The following trigger points are available for each document type.
| Document Type | Trigger Points |
|---|---|
| Sales Order | When releasing a sales order |
| Sales Shipment | When creating or releasing a sales shipment |
| Sales Return Order | When releasing or posting a sales return order |
| Sales Return Receipt | When creating or posting a sales return receipt |
| Purchase Order | When releasing or posting a purchase order |
| Purchase Receipt | When creating or posting a purchase receipt |
| Purchase Return Order | When releasing a purchase return order |
| Purchase Return Shipment | When creating or releasing a purchase return shipment |
| Transfer Order | When releasing or posting a transfer order |
| Transfer Shipment | When creating or releasing a transfer shipment |
| Transfer Receipt | When creating or posting a transfer receipt |
| Production Order | When posting production order output. With the Shop Floor Production extension: also when starting or stopping a work center, on work center failure, when starting or finishing a production order, or at recurring time or output quantity intervals. |
| Inspection Status | When a lot's inspection status matches or is updated to the configured status. |
| Inventory | When a lot has been held at a location or bin for the configured recurring interval. Evaluated by a scheduled job rather than a document event — see Create recurring checks. |
Fields
| Field | Description |
|---|---|
| Document Type | Specifies the document type that fires the trigger. Options:
|
| Document Action | Specifies the specific action on the document that fires the trigger. Select the AssistEdit button to choose from the Quality Control Trigger Actions page. Available actions depend on the selected Document Type. Not available for Inspection Status — checks fire on status assignment rather than a document action. For Inventory, Recurring Time is the only available action. |
| Document Action Caption | Read-only. Displays the name of the selected document action. |
| Location Type | Specifies whether the trigger applies to all locations or a specific location. Options:
|
| Location Code | Specifies the location this trigger applies to. Editable only when Location Type is Location. For the Start Work Center, Stop Work Center, and Failure Work Center document actions, the field value is compared to the work center's own Location Code field value when the trigger fires; leave blank to match every location. |
| Bin Code | Specifies the bin to evaluate. Leave blank to evaluate all bins in the location. Editable only when Document Type is Inventory. A Location Code must be entered first, and the field must be blank when Location Type is All Locations. |
| Quality Check Type | Specifies whether the triggered check is item-specific or general. Options:
|
| Item Type | Specifies which items the trigger applies to. Options:
|
| No. | Specifies the item or item attribute number. Editable only when Item Type is Item or Item Attribute. |
| Name | Read-only. Displays the name of the item or item attribute selected in No. |
| Source Type | Specifies the source (customer, vendor, or work center) this trigger applies to. Available options depend on the Document Type — see Source Type by document type below. Not available for Transfer or Inspection Status document types. |
| Source No. | Specifies the specific customer, vendor, or work center this trigger applies to. Not available for Transfer or Inspection Status document types. |
| Source Name | Read-only. Displays the name of the source selected in Source No. |
| Inspection Status | Specifies the inspection status that fires this trigger. Required when Document Type is Inspection Status. Available only when the Aptean Inspection Status extension is installed. |
| Team | Specifies the quality control team assigned to checks created by this trigger. Required. |
| Plan Code | Specifies the quality control plan used when creating checks. Required. |
| Plan Certified | Read-only. Indicates whether the selected plan is certified. |
| Plan Effective | Read-only. Indicates whether the selected plan is currently effective based on its effective dates. |
| Finished Before Posting Doc | When selected, the related document cannot be posted until all quality checks created by this trigger are completed or deleted. For Production Order triggers, the behavior varies by action — see Production Order actions below. |
| Create Single Start QC Check | Controls whether the Start Production Order trigger creates a check only once per production order or every time the order transitions back to a started state. When selected, a check is created the first time the production order is started. If the order is subsequently stopped or paused and then restarted, no additional check is created — the original check already covers this production order. When cleared, a new check is created each time the order moves from a stopped or paused state back to running. Available only when Document Action is Start Production Order. |
| Allow Multiple Open Checks | When selected, the system can create multiple open quality checks for the same production order. Available only when Document Type is Production Order. |
| Per Lot | When selected, the system creates one quality check per lot number on the document. Editable only when Quality Check Type is Item. Always active for Inspection Status (checks are inherently lot-specific). For Inventory, the field is set automatically and is read-only, because inventory triggers only evaluate lot-tracked items. |
| Recurring Period | Specifies the time unit for recurring checks. Options:
|
| Recurring Value | Specifies the interval between recurring checks. What the value counts depends on the document action:
|
| Create First Recurring Check on Start | When selected, the first recurring check is created as soon as the operation is started in Shop Floor Production, rather than waiting for the first interval to pass. The recurrence baseline is set at that moment, so the next check falls due one Recurring Value later. When cleared, no check is created at start — the first check is created once the recurring interval or output quantity increment is first reached. The initial check is created only once per production order routing line, so stopping and restarting the operation does not create another. Available only when Document Type is Production Order and Document Action is Recurring Time or Recurring Output Quantity. Requires the Shop Floor Production extension. |
For Production Order triggers, the Per Lot field should be selected when the Document Action is Post, and cleared for all other Production Order document actions.
Quality Check Type constraints
The Quality Check Type field is constrained by the Document Type and Document Action:
| Document Type | Document Action | Required Quality Check Type |
|---|---|---|
| Production Order | Start Work Center, Stop Work Center, Failure Work Center | General |
| Production Order | Start Production Order, Finish Production Order, Recurring Time, Recurring Output Quantity | Item |
| Inspection Status | (not applicable) | Item (forced) |
| Inventory | Recurring Time | Item (forced) |
| All others | Any | Item or General |
Source Type by document type
The options available in Source Type depend on the selected Document Type:
| Document Type | Available Source Types |
|---|---|
| Sales Order, Sales Shipment, Sales Return Order, Sales Return Receipt | Customer, Customer Attribute, All Customers |
| Purchase Order, Purchase Receipt, Purchase Return Order, Purchase Return Shipment | Vendor, Vendor Attribute, All Vendors |
| Production Order | Work Center, All Work Centers |
| Inventory | Vendor, Vendor Attribute, All Vendors |
| Transfer Order, Transfer Shipment, Transfer Receipt | (not available) |
| Inspection Status | (not available) |
Production Order actions
The Post action is available with or without the Aptean Shop Floor Production extension, however the following actions require Shop Floor: Start Work Center, Stop Work Center, Failure Work Center, Start Production Order, Finish Production Order, Recurring Time, and Recurring Output Quantity.
The Finished Before Posting Doc field behaves differently depending on the action:
- For Post, Start Production Order, Recurring Time, and Recurring Output Quantity — prevents finishing the production order in Shop Floor Production until all associated quality checks are completed or deleted.
- For Finish Production Order — the check is created by the finish action itself, so it cannot block finishing in Shop Floor Production. Instead, it prevents posting the production order in Business Central until the check is completed or deleted.
- For Start Work Center, Stop Work Center, and Failure Work Center — prevents starting work centers when open quality checks already exist for that production order.
A trigger linked to a released production order routing line cannot be deleted until the routing line is removed or the order is completed.