Marketplace Connector

Shopify: Monitoring Errors, Warnings and Integration Activities

Introduction

The Shopify™ Integration Log can be used to view the integrations history, including errors, warnings, and integration activities. You can filter, export, or refresh the log. This article provides instructions for accessing and using the Integration Log, explains the various integration headers, and describes common Shopify errors and their solutions.


Shopify Integration Log

To display the Shopify Integration Log:

  1. Go to Settings > eCommerce Integrations > eCommerce Integrations.

  2. Click the Shopify line item to display the setup page for Shopify integrations.

  3. Scroll to the Integration Log (bottom of page).



    Please reference the image above:

    • The check boxes in the first column can be used to select items for export.

    • Each integration item is assigned an ID (second column).

    • The entry in the Level (third) column identifies the integration activity as Info, an Error, or a Warning.

    • To refresh the table, click the Refresh Table button (highlighted in the image, above). The refreshed grid shows any activity that occurred after you displayed the table, which can be useful while testing or troubleshooting.

    • Click any entry in the line item to display the corresponding Log. The Log includes the entire Request code and Response code, which may be useful in troubleshooting. (The first parts of the Request and Response codes are displayed in the grid.)


See also Filtering the Integration Log and Exporting the Integration Log.


Integration Headers (Columns)

The Integration Log includes these columns:

  • Check boxes (first column): Used to select Integration Log items for export. The select all check box is at the top of the column.

  • ID (second column): A unique ID of the integration item

  • Level: Indicates a Warning (one-time issue), an Error (most common to review), or integration Info

  • Integration Process: Part of the process where the error occurred

  • Integration Entity Type: Used only by development

  • Integration Entity ID: ID of the issue from other software; it is often a hyperlink to the source issue

  • Internal Entity Type: The process in Descartes® Marketplace Connector affected by the issue

  • Internal Entity ID: Internal ID of the Entity Type; it is often a hyperlink

  • Integration Message: Captured error message

  • Internal Message: Error produced by Descartes Marketplace Connector

  • Request: Information sent to the entity (may be blank)

  • Response: Information received in return (may be blank)

  • Created Date: First occurrence of the specific error

  • Modified Date: Last occurrence of the error


Filtering the Integration Log

To filter the Integration Log using various criteria:

  1. Click the Filter button (highlighted in the image, above) to display a search field at the top of each column. (The search fields are displayed in the image, above.)

  2. To filter the list by Info, Warning, or Error, select the item in the Level dropdown.

  3. To filter the list by specific text, enter text into a search field, and then press Enter. For example, enter RETRIEVE into the Integration Process search field.

  4. As needed, filter the list further by repeating the previous step for another column.


Exporting the Integration Log

To export all or part of the Integration Log:

  1. Do one of the following:

    • To export the entire list: 1) Check the "select all" check box (top of the first column); 2) Remove any text from the search fields; 3) On the Level dropdown, select the blank item.

    • To export part of the list, filter the Integration Log and/or check some of the check boxes in the first column.

  2. To include the exact total in the CSV file, select Get Exact Total (above or below the grid at far right).

  3. Click the CSV Export button (highlighted in the image above) to generate a spreadsheet containing the data.

  4. Choose to open or save the spreadsheet file.

Shopify Errors

Note: See also Peoplevox and Pixi Errors.


  • SKU Change Cross-Reference Issue: If a product's SKU is changed in Shopify and not updated within 30 minutes, search for the SKU, delete the cross-reference, and then re-add the product manually.

    The SKU for the variant has been changed. However, there are several cross-references associated with its product within ZIM. Import skipped.


  • HTTP Status Code: 404: Descartes Marketplace Connector cannot find the item in Shopify. Delete the cross-reference and re-import the product. Ensure the product still exists in Shopify.

    HTTP Status Code: 404, {"errors":"Not Found"}


  • No Fulfillment Order: The order was likely closed in Shopify before the integration closed it.

    There is no fulfillment order. Skipping fulfillment.


  • Inventory Decrement Issue: Shopify does not have enough inventory to fulfill the order. This issue typically resolves itself.

    There are more picked quantities left than we can fulfill on Shopify.


  • Active Cross-Reference Error: SKU likely changed or duplicate product added in Shopify. Delete the cross-reference and re-import the product.

    There is already an active cross-reference for this integration and SKU (TPGC11333-CFB). Skipping variant.


  • Custom Product Order Line Item: Descartes Marketplace Connector does not process custom items from Shopify.

    Order Line Item skipped. Fulfillment order 6836599717951 has a custom product (Happy Father's Day Text Greeting Card - default).


  • Error Fetching HTTP Headers: Verify integration is working. This is usually a non-issue.

    Error Fetching http headers #0 [internal function]: SoapClient->__doRequest(' __soapCall('Authenticate', Array) #2 /


Back to Top