Jet Magento Integration

To install the Jet extension :-

• Login to your Magento Admin Panel.
• Select System >> Magento Connect >> Magento Connect Manager.
• Magento Connect Manager login Panel Appears. Login with your Admin Credentials.
• Unselect the "Put store on the maintenance mode while installing/upgrading/backup creation" option.
• In "Direct package file upload" section browse the Jet Extension package and click on upload.
• The Jet Extension gets uploaded on your Magento.

• Configuration settings will be created in his Magento admin panel’s System Configuration named as ‘jet configuration’ under CedCommerce 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 attribute.

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.
It will open a page asking ‘Set up your test API’.

Enable product API

Enable order API

Enable return API

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.

To configure the settings in jet > configuration the merchant needs to go to https://partner.jet.com and login to his account.

• Click on API link to obtain the API key, Secret Key and Merchant Id.
• Click on Fulfillment link to generate a Fulfillment Node as per Jet specifications to have a Jet Fulfillment Node Id .

Before creating Jet Attributes it is necessary to create Jet Categories by uploading the csv file.
If the Jet Categories are already created then:-

• From Magento admin panel menu select Jet > Manage Jet Attributes.
• Click Import New Attribute button to automatically create all the attributes.
• After updating all the categories and attributes go to Catalog > Manage Products and select all the products.
• From the mass Action drop-down Select all the products, choose Update Attribute and click Submit button to update all the attributes and categories.
• The Update Attribute page will appear. Scroll down to locate Jet Product Status field .
• Tick the check-box next to "Change" so that all the products go to Not Uploaded state by default. Now click on Save Button.

After the categories get created in Magento, they need to be assigned to the products.
For this purpose:-

• From Magento admin panel menu select Catalog > Manage Products > Select the product to be edited and locate the Categories tab.
• Now Select a category which has to be assigned to the product.

For uploading the products on jet.com

• Click Jet > Manage Products > Upload Product in the menu section to open Product Manager.
• Select the product whose status is Not Uploaded.
• Select Selected Product Upload option from the Mass Action drop-down and click Submit button.
• A message will appear in product upload panel reading “Your product has been successfully uploaded”.
• Click on "Get Updated Product status" to update the Jet Product Status immediately.

The Necessary Information regarding Product uploads are:-

• The Product must be assigned to a jet category. One product can be assigned to only one Jet category.
• A product must have one of the following information (UPC, UPC-E, GTIN-14, ISBN-13, ISBN-10, EAN, and ASIN).
• For uploading the configurable products, it is necessary that their associated product must be uploaded first.
• 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’.

To Archive/Close/Disable the product:-

To Unarchive /Reopen/Enable the product:-

Due to any reason if an error occurs during the product upload then that product will be listed in the Rejected File panel.

• Select Jet > Manage Products > Rejected Files from the menu section to open Rejected Jet Files Manager.
• From here the merchant needs to go to View Error & Resubmit action.
• By Clicking on the "View Errors and Resubmit" link "Error Files Information" page appears .
• The error gets listed over here in the Error Description section.

When an order is generated on jet.com , then the merchant should notify jet.com that whether he is able to fulfill the orders or not.
For this purpose:-

• Go to Sales > Orders. All the orders will be shown here.
• Click on the View button of the Pending order to open the Order View Page.
• Click Acknowledge button to acknowledge the order and click Reject button to reject the order.
• If Acknowledge button is clicked then the admin cannot reject it.
• If Reject button is clicked then it cannot be acknowledged and the Order Status will change to Cancelled.

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.
For this purpose :-

• Go to Sales > Orders. All the orders will be shown here.
• Click on the View button of the Pending order to open the Order View Page.
• Click Acknowledge button to acknowledge the order and click Reject button to reject the order.
• Click on Ship By Jet option for shipping purpose.
• 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 drop-down.
• 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.
  

List of failed 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.
• To manually fetch the latest orders (if required immediately) the merchant can click on the “Fetch Latest Orders” button.

• Select the orders to be deleted and then,
• Choose Delete option from the mass Action drop-down and click Submit button.

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 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 "Return Fields" form.
• Once the merchant fills all the fields and clicks on the Submit Return button, his return will be completed on jet.com.
• A message will appear in the pop up showing that his return has been completed and in the return panel its status will be changed to Completed.

To manage this type of return there is a panel ‘Jet Refund’:-

• Select Jet > Jet Orders > Refund from the menu section to open the Refund Management page.
• Click on "Get Updated Refund Status" button to get Updated Refund Status immediately.
• Click on Create New Refund button to open Refund Information form.
• This will open a form for entering the Refund related information.
• Refund id
This is the refund id that 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.

• Merchant Order Id
This is the order id for which return request has been generated.

• Order item id
This is the item id that has been ordered.

