Skip to content

Troubleshooting

What to check when something doesn't sync, what the messages mean, and how to fix them.

Start with Store check: it shows whether the store is set up correctly and lists recent errors.

Where problems show up

A record that fails is held with its reason, so you can fix it and retry. Other records keep syncing.

Store records inbox and outbox

  • Store records inbox lists every record that came from the store: orders, customers, products and payments.
  • Store records outbox lists every Business Central record on its way to the store.

Each row has a Status and, when it failed, What went wrong.

Status in the inbox Status in the outbox What it means
Waiting Waiting to sync Queued
In progress Sending, or Waiting for the store Being processed
Done Synced Finished
Will try again Will try again It failed and is retried automatically
Needs attention Needs attention It failed after its retries. Fix the cause, then choose Retry now.
Cancelled Cancelled Someone cancelled it. A cancelled outbox record syncs again when it next changes.

Choose Show records that need attention to see only the failures. Show synced record opens the Business Central record. Show technical details shows more about the failure; i95Dev support may ask you for it.

Store orders

The Store orders page lists store orders and the sales orders you sent to a store. Look for Failed or Missing information in Sync status, and read Error to see what to fix.

Sync runs

Sync runs lists each background sync run and what it did. Synced records shows the result for each record. To open it, choose Sync runs on the store's Store sync settings, or choose the Last synced value.

i95Dev Connect sync log

The i95Dev Connect sync log shows what i95Dev Cloud did with each record: status, store, record type, direction and message. Use Retry, Load more and Refresh.

Sync dashboard

The i95Dev Connect sync dashboard shows totals, for example "{n} records need your attention. Review them below." Choose a total to see the records.

The Role Center also notifies you: "Records that couldn't sync today: {n}. Review them, fix the problem and retry."

Retry a record

  1. Open the Store records inbox or Store records outbox.
  2. Choose Show records that need attention.
  3. Read What went wrong and fix the cause in Business Central or in the store.
  4. Select the row and choose Retry now.

If you don't need the record, choose Cancel.

Orders created in Business Central

The order doesn't go to the store

A sales order you create in Business Central goes to a store only after you choose the store for it:

  1. Open the sales order.
  2. Choose Online store > Sync with ... (or Sync with online stores).
  3. Switch on the store and choose OK.

Releasing the order doesn't send it.

"This sales order has no shipping method"

The full message is "This sales order has no shipping method, so the store can't accept it. Choose a shipping agent (with its service) or a shipment method on the order; it syncs once you save the change."

The order is held on the Store orders page with the status Missing information.

  1. On the sales order, choose a Shipping agent and Shipping agent service, or a Shipment method.
  2. Save the order. It's sent on the next sync.

"This sales order has no payment method"

The full message is "This sales order has no payment method, so the store can't accept it. Choose a payment method on the order; it syncs once you save the change."

Choose a Payment method on the sales order and save it. The order is sent on the next sync.

An order with no lines is held the same way: "This sales order has no lines, so it can't sync. Add at least one line."

"Shipping method is missing"

The store refused the order because it got no shipping method. Shopify says "Shipping Method Missing".

  1. On the sales order, choose a Shipping agent (with its service) or a Shipment method, and save. The order is sent again.
  2. If the field is already filled in, check that Methods sent to the store has a row for it (see below), then choose Retry now on the Store records outbox.

"Payment method not available"

Shopify refused the order because it has no payment gateway for the order's payment method. The message reads "Payment method not availble. Please configure the Payment method in i95Dev Cloud".

You fix this in Business Central, not in i95Dev Cloud:

  1. Open the store's Store sync settings and choose Methods sent to the store.
  2. Add a Payment row for the order's payment method.
  3. In Store method, type the Shopify payment gateway name exactly, such as manual or Cash on Delivery (COD).
  4. Choose Retry now on the Store records outbox.

Adobe Commerce refuses the shipping or payment method

Adobe Commerce needs its own codes. Without a row on Methods sent to the store, the order is sent with the Business Central code in lower case, such as ups-ground, which Adobe Commerce doesn't know.

  1. Open Methods sent to the store from the store's Store sync settings.
  2. Add a Shipping row for the shipping agent (and service) or shipment method, with the carrier and method code, such as flatrate_flatrate.
  3. Add a Payment row for the payment method, with the payment code, such as checkmo.
  4. Choose Retry now on the Store records outbox.

See Methods sent to the store.

The store refused an order

When the store refuses an order, its status is Failed. If you change its payment method, shipping agent, service or shipment method and save the order, it's sent again. For any other fix, choose Retry now on the Store records outbox. The Store orders page has no retry action.

Stock isn't updating in the store

The stock sent to the store is the inventory at the store's Default location plus stock posted without a location, minus open sales orders. It's never below 0. Stock at other locations doesn't count.

If stock doesn't update:

  1. Check that Inventory is switched on in What syncs on the store's Store sync settings.
  2. Check that the item is switched on for the store (Online store > Sync with ... on the item).
  3. Check where the stock was posted. Stock at a location other than the Default location isn't sent.
  4. Open the Store records outbox and look for an Inventory row for the item. If it failed, fix the cause and choose Retry now.

