Connection Test Failure With 403 Errors

Issue

The Lightspeed Retail connection test fails with the following errors:

Endpoint /EmployeeHours.json fetch failed due to 

{"httpCode":"403","httpMessage":"Forbidden","message":"Not Authorized: 

Insufficient rights to perform the request","errorClass":"InsufficientRightsException"}

Endpoint /PriceLevel.json fetch failed due to 

{"httpCode":"403","httpMessage":"Forbidden","message":"Not Authorized: 

Insufficient rights to perform the request","errorClass":"InsufficientRightsException"}

Endpoint /SaleVoid.json fetch failed due to 

{"httpCode":"403","httpMessage":"Forbidden","message":"Not Authorized: 

Insufficient rights to perform the request","errorClass":"InsufficientRightsException"}

Environment

Connector: Lightspeed Retail

Answer

This error occurs if the Lightspeed Retail user creating the connection does not have the permissions required to access the endpoints listed in the error message.

To resolve this issue, do one of the following depending on the type of employee role assigned to the user creating the connection:

• If the user is assigned a built-in role (Owner, Admin, Manager, or Associate), grant the following permissions to the user by following the instructions in Lightspeed Retail's documentation:

  • Settings - Basic
  • Settings - Employee Setup
  • Settings - Void Sales

• If the user is assigned a Custom role, do the following:

  1. Log in to your Lightspeed Retail account.
  2. On the navigation menu, go to Settings > Employee Setup.
  3. Open the employee record of the user.
  4. In the Details section, click Rights.
  5. Grant the following permissions:
     • Settings - Basic
     • Settings - Employee Setup
     • Settings - Void Sales

NOTE: If you receive similar errors for other endpoints, follow the steps listed above for the permissions associated with the endpoints mentioned in the error message.

Cause

The permissions granted to the Lightspeed Retail user affect the scope of the Lightspeed Retail API. However, you can modify the employee role and user permissions. For more information, see Lightspeed Retail's documentation.