SlideShare une entreprise Scribd logo
© CedCommerce. All rights reserved.
SUPPORT@CEDCOMMERCE.COM
[Jet-Magento Integration]
CedCommerce Jet-Magento Integration, an extension by CedCommerce, establishes synchronization of
inventory, price, other details for product creation and its management between Magento store and
Jet.com. The smooth harmonization is established with help of Jet.com REST API.
© CedCommerce. All Rights Reserved.
2
Jet-Magento Integration
User Manual
Version – 0.0.5
© CedCommerce. All Rights Reserved.
3
Contents
I. Overview...............................................................................................................................................4
II. Jet Configuration...................................................................................................................................5
III. Jet API..................................................................................................................................................10
IV. Create Jet Category..……………………………………………………………………………………………………………………. 12
V. Assign Category to Product…………….………………………………………………………………………………………………14
VI. Manage Jet Attribute…….…………………………………………………………………………………………………………….…15
VII. Manage Product…………………………………………………………………………………………………………………………….17
VIII. View Jet Orders………………….………….……………………………………………………………………………………………..38
IX. View Failed Import Jet Orders Log….……………………………………………………………………………………………..42
X. Jet Return………………..…………………………………………………………………………………………………………………...43
XI. Jet Refund………………….………………………………………………………………………………………………………………….47
XII. Cron Status……………………..…………….……………………………………………………………………………………………...51
XIII. Support………………………………………………………………………………………………………………………………………..51
© CedCommerce. All Rights Reserved.
4
OVERVIEW
Jet-Magento Integration, an extension by CedCommerce, establishes a synchronization of
inventory, price, other details for product creation and its management between Magento
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).
. Map single Magento store to Jet.com with single Fulfillment node.
. Import Jet.com orders to convert it into regular Magento Orders & Shipments.
Admin can manage returns & refunds of jet products.
In this extension currently we have provided support for two types of products: - Simple
product and Configurable product which means only simple products and configurable
products can be uploaded to Jet.com and the attributes will also be listed only for simple and
configurable products.
UPGRADATION INSTRUCTION
It is a very simple process. If a merchant wants to upgrade or reinstall module from Magento Connect
manager then he needs to remove the folder “jetcsv” from his Magento “var” directory. Just login to
your ftp and go to Magento root folder (generally present under public_html folder) and then just
overwrite the app, skin and var folders by checking the “Apply to this queue only” option so that it
doesn’t asks for overwrite again and again. Your package will be upgraded.
© CedCommerce. All Rights Reserved.
5
JET CONFIGURATION
In order to obtain 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.
The app folder should be replaced only
after replacing the above two folders.
Moreover, the app > etc > modules >
modules.xml file should be replaced at
the end after replacing all the files and
folders so as to avoid any issues.
© CedCommerce. All Rights Reserved.
6
After that obtain the API key and Secret Key and generate a Fulfillment Node as per Jet
specifications to have a Jet Fulfillment Node Id. These details will be used in the configuration
settings in the merchant’s admin panel.
Once the merchant installs this extension, configuration settings will be created in his Magento
admin panel’s System Configuration named as ‘jet configuration’ under CedCommerce
Clicking on Test shows
Sandbox mode and clicking
on Live shows Live mode.
© CedCommerce. All Rights Reserved.
7
Extension tab, as well as a menu will be added in the menu section named as jet that will
consist of all the panel listing. This extension will also create a tab in the product’s general tab
named as jet.com which will list all the created jet.com attributes. That we will explain later.
The Configuration Setting can be done from here with jet com
Here the merchant needs to enter following things
1. API URL (Default Selected)
2. API username (API User in Jet)
3. API password (Secret in Jet)
4. Fulfillment Node Id
5. Email Id
6. Select Store (Store which you want to integrate to Jet.com)
Fullfillment Node Id (not Merchant Id of Jet, go to Fulfillment > Fulfillment Node Id from left
navigation menu in the Jet Partner Panel).
To display the module at
frontend select Yes in this
field.
© CedCommerce. All Rights Reserved.
8
Email Id field is necessary because Jet API doesn’t provides Customer Email Address & an order
can’t be created in Magento until a customer email Id is obtained. Thus, an email id has to be
used to import orders from Jet into Magento. That’s why the merchant needs to create a
customer with an email id from admin panel & use that email id in the Email field in Jet
Configuration Settings as shown below.
For this purpose, go to Customers > Manage Customer; here you can see the form for creating
a customer from the admin panel. Just enter the customer’s First Name & Last Name as well as
the Email id, save this customer & enter the same email id in the Jet Configuration Email field. If
you do not enter the Email Id then a default id will be used which is sales@test.com.
© CedCommerce. All Rights Reserved.
9
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. These configurations are mandatory
to set before integrating Magento store with jet.com and this should be the first step after
installing the extension on your site.
These settings are provided if the quantity and price of a product to be uploaded on jet needs
to be updated every time their quantity is changed in Magento. For instance, there is a product
which has been uploaded on jet. Now, its quantity or price has been edited in Magento and the
merchant wants that these new changes should also reflect on jet.com without re-uploading
the product on jet, then, these configuration settings should be turned on.
On product edit page (Catalog > Manage Product > Edit), if the status of the product is
“Disabled” and the product is already uploaded on jet.com then is status will become
© CedCommerce. All Rights Reserved.
10
“Archived" over there. If the product’s status is “Enabled” in Magento then the product will
become enabled on jet.com as well.
Note: - After setting the configuration go to Catalog > Manage Products and select all the
products. From the mass Action dropdown select Update Attributes and click Submit button so
as to update newly created categories and attributes in the Product Edit/Create form. Locate
the Jet Product Status field; tick the checkbox labeled “Change” and then click Save button.
Jet API
To integrate Magento store with jet.com firstly the merchant needs to enable his API setup on
jet com. Before enabling the Jet API, the merchant needs to make sure that the cache (Magento cache)
is disabled. After testing all the APIs the cache can be enabled. If any merchant has created his
account on jet .com and not enabled his API yet then he can enable his API panel from jet > API
After setting up the Configuration Settings, this step is mandatory to be followed for the first
time users who have just installed this extension. In order to obtain the live mode credentials
all the Test APIs should be run because Jet doesn’t provides Live Mode details until all the Test
APIs have been setup.
i. Enable product API
To enable the product API, the merchant needs to send SKU, price and inventory. So a
setup has been prepared. For this the merchant only needs to click on Send link. Once
Select all the products, choose Update Attribute and click
Submit button to update all the attributes and categories.
© CedCommerce. All Rights Reserved.
11
your product information will be send, link text will be changed to Send Successfully and
it will no longer remain a link.
ii. Enable order API
To enable order API on jet.com the merchant needs to create an order from Order
Generator. For this a link has been given named as Order Generator, it will redirect
the merchant to jet.com order generator. Once the order has been created the
merchant has to send Order Acknowledge.
To enable Cancel Order the merchant needs to click on the Send link next to Cancel
Order. Once the order information will be uploaded successfully, the link text will be
changed to Send Successfully and it will no longer remain a link.
iii. Enable return API
Return API used to manage Returns generated for the completed order on jetc.com.
To enable return API merchant needs to click on Send link next to Enable Return.
Once the return is complete, the link text will be changed to Send Successfully and it
will no longer remain a link.
Select Jet > API from the
menu section to open this
page.
© CedCommerce. All Rights Reserved.
12
CREATE JET CATEGORY
To create jet categories in Magento go to Jet > Jet Category List.
There are two ways of creating categories:-
1. By Importing
The list of categories used in Jet.com will be displayed. Select the category (s) which has to be
created in Magento and then from the mass Action dropdown select “Create Category” option
and click the Submit button. Those many categories will be created in Magento.
Select this menu item to open
the category listings
© CedCommerce. All Rights Reserved.
13
2. By Mapping
If you have an already created category in Magento and you would like to map that category to
any of the Jet categories, then go to Catalog > Manage Categories. Select the required category
and then open the Jet Category Information tab. Enter the Jet Category Id which has to be
mapped to this Magento category, select Yes in the “Is Jet Category” field and then click on the
“Save Category” button.
After creating/mapping the categories, it is necessary to import the attributes from Jet >
Manage Attributes section (given on page 13).
Select the categories to be created in
Magento and then choose Create
Category option from the mass Action
dropdown and click Submit button.
Enter Jet Category Id here
© CedCommerce. All Rights Reserved.
14
ASSIGN CATEGORY TO PRODUCT
After the categories get created in Magento, they need to be assigned to the products (if not
already assigned to the required category). For this purpose, the merchant should go to Catalog
> Manage Products > Select the product to be edited and locate the Categories tab. There he
will find all the categories listed in the same manner as they were in Jet.com. Now, he should
select a category which has to be assigned to the product. But, a product can be assigned to a
single category only as this is the specification of Jet.com and we have to follow it.
If there is nesting of categories (say 3 level nesting) then the product should be assigned either
to the parent category, or to the child category or to the sub-child category, but NOT to all 3 of
them or any 2 of them. Every product should be assigned only to a SINGLE Jet Category. For
instance, if there is a product (say “Plum Seeds”) and it falls under 3 categories having parent-
child relationship (say Grocery, Cooking & Baking Supplies and Nuts & Seeds) then Plum Seeds
should either be assigned to Grocery or it should be assigned to Cooking & Baking Supplies or to
Nuts & Seeds but, not to all 3 of them or any 2 of them.
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.
To assign the products to their respective categories in a much faster way, go to Catalog >
Manage Categories > Select the required category > Category Products Tab > Select all the
Either Grocery
Or Cooking &
Baking Supplies
Or Nuts & Seeds
© CedCommerce. All Rights Reserved.
15
products that have to be assigned to this category and click Save Category button. If the
products are not getting listed in that section, click on the “Reset Filter” button.
MANAGE JET ATTRIBUTE
Jet has a different procedure for attribute mapping. In Magento the attributes are assigned to
the products whereas in Jet the attributes are assigned to the categories. Every Jet category has
a specific set of attributes (not attribute set just a certain number of attributes) associated to it.
The value of these attributes is necessary to be provided as if any required attribute will be
found missing by jet, then Jet will throw related errors (which could be seen in Jet > Manage
Magento Jet
Product
Attribute (s)
Category
Attribute (s)
Assigned to
Assigned to
Imported to
(in Jet Magento
Integration)
Imported to
(in Jet Magento
Integration)
Category
Product
Assigned to
Assigned to
© CedCommerce. All Rights Reserved.
16
Products > Rejected Files > Error Description section given on Page 26) and the product won’t
be uploaded on Jet.
Since jet categories have some pre defined attributes, so the merchant needs to create the
attributes after creating categories. For this he should go to Magento admin panel and select
Jet > Manage Jet Attributes and click on the Import New Attribute button. It will create an
attribute related to jet category. All the created category attributes will be listed in jet Manage
Attribute panel.
It will create three types of attribute:–
1. Text – For text type attribute there is no prior requirement, just the value needs to be
entered.
2. Text with unit - For Text type attribute with unit we have added a hint below text type
field by which merchant can acknowledge which type of unit he needs to enter for a
particular attribute.
3. Dropdown/List - For Dropdown type of attribute, the merchant needs to add options on
his own.
Click Import New Attribute
button to automatically create all
the attributes as given in the csv
uploaded for creating the
categories.
© CedCommerce. All Rights Reserved.
17
MANAGE PRODUCT
This tab will manage the product upload system. It consists of two sub menus:-
1. Upload files - Following operations can be performed here:-
Necessary information during general product uploads:
1. It must be assigned to a jet category. One product can be assigned to only one
category.
2. A product must have one of the following information (UPC, GTIN-14, ISBN-13, ISBN-
10, EAN, and ASIN).
3. Brand Name attribute is mandatory to be given along with either Manufacturing Part
Number or ASIN or any one of UPC, ISBN-10, GTIN-14.
Initially when the product will be uploaded, its default status will be ‘Not Uploaded’. When the
product will be successfully uploaded its status will change to ‘Processing/Under Jet Review’.
Information to be filled during product creation
Click Jet > Manage Products >
Upload Product in the menu
section to open Product Manager.
© CedCommerce. All Rights Reserved.
18
During the product creation the merchant can fill the attribute information from jet.com tab
created under General Information tab on Product Edit Page. From here the merchant can fill
the attribute information. During product creation it must have one of the following
information (UPC, GTIN-14, ISBN-13, ISBN-10, EAN, and ASIN).
Optional Attributes that can be provided apart from the necessary attributes
Extra attributes in which the values can be provided are:-
1. Amazon Item Type Keyword
2. Category Path String
3. Bullets
4. Number Units for Price per Unit
5. Type of Unit for Price per Unit
6. Shipping Weight Pounds
7. Package Length Inches
8. Package Width Inches
9. Package Height Inches
10. Display Length Inches
11. Display Width Inches
12. Display Height Inches
Click Catalog > Manage Products >
Open the required product. ASIN, UPC,
ISBN, EAN, ISBN-13, ISBN-10, GTIN-14
can be entered from this page.
© CedCommerce. All Rights Reserved.
19
13. Prop 65
14. Legal Disclaimer Description
15. Cpsia Cautionary Statements
16. Country of Origin
17. Safety Warning
18. Start Selling Date
19. Fulfillment Time
20. Msrp
21. Map Price
22. Map Implementation
23. Product Tax Code
24. No Return Fee Adjustment
25. Exclude from Fee Adjustments
26. Ships Alone
© CedCommerce. All Rights Reserved.
20
© CedCommerce. All Rights Reserved.
21
© CedCommerce. All Rights Reserved.
22
© CedCommerce. All Rights Reserved.
23
© CedCommerce. All Rights Reserved.
24
i. Upload product
Upload simple product
This panel will list all the products assigned in jet categories. For uploading the product
on jet.com from here, the merchant needs to select the product using Mass Select by
clicking the respective checkboxes and after that Upload Selected Action should be
selected from mass Action dropdown and submit button should be clicked. It will upload
the products on jet.com and a message will appear in the product upload panel reading
“Selected products Upload Request Send Successfully on Jet.com”.
Upload configurable product
The products which are identical in structure but differ on the basis of some attributes fall in
the category of Configurable Products. Jet.com accepts the Relational Products in two
categories:-
1. Accessories – for Bundle and Grouped products
2. Variation – for Configurable products.
2. Select Upload Selected option
from the Mass Action dropdown
and click Submit button.
1. Select the product whose status is Not Uploaded.
Click this button to update the
Jet Product Status immediately.
© CedCommerce. All Rights Reserved.
25
Let us first understand the difference between the Magento Configurable Product and Jet
Configurable Product (Variation product). The configurable products in Magento include one
parent product to which its associated products are mapped whereas in Jet there is no such
parent product. Instead any one of the child products is treated as a parent product and all the
rest of the products are mapped to it. We have also followed a similar procedure while sending
the data to the API.
Some points are necessary to be followed for uploading configurable products:-
1. Brand Name attribute is mandatory to be given alongwith either Manufacturing Part
Number or ASIN or any one of UPC, ISBN-10, GTIN-14.
2. All the children products of the configurable product should be assigned to the same jet
category.
3. Brand Name of the children products should be the same as that of the parent product.
Steps for uploading the configurable product:-
Step 1: Attribute Mapping
Before uploading any configurable product, all the Magento attributes responsible for
differentiating the child (associated) products should be mapped to the Jet attributes first.
For example, if the associated products differ on the basis of Color and Size attributes in
Magento then on sending the data to jet.com, Jet will be looking for its Color and Size attributes
that are assigned to its categories NOT the Color and Size attributes of Magento. Therefore, it is
very necessary to map Magento attributes to Jet.com attributes.
For this purpose, follow the below given steps:-
1. If suppose a product “Shirt” is a configurable product that has to be uploaded on
jet.com and has Color and Size attributes, then a Jet category should be searched from
the Jet > Jet Category List panel which contains both the attributes (not any one). All the
child products of the configurable product “Shirt” should be assigned to this category
only having both the color and size attributes (if not previously assigned) and no other
category.
© CedCommerce. All Rights Reserved.
26
Filter the categories on the basis
of a specific category.
Click this link to view the attributes of
the respective categories.
Selecting a category with only
Color attribute is not valid.
Selecting a category with only
Size attribute is not valid.
© CedCommerce. All Rights Reserved.
27
2. Now the attributes need to be mapped, therefore, go to Catalog > Attributes > Manage
Attributes > Open the attribute that needs to be mapped (Color and Size in this case) in
a new tab and let the previous tab of Jet Category List remain open in another tab. Copy
the Attribute id from the “Jet Category Listing Tab” and paste it in the “Jet Attribute Id”
field. Now click the “Save and Continue” button. If you would like to view the id of the
Jet attribute then it can be seen from the csv file which will be available for download by
clicking on the “Click Here” link under Jet Attribute tab.
3. After saving the attribute you might get an Error Notification message as well alongwith
the Success message. That notification message will warn you to enter only the valid
Click Here to download the
Jet_Taxonomy_attribute.csv
file.
Both the attributes Color and
Size should be present in a Jet
Category.
Copy and Paste this Attribute Id in the Jet
Attribute Id field in the Catalog > Manage
Attribute section shown below.
© CedCommerce. All Rights Reserved.
28
values (that are accepted by jet) as options to that attribute if it is a dropdown type of
attribute. This step should be followed otherwise the product won’t be uploaded on
jet.com.
Three types of attributes can be created in jet: Text type, Dropdown type and Unit type. In
Unit type and Dropdown type attributes, as soon as you click “Save” button, you will be notified
via an error message that you also need to provide the values to these attributes. So then you
should go to “Jet Attribute Tab” again, a note would now have been appended over there. For
example, if it is a UNIT type attribute then it will look like this
Likewise it is for dropdown type attribute also. Therefore, the values should be provided to
these attributes and it will accept only those values at jet.com which have been suggested as
options over here. Any extra custom values if provided will not be accepted. The syntax how
the values should be provided is also given here. That syntax should be followed to ensure
proper functioning.
Step 2: Uploading Configurable Product
1. After the proper completion of Step 1, select the configurable product to be uploaded
from the Jet > Manage Product Grid, select the “Upload” option from the mass Action
dropdown and click on the Submit button.
These are options that can be
provided as values to the dropdown
type attributes.
The values to this
type attribute
should be
provided in this
way.
© CedCommerce. All Rights Reserved.
29
2. Click on the View Details link of that product. Locate the “Variation Refinement” field, if
it contains the attribute ids of all the attributes that were mapped then it means the
product has been successfully uploaded on jet.com otherwise if a blank field appears
then that means the product has not been uploaded.
Select the configurable product
to be uploaded, select Upload
Selected option from the mass
Action and click Submit button.
Click this link to
view the details
of the product
that are on Jet.
© CedCommerce. All Rights Reserved.
30
This field contains values i.e. the attribute
ids of the attributes being mapped. Thus,
the product has been uploaded
successfully.
© CedCommerce. All Rights Reserved.
31
3. When the product has been successfully uploaded then the “bulk upload” feature can
be used to upload rest of the products if any.
This completes the entire procedure of Configurable Product upload and Simple product upload
on jet.com.
How does product upload process works?
Whenever a product is uploaded then it gets uploaded in the form of batches of 30 products
each. If 100 products are uploaded (say) then 4 batches will be formed with 3 batches having 30
products and the last batch having 10 products. For every batch, 3 files are created. They are:-
1. inventory {timestap}.json
2. price{timestap}.json
3. sku{timestap}.json/merchantsku{timestap}.json
These are present at root in the var > jetupload folder. So, if total 4 batches are there, then 12
files will be created. These files are then compressed and uploaded on jet.com.
Select the configurable products to be uploaded, select
Batch Upload from the mass Action and click Submit button.
© CedCommerce. All Rights Reserved.
32
The 3 files include one having details of the quantity or inventory of 30 products, according to
the fulfillment node, which are mentioned in the sku file (inventory {timestap}.json), one having
the details of the price, according to fulfillment node, of those 30 products which are
mentioned in the sku file(price{timestap}.json file) and the other having general details of those
30 products related to SKU, etc (sku{timestap}.json file).
Whenever a product is not uploaded and some error is generated then it gets listed in the error
files section which includes any one of the 3 files. The content of those files should be seen by
the merchant to locate the product having the error so as to rectify those errors and resubmit
the file.
After all the files are submitted to jet.com server, they then process those batch files. If all the
information about the products is processed then the products are uploaded & moved to the
Processing state otherwise the batch file is marked as "Processing with error status."
© CedCommerce. All Rights Reserved.
33
ii. Batch Upload
To upload multiple products on jet or to upload all the products on jet, batch upload feature
can be used. Just select all the required products and choose “Batch Upload” from the mass
Action dropdown and click on the Submit button. The products will get uploaded. The process
of Upload will be visible to the merchant and if any error appears like UPC number is not given,
or Brand and Manufacturer Part Number is not given, etc then the Upload process will break
and the error will be listed over there itself.
Before uploading Bundle, Grouped and Configurable products, make sure the Brand Name of
the child products is the same as that of the parent product, otherwise error may appear.
If any error appears then it will be listed over here. That error can be resolved and the product
can be uploaded again.
Select the products to be uploaded
and choose Batch Upload option
from the Mass Action dropdown
and click Submit button.
© CedCommerce. All Rights Reserved.
34
iii. Close/Disable/Archive product
Jet .com provides the ability to close the uploaded product. If a merchant wants to close his
uploaded product at any time after successful upload then it can be easily done. For this, the
merchant needs to select the product from the product panel by selecting the checkbox. After
that he needs to select the archive action and click on the Submit button. That product will be
archived successfully and its status will change to Archived. This product will be closed on
jet.com and it will not appear on jet.com for purchase.
iv. Reopen/Enable/Unarchive product
Jet.com provides the ability to reopen closed products. For this, the merchant needs to select
the archived product and then select Un-archive option from the Action dropdown and click on
the Submit button. The selected product will be available again for purchase on jet.com.
Merchant can archive or Un-archive multiple products by selecting multiple products using
checkbox. If the merchant wants he can archive or un-archive a single product also. To do this,
the merchant needs to go to the View Detail action of the product from the product panel. If
1. Select the product from here which has to be
Closed/Archived.
2. Select Archive option from the
Mass Action dropdown and click
Submit button.
© CedCommerce. All Rights Reserved.
35
the product is open an Archive button will be shown. If the product is closed, the un-archive
button will be shown. From here the merchant can choose a specified action as he wants.
v. Add 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 go to “View Product Status”
page by clicking on the “View Details” link on the Manage Products page. There he’ll find a tab
in the left “Shipping Exception”. The merchant needs to fill in the requisite details over here
and click on the Save button to save the information.
1. Select the product from here which has to be
Reopened/Unarchived. Only Archived products can
be Unarchived.
2. Select Unarchive option from
the Mass Action dropdown and
click Submit button.
© CedCommerce. All Rights Reserved.
36
vi. Add 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 “View Details” link to open the Product Information page. Click on the
“Return Exception” tab in the left to add the exception.
2. Rejected files
We upload jet.com product using their file upload process. Due to any reason if an error occurs
during the product upload then that product will be listed in the Rejected File panel. From here
the merchant needs to go to View Error & Resubmit action.
Shipping Exception related details
can be entered over here.
Return Exception related details
can be entered over here.
© CedCommerce. All Rights Reserved.
37
Here the Errors present in the corresponding file appear with Resubmit button. When the
merchant clicks on this button his product will be resubmitted to jet.com. If the product gets
submitted successfully then the status of the file will change to N/A.
Select Jet > Manage Products >
Rejected Files from the menu
section to open Rejected Jet Files
Manager.
Click here to view the errors coming in the rejected files.
Click Jet > Manage Products >
Rejected Files, to open the Error
Files Information page.
Notification area displays the
count of rejected Jet files.
The errors will be listed here and then the
merchant needs to find the error in his file,
resolve it and click Resubmit File button.
The contents of the file can be seen from here.
These are the total products whose
information went to jet for upload. These
products can be seen for errors and those can
be rectified.
© CedCommerce. All Rights Reserved.
38
Whenever the product gets uploaded then a batch file of products is created and that file is
responsible for uploading the products on jet.com, therefore if some error occurs in found by
jet in the products which are present in the batch file uploaded on jet.com then it rejects the
file with some errors. Then all the recently uploaded products should be checked for that error
and uploaded again i.e. Resubmit File.
Note: The errors corresponding to the related files will be listed under the Error Description
section on the Error Files Page (as shown above in the “Create Jet Attribute” section). It is the
responsibility of the admin/merchant to locate those errors in the respective files and resolve
them.
VIEW JET ORDER
We have set up a Cron for the orders that will fetch all the orders generated on jet.com. The
merchant gets notified by the notifications in admin panel. 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. We
have used default shipping method (custom jet shipping method) and default payment method
Click this button to fetch
Rejected Files immediately.
Select the file to be deleted and
then choose Delete option from
the mass Action dropdown and
click the Submit button.
© CedCommerce. All Rights Reserved.
39
(custom jet payment method) for jet orders. So the merchant should enable these methods in
Magento.
Select Sales > Order from the menu
section and then select the
respective order and click on its View
link to open Order view page.
As soon as the order is placed these two buttons (Acknowledge & Reject)
remain enabled. If any of the buttons is clicked then both of them become
disabled. If Acknowledge button is clicked then the admin cannot reject it.
Likewise, if Reject button is clicked then it cannot be acknowledged and
the Order Status will change to Cancelled.
© CedCommerce. All Rights Reserved.
40
For shipment, we have added a tab ‘Ship by Jet ‘from which the merchant can create shipment
for orders. This tab will be visible only if the order has been placed from Jet.com.
Click on Ship by jet tab in the
left menu to open this section.
© CedCommerce. All Rights Reserved.
41
Here the merchant needs to enter the tracking number; quantity ordered will be auto-filled. In
the quantity cancelled field, the merchant needs to enter the quantity he is not able to supply
at the time of orders. Product SKU will reflect the SKU of the ordered quantity. If the merchant
wants to send a Return location address then it can be done by selecting ‘yes’ from the
dropdown. It means if after order completion the customer generates a return request for this
order then this product will be returned to the address set in the return location configuration.
When the merchant clicks on the Ship button, the order will be shipped and its invoice and
shipment will be created automatically in Magento. The status of order will change to
Completed.
To view the newly imported/fetched Jet orders “Jet Orders Details” panel is used. This panel
lists the newly generated Jet orders with their “Jet Reference Order Id” and their corresponding
Magento “Order Id” clicking on which their corresponding Order View page will open. The
merchant can also mass “Acknowledge” the orders from this panel itself by selecting the
respective orders and then choosing the “Acknowledge” option from the mass Action
dropdown and then clicking on the “Submit” button. But for “Rejecting” the orders their view
page has to be opened as in case of rejecting the orders for shipment certain details have to be
filled.
But, as soon as the latest orders are fetched, a notification appears in the admin panel’s
notification area and those orders get Auto-Acknowledged. This is done so that if the merchant
is unable to acknowledge the orders within 2 hours then they don’t get rejected.
© CedCommerce. All Rights Reserved.
42
To manually fetch the latest orders (if required immediately) the merchant can click on the
“Fetch Latest Orders” button.
VIEW FAILED IMPORT JET ORDERS LOG
When some order (s) is placed using Jet.com for a particular product and for the same product
Magento order has also been placed then a case may arise where that product can become Out
of Stock, Required Quantity is Not Available or has been Disabled then those orders are not
placed on Jet.com and the list of those orders can be viewed by selecting Jet > Jet Orders >
View Failed Import Jet Orders Log from the menu section.
This section displays the failed orders with their order id and the reason for their failure.
Select Jet > Jet Orders > View Jet Orders from the
menu section to open the Jet Orders Details page.
Select the orders to be acknowledged and then
choose the Acknowledge option from the mass
Action dropdown and click the Submit button.
Click this button to manually fetch
the orders in case of immediate
requirement.
© CedCommerce. All Rights Reserved.
43
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 then it will be listed in the
return panel with status Created and the merchant (admin) will be notified about it by
notification in the admin panel.
Select the orders to be deleted and
then choose Delete option from the
mass Action dropdown and click
Submit button.
© CedCommerce. All Rights Reserved.
44
For completing the return the admin/merchant needs to enter some information like quantity
refunded, return feedback, shipping cost, shipping tax and tax. Hence the merchant needs to
click on the Edit link. It will open a form that contains all the necessary fields which the
merchant has to fill for completing the return.
Select Jet > Jet Orders > Return from the menu
section to open the Return Management page.
Click on the Edit link of any particular
row in the grid that appears on Return
Management page to open this form.
Click this button to fetch New
Returns immediately.
Respective Magento Order Id of the
corresponding Jet Order.
© CedCommerce. All Rights Reserved.
45
Select Yes in this field if you agree
to return the product.
Select Yes in this field if you agree
to return this item. This section
comes item-wise like if two products
have been ordered in a single order
then this section will be displayed
item-wise so that if you don’t agree
to return a particular item then you
can select No in this field.
Enter the qty of the item that you
want to refund to the customer.
© CedCommerce. All Rights Reserved.
46
ii. 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’
iii. Want To Send
If the merchant agrees to accept the return this particular item, Yes should be selected
in this field otherwise No.
iii. Qty Refunded
Here the merchant needs to enter the quantity that he wants to refund to the customer.
iv. Return Feedback
Here the merchant needs to enter the feedback about the return.
v. Shipping Cost
This is the shipping cost of the item that will be refunded to the customer.
vi. Shipping Tax
This is the amount that was charged on the shipping apart from the shipping amount
and will be refunded to the customer.
vii. Tax
This is tax amount that was charged on the item and will be refunded to the customer.
This is the amount that will be
returned to the customer.
© CedCommerce. All Rights Reserved.
47
Except this all the fields will be initially filled like return id, merchant order id, order item id, qty
ordered, qty already refunded, and qty available for refund, qty returned and amount.
Once the merchant fills all the fields and clicks on the Submit Return button, his return will be
completed on jet.com. A success message will appear on the top of the return grid showing that
the return has been posted to jet successfully and in the return panel its status will be changed
to Completed.
As soon as the Return is completed, the credit memo for that order is also generated in
Magento so as to complete the return process of that order in magento as well.
JET REFUND
If the merchant ships any order generated on jet.com and after that if a customer return that
product/order directly to the merchant without the involvement of jet.com, then the merchant
needs to send a request on jet.com for completing this type of return. To manage this type of
return there is a panel ‘Jet Refund’.
If any jet.com product will be returned directly to the merchant then to complete this return
the merchant needs to click on ‘Create New Refund’ button. This will open a form for entering
the information.
Select Jet > Jet Orders > Refund from the menu
section to open the Refund Management page.
Click this button to get Updated
Refund Status immediately.
Click this button to create a
new Refund.
© CedCommerce. All Rights Reserved.
48
As soon as these details are filled the respective order details get displayed item-wise in the
new section (s) that gets listed below. Click on the “Add” button adjacent to the sku tab to
display the form shown below.
Click on Create New Refund
button to open this form.
This is the merchant id that is provided by
jet.com to the merchant and can be
obtained from the partner panel.
This id can also be obtained from by going to Jet >
Jet Orders > View Jet Orders > Jet Merchant
Order Id column. Locate your order whose refund
has to be created and then copy its id and paste it
in this field over here.
Enter the quantity that the
customer wants to return.
Enter the quantity that the merchant wants to
refund. It cannot be more than the Qty Returned
but can be less than it as the merchant may not
want to refund all the items.
© CedCommerce. All Rights Reserved.
49
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. Refund Merchant Id
This is the merchant id i.e. the id of that merchant for whose products the return request has
been generated.
iii. Order item id
This is the item id that has been ordered.
iv. Qty Requested
This is the total items ordered in the current order.
Provide a Refund feedback
over here.
Provide a reason for
Refund as provided by
the customer.
Enter the Refund
Shipping cost, Refund
Shipping Tax and
Refund Tax as per the
need.
© CedCommerce. All Rights Reserved.
50
v. Qty Already Refunded
This is the number of items which have been already refunded to the customer.
vi. Qty Available for Refund
This is the number of items which can be refunded i.e. if there were 4 items in an order out of
which two have been already refunded then only 2 items are left that can now be refunded and
not more than 2 as the order consisted of only 4 items.
vii. Qty Returned
This is the total quantity that has been returned by the customer. It should not be more than
shipped qty.
viii. Qty Refunded
This is the quantity that the merchant wants to refund. It should not be more than the returned
quantity but can be less than that.
ix. Refund tax
This is the tax applied on the products returned.
x. Refund Amount
This is the amount that jet has to return to the customer.
xi. Refund Shipping Cost
This is the shipping cost applied on the returned product.
xii. Refund Shipping tax
This is the shipping tax applied on the returned product.
xiii. Refund Feedback
This is the feedback that the merchant wants to send about the returned product.
xiv. Refund Reason
This is the reason why customer has returned the product.
© CedCommerce. All Rights Reserved.
51
CRON STATUS
The updated status will be reflected (visible) as follows:-
Activity Time Required for Updating (min)
Order Creation 10
Error in Rejected Files 10
Return Status 10
Refund Status 10
Product Status 10
SUPPORT
If you need support or have questions directly related to JET-MAGENTO 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

