For suppliers with complex infrastructure, ERPs, or custom environments, Convictional offers an open API for you to use to transact via Lightspeed Supplier Market. API documentation is available at https://developers.convictional.com/reference/seller.
Product Formatting: Products are created via POST/ Products. Variants are nested underneath a Product Code. Note that Lightspeed requires:
- Validated GTINs ((EAN, UPC, ITF-14, ISBN)
- No more than 12 images per product
- No more than 100 variants per product
Price Lists: Price lists outline the wholesale cost and retail price for your products. Price lists must be created within the Convictional Prices tab or via POST. See Convictional’s guide on price lists. Note: any new products must also be added to a price list before they can sync.
Order Information: Sellers using CSV/SFTP can view Lightspeed orders within the Convictional Orders tab or receive Order information from Convictional’s GET/ Orders endpoint. New orders will sync every 15 minutes from Lightspeed to Convictional as well as order updates sent from Convictional to Lightspeed. See Convictional’s guide on Updating Orders.
Note: It is recommended that GET/ Orders is polled at a frequency of daily, hourly, or up to every 15 minutes, based on your capabilities.
Fulfilling Orders: Information for the Merchant name and address will be visible in-app or in the response body. Orders can be fulfilled partially or in full. Shipment information (ex tracking number) can be uploaded to Orders directly via the Convictional app or via POST to the API.
Order Status: Order status is either “incomplete” or “complete” for Lightspeed orders processed via Convictional. Merchant orders that have not received fulfillment information are marked as incomplete until such information is sent to Convictional. Orders are complete when all products have fulfillment information associated with them. Orders can be cancelled by Suppliers from within the Lightspeed Supplier dashboard. Merchants must contact their supplier to cancel an order.
Paid Status: Orders display as “paid”. Payment for orders occurs outside of Lightspeed and Convictional. To receive payment for your order, please invoice your merchant directly as per your usual process.