Support › Orders

The order card and its checks

Short answer

Every paid order is checked before it goes to EJD. If something's wrong, the order is held and nothing is sent. Fix what the order says in Shopify, then select Check again.

The app checks every paid order with EJD items before it can go to EJD. If a check fails, the order is held, tagged EJD-Problem, and nothing is sent until you fix it. There's no "send anyway": EJD can't cancel a purchase order once it arrives.

You can see the checks in two places:

  • On the Shopify order page, in the app's card headed EJD.
  • In the app, under Orders. Held orders are under Needs you. Open one to see every problem.

Clear a held order

  1. Read each problem in the Held box. Each has a How to fix link to the matching section below.
  2. Fix the order in Shopify.
  3. Select Check again, on the card or on the order in the app. The app reads the order from Shopify as it is now.
  4. When every check passes, the order follows your order mode: it waits for you to send it, or sends after your wait.

The app doesn't check again on its own when you edit an order, so select Check again after each fix. It tells you when nothing has changed in Shopify since the last check. Check again isn't offered once an order has gone to EJD, or on sample orders.

Mark handled, don't send

If you dealt with a held order another way (you ordered it from EJD yourself, refunded it, or filled it from your shelf):

  1. Open the order in the app and select Mark handled, don't send.
  2. Confirm. This can't be undone.

The app never sends it, it leaves Needs you, and it shows as Closed with who marked it and when. It's recorded in Activity.

ORDER_INGEST_FAILED

A paid order came in, but something went wrong reading it, so it isn't on the Orders page yet. The alert names the order. Nothing was sent to EJD.

Shopify sends the order to the app again over the next few hours, and the alert clears when it works. If the order still isn't on Orders the next day, contact support with the order number.

ORDER_UNPAID: the order isn't paid yet. Wait for the payment to be captured in Shopify, then select Check again.

ORDER_HIGH_RISK: Shopify recommends cancelling this order because of fraud risk. Review it in Shopify. The app won't send an order while Shopify recommends cancelling it. If you're sure it's genuine, place it with EJD another way.

Not sent to EJD before

ORDER_ALREADY_SENT: this order already went to EJD, or a send started and may have reached EJD. A second purchase order would ship it twice. Open the order in the app and check Progress. For a replacement, create a new order in Shopify.

Placed before order sending was on

Code ORDER_BEFORE_SWITCH. The order was placed before you turned on order sending in the app, or it was waiting to go when order sending was turned off (or your plan changed to Store). If you sent orders another way until then (another app, or by hand), this one may already be at EJD, and EJD can't cancel a purchase order: a second one ships and bills twice.

  1. Look for the order in EJD's portal or your old tool.
  2. If it was sent, select Mark handled, don't send.
  3. If it wasn't, select It wasn't sent to EJD and confirm. The order then goes through the other checks as usual.

Check again doesn't clear this one: only a person who has looked can.

Orders the app never received

If an order was paid while order sending was still off (while you switched from another tool), or Shopify couldn't reach the app for a while, it isn't on Orders. To bring those in:

  1. Open Orders. Under Missed orders, enter the date and time to check from, in your store's time. When switching tools, use when the other tool sent its last order.
  2. Select Check orders placed since. The app reads every paid order placed since then from Shopify, up to 14 days back, and checks each one it doesn't already have, like any new order. Nothing is sent from here.
  3. Orders placed before you turned on order sending are held with ORDER_BEFORE_SWITCH. Check each against the other tool and confirm, as above. The rest wait for review or send, as your order settings say.

Orders already on Orders, and orders with nothing from EJD, are left alone. You can run it again: nothing is added twice.

Units moved to your store

Code ORDER_UNITS_CHANGED. Right before a purchase order goes out, the app checks how many units Shopify still has assigned to EJD's location. If some moved to your store after the order was checked (a shelf check, or a move you made in Shopify), those units must not go to EJD as well, so the app sends only what's left. The order is held with this code when Shopify can't be read at that moment, or the units still don't match the order's lines. Nothing was sent.