Contenu connexe

Tendances

Tendances (10)

Vendor Attribute Addon - Magento2 Multi-Vendor Marketplace By CedCommerce
Vendor Attribute Addon - Magento2 Multi-Vendor Marketplace By CedCommerceVendor Attribute Addon - Magento2 Multi-Vendor Marketplace By CedCommerce
Vendor Attribute Addon - Magento2 Multi-Vendor Marketplace By CedCommerce
 
Vendor Product Addon - Magento2 Multi-Vendor Marketplace by CedCommerce
Vendor Product Addon - Magento2 Multi-Vendor Marketplace by CedCommerceVendor Product Addon - Magento2 Multi-Vendor Marketplace by CedCommerce
Vendor Product Addon - Magento2 Multi-Vendor Marketplace by CedCommerce
 
All-In-One Checkout User Manual for Magento by Aitoc
All-In-One Checkout User Manual for Magento by AitocAll-In-One Checkout User Manual for Magento by Aitoc
All-In-One Checkout User Manual for Magento by Aitoc
 
Magento Multi-Vendor Marketplace Work Flow by CedCommerce
Magento Multi-Vendor Marketplace Work Flow by CedCommerceMagento Multi-Vendor Marketplace Work Flow by CedCommerce
Magento Multi-Vendor Marketplace Work Flow by CedCommerce
 
