Shopify guide

Import Shopify orders into RummageRail

A signed-in seller starts each import page. RummageRail reads up to 20 orders at a time and does not import in the background.

Shopify order import is a seller-started workflow in Report a Sale. It does not run automatically in the background, and each batch is saved only after its order details are read successfully.

  1. 01

    Verify read_orders on the connected store

    Open Shopify management and check the current connection. Order import requires Shopify to verify read_orders. If it is missing, the Shopify app owner must enable it and you must reauthorize the store before importing.

  2. 02

    Start with the latest orders

    Open Report a Sale and choose the Shopify import action. Each request reads the latest 20 available orders, newest first. Use the available next-page control to continue in pages of 20. RummageRail does not import new orders or poll Shopify in the background.

  3. 03

    Understand Shopify’s history window

    Shopify normally makes only the latest 60 days of orders available to the app. Older history can be read only if Shopify approves additional order-history access for this app; RummageRail cannot grant that access itself.

  4. 04

    Know the line-item read limit

    RummageRail reads line items in pages of 50, up to 100 pages for each order. If Shopify reports more pages than the implementation can read, or a detail page is incomplete or unreadable, that order batch is not saved.

  5. 05

    Review errors and retry safely

    The import panel reports incomplete or failed reads. RummageRail saves a batch only after it has fetched all available order and line-item details, so an incomplete or unreadable detail leaves that batch unsaved. A failed import leaves earlier imported Shopify results and seller-entered records unchanged. Resolve the reported access or availability issue, then start the import again.

Before you finish

  • Confirm the connected store has a current, verified read_orders scope.
  • Start each page from Report a Sale; each page contains up to 20 orders.
  • Expect a 60-day window unless Shopify approved more history access.
  • If a batch is incomplete or unreadable, use its error result before retrying; the batch was not saved.
Back to Help directory