Understanding Inbox Flags in Webgility i
This article helps Webgility i users understand flags in the Inbox: what each flag means and what to do about it.
When an order or refund cannot post, Webgility i files it under a flag that names the reason. One flag covers every order with the same cause, so one fix clears them all. Each flag has a row of its own in the Inbox, and its orders are on the Errors tab of the Orders page, where their Status reads Needs fix or Error.
Steps:
- Go to Inbox. Each flag is a row that names the problem, such as "A product isn't mapped to a QuickBooks item", with more detail under it.

- Click the flag's title to open it. The panel shows the kind of flag, Order flag or Connection flag, what happened, and when it was Detected and for which Sales channel.

- Click Review in the Action column to open the Errors tab of Sales > Orders, narrowed to that sales channel and to orders that need a fix or have an error. Click Fix error or Map product in an order's row to see the fix in the order's own words. See How to Find and Fix Errored Orders.

- Make the fix the flag names. The button at the bottom of the panel, for example Change closing date or Activate the customer in QuickBooks, takes you to the flag's orders on the Errors tab. It does not make the change for you: make it in QuickBooks Online or in Channel settings, as each flag below describes.
- Open the flag in the Inbox again and click Retry. The orders go back to QuickBooks Online the next time Webgility i posts that sales channel's orders automatically, and the Inbox shows, for example, "3 transactions go back to QuickBooks on the next run." If automatic posting is off for the sales channel, or to post the orders now, tick them on the Errors tab and click Post to QuickBooks.

Note: For flags you fix yourself, Webgility i also checks the orders again once a day, and when you save a change on the Workflows page for that sales channel. The flag leaves the Inbox when none of its orders is waiting any more.
Flags about products
- "A product isn't mapped to a QuickBooks item": a product on the order has no QuickBooks Online item. Map the product on the Catalog page, or ignore the order.
- "A product match needs your confirmation": Webgility i found a possible match for a product but is not sure of it. Confirm the right product on the Needs review tab of the Catalog page.
- "The mapped QuickBooks item is inactive": make the item active in QuickBooks Online, or map the product to another item. See How to Make an Inactive Item Active in QuickBooks Online.
- "Waiting for the channel's listing to sync": the product has not arrived from the sales channel yet. Nothing to do. Webgility i tries again on its own.
- "The QuickBooks item is being created": Webgility i is creating the item in QuickBooks Online. Nothing to do. Contact support if the flag stays.
Flags about settings
- "An account the document needs is not set": choose the account in Channel settings.
- "Accounting setup is incomplete": a setting the order needs, such as a tax code or the customer to post to, is not chosen. Open the order to see which, and finish it in Channel settings.
- "A QuickBooks item picked in settings is inactive": make the item active in QuickBooks Online, or choose another item in Channel settings or the workflow rule.
- "The QuickBooks customer is inactive": make the customer active in QuickBooks Online, or let the sales channel switch inactive customers back on in Channel settings. See How to Make an Inactive Customer Active in QuickBooks Online.
- "The order is in a foreign currency and multicurrency is off": turn on Multicurrency in QuickBooks Online, or ignore the order. QuickBooks Online cannot turn Multicurrency off again. See How to Turn On Multicurrency in QuickBooks Online.
- "The books are closed for the order's date": change the closing date in QuickBooks Online. See How to Change the Closing Date in QuickBooks Online.
- "QuickBooks refused a duplicate document number": QuickBooks Online already has a document with the same number. Change or remove the other document in QuickBooks Online. See How to Find a Transaction by Its Number in QuickBooks Online.
- "Shipping fees are on but no order workflow is active": turn on an order workflow for the sales channel on the Workflows page.
- "Orders posted without their sales tax: the channel's tax settings name no tax code": a warning, not an error. The orders did post, but without their sales tax, because the Sales tax tab of Channel settings names no QuickBooks tax code for that tax. Click Open Sales tax settings, choose the tax code and save. The flag goes away when you save the channel's settings or rules, and comes back if another order posts without its tax. Orders already posted stay without the tax: to add it, unpost them and post them again. See How to Post Orders to QuickBooks. This flag does not light the dot on Inbox in the left menu.
Flags about connections
- "QuickBooks is disconnected": Webgility i can no longer sign in to your QuickBooks Online company. Connect it again in Business settings. See How to Connect Your QuickBooks Online Account to Webgility i.
- "The sales channel needs to be re-authorized": Webgility i stopped downloading from the sales channel because its sign-in expired. Go to Setup > Connections in the left menu and re-authorize the sales channel. This flag holds no orders, so it has no Retry button. It leaves the Inbox once Webgility i downloads from the sales channel again.
Flags that need a closer look
- "QuickBooks did not answer after several tries": QuickBooks Online did not answer after several tries. Click Retry later, and contact support if it keeps happening.
- "QuickBooks refused the document": QuickBooks Online refused the order for a reason Webgility i has no set fix for. The flag shows what QuickBooks Online said, and the Inbox can show this flag more than once, one row for each different message. For example: a document number QuickBooks Online already has; "Transaction date is prior to start date for inventory item" (set the product's Inventory start date in QuickBooks Online on or before the order date); a customer name already used by a QuickBooks vendor (rename the vendor, see How to Rename a Customer, Vendor or Employee in QuickBooks Online); or "This account has been deleted" (choose another account in Channel settings, or make it active again in QuickBooks Online). Open an order: its error box shows the same message. Fix what it names, then click Retry or post the order again. Contact support if you are not sure what to change.
- "No answer from QuickBooks: check whether the document is there": the document may already be in QuickBooks Online. Look for it there first, so the order is not posted twice, and contact support to release the order.
- "An edit could not update the posted document": the sales channel changed the order after it posted, and the posted document could not take the change. Check the document in QuickBooks Online, and review the change on the Updated tab.
- "Undo could not take the document out of QuickBooks": contact support.
- "The Bill posted but its payment failed": contact support.
- "The edited order's payment is pending on the channel": the order was edited at the sales channel and its payment is pending. Nothing to do. It posts once the sales channel marks it paid.
- "The order's currency is not one QuickBooks takes", "The order has no date" or "The order has no line to post": the sales channel sent an order Webgility i cannot post. Ignore the order, or contact support. See How to Ignore and Restore Orders.
- "The refund can't be posted automatically": Webgility i does not post this kind of refund on its own, for example a refund to store credit, part of an exchange, or more than the order total. Ignore the refund, or contact support. See How to Download, Review and Post Refunds.
- A title that starts with "Held:" followed by a code: Webgility i has no words for this reason yet. Contact support and share the code.
Note: Ignoring an order takes it out of its flag at once. A flag with no orders left leaves the Inbox.