About the Lightspeed eCommerce category

[Roland]

Put topics about this connector package here.
Always check the ‘How to use the Alumio connector packages’ topic.

Extra information

System documentation: REST API Documentation

Connector package documentation

​​Table of Contents

• 1. Setting up HTTP Client Lightspeed E-Commerce
  • 1.1 Steps
• 2. Subscribing to Entities from Lightspeed E-Commerce
  • 2.1 Steps
  • 2.2 General Concept
• 3. Publishing Entity to Lightspeed E-Commerce
  • 3.1 Steps
  • 3.2 General Concept

1. Setting up HTTP Client Lightspeed Ecommerce

1.1 Steps

1. In Alumio Dashboard, go to Clients → HTTP Clients.
2. Create a new HTTP Client and select Lightspeed E-Commerce HTTP Client as the prototype.
3. Fill in the Base or Cluster URL, API Key, API Secret and Shop language.
4. Refer to this article to get the API key and API secret.

2. Subscribing to Entities from Lightspeed Ecommerce

2.1 Steps

1. Go to Connections → Incoming and create a new incoming configuration and select Lightspeed E-Commerce Subscriber as the subscriber.
2. Select the entity you want to subscribe.
3. Select the Lightspeed E-Commerce HTTP Client to use.

2.2 General Concept

We follow Lightspeed E-Commerce documentation on building this connector so you can easily use the connector based on Lightspeed E-Commerce Reference.

• Path is the path parameter of the url. For example the {id}.
• Query is defined set of parameters attached to the end of a url.
  Example: www.url.com?type=true&start=0

Entity

It’s the entity you want to subscribe from Lightspeed E-Commerce.
Please refer to the entities in Management APIs from the Lightspeed E-Commerce API Reference page.

Request Parameters

These are the parameters you can provide to get the needed entity based on the Lightspeed E-Commerce API Docs.
See below how you’d fill it to get a Quote with Id 1016615295.

Input Transformer

Any transformers set here will be executed after the Request Parameters loaded. So, you basically can add any transformer to provide and transform the request parameters into anything you need either as path parameters and/or as query parameters of an entity.

HTTP Client

It’s the HTTP Client configuration or prototype you will use to access Lightspeed E-Commerce.

3. Publishing Entity to Lightspeed Ecommerce

3.1 Steps

1. Go to Connections → Outgoing, create a new outgoing configuration and select Lightspeed E-Commerce Publisher as the publisher.
   2.Select the action that you want the publisher to do with the data.
2. Select the Lightspeed E-Commerce entity you want the data to be published towards.
3. Select the HTTP Client to use.

3.2General Concept

Like the subscriber, the publisher has similar methods on how to use it.
The difference is the payload. The payload used by a publisher originates from the data (from routes, from transformers in outgoing configuration), though you can also add or modify payload using the Request Transformer.

Action

Currently, we support Create (HTTP POST method), Update (HTTP PATCH method) and Delete (HTTP DELETE Method).

Entity

We support publishing to most Lightspeed E-Commerce endpoints. Based on the documentation, some endpoints may need one or more path parameters.

• Path is the path parameter of the url. For example the {id}.
• Query is defined set of parameters attached to the end of a url.
  Example: www.url.com?type=true&start=0
• Payload is the data contained within a request.

HTTP Client

It’s the HTTP Client configuration or prototype you will use to access Lightspeed E-Commerce.