Skip to main content

Inventory API Event Logs

Purpose​

This page guides you on reviewing your inventory jobs and their progress in partner portal.

Key Components​

  • Event Logs: Accessible through the Partner Portal, these logs provide you with end-to-end status updates of you inventory API transactions.
  • Item-Level SKU Failure Reporting: You can now retrieve detailed information about individual SKU failures, enabling targeted troubleshooting.
  • Exhaustive Error Messaging: Updated error messages provide clear reasons for SKU failures and actionable steps for resolution.

Schema​

Field NameTypeDefinitionNew / Exists
operation_idSTRINGUUID to identify jobs sent by the MerchantExists
operation_statusSTRINGHTTP status code indicating the result of the operation (e.g., 200, 400)Exists
messageSTRINGIndicates if job is successful, failed, queued, or errors outExists
detailsSTRINGSKU level information about shared payload to DDNew
success_itemsSTRINGObject containing MSIDs for successful SKUsNew
failed_itemsSTRINGObject containing MSIDs for failed SKUs and their failure reasonsNew
success_items_countSTRINGTotal number of successful SKUs in the jobNew
failed_items_countsSTRINGTotal number of failed SKUs in the jobNew
request_idSTRINGUUID to identify follow-up request from DDNew

Common Error Reasons​

Item Not in Catalog​

The item does not exist in the current catalog. Verify the item has been sent through the Catalog API. If it was sent over 18 days ago, reach out to your DD account owner. If not, it's still in the build pipeline.

Missing Price​

Dropped due to missing price. Verify a price is being sent and trigger another inventory update. The previous job's price will be honored.

Missing Availability Flag​

Dropped due to missing availability flag. Please verify it is being sent and trigger another update.

Invalid Hours Format​

Incorrect item-level hours format. Required format: HH:MM:SS.

Restricted Item​

Item is restricted. Contact your DD account manager if this is a mistake.

Alcohol Sales Not Permitted​

Store is not allowed to sell alcohol. Contact your DD account manager to enable.

Semantic Duplication​

Dropped due to semantic duplication (name, category 1, category 2). Contact DD partnership contact if this is incorrect.

Inactive in Catalog​

Item is inactive. Contact DD partnership contact to reactivate.

Price Change Outside Threshold​

Price change exceeds threshold (100% increase / 70% decrease). Update ignored. Item still available at old price.

High Item Drop Rate​

Too many items dropped (>25%). Check accuracy of SKU count in request.

Invalid Price​

Price is empty, < $0.10, or > $1000.00. Must be corrected.

Weighted Item Conflict​

Weighted Item status conflicts with DD configuration. Contact DD account owner.

Catalog Data Error / Validation Error​

Internal issue with DD catalog data. Contact DD support to resolve.

Low Item Count​

Active item count below 50% threshold of previous successful job. Causes sync error.

Internal Error​

Unexpected error. Try again or contact support.​

Payload Example​

{
  "store_id": "1234567",
  "success_items_count": 101,
  "failed_items_count": 2,
  "request_id": "uuid",
  "details": {
    "success_items": [
      "msid1", "msid2", ...
    ],
    "failed_items": {
      "msid3": ["ErrorCode1"],
      "msid4": ["ErrorCode2", "ErrorCode3"]
    }
  }
}