helpwith.salesorder.com
  • Read me first
  • Start!
    • How to move forward
  • Video Index
  • Live in 5
    • Step 4: Solution Plan
      • Workflow Guides
    • Must read: Data Migration
      • Read First: ASIC and presets
      • Transaction Migration Primer
      • Migrate transactions
      • Migrate from Quickbooks
        • How to categorize Quickbooks 'Open' Purchase Orders
    • Step 5: Launch Sequence
      • T -6: System Settings
      • T -5: Baseline preparation
      • T -4: 'Open' transactions
      • T -3: Trial balance
      • T -2: Set Stock levels
      • T -1: User testing / Dry run
  • Customer references?
  • Common Actions
  • Company
    • Workers and Users
      • Add new User login
      • Owners
  • Organizer
    • Memo
    • Contacts
    • Calendar
    • Email
    • Attachments and Linking
  • Expenses/Timesheets
    • Expense Claims
      • Mileage Claims
    • Timesheets
  • Sales Forecasting
  • Sales
    • Leads
    • Prospects
    • Customers
      • Credit Controls
    • Jobs
    • Sales Quote
    • Sales Orders
      • Common Sales Tasks
        • Pre-Authorization/Pre-Payment with BASYS
      • Ordered Item History
      • Stock Allocation
      • Pick-Pack-Ship Process
      • Sales Order List
      • Drop Ship
      • Special Orders (Just in Time)
      • Discounts
      • Prepayment/Deposit
    • Cash Sales
    • Sales Invoices
    • Payments from Customers
      • Processing digital Payments
      • Apply Credit Automatically on Payments
    • Customer Credit Notes
    • Customer Refunds
    • Delivery Notes (a.k.a Packing List)
    • Customer Statements
    • Shipments
      • Pick List
    • RMA
    • Commission automation?
  • Purchasing
    • Suppliers
    • Purchase Quotes
    • Purchase Orders
    • Cash Purchases
    • Item Receipts
    • Bills (Purchase Invoices)
    • Payments to Suppliers
    • Supplier Credit Notes
    • Supplier Refunds
    • PO Generator by Item
    • PO Generator by Order
  • Inventory Forecasting
    • Inventoro
  • Products/Services
    • Items - which ones?
      • Preferred Suppliers
      • Stock Items (SKUs)
      • Stock Assemblies
      • Kits
      • Non Stock Items
      • Group Item
      • 'Calculation' Items
      • Service Item
      • Matrix Item
    • Sites
    • Stock Adjustment
    • Stock Manager
    • Stock Locations
    • Categories, Tags and Attributes
      • Categories
      • Tags
      • Attributes
    • Images on Items
    • Item Extra Info
    • Price Levels
    • Price Lists
    • Advanced Price Lists
  • Banking
    • Cashflow Forecast
    • Checks
    • Bank Reconciliation
    • Petty Cash Accounts
    • Credit Cards
    • Money In and Out
  • Accounting
    • Accounting Periods
    • Payment Terms
    • Tax
      • Sales Tax
        • US Tax Codes
      • Tax Authorities
        • Working with HMRC (UK Specific)
      • Tax Codes
      • Tax Groups
      • Item Tax Options
      • VAT Returns
    • Currencies
    • General Journals
    • Memorized Transactions
    • Reverse Transactions
  • WMS: Warehouse Management
    • Stock View
    • Goods In
    • Goods Out
    • RMA
    • Shipping
    • Pallets
    • Kits and Assemblies
    • Stock Actions
    • Stock Count
    • Locations
    • History
    • Admin
    • Config
    • Barcode Scanner App ⛭
    • Multipacks
    • Overship Tolerance
    • Expiry Date
  • WMS Setup
  • Third-party logistics (3PL)?
  • Shipping
    • FedEx Manager Integration
    • UPS WorldShip Integration
  • Reports
    • Classifications
    • Report Mailer
    • Email Reports on Schedule
    • Accounting Periods
  • Setup
    • Roles
    • Email templates
    • Payment Processors
      • Basys: low fees, VIP service
      • Authorize.net
      • Cybersource
      • PayPal
      • USAePAy
      • Paragon (PAYA)
    • Configuration
      • Company ⛭
      • Memo ⛭
      • Ref # ⛭
      • Leads ⛭
      • Prospects ⛭
      • Customers ⛭
      • Credit Controls⛭
      • Jobs ⛭
      • Sales Quote ⛭
      • Sales Order ⛭
      • Sales Invoice ⛭
      • Customer Credit Note ⛭
      • Cash Sale ⛭
      • Statements ⛭
      • Shipment ⛭
      • Customer Refund ⛭
      • Delivery Notes ⛭
      • RMA ⛭
      • Pick List ⛭
      • Supplier ⛭
      • Purchase Quote ⛭
      • Purchase Order ⛭
      • Item Receipt ⛭
      • Cash Purchase ⛭
      • Bills ⛭
      • Payment to Suppliers ⛭
      • Supplier Credit Notes ⛭
      • Supplier Refunds ⛭
      • 1099 Categories ⛭
      • Kit ⛭
      • Accounts ⛭
      • Accounting Periods ⛭
      • VAT ⛭
      • Email Accounts ⛭
        • OAuth for Outlook 365 ⛭
      • Company Security ⛭
        • Two Factor Authentication
      • Classifications ⛭
      • Document Templates ⛭
      • Shipping Carriers
      • Sales Invoice ⛭
      • Payments from Customers ⛭
      • Sales Opportunities ⛭
    • EasyPost ⛭
    • Shipstation ⛭
    • Web to Lead
    • Import data templates
    • Exporting Data
    • Your Account
  • Shopping Carts b2c
    • ⚠ Live Shopping Carts
    • Shopping Cart controls
    • Shopify ⛭
    • BigCommerce ⛭
    • Magento ⛭
    • Woocommerce ⛭
    • Prestashop ⛭
  • Trade Acceleration Portal 2.0
    • TAP Users
      • Customers
      • Sales Reps
      • Sales Teams
      • Administrators
        • Configure barcode order entry
        • Get your Inventory List from QuickBooks
    • TAP UX
      • Global Brand Style
      • Themes
      • Pages
      • Blocks
        • Group Start
        • Plain Text
        • Image
        • Hyperlink
        • Menu Matrix
        • Title
        • Custom HTML
        • Block Configurations
          • Pixels and Percentages
          • Flex Box Settings
            • Flex Wrap
            • Justify Content
            • Align Items
            • Column/Row Gap
            • Align Content
          • Background
          • Dimensions
          • Border
          • Slider & Carousel
          • Margin Padding
          • Overflow Settings
      • Content Management System (CMS)
  • Trade Acceleration Portal 1.0
    • Configure barcode order entry
    • Get your Inventory List from QuickBooks
  • Customization
  • Volume Automation
  • EDI
    • EDI integration via XML
  • REST API
  • Schema Documents
