Jet Prestashop Integration by CedCommerce

© CedCommerce. All rights reserved.
SUPPORT@CEDCOMMERCE.COM
[Jet Prestashop Integration]
CedCommerce Jet-Prestashop Integration, an extension developed by CedCommerce that
synchronize the inventory, price, other details for product creation and its management
between Prestashop store with Jet.com. The smooth harmonization is established with help of
Jet.com REST API.

© CedCommerce. All Rights Reserved.
2
Jet-Prestashop Integration
User Manual
Version – 0.0.1

3
Table of Contents
Overview......................................................................................................................................... 4
Configuration Settings .................................................................................................................... 4
Jet API.............................................................................................................................................. 7
Create Jet Categories...................................................................................................................... 7
Manage Jet Attributes .................................................................................................................. 10
Assign Category To Product.......................................................................................................... 11
Add Jet Specific Data to Products................................................................................................. 12
Mass Upload Product................................................................................................................ 15
Archive/Close Product............................................................................................................... 15
Reopen/Enable/Unarchive product.......................................................................................... 16
Rejected files............................................................................................................................. 17
Shipping Exception.................................................................................................................... 17
Return Exception....................................................................................................................... 18
Upload Product Relationships................................................................................................... 19
View Jet Product Related Information...................................................................................... 19
View Jet Order............................................................................................................................... 20
View Failed Import Jet Orders ...................................................................................................... 24
Jet Return...................................................................................................................................... 24
Jet Refund ..................................................................................................................................... 27
Settlements................................................................................................................................... 29
Cron Status.................................................................................................................................... 30
Support.......................................................................................................................................... 30

4
Overview
Jet-Prestashop Integration, an extension by CedCommerce, establishes a synchronization of
inventory, price, other details for product creation and its management between Prestashop
store and Jet.com. The smooth harmonization is established with help of Jet.com REST API.
This extension provides various key features:-
• User friendly interface delivers bulk management (product upload, product close,
product open).
• Maps single Prestashop store to Jet.com with a multiple Fulfillment node.
• Imports Jet.com orders to convert it into regular Prestashop Orders & Shipments.
• Admin can manage returns & refunds of jet products from admin panel.
In this extension, currently we have provided support for Prestashop Standard products which
means only Standard products can be uploaded to Jet.com
Configuration Settings
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.

5
To configure the setting you need to click on Jet > Configuration.
Mandatory Fields for API Integration:
Add details of filled at Jet Partner Portal and merchant id and fulfillment node id generated
there.

6
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. Also add details of return node that
was generated at Jet Partner Portal.
In the Prestashop Customer Detail section, the merchant needs to enter details. If the Auto
a k o ledge field is set to Yes the 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 15 minutes from the time of
order creation. If you set Auto acknowledge field to No the ou eed to a uall
acknowledge the order within 15 minutes.
These configurations are mandatory to set before integrating Prestashop store with jet.com
and this should be the first step after installing the extension on your site.

7
Jet API
To integrate Prestashop store with jet.com the merchant needs to enable all the API's with
jet.com. After a merchant has created its products for jet, the merchant needs to enable the
product API (s), test and understand shops coordination with jet, and then move to order and
return API.
Create Jet Categories
To upload a product on jet.com, the product must be assigned to a jet category. The merchant
needs to create a jet category which can be done with the help of a csv file having all the
categories that have to be created in Prestashop.

8
The CSV file to be uploaded should follow the given format:-
While creating your own csv, it is important to keep in mind that, if you are creating a second
level category then its parent level categories should also be mentioned along-with their ids in
the csv file. If not 0th
level category then atleast 1st
level category must be mentioned in the csv
along-with its parent id in the csv file.
For example:
Grocery (0th
level) is the parent of Beverages (1st
level) and Beverages is the parent category of
Cocktail Mixers (2nd
level). Therefore, to add any 2nd
level category merely defining it in the csv
is not enough. Its parent level categories should also be defined. This is done because for 2nd
level category its parent category (1st
level) could be obtained by its parent id but for the 1st
level parent category its corresponding 0th
level parent category cannot be obtained because
Click here to download the csv.

9
there is parent id as 1st
level category is not even defined. Therefore, defining at least 1st
level
parent category is necessary.
Parent Id of 0th level category is missing. So, at least 1st level category should be defined.
Click on Download CSV link to download the sample csv and then after updating your csv you
can choose your csv by clicking on Browse CSV File button and then click on the Create
Category utto . Your categories will be created. You need to wait for a while, until each
category is created on your shop, do not attempt to refresh the page. You will be redirected to
Catalog / Categories table and you can view new categories under Jet root category with the
same hierarchy as your csv.