Establish an uninterrupted communication channel with Vendor Messaging Addon
Establish an uninterrupted communication channel with Vendor Messaging AddonEstablish an uninterrupted communication channel with Vendor Messaging Addon
Establish an uninterrupted communication channel with Vendor Messaging Addon
 
Magento 2 Order Attributes
Magento 2 Order Attributes Magento 2 Order Attributes
Magento 2 Order Attributes
 
Google home assistant integration with salesforce.
Google home assistant integration with salesforce.Google home assistant integration with salesforce.
Google home assistant integration with salesforce.
 
WordPress SugarCRM Customer Portal Pro Plugin
WordPress SugarCRM Customer Portal Pro PluginWordPress SugarCRM Customer Portal Pro Plugin
WordPress SugarCRM Customer Portal Pro Plugin
 
Saml sap netweaver_fiori
Saml sap netweaver_fioriSaml sap netweaver_fiori
Saml sap netweaver_fiori
 
Hospital app project (how to upload app)
Hospital app project (how to upload app)Hospital app project (how to upload app)
Hospital app project (how to upload app)
 

Similaire à Jet Magento Integration by CedCommerce

Similaire à Jet Magento Integration by CedCommerce (20)

Windward Magento Integration - Manuals
Windward Magento Integration - ManualsWindward Magento Integration - Manuals
Windward Magento Integration - Manuals
 