Powered by GitBook
On this page
  • Instructions
  • Video instructions
  • Simulator instructions
  • Written instructions
  • 1. Log in to the Admin on your Shopify Cart
  • 2. Create a new 'App' in Shopify
  • 3. Set the Admin API access scopes
  • 4. Retrieve the API 'key' details from Shopify
  • 5. Create a new cart in Salesorder
  • 6. Auto sync settings (for testing)
  • 7. Test cart connection
  • 8. Test Order Import - Add Items
  • 9. Enter a Test Order (Shopify)

Was this helpful?

  1. Shopping Carts b2c

Shopify ⛭

Connect your Cart.

PreviousShopping Cart controlsNextBigCommerce ⛭

Last updated 10 months ago

Was this helpful?

Instructions

We've provided a video, simulator, and written walkthrough of how to connect your Shopify Cart.

Video instructions

Simulator instructions

Written instructions

1. Log in to the Admin on your Shopify Cart

Go to https://YourCartName.shopify.com/admin and log in.

2. Create a new 'App' in Shopify

Click on Apps>, notice the last option in the dropdown ' Apps and sales channel settings', click on this.

You'll be presented with a screen like this.

In the top right-hand corner of the screen, click on Develop Apps.

Don't worry, you definitely don't have to be a developer (programmer) to do these next steps :-). You're just going to click on some checkboxes (phew).

You'll be taken to the screen below.

Click on Create an app

You'll be taken to this screen

Enter a memorable name in the 'App name' field, e.g. SOconnect. You'll enter this name later into a field in your Salesorder system. Write or record this somewhere safe.

Now click Create app.

You'll be taken to this screen.

Now click on 'Configure Admin API scopes'.

3. Set the Admin API access scopes

Go to Settings>Apps and Sales Channels

Notice the Admin API access scopes is a scrollable window.

Set the Admin API access scopes as follows:

3.1 Assigned fulfillment orders

Check the boxes as shown below.

Scroll down the 'Admin API access scopes'.

3.2 Customers

Check the boxes as shown below.

Scroll down the 'Admin API access scopes'.

3.3 Fulfillment services

Check the boxes as shown below.

Scroll down the 'Admin API access scopes'.

3.4 Inventory

Check the boxes as shown below.

Scroll down the 'Admin API access scopes'.

Check the boxes as shown below.

3.5 Orders

Scroll down the 'Admin API access scopes'.

Check the boxes as shown below.

3.6 Product Listings and Products

3.7 Save your Settings

Notice, just below Admin API access scopes, you should have 10 settings selected.

Top right-hand corner - black Save button.

Shopify will display 'Configuration Saved'.

4. Retrieve the API 'key' details from Shopify

Now click on 'API credentials' (underlined), and you'll see this screen.

Notice the 'Install App' button in the Access Tokens area in the center of the above screen.

You'll see this screen.

Click the black 'Install' button.

You'll see this screen.

Click 'Reveal token once'.

