Skip to main content

Installation manual for the Lightspeed AFAS integration

Updated today


Table of contents


1. Connect to Lightspeed

Log in to your Lightspeed eCom (C-Series) environment.

Go to 'Apps' in the menu.

Search for 'Combidesk' using the search bar at the top.

You will see all available Combidesk apps. Select the app you want to install.

Click the green 'Install App' button in the top right corner.


2. Connect to AFAS

Before you begin, make sure you have access to the following:

  • An active AFAS subscription with access to the AppConnector

  • The subdomain of your AFAS environment (the part before .afas.online)

  • An XML token generated via the AppConnector in AFAS

Haven't set up the AppConnector yet? Do this first in AFAS via Management → AppConnector. Make sure that at least one connector has been added to your AppConnector and copy the XML token — this is only shown once by AFAS.

Step by step: connecting your AFAS account

Step 1: Open the connection screen

Go to the installation page of the integration and click "Connect your AFAS account". A screen will appear as shown below.

Step 2: Enter your subdomain

In the Subdomain field, enter the first part of your AFAS URL. The full URL has the following format:

Only enter the part that comes before .afas.online.

Step 3: Paste the XML token

In the Token field, paste the full XML token that you copied from the AppConnector in AFAS. The token looks like this:

<token><version>1</version><data>...</data></token>

Please note: AFAS only shows this token once. If you no longer have it, you will need to create a new token in the AppConnector.

Step 4: Test or acceptance environment (optional)

Do you want to connect to a test or acceptance environment? Check the corresponding option:

  • Connect to a test environment

  • Connect to an acceptance environment

Leave these options unchecked if you want to connect to your production environment.

Step 5: Save

Click "Save" to confirm the connection. If everything is correct, your AFAS account is now successfully connected.


3. Configuration of the integration

For the integration to work properly, it must be configured correctly. In the paragraph below, we'll go through all the steps of the integration in sequence. Before starting the installation, we recommend that you first carefully read through these steps.


Configure these Lightspeed steps:

  • Discounts in orderlines
    Should orderline discounts be added to the orderlines (yes) itself or separately (no)?

  • Filter order statuses
    Select the order statuses that orders should have to be transferred. If no status is selected, all orders will be transferred.

    Make sure to have "Cancelled" included to have orders that are cancelled deleted again in Afas.

  • Transfer the product catalogue from AFAS to your shop
    Shall we sync all products, changes from now on or none at all?

    This may take a while for larger webshops!

  • Default pricelist
    Use the default pricelist including or excluding VAT?

  • Configurable product grouping
    Configurable product grouping by title or by main item code

  • Configurable product sorting attribute
    The attribute to sort the configurable products by (if group by title)

  • Sorting attribute sort order
    Enter the attribute values of the sorting attribute order by priority descending

  • Convert long description
    Should the markdown formatting in the long description fields from Afas be converted into html?

  • Sync zero priced products
    Do you want to sync products with a price of 0?

  • Synchronise stock to your webshop
    Sync stock amounts from the selected warehouse to your webshop?

  • Uses stock on warehouse level
    Uses stock on warehouse level? (Uses the default Combidesk_Profit_Stock GetConnector?)

  • Definition of stock
    Please select the definition of stock you want to use (None=use default)

  • Synchronise stock of preferred sales unit
    Do you want to synchronise the stock of compositions to your webshop?

  • Synchronise stock of compositions to your webshop
    Do you want to synchronise the stock of the preferred sales unit of the item if available?

  • Accounts for debtors
    Create user accounts for debtors in AFAS?

  • Use delivery address
    Use the delivery address of a debtor if available

  • Use contact persons
    Do you want to use debtor contact persons or debtors (Yes for contact persons, No for debtors)

  • Use invoice to addresses
    Use the address of an invoice to debtor if available

  • Synchronise prices to your webshop
    Sync product prices to your webshop?

  • Enable support for action prices
    Enable support for action prices in your webshop (only Magento 2)?

  • Synchronize returns
    Synchronize returns from your Lightspeed shop to AFAS Profit (and the status back)?

  • Mark orders completed
    Mark orders completed in your webshop if they have status "Geleverd" or "Handmatig afgehandeld". Note: all items of the order will be marked as delivered in your webshop though they might be in backorder.

  • Synchronize credit invoices
    Synchronize credit invoices from your Lightspeed shop to AFAS Profit?

  • Article code for standalone credit invoice lines
    Enter the article code here for standalone credit invoice lines that are not related to a product. Note: this article code must exist in AFAS.