• Qty Returned
This is the total quantity that has been returned. It should not be more than shipped quantity.

• Qty Refunded
This is the quantity that the merchant wants to refund. It should not be more than the returned quantity .

• Refund tax
This is the tax applied on the products returned .

• Refund Amount
This is the amount that jet has to return to the customer.

• Shipping Cost
This is the shipping cost applied on the returned product.

• Shipping tax
This is the shipping tax applied on the returned product.

• Refund Feedback
This is the feedback that the merchant wants to send about the returned product.

• Refund Reason
This is the reason why customer has returned the product.

To set up the configuration setting:-

• Click Jet > Configuration in the menu section to open Jet Configuration.
• Enabled: Set Yes To display the module at front-end.      
• Enter API URL, API username (API User in Jet), API password (Secret in Jet)
• Enter Fulfillment Node Id and Email Id.
• 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.

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 which 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.

The 3 files include:-
1. inventory {timestap}.json, having details of the quantity or inventory of 30 products, according to the fulfillment node, which are mentioned in the sku file
2. price {timestap}.json file, having the details of the price, according to fulfillment node, of those 30 products which are mentioned in the sku file and
3. sku {timestap}.json file, having general details of those 30 products related to SKU, etc.

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."

To map an already existing category to a Jet category, go to Catalog > Manage Categories. Select the required category that needs to be mapped (should be a non-jet category) and click on the "Jet Category Mapping" tab, where you need to select the required category from the dropdown, then click on Save Category button. Now go to Catalog > Attributes > Manage Attributes > Edit the required attribute > Jet Attribute Tab. Enter the “Attribute Id” of the Jet Attribute that has to be mapped with the Magento Attribute in the Jet Attribute Id field. Now click on the Validate button. When you map your Magento category, all products of the mapped category get listed in Manage Product grid of Jet.

Brand signifies the name under which a product comes. The Brand attribute has been marked as important by Jet. Therefore, before uploading a product on Jet it should be checked that the product's brand name is provided to ensure that the product gets successfully uploaded on Jet.

After uploading the product, if no error files are generated still the product is not visible on Jet and no files are generated in the Jet Partner Panel > API > File Uploads section then that means the product has been successfully uploaded on Jet. If is it not getting listed then that is an issue of Jet as sometimes the products get stored in their backend but never get listed due to some internal issue of Jet. In this case the Jet support Team should be contacted.

You cannot add discounts but you can use the Rules Engine which is available in the Jet partner panel and update pricing to become more competitive on products.

If the product is in the "Under Review" section of jet for a long time then it may be because all the details of the product might not have been entered. Although it takes approximately 1 week for the products to go from "Under Review" section to Live Mode. To speed up the process, all the jet attributes assigned to the product under jet.com tab on product edit page should have proper values and none of the attribute should be left blank. This way jet will receive all the values for all the attributes. If jet was looking for some attribute value which was causing the products to remain in "Under Review" section then by providing values for all the jet attributes this problem may not occur and the products will go to Live Mode if no other issue happens to be on Jet.

Sometimes the products get stored in their backend but never get listed on frontend as this is Jet.com's internal issue which when gets resolved, the products start showing up at frontend.

Follow the path as mentioned below:
Jet >> Manage Product >> Upload Product
The Jet Product Status is empty because upon installation of Magento-Jet extension the Catalog Product attribute- Jet_Product_Status is created that reflects the latest product status as on jet.com.
Under Product Edit section the jet.com
tab appears that further leads to Jet Product Status dropdown.
Select the "Not Uploaded" option from the Jet Product Status dropdown before uploading any product on jet.com.
Alternatively, you can apply the Mass Action dropdown option "Update Attributes" through Catalog >> Manage Product Grid
1) Select number of products which you wish to upload on jet.com.
2) Select dropdown option "Update Attributes" and click on the Submit button.
3) Set Jet Product Status as "Not Uploaded".
4) Click on the Save button.

Tier price cannot be uploaded on Jet.com. But Jet Provided a Jet Rule Engine to apply customer benefit settings. These settings can be found in your Jet Partner Panel. You need to use Rules Engine (available in the left side menu in the partner panel) & contact to partner panel support for "How to use Jet Rules Engine. The module doesn't includes these features as there is no API for this. This can be done from Jet Partner Panel only.

From Magento-Jet extension for uploading the variant product .

• If a merchant wants to upload a variant product say a shirt(S1) having size as attribute(large,medium,small).
• So, he will create 3 variation products  (S1-large), (S1-Medium), (S1-small) .
• Now when he will upload this product on to jet the product which has been uploaded first will be the parent product and the remaining 2 products will be child product.
• So, if (S1-Medium) product is uploaded first on jet then this will be the parent product and (S1-large),  (S1-small) product will be the child product of (S1-Medium).