To send an item's current stock again, choose Online store > Sync with ... on the item and confirm its stores.

Stock across multiple warehouses isn't supported at launch.

A customer or item doesn't reach a store, or reaches the wrong one

Changes to a customer or item go only to the stores the record is switched on for. To check or change them, choose Online store > Sync with ... on the record.

  • If a store is switched off, the record's changes don't reach it. Switching a store off doesn't delete anything in the store; remove the record there yourself if it shouldn't be there.
  • A customer or item that came from a store keeps syncing with that store. To stop it, open the dialog and choose OK with the store switched off.

Adding records to a store

Each record type must be switched on in What syncs before records of that type can go to a store. See Choose stores.

Message What to do
Before item {no.} can sync with a store, give it a description. Fill in the item's Description, then try again.
Item {no.} can't be added to a store because Available online is turned off. Turn on Available online for the item, then try again.
Products aren't set up to sync from Business Central to this store. Switch on products in What syncs on the store sync settings.
Syncing products from Business Central to this store is turned off. Same as above.
No store is connected to this company yet. Connect a store from i95Dev Connect stores > Add store.

Store check failures

What you see What to do
Setup failed, or the store Needs attention Open Store check, fix the cause it names, then choose Retry on the stores page.
The store rejected the store details Check the details in your store's admin, then choose Enter store details on the stores page and enter them again.
The subscription has expired or is switched off Contact i95Dev support.
"This check isn't available yet." Try again later, or contact i95Dev support.
Nothing comes from the store Check that background sync is running, and see the store side check in Store check.

Orders from the store

Message What to do
Item {no.} on this order doesn't exist in Business Central. Create the item or correct the SKU in the store, then sync the order again. Create the item, or fix the SKU in the store. Then choose Retry now. Other orders still come in.
No customer with email {e-mail} or store ID {id} exists in Business Central. The order arrived before its customer. If the customer is still syncing, wait and choose Retry now. Otherwise create a customer with that e-mail address, then Retry now, or Cancel the order.
The customer on this order couldn't be found or created in Business Central. Check the customer in the store, then choose Retry now.
This guest order couldn't be created because no guest customer is set. Choose a Guest customer no. on the store sync settings, then Retry now.
No number series for sales orders is set for store {store}. Fill in Sales order nos. on the store sync settings, then Retry now.
The store charged tax on this order, and no Sales tax liability account is set, so the order wasn't created. Choose a Sales tax liability account on the store sync settings. Held orders are tried again straight away.
Line '{line}' on this order isn't an item (it's a tip, fee, custom item or gift card), and no G/L account is set for such lines, so the order wasn't created. Choose a Non-item line G/L account on the store sync settings, then Retry now.
This order from the store has no lines, so it wasn't created. Check the order in the store.
A sales order for store order {no.} already exists, or the order was already shipped or invoiced. Nothing: the order is already in Business Central. Cancel the row if you like.
The store sent '{value}' for {field}, which is longer than the {n} characters Business Central allows, so the record couldn't sync. Shorten the value in the store, then Retry now. Business Central never cuts values short.

Shipping and payment methods on store orders

A store method that isn't matched doesn't stop the order. The order comes in without that shipping agent or payment method, and the method is listed on Shipping and payment methods with the status To match.

  1. Open the store's Store sync settings and choose Shipping and payment methods.
  2. Choose Show methods to match.
  3. Match each method to a shipping agent (and service) or payment method.

Orders that come in later get the method. Orders that already came in aren't changed; fill in the method on them yourself.

Variants on store orders

Message What to do
SKU {sku} couldn't be matched to an item and variant. Check that it follows the variant pattern in the store sync settings. Fix the SKU in the store, or the variant settings.
Item {no.} doesn't exist in Business Central, so this order line couldn't be matched to an item. Create the item, then sync the order again.
Variant {code} doesn't exist for item {no.} in Business Central. Create the variant, then sync the order again.
The variant SKU points to item {no.}, but the order line is for item {no.}. Correct the SKU in the store.
No variant pattern is set for variants with {n} attributes, so the variant can't be read. Fill in the variant pattern on the store sync settings.

Customers and products from the store

Message What to do
The product '{name}' with store ID {id} came without a SKU, so it wasn't created. Add a SKU to the product in the store.
The customer with store ID {id} came without an e-mail address or a name that Business Central can read, so it wasn't created. Contact i95Dev support.
Business Central can't process {record type} from the store yet. Contact i95Dev support to switch on this record type.
Processing this record stopped before it finished, for example because the sync run timed out. It's tried again automatically. Nothing
This customer, product, sales order or payment couldn't be created or updated, and Business Central gave no reason. Choose Retry now. If it fails again, contact i95Dev support with the technical details.

Records to the store