Configure these AFAS steps:

  • Debtor ledger account
    The debtor ledger account new debtors will be assigned to

  • Shipping costs item
    The item code on which the shipping costs will be booked

  • Other costs item
    The item code on which the other costs will be booked

  • Discounts item
    The item code on which the discounts will be booked

  • Warehouse
    The warehouse from which the orders will be booked

  • Administration
    The administration the order will be booked into

  • Project
    The project the order will be booked on

  • Default pricelist
    The default pricelist that will be used

  • Journal
    The journal the order will be booked into

  • Shipping costs VAT low item
    The item code on which the shipping costs will be booked

  • Update existing debtors
    Should existing debtors be updated in AFAS?

  • Default currency
    Enter the default currency code for new relations

  • Default "verstrekkingswijze"
    Enter the default 'verstrekkingswijze' for new relations

  • Default debtor profile B2C
    Enter the code of the debtor profile for new B2C relations

  • Default debtor profile
    Enter the code of the debtor profile for new relations

  • Payment term
    Select the default payment term for new relations

  • Credit limit
    Enter the default credit limit for new relations

  • Order processing
    Enter the code for the default order processing for new relations here

  • Preferred warehouse
    Select the preference warehouse for new relations

  • Afwijkende aanmaningset
    Enter the afwijkende aanmaningset for new relations

  • Representative
    Select the representative for new relations

  • Default pricelist for new debtors
    Select the default pricelist for new relations

  • Transporter
    Select the default transporter for new relations

  • Shipping service
    Select the shipping service for new orders

  • Sending status
    Select the default sending status for new orders

  • Package
    The default package for new orders

  • Cost type
    Are costs booked on costs items?

  • Discounts VAT low item
    The item code on which the discounts will be booked

  • Default language
    Enter the code for the default language for new relations here

  • Default to account
    Enter the code for the default to account for new relations here

  • Default delivery conditions
    Enter the code for the default delivery conditions for new relations here

  • Default assortment
    Enter the code for the default assortment for new relations here

  • Pricelist for invoices
    Should orderlines be inserted with the debtor pricelist instead of the webshop prices?

  • Preferred payment condition
    Select the preferred payment condition for orders

  • Preferred payment method
    Enter the preferred payment method for orders

  • Alternate contact person
    Indicate if a different contact person should be added to the order

  • Foreign debtor ledger account
    The debtor ledger account new foreign debtors will be assigned to

  • VAT duty code 3 to EU residents
    Assign VAT duty code 3 to EU residents (note that a valid VAT number is mandatory)

  • Payment method mapping
    Map Afas properties for specific order payment methods. Format: <status1>=<property1>:<property_value1>&<property2>:<property_value2>;<status2>=<property1>:<property_value1>. Example: Paypal=OrderProcessingCode:1&PaymentMethod:00; Properties that are currently supported are: PaymentMethod, PaymentCondition and OrderProcessingCode

  • Free field "Credit" for sales invoice
    The code for the free field "Credit" for sales invoices (please contact us if you don't have the free field)

  • Invoice to
    Should the invoice to field be filled with the debtor?

  • Additional warehouses
    Enter a comma separated list of warehouse codes that are used in addition to the default warehouse

  • Fixed debtor
    If you want all orders booked on the same fixed debtor, enter the debtor number of this debtor here

  • Balie / Directfacturen
    Do you want to create balie / directfacturen aangemaakt in Profit instead of sales orders?

  • 'Ordersoort'
    Please enter the 'Ordersoort' code below

  • Use preferred warehouse
    Should the preferred warehouse of the sales relation be used?

  • Enter a comma separated list of country codes below, of which consumers should get VAT code 5 ("Afstandsverkopen").
    Enter a comma separated list of country codes below for which consumer clients need to get VAT code 5 (distance selling).

  • Canonline specific product numbers to administration

  • Fill amount down payment
    Indicate if the field Amount Down Payment should be filled with the total order amount in case the order is paid. Note that Order Processing will be set to 7 (Aanbetalen, levering na aanbetaling) in Profit.

  • Map shipping method on expeditor
    Connect the shipping methods from your webshop to the corresponding expeditors in Profit

  • Add address to contact person
    The address will be added to the contact person

  • VAT duty code 1 to EU companies
    Assign VAT duty code 1 to EU companies that haven't filled the VAT number

  • Fill invoice reference
    Should the field invoice reference be filled with the order number?

  • Fixed product
    If you want all order lines booked on the same fixed product number, enter the product number of this product here

  • Vrijgifte Boxwise
    Do you want to fill in the field 'Vrijgave Boxwise' based on the payment status of the order? True if order is paid, false otherwise

  • Vat tariff groups
    For foreign orders, do we need to determine the vat tariff group on orderline level based on the used tariff in the order?

  • Mapping default pricelist for new debtors
    Map the default pricelist for new relations on the storeview

  • Languages per storeview for new debtors
    Enter the language code for new relations for every storeview

  • Sales relation profile per storeview for new debtors
    Enter the sales relatin profile code for new relations for every storeview

  • Add person name as department name
    Do you want to add the person name as department name?

  • Use preferred sales unit for orders
    Should the preferred sales unit be used for orderlines?

  • Orderline prices incl. vat?
    Should the orderline prices be inserted incl. vat when transferring them to Afas?

  • Create orders blocked
    Should orders be created blocked?

  • Order blocked amount
    Enter the amount limit to create orders blocked

  • Enter default verbijzonderingsas
    Enter the default 'Verbijzonderingsas' for invoice lines

  • Insert price incl. VAT
    Should prices be inserted incl. VAT in your webshop?

  • Delete products?
    Remove products that have been disabled for E-Commerce in AFAS Profit from your Lightspeed shop?

  • Enable category mapping
    Add and remove categories from products

  • Disable content synchronisation
    Do you want to disable synchronisation of content updates?

  • Product variants
    Do you want to create multiple variants per product (based on the Profit configuration)?

  • Product variant title attribute
    Enter the attribute in which the product variant title is entered (attribute1 .. attribute15)

  • Product filter attribute mapping
    Enter the mapping between the Lightspeed filter title and the corresponding attribute in Profit (attribute1 .. attribute15). Note, use the format: lightspeedFilterTitle1=attribute1;lightspeedFilterTitle2=attribute2;

  • Use Fresh Cotton categories

  • Product visibility
    Select the default visibility for new products

  • Sync Google meta fields
    Should the Google meta fields be transferred to Lightspeed?

  • Default product specification type
    Select the default product specification type for new products

  • Map product attributes
    Enter the mapping between the Lightspeed product specification attributes and the corresponding attributes in Profit (attribute1 .. attribute15). Note, use the format: lightspeedAttributeTitle1=attribute1;lightspeedAttributeTitle2=attribute2;

  • Send password email
    Send a password email to new customers?

  • Track and trace code
    Synchronise the track and trace codes from Profit to Lightspeed shipments?


4. The Combidesk customer dashboard

How does the dashboard work?

If you've created a new Combidesk account or installed a integration, you'll receive an email with access to your Combidesk account. When you log in to combidesk.com, you'll arrive at the dashboard. This is where your integration is located. From here, you can easily adjust your integration and account settings, view the integration logs (history), and access support.

What can you view via your Combidesk account?

From your Combidesk dashboard you also have access to your account settings, connected accounts, billing and support.


5. What can you expect from Combidesk?

We understand you're busy or perhaps have little software experience. That's why our specialized team is always ready to help. Take advantage of our installation packages to save yourself even more time.

Installation appointment

If you're short on time or would like us to handle the entire installation, take advantage of our remote implementation support. We'll take care of everything for you right away and deliver a fully functional connection. For most connections, installation support costs a fixed fee of €150, while others cost €300. If you decide not to continue with the connection after the trial period, there's no charge. Schedule an installation appointment below and schedule it right away.

Explanation of service level (SLA) subscriptions (Basic, Pro, Premium)

To help you use our integration effectively, we offer three service levels: basic, pro, and premium. You can always change the service level in your integration. The price will be adjusted for the next billing period.

Did this answer your question?