HomeSolutionsAboutDocumentation

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.