Skip to main content

Handling Historical Orders

Most stores already have orders in Shopify from before they started using Digital Content Manager. The app handles these historical orders more cautiously, because it has no history for them. An order or line item is historical if it was:

  • Created before you installed the app. The app records the date your store installed it.
  • Placed before its product went live, the first time you enabled it, even on an order the app processed. Another app may have processed it.
  • Imported from a CSV file, whatever its date.

Why they're handled differently​

There is a bunch of subtle issues we want to avoid. For example...

  • Wasting keys. Automatically assigning keys to historical orders would pull keys from your inventory for orders that may already have been fulfilled some other way.
  • Restocking used keys. The app can't know whether a key on a historical order was already revealed or used, so restocking it could send a used key to a new customer.

What the app won't do automatically​

For historical orders, the app will not automatically:

  • Create the order. Daily order reconciliation, manual syncs, and Shopify events such as an order being paid or refunded won't add orders created before you installed the app, or line items placed before their product went live.
  • Assign license keys, even if the quantity in Shopify is higher than the number of keys on the order.
  • Restock license keys. Keys imported on historical line items are never put back in your inventory. This applies to returns, refunds and chargebacks, even with your restock settings turned on. This is because we cannot tell if the key was revealed or not.

Importing historical orders​

To manage these orders in the app, import them from a CSV file, with any license keys and content the customers were already given. Nothing comes from your stock: an order imported without keys stays without them. Edit the order to add them yourself.

After an order is imported​

Imported orders stay in sync with Shopify like any other order, with the license key restrictions above. Reconciliation still:

  • syncs order name, date and customer changes,
  • syncs returned line items, and
  • marks license keys as returned when the quantity in Shopify goes down, for example after a refund. The keys are returned, not restocked.

New line items on an old order​

If a line item is added in Shopify to an order from before the app was installed, that new line item is assigned license keys from your inventory, the same as a new order. On an order imported from a CSV file, it isn't: the app it came from processed it.

Because this uses keys from your inventory, the app raises a warning alert, License keys assigned to an order from before the app was installed, so you can confirm the change was expected. See Alerts & Notifications.