Mais conteúdo relacionado Semelhante a Jet Shopify Integration by CedCommerce (20) Jet Shopify Integration by CedCommerce1. © CedCommerce. All rights reserved.
SUPPORT@CEDCOMMERCE.COM
[Jet Shopify Integration]
CedCommerce Jet-Shopify Integration, an app developed by CedCommerce that synchronize the
inventory, price, other details for product creation and its management between Shopify store with
Jet.com. The smooth harmonization is established with help of Jet.com REST API.
2. © CedCommerce. All Rights Reserved.
2
Jet-Shopify Integration
User Manual
Version – 0.0.3
3. © CedCommerce. All Rights Reserved.
3
Contents
I. Overview ....................................................................................................................................................4
II. Jet Login ....................................................................................................................................................4
III. Jet Configuration Settings........................................................................................................................9
IV. Create Jet Categories………………….…………………………………….………………………………………………………………13
V. Manage Product……………………….….……………………………………………………………………………………………………15
i. Jet API…………………….……………………….………….………………………………………………………………………………..21
ii. Mass Upload Product………………………….……..………………………………………………………………………………..22
iii. Archive Product………….….…………………………………..……………………………………………………………………...23
iv. Unarchive Product…………………..………………………………………………………………………………………………….23
v. Rejected Files…….………………………………………………………………..………………………………………………………24
vi. Shipping Exception…………………………..………………………………..……………………………………………………….25
vii. Return Exception…………………..…………………………………………..………………………………………………………26
VI. View Jet Order. ......................................................................................................................................27
VII. View Failed Import Jet Orders Log........................................................................................................28
VIII. Jet Return….……………………………………………………………………………………………………………………………………29
IX. Jet Refund…………………………………………………………………………….…………………………………………………………..31
X. Jet Settlement……………………………………………………………………………………………………………………………………33
XI. Cron Status…..………..…………………………………………………………………………………………………………………………34
XII. Support.. ...............................................................................................................................................34
4. © CedCommerce. All Rights Reserved.
4
Overview
Jet-Shopify Integration, an app by CedCommerce, establishes a synchronization of inventory,
price, other details for product creation and its management between Shopify store and
Jet.com. The smooth harmonization is established with help of Jet.com REST API.
This app provides various key features:-
• User friendly interface delivers bulk management (product upload, product close,
product open).
• Maps single Shopify store to Jet.com with a single Fulfillment node.
• Imports Jet.com orders to convert it into regular Shopify Orders & Shipments.
• Merchant can manage returns & refunds of jet products from admin panel.
In this app, currently we have provided support for Shopify Simple (Products with No Variants)
and Variation (having size, color, etc variants) products to be uploaded to Jet.com
Jet Login
You need to generate the license from your CedCommerce customer account and fill the
domain name. Once you enter the domain and get the license key you then need to click on the
“Click to Integrate Jet-Shopify” button in green which will take you further to the login page
to carry out the installation (as shown in the below image).
Note: The domain that you enter should be of the form shopname.myshopify.com and it
should be the same as to be used for Login. For e.g. your shop URL or domain name can be
fashion.myshopify.com.
Here is the screenshot where you can enter the shop URL and get the license key
5. © CedCommerce. All Rights Reserved.
5
After generating the license, click this button “Click to Integrate Jet-Shopify”.
6. © CedCommerce. All Rights Reserved.
6
The first screen will be the home page from where you can login to your Shopify store login
panel.
7. © CedCommerce. All Rights Reserved.
7
Note: The domain name that you enter should be of the form shopname.myshopify.com and it
should be exactly the same as used at the time of Generating License for downloading your
app. For e.g. your shop URL or domain name can be fashion.myshopify.com.
After successful login you will be redirected to our Jet-Shopify app’s home page.
You now will be able to see the Jet Menu on the menu bar adjacent to Home. The integration
Enter your shop URL here
and click Install button.
9. © CedCommerce. All Rights Reserved.
9
Jet Configuration Settings
Jet Configuration panel is used to configure jet API with Jet-Shopify Interface for API calling. In order to
integrate Shopify with jet.com API credentials are needed to establish a connection between jet.com
and Jet-Shopify Interface.
To configure the setting you need to click on Jet > Jet Configuration.
Enter this URL https://merchant-
api.jet.com/api over here.
Equivalent to API User
field in Jet Partner Panel.
Equivalent to Secret field
in Jet Partner Panel.
10. © CedCommerce. All Rights Reserved.
10
In order to obtain the Jet API key, Jet Secret key and Fulfillment Node Id the merchant needs to
go to https://partner.jet.com/ and login to his account and get API credentials.
You can switch from Test
mode to Live mode from here.
Click here to Get API Keys for Test mode.
To obtain Live mode credentials click on
the Live button at the bottom left corner.
Test mode credentials.
11. © CedCommerce. All Rights Reserved.
11
To obtain Fulfillment Node Id go to Jet Partner Panel > Live mode > Fulfillment (from left
menu) > Fulfillment Node Id column.
Note: Fulfillment Node Id remains same both for Test mode and Live mode.
Test mode
credentials.
Enter this in the Api user field of the
App’s Configuration Settings.
Equivalent to
Api password
field of the
app.
12. © CedCommerce. All Rights Reserved.
12
Mandatory Fields for API Integration:
In the Return Location, the merchant needs to enter the address where product has to be
returned if any return is generated for completed orders.
Enter this value in the Api Fulfillment
Node Id field in the Configuration
Settings of the app.
Enter this address in the
Return Location field of
the app.
Enter Return Location
Address over here as
in Jet Partner Panel.
13. © CedCommerce. All Rights Reserved.
13
Set default price for all products (in case of Back Orders) – As Jet does not allow negative
quantity of a product to place the orders, therefore, a default quantity has be set here in this
field, so that, at the time of product upload (on jet.com) this default quantity will be treated as
the available quantity (inventory) of the product. But, this feature will be available only if Back-
Order facility is available.
In the Shopify Customer Detail section, the merchant needs to enter details. If the “Auto
acknowledge” field is set to “Yes” then all the orders created from jet.com will get
automatically acknowledged. Otherwise, the merchant needs to acknowledge the order
manually. In jet.com, every order must be acknowledge within 2 hours from the time of order
creation. If you set “Auto acknowledge” field to “No” then you need to manually acknowledge
the order within 2 hours.
These configurations are mandatory to set before integrating Shopify store with jet.com and
this should be the first step after installing the app on your site.
Create Jet Categories
To create Jet categories click on Jet > Jet Category in the menu section to open the Jet Category Page as
shown below.
If a product to be
uploaded on jet.com
happens to have
negative quantity
then the quantity
entered in this field
will be treated as
the default quantity
of the product.
14. © CedCommerce. All Rights Reserved.
14
After the categories get created they can seen on the Product Edit page. For this purpose, go to Jet >
Jet Manage Products > Upload Product > Select the product to be edited.
Click the Categories tab. The created categories will be listed over there and their respective attributes
will be listed in the Attributes tab.
1. Select the
categories that
have to be created.
2. Click the Submit button.
3. The status of the
categories will change from
“not created” to “created”.
15. © CedCommerce. All Rights Reserved.
15
Manage Products
After the categories get created in Shopify, they need to be assigned to the products.
Go to Jet > Jet Manage Products > Upload Product > Select the product to be edited
The created categories
will be listed here.
17. © CedCommerce. All Rights Reserved.
17
The General Information tab:-
In general tab the brand filed is required.
“Brand” field will have the same
value as in this field “Vendor”.
This field will be auto-filled with the same value
as in the “Vendor” field in the above image.
18. © CedCommerce. All Rights Reserved.
18
Note: Following fields are mandatory for uploading products on jet.com:
Brand + UPC or
Manufacturer part number + brand or
ASIN + brand
Since the Brand field is mandatory to be filled as per Jet specifications, therefore, this field
contains pre-filled value (which cannot be edited) that is the same as in the Vendor field
because Vendor is itself a brand. E.g. If Nokia is the vendor then it is the brand itself.
In Categories tab:
Select one of the categories from category tree to automatically enter the corresponding
category id in the required field. (Mandatory)
Note: One product should be assigned to only one Jet Category and not more than that. A
category can have multiple products but a product should be mapped to only one category.
As soon as the Jet category is selected its related
attributes will be shown in the “Attributes tab”.
This field is required. So a category has to be
selected to enter the Category Id in this field.
19. © CedCommerce. All Rights Reserved.
19
In Attributes Tab:
Note: Once you select the category then only the attribute corresponding to that category will
be listed. Every category has some attributes, therefore select the category first and then fill
the attribute value to ensure proper category and attribute mapping. If any attribute has 'unit'
then you need to fill the unit along with the attribute value. Attributes help in listing the
product on jet.com.
For Products with No Variants
If the product has been successfully uploaded then instead of three, five tabs will be shown in the above
screenshot which are Shipping Exception and Return Exception (as shown on Page 24).
The attributes of the selected
category will be listed here.
1. Select 1 option in case of dropdown type
jet attribute (like language).
2. Enter attribute value in case of textbox
type jet attribute (like: size).
3. Enter the value with units for unit-type
jet attribute (like: weight).
20. © CedCommerce. All Rights Reserved.
20
For Variation or Configurable Products
Enter the Jet Attribute Id of that Jet attribute
which has to be mapped to the Shopify Attribute.
The attributes of
your Variation
product on the
Product Edit Page of
your Shopify admin
panel will be listed
in the “Attributes”
section of the app.
These attributes can
then be mapped to
the Jet Attributes
(see the image
below).
These are the values of the attributes for respective simple
products which are associated with this variation product.
Variation
options of this
variation
product.
21. © CedCommerce. All Rights Reserved.
21
i. Jet API
To integrate Shopify store with jet.com the merchant needs to enable all the API's
with jet.com. First the merchant needs to enable the product API (s) then move to
order and return API.
Important Note: To run Test APIs you have to create one or two products (if not
already created) complete in all respects or update the first product of your store
including categories and attributes, price, SKU, Brand + UPC or Brand +
Manufacturer Part Number or Brand + ASIN, etc and all the other necessary details
required for uploading a product on Jet.com as Test API uploads a Test Product on
Jet.com and this Test Product will be the first product present on your store.
If that product is not complete in any respect then you will be redirected to the
Product Edit Page.
22. © CedCommerce. All Rights Reserved.
22
ii. Mass Upload Product
After editing each product next step is to upload the product in bulk to jet.com. For
this purpose, select the product that you want to upload on jet.com and then
choose “upload” option from the dropdown and then click the “Submit” button.
If the entire product information is correct as per the guidelines of jet.com then it
will be uploaded successfully on jet.com and the status of the product will be
changed to “processing”. If the product is not uploaded successfully then the
merchant can view all the errors in the “Rejected Files” panel (describe later).
23. © CedCommerce. All Rights Reserved.
23
iii. Archive/Close Product
Jet.com provides the ability to close the uploaded product. If the merchant wants to
close his uploaded product at any time, then he needs to select the product
followed by selecting the “Archive” action then click on the “Submit” button. After
that, the product will be archived successfully and the status will be changed to
“Archived”.
iv. Reopen/Enable/Unarchive product
Jet.com provides the ability to reopen closed products. The merchant needs to
select the archived product followed by selecting the “Unarchive” option and then
click the “Submit” button. The selected product will be available again for purchase
on jet.com and the Product Status will be changed to “processing”.
24. © CedCommerce. All Rights Reserved.
24
v. Rejected files
We upload jet.com product using their file upload process. Due to any reason if an
error occurs during product upload then that product will be listed in the Rejected
File panel. After uploading the products in bulk, if any product has incorrect
information and did not got uploaded successfully on jet.com then, in that case, the
merchant can fetch the entire error file information and Resubmit the product for
uploading after correction.
Click on the “Fetch Rejected Files” button.
25. © CedCommerce. All Rights Reserved.
25
On Clicking the View button the merchant can resubmit this file by clicking on the “Resubmit“
button after product correction.
vi. Shipping Exception
Shipping Exception is nothing but just a caution notice that should be sent with the
package to the customer like “The Item is delicate; please handle carefully”, “Glass
product; to be shipped with care”, etc. To add Shipping Exception, the merchant
needs to click on the “Edit” icon on the Manage Products page. There he’ll find a tab
“Shipping Exception”. The merchant needs to fill in the requisite details over here
and click on the Update button to save the information.
26. © CedCommerce. All Rights Reserved.
26
vii. Return Exception
In case the customer wants to return the product (s) that he has purchased then
Return Exception is used to give him an idea about the return location of the
product, the shipping method to be used for returning the product and the time
frame of return. To add the Return Exception click on the “Edit” link to open the
Product Information page. Click on the “Return Exception” tab to add the exception
and then click on the Send button.
27. © CedCommerce. All Rights Reserved.
27
View Jet Order
To fetch the orders created in jet.com the merchant should go to Jet > Orders> View Jet Order
and click on Create Jet Order button.
Firstly, the merchant should notify jet.com that whether he is able to fulfill the orders or not.
For this we have added two buttons Acknowledge and Reject. If a merchant is able to fulfill the
orders then he needs to send an acknowledgement. Otherwise, he needs to send a reject
request. As the merchant clicks on the Acknowledge button, jet.com gets notified that the
merchant is able to fulfill the order. If the merchant clicks Reject button then that order will be
rejected from jet.com.
If the merchant has set Auto-Acknowledge field to yes in Jet Configuration tab then he does not
have to acknowledge the newly created orders. The orders will be acknowledged automatically.
The merchant just needs to ship the order to complete the order. Upon completion of the
shipment process the order status is changed to “Complete”.
28. © CedCommerce. All Rights Reserved.
28
View Failed Import Jet Orders Log
This section displays the failed orders with their order id and the reason for their failure.
29. © CedCommerce. All Rights Reserved.
29
Jet Return
This panel lets the merchant know about the returns generated for the completed orders on
jet.com. Whenever a return will be generated for a completed order by a jet customer then it
will be listed in the return panel with the status “Created”.
To fetch newly created return from jet.com. Merchant can click on “fetch jet return” button.
30. © CedCommerce. All Rights Reserved.
30
To complete the return the merchant needs click on “update” button to fulfill the return by
entering some information like quantity refunded, return feedback, and agree to return or not.
31. © CedCommerce. All Rights Reserved.
31
• Qty Refunded
Here the merchant needs to enter the quantity he wants to refund to the customer.
• Return RefundFeedback
Here the merchant needs to enter the feedback about the return.
• Agree To Return
If the merchant has agreed to return the charges that customer has requested, then the
merchant needs to select ‘yes’, otherwise ‘no’.
Once the merchant fills all the required fields and then clicks on the Update button, his return
will be completed on jet.com.
Jet Refund
If the merchant ships any order generated on jet.com and after that if a jet customer request
the return of any product directly from the merchant without the involvement of jet.com, then
the merchant needs to send a request on jet.com for complete return. To manage this type of
return there is a panel named ‘Jet Refund’.
In this case, the merchant needs to click on ‘Create New Refund’ button. This will open a form
for entering the information.
32. © CedCommerce. All Rights Reserved.
32
i. Refund id
This is the refund id that the merchant will get from jet.com after the refund request has been
created. Merchant doesn’t needs to enter this at the time of refund creation.
ii. Merchant Order Id
This is the order id for which return request has been generated.
iii. Order item id
This is the item id that has been ordered.
iv. Qty Returned
This is the total quantity that has been returned. It should not be more than the shipped qty.
v. Qty Refunded
This is the quantity that the merchant wants to refund. It should not be more than the returned
quantity.
vi. Refund tax
This is the tax applied on the products that are returned.
vii. Refund Amount
This is the amount that jet has to return to the customer.
viii. Shipping Cost
This is the shipping cost applied on the returned product.
33. © CedCommerce. All Rights Reserved.
33
ix. Shipping tax
This is the shipping tax applied on the returned product.
x. Refund Feedback
This is the feedback that the merchant wants to send about the returned product.
xi. Refund Reason
This is the reason why customer has returned the product.
Jet Settlement
The Settlement API provides methods to retrieve all the details regarding merchant payment
for sale on Jet.com. This schema also provides settlement information for customer generated
returns where Jet must refund the customer.
Enter the number of days here and click the Submit button.
34. © CedCommerce. All Rights Reserved.
34
Cron Status
The updated status will be reflected (visible) as follows:-
Activity Time Required for Updating (min)
Order Creation 8
Error in Rejected Files 60
Return Status 60
Refund Status 60
Product Status 60
Support
If you need support or have questions directly related JET-SHOPIFY INTEGRATION, please use
our Online Message Form to contact our support team or send us an email at
support@cedcommerce.com
Note: If you face any problem related to app installation then you can provide us your Shopify
admin store URL as well as login credentials to install Jet-Shopify app for your store (shop).
Best Regards,
CedCommerce Team
After some time these links will be visible;
clicking on them will display the order, payment
and return related details (if any) in a popup.