Connect Business Central with SparkLayer

Use Tinx SparkLayer Connector to connect Business Central with SparkLayer. The goal is to create a SparkLayer sales channel in Business Central so that you can send B2B price lists to Shopify. To do that, complete the following steps.

  1. Install SparkLayer. Log in to the Shopify backend and install the SparkLayer B2B & Wholesale app.
  2. Generate an API key in SparkLayer. On your SparkLayer Dashboard, generate the API key that you use to connect Business Central with SparkLayer.
  3. Install Tinx SparkLayer Connector. Install the connector from AppSource and complete the initial setup in Business Central.
  4. Create and configure a SparkLayer sales channel. Use the API key from step 2 to configure the sales channel in Business Central.
  5. Verify the SPL-002 message definition. Check the setup of the key message definition required to send price lists to SparkLayer, and then publish a price list to test the connection.

You always use Tinx SparkLayer Connector together with another connector that connects Business Central with your Shopify webshop. Tinx SparkLayer Connector sends only Business Central prices to SparkLayer. SparkLayer then shows these prices in your Shopify webshop. For more information, see Manage B2B pricing in your webshop. You can use Tinx SparkLayer Connector together with either Tinx Shopify Connector or the native Shopify connector from Microsoft. If you plan to connect to Shopify by using Tinx Shopify Connector, establish the connection between Business Central and Shopify before you set up SparkLayer. For more information, see Connect Business Central with Shopify. Before you continue with this article and its procedures, review the general concept of using SparkLayer to synchronize prices. For more information, see Tinx SparkLayer Connector overview.

To install SparkLayer

To generate an API key that connects Business Central with SparkLayer, you need the Pro plan or higher. For more information, see SparkLayer pricing.

  1. Log in to your Shopify backend.

  2. Select Settings, and then select Apps.

  3. On the Apps page, select Shopify App Store.

    Apps page in Shopify settings with the Shopify App Store button

  4. In the Shopify App Store, find SparkLayer B2B & Wholesale, and then select Install.

  5. Configure your SparkLayer storefront. For more information, see Shopify B2B Store Setup.

To generate an API key in SparkLayer

Generate an API key on the SparkLayer Dashboard. For more information, see Getting started with the API.

  1. Log in to the SparkLayer Dashboard.

  2. Select your account.

  3. On the Account page, copy the Site ID value to a secure location. You need it to configure the SparkLayer sales channel in Business Central.

    SparkLayer Dashboard Account page with the Site ID field

  4. To open the API page, select Settings, and then select API.

  5. Create an API key. For more information, see API Keys.

  6. Copy the Client ID and Client Secret values to a secure location. You need these values to configure the SparkLayer sales channel in Business Central.

To install Tinx SparkLayer Connector and complete the initial configuration

  1. Install Tinx SparkLayer Connector from AppSource. For more information, see Install.

    You need a runtime application if you're using Business Central on-premises. For more information, see Runtime application and Update Customer License. Except for installing the runtime application and updating the customer license, the setup steps are the same for on-premises and online installations.

  2. Set up the following areas in Tinx Connector. For more information, see Initial configuration.

    • Change your role to TINX E-Com Admin.
    • Allow HttpClient requests.

To create and configure a SparkLayer sales channel in Business Central

The following procedure is the minimum needed to establish the connection between Business Central and SparkLayer. It's enough if you only want to test that the connection works. The sales channel setup includes many more areas. For more information, see Sales channel.

  1. In Business Central, select Search (Alt+Q) in the upper-right corner, enter Sales Channels, and then choose the related link.

  2. On the Sales Channel List page, in the New group, choose the Webshop Connectors action.

  3. On the Webshop Connectors Overview page, choose the New action, and then choose Create Sales Channel.

  4. On the Start Assisted Setup page, in the Webshop Code field, choose SPARKLAYER.

  5. Choose OK to create a sales channel.

    Tinx Connector applies the default Sales Channel Code when you create the first sales channel. You can change the code later on the Sales Channel Card page.

    If this is the first SparkLayer sales channel you create in Business Central, Tinx Connector downloads the default mapping for SparkLayer. The download can take a few minutes. For more information, see Default mapping.

  6. When the download is complete, on the Sales Channel List page, select the newly created SparkLayer sales channel, and then choose the Edit action.

  7. On the Sales Channel Card page, configure the necessary fields for your SparkLayer integration.

    The following table describes the most important fields that you need to fill in to connect to SparkLayer.

    Field Description
    Website Enter https://app.sparklayer.io. For more information, see Environment Domain.
    API Endpoint Tinx Connector automatically populates this field based on the Website field.
    Site ID (SparkLayer) Enter the Site ID value from the SparkLayer Dashboard. For more information, see Getting started with the API.
    Client ID Enter the Client ID value from the SparkLayer Dashboard.
    Client Secret Enter the Client Secret value from the SparkLayer Dashboard.

  8. Turn on the Active toggle, and leave the Is Default toggle turned off. For more information, see Is Default and Active toggles.

    The following image shows the SparkLayer connection setup on the Sales Channel Card page.

    SparkLayer connection setup on the Sales Channel Card page

To adjust the SPL-002 message definition

To publish prices from Business Central to SparkLayer, set up the SPL-002 message definition.

  1. Select Search (Alt+Q) in the upper-right corner, enter Synchronisation Dashboard List, and then choose the related link.
  2. On the Synchronisation Dashboard List page, select the SPL-OUT-PRICING NEW dashboard, and then choose the Edit action.
  3. On the Synchronisation Dashboard page, on the Lines FastTab, select the line where the Document No. field is set to SPL-002, and the Description field is set to Create a Price List based on the sales price table. Then choose the Message Definition action.
  4. On the Message Definition page, on the Lines FastTab, check the following fields.
    • Set the JSON Data Type field to IsObject.
    • Set the Response Field No. field to 11205249. This is the Webshop Slug field number on the Sales Price List page. Tinx Connector must populate the Webshop Slug field based on SparkLayer's response. Otherwise, Business Central doesn't send prices to SparkLayer. For more information, see Sending a price list to SparkLayer.
    SPL-002 Message Definition page with the JSON Data Type and Response Field No. fields

Related information

SparkLayer API documentation
Update Pricing by Price List
Tinx SparkLayer Connector overview
Quickstart
Key concepts in Tinx Connector
Troubleshooting checklist
Get help from Tinx Support

Help us improve the documentation

We continuously update the Tinx documentation. This article was recently rewritten. Send your feedback to docs@tinx-it.nl to help us make it even better.

Last updated on October 12, 2026