Message What to do
This record couldn't sync to the store after {n} tries: {reason} Fix the cause, then choose Retry now in the Store records outbox. Fix the cause shown, then choose Retry now.
Sending this record stopped before the store answered, for example because the sync run was stopped. It's sent again automatically. Nothing
Cancelled in the Store records outbox. The record syncs again when it changes. Nothing
This item (or customer, sales order, shipment, invoice) no longer exists in Business Central, so it can't sync. Nothing. Cancel the row.
The store this order is assigned to no longer exists, so it can't sync. Assign the order to a store again. Choose Online store > Sync with ... on the order and choose a store.
Item {no.} has variants, but no variant SKU pattern is set for variants with {n} attribute(s). Fill in the variant pattern on the store sync settings. See Variants.

Background sync

Message What to do
Before you switch on syncing, fill in: {fields}. Fill in the named fields on the store sync settings, or choose Fill in defaults.
Syncing is on, but some records may not sync until you fill in: {fields}. Same. The store keeps syncing in the meantime.
Background sync couldn't start because you don't have permission to schedule background tasks. Ask an administrator with permission to schedule job queue entries to switch on the store, or to choose Start background sync on the store sync settings.
Stopped because of an error. Choose the value to see what went wrong. Choose the Background sync value on the store sync settings, fix the cause, then choose Start background sync.
{step} stopped with an error: {reason} The next sync run tries again. Usually nothing. If it repeats, fix the cause shown.
Background sync isn't set up yet. Turn on a store to start it. Switch on Sync on for a store.
Sync is paused: it runs as {user}, who doesn't hold an i95Dev Connect plan license. In the Microsoft 365 admin center, assign your i95Dev Connect licence to that user. Or sign in as the user who holds it and choose Run sync as me.
This needs an i95Dev Connect plan license, and you don't hold one. Ask your administrator to assign you an i95Dev Connect licence in the Microsoft 365 admin center.
Syncing for {store} is paused: i95Dev Cloud has turned off its connection, usually because a trial ended. Choose a plan (see Plans and trial), or contact i95Dev support.
You can't delete {store} because some records are still syncing with the store. Wait until they finish, then try again.
No store is set up yet, so nothing can sync. Connect a store.

Connection and sign-in

Message What to do
i95Dev Connect couldn't be reached. Check your internet connection and try again. Try again. If it keeps happening, wait a few minutes.
Something went wrong in i95Dev Connect (error {n}). Try again in a few minutes. Try again later. If it keeps happening, contact i95Dev support.
To use i95Dev Connect, an administrator must agree to the i95Dev Cloud privacy notice. Choose Agree, or ask an administrator to approve it on the Privacy Notices page.
Access for i95Dev Connect can only be granted in Business Central online. Use Business Central online. On-premises isn't supported.
Store {store} isn't connected yet, so it can't sync. Finish connecting the store on the i95Dev Connect stores page.
Store {store} isn't signed in, the sign-in has expired, or Business Central couldn't sign in to it. Connect the store again, then sync.
Business Central couldn't sign in to the store because there was no answer. Try again in a few minutes. If it keeps happening, connect the store again.
The service address must start with https://. Enter the address that i95Dev support gave you.

Sign-up and sign-in messages

Message What to do
That code isn't right. Check the latest e-mail from i95Dev and try again. Enter the code from the latest e-mail. If you have no tries left, choose Start again.
This code has expired or was already used. Choose Start again to get a new code.
This code request is no longer valid. Choose Start again to get a new code.
Too many wrong codes, so this code no longer works. Wait a few minutes, then choose Start again.
Too many tries in a short time. Wait, then try again later. This can take up to an hour.
Use your work e-mail address. Free and disposable e-mail addresses can't be used to sign up. Use your work e-mail address.
Use a work e-mail address from your organization's Microsoft 365 domain, the one your Business Central belongs to. Use an address from that domain. If you're signing up on a customer's behalf, contact i95Dev support.
We couldn't check your organization with Microsoft just now. Wait a few minutes, then try again.
Your organization already has an i95Dev Connect account. Choose Start again, then I already have an account, to sign in.
Your organization has already used its free trial. Sign in to your existing account, or choose I want to buy a paid plan.
Sign-up isn't open for your organization yet. Contact i95Dev to get access.
This i95Dev Connect account is suspended. Contact i95Dev support.

No code? Check your junk mail folder. When you sign in, the code is sent only if the address belongs to your organization's account; if nothing arrives after a few minutes, check the address, or sign up instead.

Changes the sync missed

Changes the sync missed lists Business Central changes that i95Dev Connect couldn't note when they happened, for example because of missing permissions. The change itself was saved in Business Central.

Message What to do
The change couldn't be picked up, and Business Central gave no reason. Choose Try again now. If it keeps failing, contact i95Dev support.
{record} was deleted in Business Central, but the store couldn't be told. Disable or remove the record in the store yourself, then choose Dismiss.

Still stuck?

Contact i95Dev support. Include the store name, the record, the message, and the Show technical details text from the inbox or outbox. See Support.