Managing integration exceptions

Use the Integration Exceptions tool to view and resubmit failed integration requests. There are several different types of exceptions that can occur. The most common exceptions are digital rights and fulfillment exceptions.

When an integration exception occurs, you must fix the problem causing the exception and re-extract the transaction. As long as the exception remains unfixed, the client and Digital River cannot charge the shopper and therefore recognize revenue from the transaction. You may need to cancel a line item or the entire order to fix the exception. You should only cancel orders when you are sure that you cannot fix the problem that caused the exception. (The client and Digital River to lose revenue when you cancel a line item or order.) Once you cancel a line item or order, you cannot recover or uncancel it.

Manage Integration Exceptions attributes

Attribute Description
Exception Type

Choose the type of exception you want to find. Your options are as follows:

  • All Exception Types
  • Digital Right Exception
  • Digital Right Revocation Exception
  • External Download Update Service Exception
  • Fulfillment Exception
  • Subscription Service Exception
  • Electronic Fulfillment Exception
  • Return Exception
Order ID

Provide the system-generated ID assigned to the order.

Click the link to view the exception details. See Editing exception details for more information.

Principal ID

The principal identifier.

Site ID

Shows the unique ID for a site.

Product ID

The unique ID for a product.

Fulfiller Part Number

This field shows the fulfiller's part number for the 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.

Failure Begin Date

The beginning of the search date range.

Failure End Date

The end of the search date range.

Corrective Action Taken or Removal Reason

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

This field appears when you click Search Search.

Failure Date The date and time when the failure occurred.
Order Date The date when the shopper submitted the order.
Order Value The value of the order.
Shipping Method

The shipping method for the order.

Error Description A description of the order.
Notes Displays notes regarding the order.

How to search for an integration exception

  1. Select Administration, select Company and then click Integration Exceptions. The Manage Integrations Exceptions page appears. By default, all exception types appear in a list on the page when it loads.
  2. Complete the fields under Search and Filters, and then click Search Search. The search results appear in the Manage Integration Exceptions list.

How to re-extract exceptions

You can perform this task after you fix one or more integration exceptions. See How to fix an integration exception for instructions.

  1. Search for integration exceptions. See How to search for an integration exception for instructions.
  2. Enter a reason for re-extracting the integration exceptions in the Corrective Action Taken or Removal Reason field.
  3. Select the one or more checkboxes next to each integration exception in the Manage Integration Exceptions list. To select all integration exceptions, click the checkbox in the column next to Order ID.
  4. Click Re-Extract Selected or Re-Extract All. The following message appears:

    The exceptions have been re-extracted.