Convictional can ingest product information via an SFTP feed. For details on setting up your SFTP connection, see Convictional’s guide to SFTP.
Product Formatting: Convictional prefers for ingesting your product information, see their CSV Products template. This CSV must be uploaded to their SFTP server. If this template is not used, products will need to be manually mapped, which will require additional turnaround time.
Note On Inventory: Suppliers often upload their inventory information directly in their Product CSV. If this is not possible for you, please upload your inventory information in a separate CSV file to the SFTP folder. This separate file must contain your Product SKUs as well as inventory.
Sync Frequency: Products are synced hourly from Convictional to Lightspeed. Any updates you make to your product catalog will push through during the next sync.
Price Lists: Price lists outline the wholesale cost and retail price for your products. Price lists must be created or uploaded 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 POSTing 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 oder.
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.