Mkmage jet magento integration user guide
Mkmage jet magento integration user guideMkmage jet magento integration user guide
Mkmage jet magento integration user guide
 
Vendor Group Addon -Magento2 Multi-Vendor Marketplace by CedCommerce
Vendor Group Addon -Magento2 Multi-Vendor Marketplace by CedCommerceVendor Group Addon -Magento2 Multi-Vendor Marketplace by CedCommerce
Vendor Group Addon -Magento2 Multi-Vendor Marketplace by CedCommerce
 
Vendor Group Addon - Magento Multi-Vendor Marketplace Addon by CedCommerce
Vendor Group Addon - Magento Multi-Vendor Marketplace Addon by CedCommerceVendor Group Addon - Magento Multi-Vendor Marketplace Addon by CedCommerce
Vendor Group Addon - Magento Multi-Vendor Marketplace Addon by CedCommerce
 
SuiteCRM Customer Portal
SuiteCRM Customer PortalSuiteCRM Customer Portal
SuiteCRM Customer Portal
 
Social Login User Manual by CedCommerce
Social Login User Manual by CedCommerceSocial Login User Manual by CedCommerce
Social Login User Manual by CedCommerce
 
Walmart Magento Integration User Guide - CedCommerce
Walmart Magento Integration User Guide - CedCommerceWalmart Magento Integration User Guide - CedCommerce
Walmart Magento Integration User Guide - CedCommerce
 
Feedback Pro Extension - User Guide
Feedback Pro Extension - User GuideFeedback Pro Extension - User Guide
Feedback Pro Extension - User Guide
 
190 959
190 959190 959
190 959
 
Magento 2 Admin Mobile App
Magento 2 Admin Mobile AppMagento 2 Admin Mobile App
Magento 2 Admin Mobile App
 
Instagram extension setup in Magento framework
Instagram extension setup in Magento frameworkInstagram extension setup in Magento framework
Instagram extension setup in Magento framework
 
Vendor Product Attribute Addon - Magento Multi-Vendor Marketplace by CedCommerce
Vendor Product Attribute Addon - Magento Multi-Vendor Marketplace by CedCommerceVendor Product Attribute Addon - Magento Multi-Vendor Marketplace by CedCommerce
Vendor Product Attribute Addon - Magento Multi-Vendor Marketplace by CedCommerce
 
Ace shop quick_guide
Ace shop quick_guideAce shop quick_guide
Ace shop quick_guide
 
Magento 2 BTSWholesaler Dropshipping
Magento 2 BTSWholesaler DropshippingMagento 2 BTSWholesaler Dropshipping
Magento 2 BTSWholesaler Dropshipping
 
How to Create Module to Track Affiliate Conversions?
How to Create Module to Track Affiliate Conversions?How to Create Module to Track Affiliate Conversions?
How to Create Module to Track Affiliate Conversions?
 
How to migrate data from AmeriCommerce to Magento by LitExtension
How to migrate data from AmeriCommerce to Magento by LitExtensionHow to migrate data from AmeriCommerce to Magento by LitExtension
How to migrate data from AmeriCommerce to Magento by LitExtension
 
How to migrate data from 3d Cart to Magento with LitExtension
How to migrate data from 3d Cart to Magento with LitExtensionHow to migrate data from 3d Cart to Magento with LitExtension
How to migrate data from 3d Cart to Magento with LitExtension
 
New Features in Magento Enterprise Edition 1.14 (EE) Magento Community Editio...
New Features in Magento Enterprise Edition 1.14 (EE) Magento Community Editio...New Features in Magento Enterprise Edition 1.14 (EE) Magento Community Editio...
New Features in Magento Enterprise Edition 1.14 (EE) Magento Community Editio...
 
Exto RMA for Magento 2 (user guide)
Exto RMA for Magento 2 (user guide)Exto RMA for Magento 2 (user guide)
Exto RMA for Magento 2 (user guide)
 
Magento (Adobe Commerce) upgrade checklist.pdf
Magento (Adobe Commerce) upgrade checklist.pdfMagento (Adobe Commerce) upgrade checklist.pdf
Magento (Adobe Commerce) upgrade checklist.pdf
 

Plus de CedCommerce

Plus de CedCommerce (20)

Sell on MercadoLibre with Magento & Double Up Your Sales Instantly
Sell on MercadoLibre with Magento & Double Up Your Sales InstantlySell on MercadoLibre with Magento & Double Up Your Sales Instantly
Sell on MercadoLibre with Magento & Double Up Your Sales Instantly
 
Sell on Lazada to Boost your Business in the Southeast Asian Region
Sell on Lazada to Boost your Business in the Southeast Asian RegionSell on Lazada to Boost your Business in the Southeast Asian Region
Sell on Lazada to Boost your Business in the Southeast Asian Region
 
