> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alumio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lightspeed eCommerce

> Connect Alumio to Lightspeed eCommerce.

## Extra information

System documentation: [REST API Documentation](https://ecom-support.lightspeedhq.com/hc/en-us/articles/220320568-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 the 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](https://ecom-support.lightspeedhq.com/hc/en-us/articles/1260804034770) to get the API key and API secret.

<img src="https://mintcdn.com/alumio/16faYbJJ7Q0GGNtK/images/connectors/lightspeed-ecommerce-01.png?fit=max&auto=format&n=16faYbJJ7Q0GGNtK&q=85&s=51ae4996442e04472dd3b0575a4015ce" alt="Lightspeed eCommerce connector screenshot 1" width="690" height="316" data-path="images/connectors/lightspeed-ecommerce-01.png" />

### 2. Subscribing to Entities from Lightspeed Ecommerce

**2.1 Steps**

1. Go to Connections -> Incoming and create a new [incoming configuration](https://forum.alumio.com/t/incoming-in-alumio/174) 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 the Lightspeed E-Commerce documentation for building this connector, so you can easily use the connector based on the Lightspeed E-Commerce Reference.

<img src="https://mintcdn.com/alumio/16faYbJJ7Q0GGNtK/images/connectors/lightspeed-ecommerce-02.png?fit=max&auto=format&n=16faYbJJ7Q0GGNtK&q=85&s=a88352aa5401ee94528b205181ca0972" alt="Lightspeed eCommerce connector screenshot 2" width="690" height="336" data-path="images/connectors/lightspeed-ecommerce-02.png" />

* "Path" is the path parameter of the url. For example the \{id}.
* "Query" is defined as a set of parameters attached to the end of a url.\
  Example: [www.url.com?type=true\&start=0](http://www.url.com?type=true\&start=0)

**Entity**

This is the entity you want to subscribe to 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.
Follow the instructions below for filling it in to get a Quote with Id **1016615295**.

<img src="https://mintcdn.com/alumio/16faYbJJ7Q0GGNtK/images/connectors/lightspeed-ecommerce-03.png?fit=max&auto=format&n=16faYbJJ7Q0GGNtK&q=85&s=6ab6c4ac00e91fd0620cb6d74151b8b9" alt="Lightspeed eCommerce connector screenshot 3" width="258" height="108" data-path="images/connectors/lightspeed-ecommerce-03.png" />

**Input Transformer**

Any [transformers](https://forum.alumio.com/t/where-to-place-your-entity-transformer-at-a-glance/203) set here will be executed after the Request Parameters are loaded. So, you can basically 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](https://forum.alumio.com/t/outgoing-in-alumio/175) 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.

<img src="https://mintcdn.com/alumio/16faYbJJ7Q0GGNtK/images/connectors/lightspeed-ecommerce-04.png?fit=max&auto=format&n=16faYbJJ7Q0GGNtK&q=85&s=2f40818dcbaeaa2b4c3e92b814523251" alt="Lightspeed eCommerce connector screenshot 4" width="690" height="200" data-path="images/connectors/lightspeed-ecommerce-04.png" />

**3.2 General 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 the 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 a defined set of parameters attached to the end of a url.\
  Example: [www.url.com?type=true\&start=0](http://www.url.com?type=true\&start=0)
* "Payload" is the data contained within a request.

**HTTP Client**

This is the HTTP Client configuration or prototype you will use to access Lightspeed E-Commerce.