Code SHELF_CHECK_UNREAD. You answered a shelf check, but the order couldn't be read from Shopify afterwards, so the app can't be sure what's left for EJD. Nothing was sent.

For either one, open the order and select Check again. Once Shopify can be read, the order goes on with the right quantities.

Something on the order ships from EJD

ORDER_NON_EJD_LINES: nothing on this order ships from EJD, so there's nothing to send. This happens when every line is store-only, self-managed, not an EJD item, or filled from your store's shelf. Fulfill the order yourself.

You only see this on an order the app already had, after Check again (for example, you edited the EJD items off it, or moved them to your store). A new order with nothing from EJD on it isn't listed on Orders at all. Find it in Shopify's own order list.

On an order that also has EJD items, lines like these aren't a problem. They're left off the purchase order and listed under Left off on the card, with the reason.

Quantities are full cases

ORDER_NOT_FULL_CASE: for example, 5 ordered where EJD sells cases of 12. EJD never breaks a case. With the customer's agreement, edit the order to a full case, then select Check again.

EJD shows enough stock

ORDER_LOW_STOCK: the stock the app last wrote for this item is less than the quantity ordered. Wait for the next stock update from EJD and select Check again, or contact the customer.

This check is skipped when When an item runs out on Stock is set to Keep selling.

Within EJD's order limit

ORDER_OVER_ALLOCATION: EJD limits some items to a set number per order for a time, often a hot seller or one in short supply. The product page shows the limit under EJD order limit. EJD wouldn't ship more than the limit, so the order waits for you.

  1. Contact the customer.
  2. Edit the order down to the limit and select Check again, or fill the rest yourself.

If you split it into a second order later, check with EJD first: the limit may count all your orders in that time.

Shipping method has an EJD code

ORDER_UNMAPPED_SHIPPING: the order's shipping method, such as "Saturday delivery", has no EJD code.

  1. Open Settings > Orders. Under Shipping methods, pick the method under Shopify shipping method.
  2. Under EJD code, pick GR (ground), 2D (two-day) or ND (next day).
  3. Select Save code.
  4. Open the order and select Check again.

You don't have to wait for an order to find out. Every morning the app reads the shipping methods in your checkout, and if one has no EJD code you get an alert the same day, before any order uses it. It clears as soon as you save a code.

Name and address fit EJD's rules

ORDER_ADDRESS_FORMAT: part of the shipping name or address doesn't fit what EJD accepts. The message says which part. For example:

  • An address line over 55 characters, or a city over 30.
  • A state that isn't a 2-letter code.
  • A missing address line, city, state, ZIP code or country.
  • A character EJD's format can't carry, such as *, ~, > or an emoji.

Edit the shipping address in Shopify, then select Check again.

ORDER_ITEM_NAME: an item on the order can't go on a purchase order as it is. For example, its UPC is missing or isn't all digits, or EJD's file has no cost for it. It's also used when the order number has characters EJD's file names don't allow (only letters, digits and dashes work, so check the order number prefix and suffix in Shopify's settings). The message says what's wrong. Fix it, then select Check again.

Lines filled from your store's shelf

With store stock in use (Shopify POS included), Shopify decides which location fills each part of an order. Only the units it assigns to EJD's location go on the purchase order. Units assigned to your store, or already fulfilled, come off your shelf. They're left off the purchase order and listed as "Filled from your store's shelf".

ORDER_LOCATION_UNKNOWN: the app couldn't read which location fills the order. It held the order rather than risk EJD shipping what your store already handed over. Select Check again in a minute.

Allowed in the ship-to state

ORDER_STATE_RESTRICTED: EJD's state restriction report says an item on the order can't be sold or shipped to the state the order ships to, for example a stain over California's VOC limit going to CA. The message names the item and the state. Shopify's checkout doesn't stop these orders on its own, so the app holds them. See Restricted states.

  1. Contact the customer. Cancel or refund the restricted item in Shopify, then select Check again.
  2. If you're sure the sale is allowed (EJD's report is out of date for this item, say), fill it another way and select Mark handled, don't send. Tell support too, so the item can be checked with EJD.

