BigCommerce Setup - B2B
Synchronize Business Central Customers, Contacts, and Ship-to locations to BigCommerce B2B Companies, Users, and Addresses.
Note: You will need to have an active subscription for our CSM for BigCommerce B2B module for full B2B functionality.
A CSM Company links a Business Central Customer to a BigCommerce B2B Company. Each Company can have:
-
Multiple Company Contacts (Business Central Contacts / BigCommerce Users)
-
Multiple Company Locations (Business Central Customer Address or Ship-to Addresses / BigCommerce Addresses).
We will be covering several sections in this document:
- Sales Channel
- Companies
- Orders
- Automations
- Maintenance
Sales Channel
-
Search for CSM Sales Channel and select the related link
-
General FastTab
-
Enable Enable B2B Features
-
This activates the B2B FastTab and all B2B functionality throughout CSM.
-
-
-
Customers FastTab
-
New Customer Behavior:
- Auto-Create: Business Central customer records are created automatically when B2B companies are retrieved
- Manual: you create Business Central customers manually
-
- B2B FastTab
- Configure the following fields:
-
|
Field |
Description |
|
New B2B Customer Template Code |
The Customer Template to use to create new B2B Customers with default values and/or dimensions. |
|
New Company Behavior |
Indicates whether a Company should be created from order data when not already a CSM Company. |
|
New Company Contact Behavior |
Indicates whether a Company Contact should be created from order data when not already a CSM Company Contact. |
|
New Company Location Behavior |
Indicates whether a Company Location should be created from order data when not already a CSM Company Location. |
- API Data FastTab
- Verify API Engine Execution Module is populated. This field is required for B2B features to function.
- Verify API Engine Execution Module is populated. This field is required for B2B features to function.
Companies
- Search for CSM Companies and select the related link; load an existing Company or create a new one
- CSM Company Card Overview:
- General FastTab
- CSM Company Card Overview:
|
Field |
Description |
|
Sales Channel Code |
The Code of the CSM Sales Channel this CSM Company relates to. |
|
BC Customer No. |
The No. of the Business Central Customer that is linked to this CSM Company. |
|
Name |
The Name of the company. |
|
Main Contact Name |
The name of the main contact for this company. |
|
Notes |
Notes regarding the Company. |
|
Default Billing Location |
The default billing location name for this company. |
|
Default Shipping Location |
The default shipping location name for this company. |
|
External Company Status |
Status ID or code of the company on the external system, in the form known by the channel. |
|
Status |
Indicates the status on the channel for this Listing. |
-
-
- Company Contacts FastTab
- Each Contact has a Role, External ID, and External Customer ID. BigCommerce calls these Users; CSM calls them Contacts.
- Company Locations FastTab
- Each location has a Company Location Type
- Customer = linked to the Business Central Customer's Address
- Ship-to = linked to a Business Central Ship-to Address
- Each location has a Company Location Type
- Company Contacts FastTab
-
-
-
Creating a CSM Company in Business Central
- Use this approach when you are creating B2B companies in Business Central and pushing them to BigCommerce.
- From the Sales Channel, go to Related > B2B > Companies > New or from the CSM Companies card, click the new button
- Ensure you have your BigCommerce Sales Channel selected for the Sales Channel Code
- In BC Customer No., select a customer
- A dialog offers three options for automatically creating contacts and locations:
- All Contacts and Locations
- Selected Contacts and Locations
- None
- A dialog offers three options for automatically creating contacts and locations:
- Assign a Role to each contact on the Company Contacts FastTab (Edit > Role).
- This is required before sending to BigCommerce.
- Set the Main Contact Name on the General FastTab
- On each company location, configure Is Billing, Is Shipping, Is Default Billing, and Is Default Shipping.
- Setting a default flag automatically populates the Default Billing/Shipping Location fields on the company card.
- From the Sales Channel, go to Related > B2B > Companies > New or from the CSM Companies card, click the new button
- Use this approach when you are creating B2B companies in Business Central and pushing them to BigCommerce.
-
-
-
- Sending to BigCommerce
- Because BigCommerce automatically creates a Customer and user for the main contact when a new Company is created, you must follow this sequence to avoid duplication:
- Sending to BigCommerce
-
-
-
-
-
- Actions > Send to Channel > Company info
- Sends the company; verify an External ID appears on the Company Status FastTab.
- Actions > Retrieve from Channel > Contacts
- Retrieves the External ID and External Customer ID BigCommerce assigned to the main contact; this essentially provides mapping for these items to be utilized in Business Central.
- Actions > Send to Channel > All Info
- Sends all remaining Contacts and Locations in one step.
- Actions > Send to Channel > Company info
-
-
-
Retrieving B2B Companies from BigCommerce
-
-
-
- Use this approach during initial setup to bring existing BigCommerce B2B companies into Business Central. This requires the Sales Channel settings for "New Customer Behavior, New Company Behavior, New Company Contact Behavior and New Company Location Behavior" set to Auto-Create.
- Retrieve Companies
- Use this approach during initial setup to bring existing BigCommerce B2B companies into Business Central. This requires the Sales Channel settings for "New Customer Behavior, New Company Behavior, New Company Contact Behavior and New Company Location Behavior" set to Auto-Create.
-
-
-
-
-
- From the sales channel, go to Related > B2B > Companies
- Choose Actions > Retrieve from channel > Companies
- CSM imports all BigCommerce B2B Companies as CSM Company records.
-
-
-
-
-
-
- Connect Companies to a Business Central Customer
-
-
-
-
-
-
- Choose Actions > Synchronize > To BC customer
- A new Business Central Customer is created using the B2B Customer template and linked to the Company.
- Choose Actions > Synchronize > To BC customer
-
-
-
-
-
-
- Retrieve and Link Contacts
-
-
-
-
-
-
- Choose Actions > Retrieve from Channel > Contacts
- For each contact on the Company Contacts FastTab:
- Synchronize > Link or create BC contact
- Creates a Business Central Contact of type Person linked to the BC Customer
- Synchronize > Link or create CSM customer
- Links the Contact to a CSM Customer (required for order processing).
- Synchronize > Link or create BC contact
- For each contact on the Company Contacts FastTab:
- Choose Actions > Retrieve from Channel > Contacts
-
-
-
-
-
-
-
Retrieve and Sync Locations
-
-
-
-
-
-
-
- Choose Actions > Retrieve from Channel > Locations
- For the Customer-type location:
- Synchronize > To linked address
- Copies Address data to the Business Central Customer card
- Synchronize > To linked address
- For each Ship-to type location:
- Synchronize > To linked address
- Creates a Business Central Ship-to Address using the BigCommerce Address ID as the Ship-to code
- Synchronize > To linked address
- For the Customer-type location:
- Choose Actions > Retrieve from Channel > Locations
-
-
-
Orders
B2B and individual (B2C) orders are retrieved together by the same order automation — there is no separate retrieval process. The difference appears after import: B2B orders display a B2B FastTab on the CSM Order page; individual orders do not.
|
Field |
Description |
|
Purchasing Entity Company Name |
Also shown on the General FastTab; empty for individual orders. |
|
Purchasing Entity Company ID |
BigCommerce company identifier — used to match the order to the correct CSM company. |
|
Purchasing Entity Customer ID |
BigCommerce customer ID for the user who placed the order. |
|
Purchasing Entity Customer Email |
Email of the company user who placed the order. |
|
Purchasing Entity First / Last Name |
From the order's billing address — not necessarily the user who placed the order. |
Some fields on the right side of the B2B FastTab may be blank for BigCommerce orders — this is expected, as CSM supports multiple platforms.
Company Creation via Order Retrieval
- When CSM retrieves a B2B order, it attempts to match the order's company/contact to existing CSM records. If no match is found, it follows the New Company/Contact/Location Behavior settings (Auto-Create or Manual).
- Auto-creation applies only to CSM records — not Business Central Customers, Contacts, or Ship-to Addresses.
- To create Business Central records from auto-created CSM records:
- Business Central Customer
- CSM Company Card
- Actions > Data > Create or update Customer
- CSM Company Card
- Business Central Contact
- Company Contacts FastTab
- Data > Link or Create BC Contact
- Company Contacts FastTab
- Business Central Ship-To Address
- Company Locations FastTab
- Data > Update linked Address
- Company Locations FastTab
- Business Central Customer
- To create Business Central records from auto-created CSM records:
Automations
- CSM includes an automation group, BigCommerce B2B Management, that handles ongoing synchronization without manual intervention. No automations are enabled by default; enable only the ones that match your data flow direction.
- Access
- Search for API Automation and select the related link
- Locate the BigCommerce B2B Management group.
- The top section controls the group; the bottom section (Steps) controls individual steps.
- The group contains seven steps:
- The top section controls the group; the bottom section (Steps) controls individual steps.
- Locate the BigCommerce B2B Management group.
- Search for API Automation and select the related link
|
Step |
Direction |
Description |
|
Get Companies |
<
|
Retrieves companies created/updated since last run. |
|
Get Contacts |
<
|
Retrieves contacts per company (one API call per CSM company). |
|
Get Locations |
<
|
Retrieves locations per company (one API call per CSM company). |
|
Send Companies |
>
|
Sends companies where External Requires Update = true. |
|
Send Contacts |
>
|
Sends contacts where External Requires Update = true (one API call per company). |
|
Send Locations |
>
|
Sends locations where External Requires Update = true (one API call per company). |
|
Send Company Status |
>
|
Sends status changes where Status Requires Update = true. Exists separately because BigCommerce requires a distinct API call for status changes. |
- Each step has CSM Automation Properties for Channel Type and Sales Channel code. If you have multiple BigCommerce sales channels, create a separate step for each.
- The Require Update Only property (default: true) limits sends to records with the update flag set. Set to false only if you need to force-send all records regardless of changes.
- Running automations — three options:
- API Automation page
- Select the group and choose Run (runs all enabled steps), or select an individual step in the Steps section and choose Run (runs that step only).
- CSM Administrator Role Center
- Choose Run B2B Automation Now in the Activities section (only visible when at least one sales channel has B2B enabled).
- Job Queue
- Create a job queue entry with Object Type = Codeunit, Object ID = 70338473 (SENAPI Automation Job Queue) for fully automated scheduled execution.
- API Automation page
- Errors during a run appear on the Error Messages page and do not stop the remaining records or steps from processing.
Maintenance
- Company status updates
- Change the Status field on the CSM Company Card, then Actions > Send to Channel > Company status.
- Syncing Business Central changes to BigCommerce
- After updating a Business Central customer, contact, or ship-to address, sync to CSM then send to BigCommerce:
|
Object |
Sync Action |
Send Action |
|
Company |
Actions > Data > Sync Company |
Actions > Send to Channel > Company info |
|
Contact |
Contacts FastTab: Data > Sync Company Contact |
Contacts FastTab: Send to Channel > Contact |
|
Location |
Locations FastTab: Data > Sync Company Location |
Locations FastTab: Send to Channel > Location |
-
- Syncing sets the External Requires Update flag to true on the record. For company address fields (other than Name), values come from the linked CSM company location — update the location before sending.
-
Syncing BigCommerce changes to Business Central
|
Object |
Retrieve Action |
Update BC Action |
|
Companies |
From Companies list: Actions > Retrieve from Channel > Retrieve companies |
Actions > Data > Create or update Customer |
|
Contacts |
On Company Card: Actions > Retrieve from Channel > Retrieve contacts |
Contacts FastTab: Data > Update BC Contact |
|
Locations |
On Company Card: Actions > Retrieve from Channel > Retrieve locations |
Locations FastTab: Data > Update linked Address |
Note: BigCommerce B2B addresses are single addresses with no separate bill-to/ship-to concept. Retrieve locations updates the billing address by default. To update shipping address instead, modify the GETADDRESS API function response mappings.
- Sending updates in bulk — All Info
- Use Actions > Send to Channel > All Info to push all company data (company info, contacts, and locations) to BigCommerce in one step.