> For the complete documentation index, see [llms.txt](https://orbit-b2b.gitbook.io/orbit-b2b-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbit-b2b.gitbook.io/orbit-b2b-docs/draft-orders/troubleshooting.md).

# Troubleshooting

## The "Submit Order for Approval" button doesn't appear

Work through these in order:

1. **Feature enabled?** Orders → Draft Orders → Settings → **Enable Submit Order for Approval** is on.
2. **App embed on?** Theme editor → App embeds → **Easy B2B Wholesale** is enabled.
3. **Customer eligible?** With *Approved B2B customers only*, the customer must be logged in and carry a tag that matches one of your Customer Group tags. A logged-out or untagged visitor correctly sees the normal Checkout button.
4. **Group tags in sync?** The storefront reads a synced tag list. It refreshes whenever you save a Customer Group — if you added a group tag and it's not taking effect, open that group and save it once.
5. **Plan gate.** Storefront features render on Advanced+ plans.

**Quick check (browser console on the cart page):**

```js
const d = JSON.parse(document.getElementById('orb2b-wholesale-data').textContent);
console.log('enabled:', d.draftOrders?.enabled, '| custTags:', d.customer?.tags, '| groupTags:', d.groupTags);
```

* `enabled: false` → feature/embed off, or settings not synced.
* `custTags` shares no value with `groupTags` → the customer isn't in an eligible group (tag them, or add the group).

## Confirm fails / no payment link

* The store token may need a refresh — reopen the app from Shopify admin.
* Check the order's payment term is valid; on a non-Plus store, if native payment terms aren't accepted the app falls back to recording the term on the order note (the order is still created).

## Payment term shows "Due on receipt" when I expected a Net term

The term follows the [cascade](/orbit-b2b-docs/draft-orders/payment-terms.md): a customer in a group whose *B2B payment term* is unset falls through to the **shop default**. Set the group's term in Customers → Customer Groups, or override it on the order at confirm time.

## Emails not arriving

See [Draft Order emails](/orbit-b2b-docs/draft-orders/emails.md) and [Emails not sending](/orbit-b2b-docs/faq-and-troubleshooting/emails.md). Common causes: SMTP not configured, spam folder, or the notification toggle off.

## Status stays "Invoiced" after the customer pays

Payment is completed and tracked in **Shopify → Orders**. The Draft Orders list shows **Invoiced** after the link is sent; automatic "Paid" status sync is planned for a later release.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://orbit-b2b.gitbook.io/orbit-b2b-docs/draft-orders/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
