Customer Engagement Shared Customer Number

With this update, the customer number assigned by Oracle Retail Customer Engagement is now available to pass through the following existing web service messages.

  • Order Management System web services now support the following versions:

    • Generic Customer History API: CWCustHistIn version 3.0 and CWCustHistOut version 2.0

    • Generic Email API: CWEmailOut version 12.0

    • Generic Invoice API: CWInvoiceOut version 6.0

    • Generic Pick Out API: CWPickOut version 6.0

    • Generic Order API: CWOrderIn version 10.0 and CWOrderOut version 11.0

      Note:

      The logic used to select and update the customer through the order API has also changed, as described below.
    • Generic Customer History API: CWCustHistIn version 3.0, as well as CWOrderOut version 11.0

    In each of the new outbound message versions listed above, the orce_customer_id tag is included only if the ORCE Customer Integration (L37) system control value is set to INTERACT and if an ORCE customer ID is assigned to the customer.

    Note:

    Assign new Customer Engagement ID for existing customer? If an existing customer was not previously assigned a Customer Engagement ID (ORCE ID), and the CWOrderIn message includes the customer number but does not include other identifying information, such as the customer’s first and last name, a Customer Engagement ID is assigned to the customer only if:
    • The CWOrderIn request message includes the customer number and email address, or

    • The existing customer record in Order Management System already has an email address.

Order Broker web services:

  • SubmitOrder request: A new Send ORCE Customer ID to OROB (M71) system control value indicates whether the BROKER_ORD process sends the ORCE customer ID to Order Broker as the customer_no or the Order Management System customer number in the SubmitOrder message. The ORCE customer ID is sent if:

    • An ORCE customer ID is assigned to the customer, and

    • The ORCE Customer Integration (L37) system control value is set to INTERACT, and

    • The new Send ORCE Customer ID to OROB (M71) system control value is selected. The new system control value is not selected by default.

    Otherwise, the Order Management System customer number is sent to Order Broker as the customer_no.

  • Fulfillments response: A new ORCE Customer ID in OROB Fulfillment (M72) system control value indicates whether to map the customer_no passed from Order Broker in the fulfillments response message to the ORCE customer ID or to the Order Management System customer number. Order Management System maps the customer_no passed to the ORCE customer ID if:

    • The ORCE Customer Integration (L37) system control value is set to INTERACT, and

    • The new ORCE Customer ID in OROB Fulfillment (M72) system control value is selected.

    Otherwise, Order Management System maps the customer_no passed in the fulfillments response to the Order Management System customer number.

Narvar integration: A new Send ORCE Customer ID to Narvar (M70) system control value indicates whether to send the ORCE customer ID as the customer_id. The ORCE customer ID is sent:

  • If an ORCE customer ID is assigned to the customer, and

  • The ORCE Customer Integration (L37) system control value is set to INTERACT, and

  • The new Send ORCE Customer ID to Narvar (M70) system control value is selected. The new system control value is unselected by default.

Otherwise, the Order Management System customer number is sent to Narvar as the customer_id.