Be very careful here. You will only see this 'Admin API access token' ONCE.

Copy the token (Ctrl C) and paste it somewhere safe i.e. Notepad if you're using Windows. Save this file somewhere safe, i.e. SalesorderShopifyToken.txt. Alternatively, use the copy icon to the right of the Token.

The token will look something like this.

shpat_7099d9765590c8XXXXX2c505157f2a7 (XXXXX obscured for security reasons)

5. Create a new cart in Salesorder

In Salesorder, go to:

Setup>Shopping Carts>Actions>New Shopify Cart

Field
Value

Shopping Cart Type

Shopify

Cart name

Use the Shopify 'App Name' e.g. SOConnect

Cart Connect URL

Go to the address bar on your browser and copy the cart address, i.e.

https://YourCartName.shopify.com/admin

adjust this to read:

https://YourCartName.shopify.com/admin/api/

Order Prefix

Optional: Add a prefix to recognize orders in Salesorder are from Shopify. Optional

Item code for Shipping Costs

Optional: Create a non-stock item called 'Shipping'. When shipping costs are added on Shopify, these will be mapped over to Salesorder and will appear as 'Shipping' on the line item table.

Item code for Discount

Optional: Create a non-stock item called 'CartDiscount'. When discounts are added on Shopify, these will be mapped over to Salesorder and will appear as 'CartDiscount' on the line item table.

6. Auto sync settings (for testing)

Field
Settings

From Cart

Status

For initial testing (now) this should be 'Stopped' (default).

Normal operation

Either 'Stopped' or 'Running'.

When 'Running' this auto-synchronization automatically imports Orders and updates Customers and Items.

Auto synchronization can be started when the Shopping Cart is in View or Edit mode.

Orders

Import orders as

For initial testing (now) this should be set to 'Sales Orders'.

Select how Orders imported from the cart will be transformed (i.e. what Document in your Salesorder system).

Options are:

  • Cash Sales

  • Sales Orders

  • Sales Invoices.

Documents will be imported with a status of PENDING.

Cash Sales and Sales Invoices will not post to the Accounts or affect Stock until you change the Status.

Last order from

For initial testing (now) set this to a date in the future. You don't want to accidentally import any live orders until your integration is tested and working.

Set the initial date/time from which you want to import Orders. Any Orders before this date will not be imported.

This value is automatically updated when Orders are imported.

Item

Enable automatic Item imports

Leave unchecked for now.

To Cart

Items

Enable real time stock updates

For initial testing (now), check this box.

If checked, this will send real-time stock updates to Shopify i.e. if you receive Item Receipts or make adjustments in Salesorder, these changes will appear in Shopify.

Note: this function assumes there is only one location. If you have multiple locations, the updates will always apply to the stock on the first location.

Shipments

Update Shipments in Cart

For initial testing (now), check this box.

If checked, will update Shipment's tracking number and courier on Shopify when you ship.

See below for Cart and Salesorder order statuses.

Cart and Salesorder order statuses

'Shipments' are 'Fulfillments'.

  • 'Fulfilled' in Shopify means 'Shipped',

  • 'Unfulfilled' means 'Not Shipped'.

  • Partial shipments are 'Fulfilled' followed by a number in brackets, e.g. if one item has been shipped the status would read as 'Fulfilled (1)'

Save your settings.

7. Test cart connection

Once you have filled in these fields, click 'Test Connection'. If successful, then you should get a message that reads:

'TEST PASSED: SUCCESSFULLY CONNECTED TO CART!'.

8. Test Order Import - Add Items

You need matching Items in Shopify and Salesorder to test the Integration.

If your cart is a live store

You will have imported your Items into your Salesorder system when you completed the ASICS import tasks. We covered this in the Evaluation to Launch workbook>Launch T -5.

Your Items (Stock and Non-Stock) will already exist in your Shopify cart.

If your cart is a new cart with no Items

You'll need to upload some or all of your Items (Stock and Non-Stock) into your Shopify store.

Make sure the Item you add in Shopify is added to your Item List in your Salesorder system.

OR

Import using the Items Import template:

Setup>Import Data>Items

9. Enter a Test Order (Shopify)

Make sure your Auto-sync on the Salesorder cart settings page is set to 'Stopped'

1. Create the order in your Shopify Cart

2. List and import the orders in Salesorder

Go to Setup>Shopping Carts>Your Shopify Cart> '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.

If you have any questions or issues, contact support@salesorder.com.

To view this demo in full screen, click .

Read this:

See Shopify Help

See .

Shopify Help has a Test Orders article . As you are testing an order, you will need to complete the order process with a payment card. The test payment details can be found in the Shopify Help article.

Enter an order in your shopping cart. Follow the order capture process to the conclusion. The process completes when you have entered the test payment details as described above, at the beginning of the '' section.

here
Adding and updating products
here
Test Order - settings
⚠ Live Shopping Carts
Create
a new Stock Item
Video walkthrough of how to connect your Shopify Cart.