Complete Guide to Sell in Europe
Complete Guide to Sell in EuropeComplete Guide to Sell in Europe
Complete Guide to Sell in Europe
 
Best ChannelAdvisor Alternative for Online Sellers
Best ChannelAdvisor Alternative for Online SellersBest ChannelAdvisor Alternative for Online Sellers
Best ChannelAdvisor Alternative for Online Sellers
 
Steps to Boost Your Sales with European Fashion Hub - Zalando
Steps to Boost Your Sales with European Fashion Hub - ZalandoSteps to Boost Your Sales with European Fashion Hub - Zalando
Steps to Boost Your Sales with European Fashion Hub - Zalando
 
Shopify Magento Integration| Connector
Shopify Magento Integration| ConnectorShopify Magento Integration| Connector
Shopify Magento Integration| Connector
 
Sell On Catch Marketplace With Magento
Sell On Catch Marketplace With MagentoSell On Catch Marketplace With Magento
Sell On Catch Marketplace With Magento
 
Sell on Zalora With Magento
Sell on Zalora With MagentoSell on Zalora With Magento
Sell on Zalora With Magento
 
Skyrocket your Sales on Shopee with Magento!
Skyrocket your Sales on Shopee with Magento!Skyrocket your Sales on Shopee with Magento!
Skyrocket your Sales on Shopee with Magento!
 
Sell on the Reverb Marketplace with Magento to Skyrocket Sales!
Sell on the Reverb Marketplace with Magento to Skyrocket Sales!Sell on the Reverb Marketplace with Magento to Skyrocket Sales!
Sell on the Reverb Marketplace with Magento to Skyrocket Sales!
 
Sell on Cdiscount Marketplace with Magento
Sell on Cdiscount Marketplace with Magento Sell on Cdiscount Marketplace with Magento
Sell on Cdiscount Marketplace with Magento
 
Sell On Manomano With Magento
Sell On Manomano With MagentoSell On Manomano With Magento
Sell On Manomano With Magento
 
Sell On Facebook Shop With Magento
Sell On Facebook Shop With MagentoSell On Facebook Shop With Magento
Sell On Facebook Shop With Magento
 
Sell on eBay with Magento
Sell on eBay with MagentoSell on eBay with Magento
Sell on eBay with Magento
 
Ultimate guide to sell on amazon with magento
Ultimate guide to sell on amazon with magentoUltimate guide to sell on amazon with magento
Ultimate guide to sell on amazon with magento
 
Sell on Southeast Asian Marketplaces to Boost your Sales!
Sell on Southeast Asian Marketplaces to Boost your Sales!Sell on Southeast Asian Marketplaces to Boost your Sales!
Sell on Southeast Asian Marketplaces to Boost your Sales!
 
A Guide to Selling on Fyndiq Marketplace – Sweden’s Largest Bargain House
A Guide to Selling on Fyndiq Marketplace – Sweden’s Largest Bargain HouseA Guide to Selling on Fyndiq Marketplace – Sweden’s Largest Bargain House
A Guide to Selling on Fyndiq Marketplace – Sweden’s Largest Bargain House
 
Progressive web application considerations before implementing magento pwa ...
Progressive web application   considerations before implementing magento pwa ...Progressive web application   considerations before implementing magento pwa ...
Progressive web application considerations before implementing magento pwa ...
 
Coffee & Commerce
Coffee & CommerceCoffee & Commerce
Coffee & Commerce
 
All need to know about Chinese new year
All need to know about Chinese new year All need to know about Chinese new year
All need to know about Chinese new year
 

Dernier

AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
Alluxio, Inc.
 

Dernier (20)

SOCRadar Research Team: Latest Activities of IntelBroker
SOCRadar Research Team: Latest Activities of IntelBrokerSOCRadar Research Team: Latest Activities of IntelBroker
SOCRadar Research Team: Latest Activities of IntelBroker
 
10 Essential Software Testing Tools You Need to Know About.pdf
10 Essential Software Testing Tools You Need to Know About.pdf10 Essential Software Testing Tools You Need to Know About.pdf
10 Essential Software Testing Tools You Need to Know About.pdf
 
A Comprehensive Appium Guide for Hybrid App Automation Testing.pdf
A Comprehensive Appium Guide for Hybrid App Automation Testing.pdfA Comprehensive Appium Guide for Hybrid App Automation Testing.pdf
A Comprehensive Appium Guide for Hybrid App Automation Testing.pdf
 
TROUBLESHOOTING 9 TYPES OF OUTOFMEMORYERROR
TROUBLESHOOTING 9 TYPES OF OUTOFMEMORYERRORTROUBLESHOOTING 9 TYPES OF OUTOFMEMORYERROR
TROUBLESHOOTING 9 TYPES OF OUTOFMEMORYERROR
 
Crafting the Perfect Measurement Sheet with PLM Integration
Crafting the Perfect Measurement Sheet with PLM IntegrationCrafting the Perfect Measurement Sheet with PLM Integration
Crafting the Perfect Measurement Sheet with PLM Integration
 
Agnieszka Andrzejewska - BIM School Course in Kraków
Agnieszka Andrzejewska - BIM School Course in KrakówAgnieszka Andrzejewska - BIM School Course in Kraków
Agnieszka Andrzejewska - BIM School Course in Kraków
 
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
AI/ML Infra Meetup | Improve Speed and GPU Utilization for Model Training & S...
 
Facemoji Keyboard released its 2023 State of Emoji report, outlining the most...
Facemoji Keyboard released its 2023 State of Emoji report, outlining the most...Facemoji Keyboard released its 2023 State of Emoji report, outlining the most...
Facemoji Keyboard released its 2023 State of Emoji report, outlining the most...
 
Secure Software Ecosystem Teqnation 2024
Secure Software Ecosystem Teqnation 2024Secure Software Ecosystem Teqnation 2024
Secure Software Ecosystem Teqnation 2024
 
Breaking the Code : A Guide to WhatsApp Business API.pdf
Breaking the Code : A Guide to WhatsApp Business API.pdfBreaking the Code : A Guide to WhatsApp Business API.pdf
Breaking the Code : A Guide to WhatsApp Business API.pdf
 
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
 
OpenChain @ LF Japan Executive Briefing - May 2024
OpenChain @ LF Japan Executive Briefing - May 2024OpenChain @ LF Japan Executive Briefing - May 2024
OpenChain @ LF Japan Executive Briefing - May 2024
 
AI/ML Infra Meetup | ML explainability in Michelangelo
AI/ML Infra Meetup | ML explainability in MichelangeloAI/ML Infra Meetup | ML explainability in Michelangelo
AI/ML Infra Meetup | ML explainability in Michelangelo
 
Benefits of Employee Monitoring Software
Benefits of  Employee Monitoring SoftwareBenefits of  Employee Monitoring Software
Benefits of Employee Monitoring Software
 
A Guideline to Gorgias to to Re:amaze Data Migration
A Guideline to Gorgias to to Re:amaze Data MigrationA Guideline to Gorgias to to Re:amaze Data Migration
A Guideline to Gorgias to to Re:amaze Data Migration
 
Advanced Flow Concepts Every Developer Should Know
Advanced Flow Concepts Every Developer Should KnowAdvanced Flow Concepts Every Developer Should Know
Advanced Flow Concepts Every Developer Should Know
 
top nidhi software solution freedownload
top nidhi software solution freedownloadtop nidhi software solution freedownload
top nidhi software solution freedownload
 
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAGAI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
 
5 Reasons Driving Warehouse Management Systems Demand
5 Reasons Driving Warehouse Management Systems Demand5 Reasons Driving Warehouse Management Systems Demand
5 Reasons Driving Warehouse Management Systems Demand
 
AI/ML Infra Meetup | Perspective on Deep Learning Framework
AI/ML Infra Meetup | Perspective on Deep Learning FrameworkAI/ML Infra Meetup | Perspective on Deep Learning Framework
AI/ML Infra Meetup | Perspective on Deep Learning Framework
 

