Editing exception details

Use the Exception Details page to view an exception's details and fix an exception error. This page shows a summary of the transaction and provides information on the exception, including any error codes.

Exception Details taskbar

Button Description
View History View History Displays the change history for the exception. See Viewing the history of an integration exception for more information.
Re-Extract Re-Extract Allows you to resubmit the transaction after you fix the exception. Re-extracting a transaction rebuilds and resubmits the transaction. When you corrected everything that caused the exception, the system processes the transaction as a normal transaction and the exception will no longer appear on the Manage Integration Exceptions page. See How to fix an integration exception for more information.

Exception Details attributes

Attribute Description
Failure Exception Displays the type of exception.
Principal ID

The principal identifier.

Order ID

Provide the system-generated ID assigned to the order. See How to view the order summary for more information.

Order Value Displays the value of the Order.
Order Date

Shows the date and time the shopper placed the order.

Exception Date The date and time the exception occurred.
Site ID

Shows the unique ID for a site.

Shipping Method

The shipping method for the order.

Locale

The name of the locale.

Notes Add any notes regarding this exception.
Corrective Action or Removal Reason

A description of the action taken to resolve the integration exception or a reason why it was ignored.

Product ID

The unique ID for a product.

SKU

Provide the stock keeping unit (SKU). A SKU is a unique identifier to track and manage inventory. It is a code or number assigned to a specific product or item in a store or warehouse. SKUs distinguish between different products, variations, or versions and are often used in inventory management systems to facilitate product tracking, ordering, and restocking.

Fulfiller Part Number

This field shows the fulfiller's part number for the product.

Quantity

This field shows the number of items ordered.

Exception

The reason for the exception.

Error Description

A description of the error.

History The following attributes appear when you click the View History button.
Action Date/Time The date and time when the integration exception was last modified.
User Name Displays the user ID for the user who last modified the integration exception and their company name in parenthesis.
Exception

The reason for the exception.

Corrective Action Taken/Reason Ignored

A description of the action taken to resolve the integration exception or a reason why it was ignored.

How to fix an integration exception

Depending on the type of exception, you can fix the problem that caused the exception, cancel the line item with the exception, or cancel the order with the exception. Usually, you just need to update the product information, deploy those changes, and re-extract (resubmit) the transaction to fix the exception.

  1. Search for the integration exception. See How to search for an integration exception for instructions.
  2. Click the order ID for the transaction you want to fix under the Order ID column. The Exception Details page appear.
  3. Use the following list to determine the action you need to take to resolve a specific type of exception.

    • For fulfillment exceptions:

      1. Look at the Exception column to determine which line item caused the exception. Note that this column may also indicate what you need to fix.
      2. Click the product ID link under the Product ID column for the exception. The product details appears.
      3. Correct the issue causing the exception.

        Example: Fix the SKU, External Reference Number, or Fulfiller Part Number.

      4. Deploy product changes.
      5. When finished, return to the Exception Details page and enter a reason for re-extracting one or more line items in the Corrective Action Taken or Removal Reason field.
      6. Select the checkboxes next to the line items or products you want to re-extract. To select all transactions, select the checkbox next to Product ID at the top of the column.

        Tip: You can re-extract one or more transactions at the same time. When you fixed a problem that caused an exception on multiple transactions, you can select every transaction with the exception and re-extract. You do not have to re-extract each transaction separately.

      7. Click Re-extract to resubmit the transaction. The Manage Integration Exceptions page appears and shows the following message:

        The exceptions have been re-extracted.

    • For digital rights exceptions where Digital River hosts the DRM for the product:

      1. Update the serial numbers or unlock codes.

        Example: A digital rights exception occurs when there are no more serial numbers or unlock codes associated with the product. Adding new serial numbers or unlock codes will allow you to re-extract the exception. Make sure you deploy any changes to the product before you re-extract the exception.

      2. Deploy product changes.
      3. When finished return to the Exception Details page and enter a reason for re-extracting one or more line items in the Corrective Action Taken or Removal Reason field.
      4. Select the checkboxes next to the line items or products you want to re-extract. To select all transactions, select the checkbox next to Product ID at the top of the column.

        Tip: You can re-extract one or more transactions at the same time. When you fixed a problem that caused an exception on multiple transactions, you can select every transaction with the exception and re-extract. You do not have to re-extract each transaction separately.

      5. Click Re-extract to resubmit the transaction. The Manage Integration Exceptions page appears and shows the following message:

        The exceptions have been re-extracted.

    • If you cannot fix the problem that caused the exception, you need to cancel the line item that caused the exception:

      Example: A bad part number caused the exception.

      1. Enter a reason for cancelling one or more line items in the Corrective Action Taken or Removal Reason field.
      2. Select one or more the products or line items associated with an exception from the list and click Cancel Selected.

        Warning: A cancelled line item, product, or order cannot be uncancelled.

        Note: The system will close this transaction by cancelling the affected line items.

        If only one item is associated with the order, you will cancel the entire order. If there is more than one line item in the order and you cancel some (but not all) line items, you must re-extract (resubmit) the transaction after canceling the line item(s) in question.

      3. Click OK.

Viewing the history of an integration exception

  1. Search for the integration exception. See How to search for an integration exception for instructions.
  2. Click the order ID for the transaction you want to fix under the Order ID column. The Exception Details page appears.
  3. Click View History. The History table appears at the bottom of the Exception Details page.

How to view the order summary

  1. Search for the integration exception. See How to search for an integration exception for instructions.
  2. Click the order ID for the transaction you want to fix next to the Order ID field or under the Order ID column. The Exception Details page appears.
  3. Click the link in the Order ID field. The Order Summary page opens in a separate browser tab. See Managing an order summary for more information.