10
Manage Jet Attributes
Once the jet categories are created, they will get listed in the Categories tab. After category
creation, attributes should be created for corresponding categories.
Every Jet category has a specific set of attributes (not attribute set just a certain number of
attributes) associated to it.
O the Ma age jet attri utes page ou ill fi d fe jet attri utes alread i the list. These are
those attri utes that are o o to all jet produ ts. You a add e attri utes fro Ma age
Attri utes anchor tag button on the toolbar, for specific categories created buy you.
Click here to create
new attributes.

11
Assign Category To Product
After the categories get created in Prestashop, they need to be assigned to the products.
Go to Catalog > Products > Select the Product you wish to upload on jet.
In the Associations Tab you can see the jet sub categories listed. Select a jet category to which
you wish to upload the product as you default category.
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.
If you have selected multiple jet categories in product associations, the properties and
attributes will be filtered only according to the Default Product Category.
Select as Default
category.

12
Add Jet Specific Data to Products
Go to Catalog > Products > Select the Product you wish to add data.
Go to Jet Prestashop Integration tab.
The form contains all options which you can choose to upload on jet.
Note: Jet identifies your Product with the Merchant SKU, so you need to enter a unique
Merchant sku for each individual product and product combination. If in any case merchant Sku
in repeated the information of the product will be one of the later which has been uploaded on
jet.
… Select Jet Prestashop
Integration Tab.

13
If the produ t o tai s Co i atio s he e ea h o i atio eeds to upload o er jet as
unique product with default combination as the Parent SKU and other combinations as child
sku, and Variant relation, according to the module. You can see an additional table similar to
one that you see in combinations tab, with Combination List and jet information stored, i.e.
Merchant SKU.
In order to save and edit each combination, click on the row to navigate to edit page.
Click Row to edit
Combination Details

14
In order to edit Product Jet Information for each Product after once selecting its default
Category you can also, go to Jet > Upload Products > Select the edit button in front of the
product to be edited.
Note: If you wish to upload Jet Relationships or Product and product combinations over jet the
brand field is required.
Click Edit to update/
change product details.

15
Mass Upload Product
After editing each product next step is to upload the product in bulk to jet.com. For this
purpose, select the products that you want to upload on jet.com and then choose upload
Selected option from the Bulk Action Drop down.
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 Under Jet
Review . If the product is not uploaded successfully then the merchant can view all the errors in
the ‘eje ted Files pa el (described later).
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
Ar hi e Selected bulk action. After that, the product will be archived successfully and the
status will be cha ged to Archived”.
Click Upload Selected to
Upload Products over Jet.
Product Jet Status changes to
‘Under Jet Review’ after Upload.

16
Reopen/Enable/Unarchive product
Jet.com provides the ability to reopen closed products. The merchant needs to select the
archived product follo ed sele ti g the Unarchive Selected” Bulk Action. The selected
product will be available again for purchase on jet.com and the Product Status will be changed
to Under Jet Review”.
Click Archive Selected to
Archive Products over Jet.
Product Jet Status changes
to ‘Archived’ after Archive.
Click Unarchive Selected to
Enable Products over Jet.

17
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.
On Clicking the View button the merchant can resubmit this file by clicking on the Resubmit
file button after product correction.
Shipping Exception
Merchant can also add a shipping Exception Details. This feature includes the ability to define
what shipping level, carrier, or method a SKU may be shipped when an order is placed.
Additionally, an extra charge to normal shipping rates may be applied to a SKU or the normal
shipping rates can be superseded when the customer places an order.
Go to Jet> Upload Products > Edit (Selected Product)
Click on the “Fetch Rejected
Files” button.

18
Here ou a see “hippi g E eptio Pa el if at least o e ou ha e uploaded the sele ted
product over Jet.
O e ha e filled the shippi g e eptio For a d ou li k “a e Butto the data is also
uploaded over jet.
Return Exception
Merchant can also add a Return Exception Details. This feature includes the ability to define
specific return details for a particular Product.
Go to Jet> Upload Products > Edit (Selected Product)
Here ou a see Return E eptio Pa el if at least o e ou ha e uploaded the sele ted
product over Jet.

19
O e ha e filled the retur e eptio For a d ou li k “a e Butto the data is also uploaded
over jet.
Upload Product Relationships
If you want to upload product and each Product Combination over jet, then we can uploads
each combination as an individual product and establish the relation among these as
Variatio . I order to do so e ha e a pa el Jet Varie t ‘elatio o Jet> Upload Products >
Edit (Selected Product) page. It is visible only if a combination exists for jet product and the
product has been uploaded over jet.
Select the various attributes that creates the difference among the combinations, i.e. the
attributes that creates each combination, a d li k Upload ‘elatio to upload relatio
information over jet.
View Jet Product Related Information
When you click a row at Jet> Upload Products> Select the product to view, you can view the
Information you have saved in you prestashop database regarding each product.