Jet Magento Integration by CedCommerce

  • 1. © CedCommerce. All rights reserved. SUPPORT@CEDCOMMERCE.COM [Jet-Magento Integration] CedCommerce Jet-Magento Integration, an extension by CedCommerce, establishes synchronization of inventory, price, other details for product creation and its management between Magento store and Jet.com. The smooth harmonization is established with help of Jet.com REST API.
  • 2. © CedCommerce. All Rights Reserved. 2 Jet-Magento Integration User Manual Version – 0.0.5
  • 3. © CedCommerce. All Rights Reserved. 3 Contents I. Overview...............................................................................................................................................4 II. Jet Configuration...................................................................................................................................5 III. Jet API..................................................................................................................................................10 IV. Create Jet Category..……………………………………………………………………………………………………………………. 12 V. Assign Category to Product…………….………………………………………………………………………………………………14 VI. Manage Jet Attribute…….…………………………………………………………………………………………………………….…15 VII. Manage Product…………………………………………………………………………………………………………………………….17 VIII. View Jet Orders………………….………….……………………………………………………………………………………………..38 IX. View Failed Import Jet Orders Log….……………………………………………………………………………………………..42 X. Jet Return………………..…………………………………………………………………………………………………………………...43 XI. Jet Refund………………….………………………………………………………………………………………………………………….47 XII. Cron Status……………………..…………….……………………………………………………………………………………………...51 XIII. Support………………………………………………………………………………………………………………………………………..51
  • 4. © CedCommerce. All Rights Reserved. 4 OVERVIEW Jet-Magento Integration, an extension by CedCommerce, establishes a synchronization of inventory, price, other details for product creation and its management between Magento 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). . Map single Magento store to Jet.com with single Fulfillment node. . Import Jet.com orders to convert it into regular Magento Orders & Shipments. Admin can manage returns & refunds of jet products. In this extension currently we have provided support for two types of products: - Simple product and Configurable product which means only simple products and configurable products can be uploaded to Jet.com and the attributes will also be listed only for simple and configurable products. UPGRADATION INSTRUCTION It is a very simple process. If a merchant wants to upgrade or reinstall module from Magento Connect manager then he needs to remove the folder “jetcsv” from his Magento “var” directory. Just login to your ftp and go to Magento root folder (generally present under public_html folder) and then just overwrite the app, skin and var folders by checking the “Apply to this queue only” option so that it doesn’t asks for overwrite again and again. Your package will be upgraded.
  • 5. © CedCommerce. All Rights Reserved. 5 JET CONFIGURATION In order to obtain 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. The app folder should be replaced only after replacing the above two folders. Moreover, the app > etc > modules > modules.xml file should be replaced at the end after replacing all the files and folders so as to avoid any issues.
  • 6. © CedCommerce. All Rights Reserved. 6 After that obtain the API key and Secret Key and generate a Fulfillment Node as per Jet specifications to have a Jet Fulfillment Node Id. These details will be used in the configuration settings in the merchant’s admin panel. Once the merchant installs this extension, configuration settings will be created in his Magento admin panel’s System Configuration named as ‘jet configuration’ under CedCommerce Clicking on Test shows Sandbox mode and clicking on Live shows Live mode.
  • 7. © CedCommerce. All Rights Reserved. 7 Extension tab, as well as a menu will be added in the menu section named as jet that will consist of all the panel listing. This extension will also create a tab in the product’s general tab named as jet.com which will list all the created jet.com attributes. That we will explain later. The Configuration Setting can be done from here with jet com Here the merchant needs to enter following things 1. API URL (Default Selected) 2. API username (API User in Jet) 3. API password (Secret in Jet) 4. Fulfillment Node Id 5. Email Id 6. Select Store (Store which you want to integrate to Jet.com) Fullfillment Node Id (not Merchant Id of Jet, go to Fulfillment > Fulfillment Node Id from left navigation menu in the Jet Partner Panel). To display the module at frontend select Yes in this field.
  • 8. © CedCommerce. All Rights Reserved. 8 Email Id field is necessary because Jet API doesn’t provides Customer Email Address & an order can’t be created in Magento until a customer email Id is obtained. Thus, an email id has to be used to import orders from Jet into Magento. That’s why the merchant needs to create a customer with an email id from admin panel & use that email id in the Email field in Jet Configuration Settings as shown below. For this purpose, go to Customers > Manage Customer; here you can see the form for creating a customer from the admin panel. Just enter the customer’s First Name & Last Name as well as the Email id, save this customer & enter the same email id in the Jet Configuration Email field. If you do not enter the Email Id then a default id will be used which is sales@test.com.
  • 9. © CedCommerce. All Rights Reserved. 9 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. These configurations are mandatory to set before integrating Magento store with jet.com and this should be the first step after installing the extension on your site. These settings are provided if the quantity and price of a product to be uploaded on jet needs to be updated every time their quantity is changed in Magento. For instance, there is a product which has been uploaded on jet. Now, its quantity or price has been edited in Magento and the merchant wants that these new changes should also reflect on jet.com without re-uploading the product on jet, then, these configuration settings should be turned on. On product edit page (Catalog > Manage Product > Edit), if the status of the product is “Disabled” and the product is already uploaded on jet.com then is status will become
  • 10. © CedCommerce. All Rights Reserved. 10 “Archived" over there. If the product’s status is “Enabled” in Magento then the product will become enabled on jet.com as well. Note: - After setting the configuration go to Catalog > Manage Products and select all the products. From the mass Action dropdown select Update Attributes and click Submit button so as to update newly created categories and attributes in the Product Edit/Create form. Locate the Jet Product Status field; tick the checkbox labeled “Change” and then click Save button. Jet API To integrate Magento store with jet.com firstly the merchant needs to enable his API setup on jet com. Before enabling the Jet API, the merchant needs to make sure that the cache (Magento cache) is disabled. After testing all the APIs the cache can be enabled. If any merchant has created his account on jet .com and not enabled his API yet then he can enable his API panel from jet > API After setting up the Configuration Settings, this step is mandatory to be followed for the first time users who have just installed this extension. In order to obtain the live mode credentials all the Test APIs should be run because Jet doesn’t provides Live Mode details until all the Test APIs have been setup. i. Enable product API To enable the product API, the merchant needs to send SKU, price and inventory. So a setup has been prepared. For this the merchant only needs to click on Send link. Once Select all the products, choose Update Attribute and click Submit button to update all the attributes and categories.
  • 11. © CedCommerce. All Rights Reserved. 11 your product information will be send, link text will be changed to Send Successfully and it will no longer remain a link. ii. Enable order API To enable order API on jet.com the merchant needs to create an order from Order Generator. For this a link has been given named as Order Generator, it will redirect the merchant to jet.com order generator. Once the order has been created the merchant has to send Order Acknowledge. To enable Cancel Order the merchant needs to click on the Send link next to Cancel Order. Once the order information will be uploaded successfully, the link text will be changed to Send Successfully and it will no longer remain a link. iii. Enable return API Return API used to manage Returns generated for the completed order on jetc.com. To enable return API merchant needs to click on Send link next to Enable Return. Once the return is complete, the link text will be changed to Send Successfully and it will no longer remain a link. Select Jet > API from the menu section to open this page.
  • 12. © CedCommerce. All Rights Reserved. 12 CREATE JET CATEGORY To create jet categories in Magento go to Jet > Jet Category List. There are two ways of creating categories:- 1. By Importing The list of categories used in Jet.com will be displayed. Select the category (s) which has to be created in Magento and then from the mass Action dropdown select “Create Category” option and click the Submit button. Those many categories will be created in Magento. Select this menu item to open the category listings
  • 13. © CedCommerce. All Rights Reserved. 13 2. By Mapping If you have an already created category in Magento and you would like to map that category to any of the Jet categories, then go to Catalog > Manage Categories. Select the required category and then open the Jet Category Information tab. Enter the Jet Category Id which has to be mapped to this Magento category, select Yes in the “Is Jet Category” field and then click on the “Save Category” button. After creating/mapping the categories, it is necessary to import the attributes from Jet > Manage Attributes section (given on page 13). Select the categories to be created in Magento and then choose Create Category option from the mass Action dropdown and click Submit button. Enter Jet Category Id here
  • 14. © CedCommerce. All Rights Reserved. 14 ASSIGN CATEGORY TO PRODUCT After the categories get created in Magento, they need to be assigned to the products (if not already assigned to the required category). For this purpose, the merchant should go to Catalog > Manage Products > Select the product to be edited and locate the Categories tab. There he will find all the categories listed in the same manner as they were in Jet.com. Now, he should select a category which has to be assigned to the product. But, a product can be assigned to a single category only as this is the specification of Jet.com and we have to follow it. If there is nesting of categories (say 3 level nesting) then the product should be assigned either to the parent category, or to the child category or to the sub-child category, but NOT to all 3 of them or any 2 of them. Every product should be assigned only to a SINGLE Jet Category. For instance, if there is a product (say “Plum Seeds”) and it falls under 3 categories having parent- child relationship (say Grocery, Cooking & Baking Supplies and Nuts & Seeds) then Plum Seeds should either be assigned to Grocery or it should be assigned to Cooking & Baking Supplies or to Nuts & Seeds but, not to all 3 of them or any 2 of them. 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. To assign the products to their respective categories in a much faster way, go to Catalog > Manage Categories > Select the required category > Category Products Tab > Select all the Either Grocery Or Cooking & Baking Supplies Or Nuts & Seeds
  • 15. © CedCommerce. All Rights Reserved. 15 products that have to be assigned to this category and click Save Category button. If the products are not getting listed in that section, click on the “Reset Filter” button. MANAGE JET ATTRIBUTE Jet has a different procedure for attribute mapping. In Magento the attributes are assigned to the products whereas in Jet the attributes are assigned to the categories. Every Jet category has a specific set of attributes (not attribute set just a certain number of attributes) associated to it. The value of these attributes is necessary to be provided as if any required attribute will be found missing by jet, then Jet will throw related errors (which could be seen in Jet > Manage Magento Jet Product Attribute (s) Category Attribute (s) Assigned to Assigned to Imported to (in Jet Magento Integration) Imported to (in Jet Magento Integration) Category Product Assigned to Assigned to
  • 16. © CedCommerce. All Rights Reserved. 16 Products > Rejected Files > Error Description section given on Page 26) and the product won’t be uploaded on Jet. Since jet categories have some pre defined attributes, so the merchant needs to create the attributes after creating categories. For this he should go to Magento admin panel and select Jet > Manage Jet Attributes and click on the Import New Attribute button. It will create an attribute related to jet category. All the created category attributes will be listed in jet Manage Attribute panel. It will create three types of attribute:– 1. Text – For text type attribute there is no prior requirement, just the value needs to be entered. 2. Text with unit - For Text type attribute with unit we have added a hint below text type field by which merchant can acknowledge which type of unit he needs to enter for a particular attribute. 3. Dropdown/List - For Dropdown type of attribute, the merchant needs to add options on his own. Click Import New Attribute button to automatically create all the attributes as given in the csv uploaded for creating the categories.
  • 17. © CedCommerce. All Rights Reserved. 17 MANAGE PRODUCT This tab will manage the product upload system. It consists of two sub menus:- 1. Upload files - Following operations can be performed here:- Necessary information during general product uploads: 1. It must be assigned to a jet category. One product can be assigned to only one category. 2. A product must have one of the following information (UPC, GTIN-14, ISBN-13, ISBN- 10, EAN, and ASIN). 3. Brand Name attribute is mandatory to be given along with either Manufacturing Part Number or ASIN or any one of UPC, ISBN-10, GTIN-14. Initially when the product will be uploaded, its default status will be ‘Not Uploaded’. When the product will be successfully uploaded its status will change to ‘Processing/Under Jet Review’. Information to be filled during product creation Click Jet > Manage Products > Upload Product in the menu section to open Product Manager.
  • 18. © CedCommerce. All Rights Reserved. 18 During the product creation the merchant can fill the attribute information from jet.com tab created under General Information tab on Product Edit Page. From here the merchant can fill the attribute information. During product creation it must have one of the following information (UPC, GTIN-14, ISBN-13, ISBN-10, EAN, and ASIN). Optional Attributes that can be provided apart from the necessary attributes Extra attributes in which the values can be provided are:- 1. Amazon Item Type Keyword 2. Category Path String 3. Bullets 4. Number Units for Price per Unit 5. Type of Unit for Price per Unit 6. Shipping Weight Pounds 7. Package Length Inches 8. Package Width Inches 9. Package Height Inches 10. Display Length Inches 11. Display Width Inches 12. Display Height Inches Click Catalog > Manage Products > Open the required product. ASIN, UPC, ISBN, EAN, ISBN-13, ISBN-10, GTIN-14 can be entered from this page.
  • 19. © CedCommerce. All Rights Reserved. 19 13. Prop 65 14. Legal Disclaimer Description 15. Cpsia Cautionary Statements 16. Country of Origin 17. Safety Warning 18. Start Selling Date 19. Fulfillment Time 20. Msrp 21. Map Price 22. Map Implementation 23. Product Tax Code 24. No Return Fee Adjustment 25. Exclude from Fee Adjustments 26. Ships Alone
  • 20. © CedCommerce. All Rights Reserved. 20
  • 21. © CedCommerce. All Rights Reserved. 21
  • 22. © CedCommerce. All Rights Reserved. 22
  • 23. © CedCommerce. All Rights Reserved. 23
  • 24. © CedCommerce. All Rights Reserved. 24 i. Upload product Upload simple product This panel will list all the products assigned in jet categories. For uploading the product on jet.com from here, the merchant needs to select the product using Mass Select by clicking the respective checkboxes and after that Upload Selected Action should be selected from mass Action dropdown and submit button should be clicked. It will upload the products on jet.com and a message will appear in the product upload panel reading “Selected products Upload Request Send Successfully on Jet.com”. Upload configurable product The products which are identical in structure but differ on the basis of some attributes fall in the category of Configurable Products. Jet.com accepts the Relational Products in two categories:- 1. Accessories – for Bundle and Grouped products 2. Variation – for Configurable products. 2. Select Upload Selected option from the Mass Action dropdown and click Submit button. 1. Select the product whose status is Not Uploaded. Click this button to update the Jet Product Status immediately.
  • 25. © CedCommerce. All Rights Reserved. 25 Let us first understand the difference between the Magento Configurable Product and Jet Configurable Product (Variation product). The configurable products in Magento include one parent product to which its associated products are mapped whereas in Jet there is no such parent product. Instead any one of the child products is treated as a parent product and all the rest of the products are mapped to it. We have also followed a similar procedure while sending the data to the API. Some points are necessary to be followed for uploading configurable products:- 1. Brand Name attribute is mandatory to be given alongwith either Manufacturing Part Number or ASIN or any one of UPC, ISBN-10, GTIN-14. 2. All the children products of the configurable product should be assigned to the same jet category. 3. Brand Name of the children products should be the same as that of the parent product. Steps for uploading the configurable product:- Step 1: Attribute Mapping Before uploading any configurable product, all the Magento attributes responsible for differentiating the child (associated) products should be mapped to the Jet attributes first. For example, if the associated products differ on the basis of Color and Size attributes in Magento then on sending the data to jet.com, Jet will be looking for its Color and Size attributes that are assigned to its categories NOT the Color and Size attributes of Magento. Therefore, it is very necessary to map Magento attributes to Jet.com attributes. For this purpose, follow the below given steps:- 1. If suppose a product “Shirt” is a configurable product that has to be uploaded on jet.com and has Color and Size attributes, then a Jet category should be searched from the Jet > Jet Category List panel which contains both the attributes (not any one). All the child products of the configurable product “Shirt” should be assigned to this category only having both the color and size attributes (if not previously assigned) and no other category.
  • 26. © CedCommerce. All Rights Reserved. 26 Filter the categories on the basis of a specific category. Click this link to view the attributes of the respective categories. Selecting a category with only Color attribute is not valid. Selecting a category with only Size attribute is not valid.
  • 27. © CedCommerce. All Rights Reserved. 27 2. Now the attributes need to be mapped, therefore, go to Catalog > Attributes > Manage Attributes > Open the attribute that needs to be mapped (Color and Size in this case) in a new tab and let the previous tab of Jet Category List remain open in another tab. Copy the Attribute id from the “Jet Category Listing Tab” and paste it in the “Jet Attribute Id” field. Now click the “Save and Continue” button. If you would like to view the id of the Jet attribute then it can be seen from the csv file which will be available for download by clicking on the “Click Here” link under Jet Attribute tab. 3. After saving the attribute you might get an Error Notification message as well alongwith the Success message. That notification message will warn you to enter only the valid Click Here to download the Jet_Taxonomy_attribute.csv file. Both the attributes Color and Size should be present in a Jet Category. Copy and Paste this Attribute Id in the Jet Attribute Id field in the Catalog > Manage Attribute section shown below.
  • 28. © CedCommerce. All Rights Reserved. 28 values (that are accepted by jet) as options to that attribute if it is a dropdown type of attribute. This step should be followed otherwise the product won’t be uploaded on jet.com. Three types of attributes can be created in jet: Text type, Dropdown type and Unit type. In Unit type and Dropdown type attributes, as soon as you click “Save” button, you will be notified via an error message that you also need to provide the values to these attributes. So then you should go to “Jet Attribute Tab” again, a note would now have been appended over there. For example, if it is a UNIT type attribute then it will look like this Likewise it is for dropdown type attribute also. Therefore, the values should be provided to these attributes and it will accept only those values at jet.com which have been suggested as options over here. Any extra custom values if provided will not be accepted. The syntax how the values should be provided is also given here. That syntax should be followed to ensure proper functioning. Step 2: Uploading Configurable Product 1. After the proper completion of Step 1, select the configurable product to be uploaded from the Jet > Manage Product Grid, select the “Upload” option from the mass Action dropdown and click on the Submit button. These are options that can be provided as values to the dropdown type attributes. The values to this type attribute should be provided in this way.
  • 29. © CedCommerce. All Rights Reserved. 29 2. Click on the View Details link of that product. Locate the “Variation Refinement” field, if it contains the attribute ids of all the attributes that were mapped then it means the product has been successfully uploaded on jet.com otherwise if a blank field appears then that means the product has not been uploaded. Select the configurable product to be uploaded, select Upload Selected option from the mass Action and click Submit button. Click this link to view the details of the product that are on Jet.
  • 30. © CedCommerce. All Rights Reserved. 30 This field contains values i.e. the attribute ids of the attributes being mapped. Thus, the product has been uploaded successfully.
  • 31. © CedCommerce. All Rights Reserved. 31 3. When the product has been successfully uploaded then the “bulk upload” feature can be used to upload rest of the products if any. This completes the entire procedure of Configurable Product upload and Simple product upload on jet.com. How does product upload process works? Whenever a product is uploaded then it gets uploaded in the form of batches of 30 products each. If 100 products are uploaded (say) then 4 batches will be formed with 3 batches having 30 products and the last batch having 10 products. For every batch, 3 files are created. They are:- 1. inventory {timestap}.json 2. price{timestap}.json 3. sku{timestap}.json/merchantsku{timestap}.json These are present at root in the var > jetupload folder. So, if total 4 batches are there, then 12 files will be created. These files are then compressed and uploaded on jet.com. Select the configurable products to be uploaded, select Batch Upload from the mass Action and click Submit button.
  • 32. © CedCommerce. All Rights Reserved. 32 The 3 files include one having details of the quantity or inventory of 30 products, according to the fulfillment node, which are mentioned in the sku file (inventory {timestap}.json), one having the details of the price, according to fulfillment node, of those 30 products which are mentioned in the sku file(price{timestap}.json file) and the other having general details of those 30 products related to SKU, etc (sku{timestap}.json file). Whenever a product is not uploaded and some error is generated then it gets listed in the error files section which includes any one of the 3 files. The content of those files should be seen by the merchant to locate the product having the error so as to rectify those errors and resubmit the file. After all the files are submitted to jet.com server, they then process those batch files. If all the information about the products is processed then the products are uploaded & moved to the Processing state otherwise the batch file is marked as "Processing with error status."
  • 33. © CedCommerce. All Rights Reserved. 33 ii. Batch Upload To upload multiple products on jet or to upload all the products on jet, batch upload feature can be used. Just select all the required products and choose “Batch Upload” from the mass Action dropdown and click on the Submit button. The products will get uploaded. The process of Upload will be visible to the merchant and if any error appears like UPC number is not given, or Brand and Manufacturer Part Number is not given, etc then the Upload process will break and the error will be listed over there itself. Before uploading Bundle, Grouped and Configurable products, make sure the Brand Name of the child products is the same as that of the parent product, otherwise error may appear. If any error appears then it will be listed over here. That error can be resolved and the product can be uploaded again. Select the products to be uploaded and choose Batch Upload option from the Mass Action dropdown and click Submit button.
  • 34. © CedCommerce. All Rights Reserved. 34 iii. Close/Disable/Archive product Jet .com provides the ability to close the uploaded product. If a merchant wants to close his uploaded product at any time after successful upload then it can be easily done. For this, the merchant needs to select the product from the product panel by selecting the checkbox. After that he needs to select the archive action and click on the Submit button. That product will be archived successfully and its status will change to Archived. This product will be closed on jet.com and it will not appear on jet.com for purchase. iv. Reopen/Enable/Unarchive product Jet.com provides the ability to reopen closed products. For this, the merchant needs to select the archived product and then select Un-archive option from the Action dropdown and click on the Submit button. The selected product will be available again for purchase on jet.com. Merchant can archive or Un-archive multiple products by selecting multiple products using checkbox. If the merchant wants he can archive or un-archive a single product also. To do this, the merchant needs to go to the View Detail action of the product from the product panel. If 1. Select the product from here which has to be Closed/Archived. 2. Select Archive option from the Mass Action dropdown and click Submit button.
  • 35. © CedCommerce. All Rights Reserved. 35 the product is open an Archive button will be shown. If the product is closed, the un-archive button will be shown. From here the merchant can choose a specified action as he wants. v. Add 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 go to “View Product Status” page by clicking on the “View Details” link on the Manage Products page. There he’ll find a tab in the left “Shipping Exception”. The merchant needs to fill in the requisite details over here and click on the Save button to save the information. 1. Select the product from here which has to be Reopened/Unarchived. Only Archived products can be Unarchived. 2. Select Unarchive option from the Mass Action dropdown and click Submit button.
  • 36. © CedCommerce. All Rights Reserved. 36 vi. Add 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 “View Details” link to open the Product Information page. Click on the “Return Exception” tab in the left to add the exception. 2. Rejected files We upload jet.com product using their file upload process. Due to any reason if an error occurs during the product upload then that product will be listed in the Rejected File panel. From here the merchant needs to go to View Error & Resubmit action. Shipping Exception related details can be entered over here. Return Exception related details can be entered over here.
  • 37. © CedCommerce. All Rights Reserved. 37 Here the Errors present in the corresponding file appear with Resubmit button. When the merchant clicks on this button his product will be resubmitted to jet.com. If the product gets submitted successfully then the status of the file will change to N/A. Select Jet > Manage Products > Rejected Files from the menu section to open Rejected Jet Files Manager. Click here to view the errors coming in the rejected files. Click Jet > Manage Products > Rejected Files, to open the Error Files Information page. Notification area displays the count of rejected Jet files. The errors will be listed here and then the merchant needs to find the error in his file, resolve it and click Resubmit File button. The contents of the file can be seen from here. These are the total products whose information went to jet for upload. These products can be seen for errors and those can be rectified.
  • 38. © CedCommerce. All Rights Reserved. 38 Whenever the product gets uploaded then a batch file of products is created and that file is responsible for uploading the products on jet.com, therefore if some error occurs in found by jet in the products which are present in the batch file uploaded on jet.com then it rejects the file with some errors. Then all the recently uploaded products should be checked for that error and uploaded again i.e. Resubmit File. Note: The errors corresponding to the related files will be listed under the Error Description section on the Error Files Page (as shown above in the “Create Jet Attribute” section). It is the responsibility of the admin/merchant to locate those errors in the respective files and resolve them. VIEW JET ORDER We have set up a Cron for the orders that will fetch all the orders generated on jet.com. The merchant gets notified by the notifications in admin panel. 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. We have used default shipping method (custom jet shipping method) and default payment method Click this button to fetch Rejected Files immediately. Select the file to be deleted and then choose Delete option from the mass Action dropdown and click the Submit button.
  • 39. © CedCommerce. All Rights Reserved. 39 (custom jet payment method) for jet orders. So the merchant should enable these methods in Magento. Select Sales > Order from the menu section and then select the respective order and click on its View link to open Order view page. As soon as the order is placed these two buttons (Acknowledge & Reject) remain enabled. If any of the buttons is clicked then both of them become disabled. If Acknowledge button is clicked then the admin cannot reject it. Likewise, if Reject button is clicked then it cannot be acknowledged and the Order Status will change to Cancelled.
  • 40. © CedCommerce. All Rights Reserved. 40 For shipment, we have added a tab ‘Ship by Jet ‘from which the merchant can create shipment for orders. This tab will be visible only if the order has been placed from Jet.com. Click on Ship by jet tab in the left menu to open this section.
  • 41. © CedCommerce. All Rights Reserved. 41 Here the merchant needs to enter the tracking number; quantity ordered will be auto-filled. In the quantity cancelled field, the merchant needs to enter the quantity he is not able to supply at the time of orders. Product SKU will reflect the SKU of the ordered quantity. If the merchant wants to send a Return location address then it can be done by selecting ‘yes’ from the dropdown. It means if after order completion the customer generates a return request for this order then this product will be returned to the address set in the return location configuration. When the merchant clicks on the Ship button, the order will be shipped and its invoice and shipment will be created automatically in Magento. The status of order will change to Completed. To view the newly imported/fetched Jet orders “Jet Orders Details” panel is used. This panel lists the newly generated Jet orders with their “Jet Reference Order Id” and their corresponding Magento “Order Id” clicking on which their corresponding Order View page will open. The merchant can also mass “Acknowledge” the orders from this panel itself by selecting the respective orders and then choosing the “Acknowledge” option from the mass Action dropdown and then clicking on the “Submit” button. But for “Rejecting” the orders their view page has to be opened as in case of rejecting the orders for shipment certain details have to be filled. But, as soon as the latest orders are fetched, a notification appears in the admin panel’s notification area and those orders get Auto-Acknowledged. This is done so that if the merchant is unable to acknowledge the orders within 2 hours then they don’t get rejected.
  • 42. © CedCommerce. All Rights Reserved. 42 To manually fetch the latest orders (if required immediately) the merchant can click on the “Fetch Latest Orders” button. VIEW FAILED IMPORT JET ORDERS LOG When some order (s) is placed using Jet.com for a particular product and for the same product Magento order has also been placed then a case may arise where that product can become Out of Stock, Required Quantity is Not Available or has been Disabled then those orders are not placed on Jet.com and the list of those orders can be viewed by selecting Jet > Jet Orders > View Failed Import Jet Orders Log from the menu section. This section displays the failed orders with their order id and the reason for their failure. Select Jet > Jet Orders > View Jet Orders from the menu section to open the Jet Orders Details page. Select the orders to be acknowledged and then choose the Acknowledge option from the mass Action dropdown and click the Submit button. Click this button to manually fetch the orders in case of immediate requirement.
  • 43. © CedCommerce. All Rights Reserved. 43 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 then it will be listed in the return panel with status Created and the merchant (admin) will be notified about it by notification in the admin panel. Select the orders to be deleted and then choose Delete option from the mass Action dropdown and click Submit button.
  • 44. © CedCommerce. All Rights Reserved. 44 For completing the return the admin/merchant needs to enter some information like quantity refunded, return feedback, shipping cost, shipping tax and tax. Hence the merchant needs to click on the Edit link. It will open a form that contains all the necessary fields which the merchant has to fill for completing the return. Select Jet > Jet Orders > Return from the menu section to open the Return Management page. Click on the Edit link of any particular row in the grid that appears on Return Management page to open this form. Click this button to fetch New Returns immediately. Respective Magento Order Id of the corresponding Jet Order.
  • 45. © CedCommerce. All Rights Reserved. 45 Select Yes in this field if you agree to return the product. Select Yes in this field if you agree to return this item. This section comes item-wise like if two products have been ordered in a single order then this section will be displayed item-wise so that if you don’t agree to return a particular item then you can select No in this field. Enter the qty of the item that you want to refund to the customer.
  • 46. © CedCommerce. All Rights Reserved. 46 ii. 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’ iii. Want To Send If the merchant agrees to accept the return this particular item, Yes should be selected in this field otherwise No. iii. Qty Refunded Here the merchant needs to enter the quantity that he wants to refund to the customer. iv. Return Feedback Here the merchant needs to enter the feedback about the return. v. Shipping Cost This is the shipping cost of the item that will be refunded to the customer. vi. Shipping Tax This is the amount that was charged on the shipping apart from the shipping amount and will be refunded to the customer. vii. Tax This is tax amount that was charged on the item and will be refunded to the customer. This is the amount that will be returned to the customer.
  • 47. © CedCommerce. All Rights Reserved. 47 Except this all the fields will be initially filled like return id, merchant order id, order item id, qty ordered, qty already refunded, and qty available for refund, qty returned and amount. Once the merchant fills all the fields and clicks on the Submit Return button, his return will be completed on jet.com. A success message will appear on the top of the return grid showing that the return has been posted to jet successfully and in the return panel its status will be changed to Completed. As soon as the Return is completed, the credit memo for that order is also generated in Magento so as to complete the return process of that order in magento as well. JET REFUND If the merchant ships any order generated on jet.com and after that if a customer return that product/order directly to the merchant without the involvement of jet.com, then the merchant needs to send a request on jet.com for completing this type of return. To manage this type of return there is a panel ‘Jet Refund’. If any jet.com product will be returned directly to the merchant then to complete this return the merchant needs to click on ‘Create New Refund’ button. This will open a form for entering the information. Select Jet > Jet Orders > Refund from the menu section to open the Refund Management page. Click this button to get Updated Refund Status immediately. Click this button to create a new Refund.
  • 48. © CedCommerce. All Rights Reserved. 48 As soon as these details are filled the respective order details get displayed item-wise in the new section (s) that gets listed below. Click on the “Add” button adjacent to the sku tab to display the form shown below. Click on Create New Refund button to open this form. This is the merchant id that is provided by jet.com to the merchant and can be obtained from the partner panel. This id can also be obtained from by going to Jet > Jet Orders > View Jet Orders > Jet Merchant Order Id column. Locate your order whose refund has to be created and then copy its id and paste it in this field over here. Enter the quantity that the customer wants to return. Enter the quantity that the merchant wants to refund. It cannot be more than the Qty Returned but can be less than it as the merchant may not want to refund all the items.
  • 49. © CedCommerce. All Rights Reserved. 49 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. Refund Merchant Id This is the merchant id i.e. the id of that merchant for whose products the return request has been generated. iii. Order item id This is the item id that has been ordered. iv. Qty Requested This is the total items ordered in the current order. Provide a Refund feedback over here. Provide a reason for Refund as provided by the customer. Enter the Refund Shipping cost, Refund Shipping Tax and Refund Tax as per the need.
  • 50. © CedCommerce. All Rights Reserved. 50 v. Qty Already Refunded This is the number of items which have been already refunded to the customer. vi. Qty Available for Refund This is the number of items which can be refunded i.e. if there were 4 items in an order out of which two have been already refunded then only 2 items are left that can now be refunded and not more than 2 as the order consisted of only 4 items. vii. Qty Returned This is the total quantity that has been returned by the customer. It should not be more than shipped qty. viii. Qty Refunded This is the quantity that the merchant wants to refund. It should not be more than the returned quantity but can be less than that. ix. Refund tax This is the tax applied on the products returned. x. Refund Amount This is the amount that jet has to return to the customer. xi. Refund Shipping Cost This is the shipping cost applied on the returned product. xii. Refund Shipping tax This is the shipping tax applied on the returned product. xiii. Refund Feedback This is the feedback that the merchant wants to send about the returned product. xiv. Refund Reason This is the reason why customer has returned the product.
  • 51. © CedCommerce. All Rights Reserved. 51 CRON STATUS The updated status will be reflected (visible) as follows:- Activity Time Required for Updating (min) Order Creation 10 Error in Rejected Files 10 Return Status 10 Refund Status 10 Product Status 10 SUPPORT If you need support or have questions directly related to JET-MAGENTO 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