Shopify integration

Shopify + Le New Black integration overview

Shopify is a popular e-commerce solution for small and medium businesses, that can be used for basic inventory and invoicing management. Le New Black acts as a collaborative B2B portal for your team and resellers and a sales rep facing iPad app that sends B2B orders back to Shopify.

	The connector uses Shopify API to exchange data (read docs)
	Le New Black is the master system for all data flows (eg. triggers all push/pull operations)
	The connector requires basic configuration in Le New Black and Shopify (see global prerequisites)

Data flows

Data flow: Inventory stock levels

Reference 

• Data flow: from ERP to LNB
• Shopify's API endpoints used:
  • Get inventory items: https://shopify.dev/api/admin-rest/2022-01/resources/inventoryitem#get-inventory-items 
  • Get inventory levels: https://shopify.dev/api/admin-rest/2022-01/resources/inventorylevel#get-inventory-levels

Facilities

• Your inventory data will reflect the available-to-sell quantities from Shopify.
• Inventory will be imported into Le New Black according to a schedule that you determine.
• You will be able to trigger this import manually by clicking a button from Le New Black if you need to refresh your stock level earlier.
• The inventory is based on either EAN13s or SKUs.

Prerequisites 

• Add permissions to your Shopify private app (see global prerequisites): write_inventory, read_inventory, read_products, read_locations

Data flow: Inventory stock movements

Reference 

• Data flow: from LNB to ERP
• Shopify's API endpoints used:
  • Get inventory items: https://shopify.dev/api/admin-rest/2022-01/resources/inventoryitem#get-inventory-items 
  • Get inventory levels: https://shopify.dev/api/admin-rest/2022-01/resources/inventorylevel#get-inventory-levels
  • Get inventory locations: https://shopify.dev/api/admin-rest/2022-01/resources/location#get-locations 
  • Post inventory level: https://shopify.dev/api/admin-rest/2022-01/resources/inventorylevel#post-inventory-levels-set 

Facilities

• Your inventory movement due to orders placed on Le New Black will be subtracted to the available-to-sell quantities in Shopify.
• You will be able to trigger this import manually by clicking a button from Le New Black if you need to update your stock earlier.

Prerequisites 

• Add permissions to your Shopify private app (see global prerequisites): write_inventory, read_inventory, read_products, read_locations

Data flow: Orders

Reference 

• Data flow: from LNB to ERP
• Shopify's API endpoints used:
  • Post order: https://shopify.dev/api/admin-rest/2022-01/resources/order#post-orders 
  • Put customer: https://shopify.dev/api/admin-rest/2022-01/resources/customer#put-customers-customer-id 

Facilities

• You will be able to select orders to be exported from Le New Black.
• Orders will be transferred from Le New Black according to a schedule that you determine.
• You will be able to trigger this export manually by clicking a button in Le New Black if you need to send orders earlier.

Callouts

• Products without EAN13/SKU codes won't be exported.
• After the order has been exported from Le New Black, any further changes must be done directly into Shopify.
• Customers without a valid customer reference will block the order export. 

Prerequisites 

• Add permissions to your Shopify private app (see global prerequisites): write_orders, read_products

Global prerequisites

You must create a private app in Shopify (see Shopify documentation) and follow these 2 steps: 

1. Generate API keys (see Shopify documentation) that you will provide Le New Black with and that look as follows:
   • API key: verylongstringwithlettersandnumbers
   • API secret: otherlongstringwithlettersandnumbers
   • Shopify URL: https://mysubdomain.myshopify.com/
2. Set API scope with the following permissions (see Shopify documentation): 
   • Inventory flows: write_inventory, read_inventory, read_products, read_locations
   • Order flow: write_orders, read_products

Integration project

Who's assigned from your team

Your Shopify administrator, or someone technical who is familiar with your specific setup. A Sales Manager who understands your business, and your merchandising strategies. 

Who's in charge at Le New Black

Your account manager will be taking care of the whole process from day 1. He/she'll be doing:

• Asking questions about your specific Shopify setup and sales process.
• Generating and exporting test orders to Shopify.
• Making sure your team is updated throughout the process and addressing delays occurring on either side.
• Working with you and Shopify support to troubleshoot any unexpected issues that arise after launch.

Timeline

A standard integration of the inventory stock levels and orders data flows will take 2-4 weeks to get up and running. 

Integration monitoring

Once the connector is set up, you will have access to the Integration center to manage and monitor your integration with a set of tools:

• access to task logs files for continuous monitoring and troubleshooting (e.g. see if a missing EAN13 or retailer reference is preventing an order from being exported)
• triggers task manually to push and pull data on-demand
• preview data before actual import (only available on some connectors)