Find the right troubleshooting guide
Find what you see in the table for your area, do the first check, then open the guide for the full fix.
Choose the symptom
Setup, stock and Shopify updates
| What you see | First check | Guide |
|---|---|---|
| An amber, red or grey dot in System health on Home | Select the dot's label to open its details. | Preparation and sync problems |
| Preparing your Shopify data stays on Home, or a row says Needs attention | Choose View preparation details and read the current run. | Preparation and sync problems |
| Open Zapstra Inventory Management from your Shopify admin | Choose Open Shopify admin, then open the app from Apps. | Preparation and sync problems |
| Stock changed in Zapstra but not in Shopify | Check the shop is Managed in Zapstra with Updates to Shopify: On, and the location is Managed. | Preparation and sync problems |
| "{location} isn't managed in Zapstra" when receiving or adjusting | Check the location's choice on Locations. | Locations and stock pools |
| Your Shopify stock is not being updated on the setup checklist | Choose Review inventory setup. | Start managing inventory in Zapstra |
| Products are left out when you start managing a shop | Open the list on Inventory management and fix each reason. | Start managing inventory in Zapstra |
| A stock change was made directly in Shopify | Open Changes made in Shopify and Accept or Reject it. | Reconciliation and activity |
| An item in Items to set up says Couldn't save | Read the reason on the row. | Prepare and verify opening inventory |
| A quantity is blank, unknown or unavailable | Confirm the material and location, then refresh. Don't enter zero to clear it. | Stock quantities |
| Stores show different stock for the same warehouse | Check material matching and whether the locations share a pool. | Locations and stock pools |
| An Unreconciled badge on a product | Confirm the count across all bins, or record the receipt. | Stock quantities |
Planning and imports
| What you see | First check | Guide |
|---|---|---|
| An order-plan row can't be applied | Read the material, source, destination, currency and quantity warnings. | Review and apply a plan |
| Preview & apply is disabled | At least one Working sheet row needs a quantity and a location. | Order plan |
| No eligible supplier on a replenishment row | Check the supplier link, sourcing for that location and Maximum supplier lead time (days). | Replenishment suggestions |
| A supplier group can't create a purchase order until its minimum is met | Add items, or change the supplier's minimum order value setting. | Review and apply a plan |
| A spreadsheet import has errors | Open the run and read each row's result. | Data Exchange |
| An import seems stuck after a timeout | Reopen it from Recent imports. | Data Exchange |
| An imported purchase order shows Still in Shopify | Close it in the old tool, then select Done again. | Import open purchase orders |
Purchase orders and receiving
| What you see | First check | Guide |
|---|---|---|
| A purchase order can't be sent | Check its destination address, line currency and required-by date. | Send and manage orders |
| Your supplier may not have received the latest email | Check the email entry on the order's timeline and the supplier's address. | Send and manage orders |
| An order is missing from the purchase order list | Turn on Show cancelled and closed, or clear the view or search. | Send and manage orders |
| A supplier says the order link doesn't work | Check whether Replace access link was used, and share the current link. | Supplier Portal |
| A supplier proposed different quantities, prices or dates | Review the proposal before accepting. | Supplier changes |
| Shipment needs attention on a purchase order | Select View shipments and read the shipment's tracking. | Shipments |
| A shipment shows delivered, but stock hasn't gone up | Check whether a receipt was completed. | Receive stock |
| Receive items is disabled with Not managed in Zapstra | The order's destination isn't managed in Zapstra. Check Locations. | Receive stock |
| The supplier committed units but never shipped them | Open the Reconciliation tab and choose Dispute on that line, or close the order short. | Receive stock |
| A completed receipt has the wrong quantity | Open the receipt and choose Correct or Reverse. | Receive stock |
| Goods arrived damaged or wrong | Reject them when you receive, then review the dispute. | Disputes and replacements |
| Fewer units arrived than expected | Receive what arrived, then dispute the rest or close the order short. | Receive stock |
| An invoice can't be approved | Compare its currency and charges with the purchase order. | Invoices and credits |
Warehouse and production
| What you see | First check | Guide |
|---|---|---|
| A transfer can't be approved, picked or received | Find which stage is blocked and open that request or task. | Transfer requests and Execute transfers |
| A transfer shows the Review tag | Choose More → View sync details. | Ship and receive transfers |
| Mark fulfilled is unavailable (Pick these items first) | Pick the remaining lines. | Pick and fulfill orders |
| Production was released but didn't start | Reopen the production order. | Production planning |
| Completing production with scrap is refused | Choose a Scrap reason. | Production execution |
| A build is applying, or its result is unclear | Check the original order before trying again. | Production execution |
Stock Scan
| What you see | First check | Guide |
|---|---|---|
| A phone can't activate, or the code isn't available | The code expired or was replaced. Send a new one from Team & devices. | Activate Stock Scan |
| All devices on your plan are in use | Cancel unused pending activations, remove old devices, or add device slots. | Manage Stock Scan devices |
| A location isn't offered when adding a device | Check that the location is managed in Zapstra. | Manage Stock Scan devices |
| A Stock Scan device has pending or rejected work | Check the captured work and its result before redoing it on the web. | Stock Scan recovery |
| Sign out with unsent work? | Don't sign out. Reconnect and let the work send. | Stock Scan recovery |
| The phone can't mark an order fulfilled or buy a label | Check that every item is picked, Shopify Shipping is set up and the order isn't on hold. | Pick orders with Stock Scan |
Billing and access
| What you see | First check | Guide |
|---|---|---|
| Your approved spending cap has been reached. | Raise the usage limit from the banner or Adjust plan. | Manage billing |
| You've used all 25 Control events for this calendar month. | Choose a paid plan. Sync and viewing keep working. | Manage billing |
| A message says your allowance, capacity or billing is unavailable | Open Billing and check its current state. | Plans and capacity |
| A teammate is missing from your users | Check that they have access to the app in Shopify admin and have opened it. | Users and permissions |
| A button is missing or disabled | Check the record's status, your access and any reason shown beside it. | Users and permissions |
Before you retry
- The screen timed out or showed no confirmation. Reopen the original record and check its status and history first. The action may have finished.
- It succeeded, but a follow-up step failed. Do only the follow-up, such as Start syncing. Don't repeat the original action.
- The screen refused the action. Fix the stated cause, then retry the same action. If the app offers a specific retry, use it.
Comparing two numbers? Make sure they're for the same material, location, unit and stage. See the Glossary and Status reference.
Still stuck? Get help with the record number, the time and the exact message.