# BigCommerce ⛭ ## Instructions We have provided a video and written walkthrough on how to connect your BigCommerce cart. ### Video Instructions {% embed url="" %} ### Written Instructions #### Cart Configuration (BigCommerce Admin) To ensure your cart can communicate through our integration, you need to configure the following settings. To access these settings go to: and login into the Admin area. Then: Settings>API>API Accounts>Create API Account {% hint style="danger" %} Once you save the details you insert in this section they cannot be edited. To start over, delete the entry in the list. {% endhint %} **Token type:** V2/V3 API token **Store:** Set a name. Set the same name in 'Cart name' on the New BigCommerce config screen: To access the BigCommerce setup screen In Salesorder go to: Setup>Shopping Carts>Actions>New BigCommerce Cart>Cart Name From the BigCommerce 'Create Account' screen, copy the API Path URL and paste this into the Cart Connect URL field in the above screen. Make sure you set the 'API Version' field to 'Version 3' in the above screen. In the BigCommerce, 'Create Account' screen, set the **OAuth Scopes** to:

BigCommerce OAuth scopes

Save the 'Create Account' screen. A modal (pop-up) window will appear '**BigCommerce API Credentials',** together with a '**Save As**' file explorer screen on your PC. {% hint style="warning" %} In this step, BigCommerce wants you to download the API credentials to your PC. Don't skip this step, as you cannot get access to these credentials from the BigCommerce Admin panel after you have clicked **'Done'**. {% endhint %}

Saving BigCommerce API Credentials

{% hint style="info" %} It's good practice to rename the .TXT file BigCommerce wants you to download to something practical like 'MyStoreAPICredentials'. {% endhint %} Click 'Save' on the 'Save As' window. From the file you downloaded you'll need to copy and paste the following credentials into the BigCommerce config screen you have open in Salesorder. 1. **Client ID** 2. **Access Token** The contents of the downloaded file will look like this: ``` ACCESS TOKEN: cc4corno7j5xoisu07d1ixn4q28gp07 CLIENT NAME: Store BC CLIENT ID: 63a9wg0iclgt0tm82bofravzgvkt13f CLIENT SECRET: 3e81b040a6087b5885b988922dc12a8400b7a52a71fa148c6caff31774ac2131 NAME: Store BC API PATH: https://api.bigcommerce.com/stores/w5z5htrnkd/v3/ ``` Now do the following: ``` How to format the API key for pasting into the API key field. ------------------------------------------------------------- Client ID:ACCESS TOKEN (make sure you insert the colon between the two values). 63a9wg0iclgt0tm82bofravzgvkt13f:cc4corno7j5xoisu07d1ixn4q28gp07 ``` Insert this last string of characters into the **API Key** field on the BigCommerce Config screen in Salesorder. {% hint style="warning" %} Make sure you insert the colon between the Client ID and the Access token, with no spaces. {% endhint %} OK, now you've completed the basic hookup settings. Click 'Save' on the BigCommerce Configuration screen in Salesorder. Now click 'Test Connection' on the above-saved screen. The screen should display 'TEST PASSED: SUCCESSFULLY CONNECTED TO CART' If you get a Salesorder error message, go back and check the details you entered are correct. If the details are correct, and you are still getting errors. repeat the API Credentials process om BigCommerce and re-enter them into Salesorder. If you still have problems, contact us: . {% hint style="warning" %} In order for us to re-create the problem make sure you provide: The BigCommerce Admin credentials Your Salesorder account (SOAxxxxxx) details and the Cart name. {% endhint %} ### Create a test order in BigCommerce To check the integration behaves as you need, follow these steps. Your cart is now connected to Salesorder. #### Items matching Your Items in Salesorder and your cart need to match. {% hint style="info" %} You currently cannot export your Item list from Salesorder into your BigCommerce Cart. If you think you need this feature, then please get in touch with us at . See '[Shopping carts (B2C)](/shopping-carts-b2c.md)'. for a list of supported features. {% endhint %} You can import Item details from your BigCommerce Cart. If you're using the BigCommerce test Items, you can immediately go to: Setup>Shopping Carts>Your cart (name)>Items (Cart) *tab* Either search for an Item you would like to import or click 'List Items'. Select the Item(s) you want to import. {% hint style="warning" %} As you're still testing the integration, you should begin with just **1 to 5 Items**. You need to be sure your Items in the cart are being accurately mirrored in your Salesorder system. {% endhint %} Click 'Export Selected Items'. When the operation is complete, go to your Item list and search for the imported Items and check their details. The following values will be imported: * SKU *item code* * Description * Unit Price The Stock Item will default to: * Unit of measure will be 'Each' * Accounting will be set to the default accounts, e.g. * Income = Sales * Cost of Goods Sold = Cost of Goods Sold * Stock Asset = Stock Asset See [Configurable accounting on transactions](/accounting.md#_tcredxcr0ait) for default settings. You can add extra data to the imported Items manually or import using the Items Import template: Setup>Import Data>Items If things don't look right, contact us at ### Test Order - key settings You'll need to configure these settings before you can run a test order. BigCommerce Documentation has a [Test Orders article here.](https://support.bigcommerce.com/s/article/Testing-Shipping-Tax-and-Payment-Settings?language=en_US) {% hint style="info" %} As you're testing an order, you'll need to complete the order process with a payment card. The [test payment card details can be found here](https://support.bigcommerce.com/s/article/Testing-Shipping-Tax-and-Payment-Settings?language=en_US#test-payment) in the above BigCommerce Article. **Enter any Expiry Date/CVS/Card owner.** {% endhint %} #### **Common sense tip** When testing anything, such as an integration or an import you should always adopt a 'rope across the river' mentality. What we mean is to check the fundamentals are working. Focus on depth and not breadth. For example in this case, just import the simplest of orders, or in the case of an import, just a couple of rows of data. #### What type of transaction to import? {% hint style="warning" %} In Salesorder on your cart settings page there is a field 'Import Cart Orders as'. You'll need to set this depending upon your workflow as: Pending Cash Sales Pending Sales Orders Pending Sales Invoices The default setting is 'Pending Cash Sales'. **Make sure you do this step before proceeding.** {% endhint %} #### Import orders with status This setting is key. If you don't set a value in the above field on your Salesorder Cart settings, you won't be able to list or import orders. You'll find a list of these statuses on the drop-down menu in the BigCommerce Admin Orders list. In the screenshot below, notice all of the orders are '**Awaiting fulfillment'**. This is where you'll find the list of values. For now, to get the 'rope across the river' set this Import Orders with Status field to '**Awaiting fulfillment**'. You can change this later as needed. ### Test order {% hint style="warning" %} Make sure your Auto-sync on the Salesorder cart settings page is set to 'Stopped' {% endhint %} #### Step 1 - create the order in your BigCommerce Cart Begin by creating an order in your shopping cart. Follow the order capture process to conclusion. The process completes when you have entered the test payment details as described above, at the beginning of the '[Test Order - settings](#test-order-key-settings)' section. #### Step 2 - list and import the orders into your BigCommerce cart In Salesorder. go to your cart settings and open the 'Orders (Cart)' tab. Click 'List Orders'. Your order should appear in this list. Select the order and click 'Import Selected Orders' #### Step 3 - Check the orders in Salesorder Go to Sales>Sales Orders and use the action 'List Pending Orders' to see your order. --- # Agent Instructions: 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: ``` GET https://helpwith.salesorder.com/shopping-carts-b2c/bigcommerce.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.