The same code with "Couldn't read EJD's state restriction report" means the app couldn't check, so it held the order rather than guess. Select Check again in a few minutes.

Only lines going to EJD are checked. Self-managed and store-only items you ship yourself aren't, so check those yourself.

Ground-only items go by ground

ORDER_GROUND_ONLY: the order asks for two-day or next-day shipping, and an item on it ships by ground only (hazardous, for example). Carriers won't fly these. The message names the item and the service the order asked for. The app holds the order rather than send it by ground on its own, because the customer paid for faster shipping.

  1. Contact the customer. If they're happy with ground, change the order's shipping to a ground method in Shopify (and refund the difference), then select Check again.
  2. Or remove or refund the item, then select Check again.

The same code with "Couldn't read EJD's item data" means the app couldn't check, so it held the order rather than guess. Select Check again in a few minutes.

To stop these orders at checkout, keep ground-only items on a shipping profile that only offers ground rates.

You're authorized for each brand

ORDER_BRAND_NOT_AUTHORIZED: the item's brand needs dealer authorization from EJD, and your store has no confirmed authorization for it. You can't confirm a brand yourself in the app yet.

  • If EJD has authorized you, contact support to record it, then select Check again.
  • Otherwise, remove the item from the order with the customer's agreement.

Other reasons an order isn't sent

These hold an order too, but aren't about the order itself. Each has its own article:

Technical details

Show the exact rules, for the technically minded

When checks run. When a paid order arrives, when you select Check again, and again just before the purchase order (850) is sent. An order counts as paid when Shopify's payment status is paid or partially refunded. Refunded or removed units never go to EJD.

High risk. Shopify's fraud analysis recommends cancelling the order.

Already sent. The order has a send time, or a send started (an EDI control number was used).

Stock. The quantity ordered is compared with the last quantity the app wrote for the item, in the listing's unit (cases for a case listing). Skipped for self-managed items and when the store keeps selling at 0.

Full cases. Units ordered, in single units, must be a multiple of EJD's order multiple. A case listing orders whole cases, so it only fails if the listing's case no longer matches EJD's.

Order limit. Units ordered (in single units) above EJD's per-order cap, while the cap is in effect on the order date.

Shipping codes. Method names are matched ignoring capital letters and extra spaces. EJD accepts only GR, 2D and ND. The daily check runs at 6:30 AM Central.

Name and address limits (from EJD's 850 map): name or company up to 60 characters (first name 55, last name 60), each address line up to 55, city 2 to 30, state exactly 2, ZIP 3 to 15, country 2 or 3. Accented letters and curly quotes in the name and address are converted to plain ones first (José becomes Jose), so they don't hold an order. What's left must be plain printable ASCII, and can't contain *, ~ or >, which EDI uses to separate fields. No leading or trailing spaces.

Phone. The ship-to phone goes on the purchase order as digits only, in a PER*DC*ST*TE segment: a US number's leading 1 and any extension are dropped, so +1 (217) 555-0100 x12 goes as 2175550100. An order with no phone goes without one; that doesn't hold it. The customer's email never goes to EJD.

Item lines. Each line needs EJD's item number (up to 48 characters) and a UPC that's all digits (up to 48). The item name goes in the PID segment, cut to its first 80 characters, so a long name never holds an order. Item names are made plain like addresses, so a name never holds an order: curly quotes become straight, ™ ® © are dropped, ° becomes "deg", accents are removed, and EJD's separator characters become spaces. Quantity goes in single units (EA); a case listing's cases are multiplied out. Cost is your EJD cost per unit.

PO number. Your Shopify order number without the #, up to 22 characters.

Ground-only items. An item ships by ground only when EJD marks it hazardous (the product's Hazardous field, custom.hazardous_flag), or EJD's restrictions file says Ground Ship Only (Shipping notes, custom.shipping_notes), or the restrictions file has no shipping note for it and EJD's feed marks it ground only. Ground orders never need this check.

Order note. The customer's order note isn't sent: EJD doesn't accept one.

Related

Still stuck? Open Help and support inside the app to ask about your own store or write to a person.