20
For combination Product it displays information of default combination of the product.
Fro the Fet h Uploaded Data of er ha t sku utto ou a fet h a d read data that has
been received at jet and stored in the form of json array. Here you can match to what
information you are sending and what is been saved at jet.
View Jet Order
To fetch the orders created in jet.com the merchant should go to Jet > Jet Order and click on
Fetch New Orders anchor button on the toolbar. If any order is available for the merchant new
orders will be created at Prestashop ith status read you can navigate to the new Orders >
Orders> Select Orders details page directly by clicking on Jet > Jet Orders > Select Order.
Click on the “Fetch Uploaded
Data of (merchant_sku)” button.
Information Saved for Jet from
edit products.
Information Retrieved from Shop.

21
In the order details page a additio al pa el Jet Order Details is a aila le if it is a jet order.
Firstly, the merchant should notify jet.com that whether he is able to fulfill the orders or not.
For this we have added buttons to Acknowledge or Reject orders. 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 wants to Reject he needs to choose and
inform jet that why he is rejecting the order.
Click on the “Fetch New Orders”
button.
New Order is created with ‘Ready’
Status.

22
If the merchant rejects an order due to an item level error. He also needs to mention that which
ite has the ite le el error fro the Produ t A k o ledge e t “tatus . Else the optio
should e fulfilla le if o e ishes to a k o ledge/ a ept order.
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 .
If the merchant reject the order the Order Status over Jet is updated as completed. And over
shop the Jet “tatus is reje ted . A d the Order is updated to Ca eled status.
If a Jet Order is Acknowledged the Prestashop Order is updated to paid o jet and Shipping
I for atio is a aila le to fill, a d to se d ship e t. A d Prestashop Order s Jet “tatus is
updated to Acknowledged , a d Order o er Jet is updated to acknowledged .
The Jet Order has been rejected
by vendor/ merchant.
Order Status updated to ‘Canceled’.

23
Fill in Shipment details a d li k o “u it “hip e t Button. The Prestashop Order Status is
updated to “hipped , Prestashop Jet “tatus to o plete a d Order status o er jet to
o plete .
Order Status updated to ‘Paid on jet’.
Jet Order details Panel shows
Shipment Form for jet.
Order Status updated to
‘Shipped’.

24
And “hippi g I for atio is displa ed i Jet Order Details Pa el.
View Failed Import Jet Orders
If merchant fails to upload any order, created by jet, the failed order details are saved in Jet>
Failed Import Orders. This section displays the failed orders with their order id and the reason
for their failure.
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”.

25
To fetch newly created return from jet. o . Mer ha t a li k o fet h jet retur utto .
To o plete the retur the er ha t eeds li k o edit utto to fulfill the return by
entering some information like quantity refunded, return feedback, and agree to return or not.
Click ‘Fetch new return’.

26
Qty Refunded
Here the merchant needs to enter the quantity he wants to refund to the customer.
Return Feedback
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
er ha t eeds to sele t es , other ise o .
Once the merchant fills all the required fields and then clicks on the “u it ‘etur button, his
return will be completed on jet.com.

27
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 er ha t eeds to li k o Add New’ button. This will open a form for entering
the information.

28
From the ‘efu d Order Id sele t the order for hi h ou ish to add ‘efu d I for atio a d
li k “ele t Order utto . A e for appears ith fe prefilled i for atio a ordi g to the
items in the selected order.
Qty Returned
This is the total quantity that has been returned. It should not be more than the shipped qty.
Qty Refunded
This is the quantity that the merchant wants to refund. It should not be more than the returned
quantity.
Refund tax
This is the tax applied on the products that are returned.

29
Refund Amount
This is the amount that jet has to return to the customer.
Shipping Cost
This is the shipping cost applied on the returned product.
Shipping tax
This is the shipping tax applied on the returned product.
Refund Feedback
This is the feedback that the merchant wants to send about the returned product.
Refund Reason
This is the reason why customer has returned the product.
Settlements
The Settlement provides methods to retrieve all details regarding merchant payment for sold
on Jet.com. This section also provides settlement information for customer generated returns
where Jet must refund the customer.
You a ie all settle e t reports either for last da s or for a ra ge of dates a d li k
respe ti e Fi d “ettle e ts utto . U‘L List elo ill list the resulted u er of reports
generated in result. You need to click on the report to view the entire report details. A window
will pop up with the concerned reports details.

30
Cron Status
The updated status will be reflected (visible) as follows:-
Activity Time Required for Updating (min)
Order Creation 2-5
Error in Rejected Files 30
Return Created 10
Refund Status 10
Support
If you need support or have questions directly related JET-PRESTASHOP INTEGRATION, please
use our Online Message Form to contact our support team or send us an email at
support@cedcommerce.com
Best Regards,
CedCommerce Team

Jet Prestashop Integration by CedCommerce

More Related Content

What's hot (11)

Viewers also liked (12)

Similar to Jet Prestashop Integration by CedCommerce (7)

More from CedCommerce (20)

Recently uploaded (20)

Jet Prestashop Integration by CedCommerce