Integrations to Retest When You Move to the Buyer Portal
A Buyer Portal migration doesn't change your ERP, but it changes what your ERP talks to.
Custom checkout scripts must be rebuilt on the latest B2B Edition checkout source. Order history must be synced, and any flow that depends on Companies or customer groups needs retesting. Test every connection in the sandbox, then again on your live store after go-live.
What a Buyer Portal switch touches
| Connection | Why it's affected | What to test |
|---|---|---|
| Custom checkout script | Must use the latest B2B Edition checkout source; BigCommerce support provides repository access | Checkout as each buyer role, with each payment method (PO, card, ACH) and address rule |
| Order history sync | B2B orders sync automatically; historical B2C orders sync only on request; new B2C orders sync after enablement | B2C customers see past orders; order details split by consignment |
| ERP (e.g. NetSuite) | Orders, Companies, price lists and invoices map to account structures that may change | A test order per role reaches the ERP with the right Company, pricing and references |
| Supply chain and dropship tools | Supplier routing, cancellations and stock updates often rely on custom order fields | Supplier IDs pass through; a cancellation updates BigCommerce, the SCM and the ERP; out-of-stock items stop selling |
| Apps that use customer groups | Independent Companies changes how Companies map to groups | Shipping rates, tax and discounts for Companies that now share a group |
| Integrations on the B2B Edition API | Create, read, update and delete for orders, Companies, addresses, payments, sales reps and Company users | Company and user sync in the sandbox, including new Companies and subsidiaries |
| Analytics and tag scripts | Theme changes can remove or break tags | Key events fire on product, cart, checkout and account pages |
| Customer service flows | Order messages aren't available in the Buyer Portal; buyers can message on open quotes | Order questions go to quotes, email or your service desk |
Sources: Buyer Portal Migration, B2B Edition developer docs, Buyer Portal overview.
How the Buyer Portal connects to your data
The Buyer Portal reads and writes through the B2B GraphQL Storefront API. Your back-office integrations keep using BigCommerce's management APIs and the B2B Edition API, often through middleware.
The integration doesn't need rewriting just because the storefront changed. It needs retesting wherever it relies on account structure, custom order fields or theme code.
Integration test plan
Inventory every connection
Apps, middleware, custom scripts and scheduled jobs.
Mark the ones that touch account data
Companies, customer groups, checkout or custom order fields.
Connect them to the sandbox
Where possible; otherwise mock the ERP side.
Run test orders
For each buyer role, payment method and storefront.
Check the far end
The order, Company and invoice as the ERP and supply-chain system see them.
Repeat on production
On go-live day, with a real test order, before announcing the change to buyers. See the migration checklist.
Integration Questions
Do I have to rebuild my ERP integration for the Buyer Portal?
Usually not. The ERP connects to BigCommerce's APIs, not to the theme. Retest any flow that depends on Companies, customer groups, custom order fields or checkout, because those can change during the migration.
What happens to a custom checkout when I enable the Buyer Portal?
A custom checkout script must use the latest B2B Edition checkout source code. Older custom checkouts often break payment methods, POs or address rules. BigCommerce support provides access to the checkout repository.
Will my order history move to the Buyer Portal?
B2B orders sync automatically. Historical B2C orders sync only if you request it from BigCommerce. New B2C orders sync automatically once the Buyer Portal is enabled.
Does Independent Companies affect my integrations?
It can. Apps that apply shipping, tax or discounts by customer group will see Companies sharing groups. Test those rates in the sandbox before enabling it, because Independent Companies can't be reverted.
Running BigCommerce with NetSuite or a supply-chain platform?
We map every connection your Buyer Portal migration touches and test it before go-live.