Suppress Order Confirmations for Orders in Error (K09)

Purpose: Use this screen to indicate whether to generate order confirmation emails for orders you receive through the order API even if the order is in error, or wait until the errors are corrected.

Yes/No field: Select this field to delay generation of the order confirmation email for orders you receive through the order API if the order is in error. The order API generates an order confirmation email for an order only if it is created in open or held status, but not for an order that is created in suspended status because of any errors. Once you correct any errors and accept and process the corrected order batch, the system generates the order confirmation email. Otherwise, if the order is rejected, no order confirmation email is generated. In addition, the ORDR_ASYNC job generates the order confirmation for any eligible orders that have not previously generated confirmations.

Why suppress? You might want to suppress initial generation of the order confirmation email so that you are generating emails only for valid orders, and that the emails contain valid information. For example, if you generate a confirmation for an order that includes an invalid ship-to name and address, this information cannot be displayed correctly in the email.

Leave this field unselected to generate the order confirmation through the order API, regardless of whether there are any errors on the order.

Order confirmation generation hierarchy: Provided the order is eligible, the system generates an order confirmation email when:

• you accept an order in interactive Order Entry.

• the order is processed by the order API, including orders in error if the Suppress Order Confirmations for Orders in Error (K09) system control value is unselected.

• you accept and process a corrected order batch, if an order confirmation has not previously been generated for the order ship to.

• the order is processed by the ORDR_ASYNC job if an order confirmation has not previously been generated for the order ship to.

Eligible for order confirmation? See When Does the System Generate an Email Notification? for a discussion of when an order is eligible for an order confirmation.

Email or CWEmailOut message? The XML only? flag for the order confirmation email template indicates whether to generate an actual email or the CWEmailOut XML message. See the Outbound Email API for an overview.