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 Jet-Magento Integration User Manual Version 0.0.5
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. XII. XIII. Jet Refund..47 Cron Status......51 Support..51
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 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. 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.
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. Clicking on Test shows Sandbox mode and clicking on Live shows Live mode. 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
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 To display the module at frontend select Yes in this field. 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).
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 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 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. Select all the products, choose Update Attribute and click Submit button to update all the attributes and categories. 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
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 CREATE JET CATEGORY To create jet categories in Magento go to Jet > Jet Category List. Select this menu item to open the category listings 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.
13 Select the categories to be created in Magento and then choose Create Category option from the mass Action dropdown and click Submit button. 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. Enter Jet Category Id here After creating/mapping the categories, it is necessary to import the attributes from Jet > Manage Attributes section (given on page 13).
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 parentchild 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. Either Grocery Or Cooking & Baking Supplies Or Nuts & Seeds 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
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. Magento Jet Imported to (in Jet Magento Integration) Category Category Assigned to Assigned to Product Attribute (s) Assigned to Imported to (in Jet Magento Integration) Assigned to Attribute (s) Product 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
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 MANAGE PRODUCT This tab will manage the product upload system. It consists of two sub menus:- Click Jet > Manage Products > Upload Product in the menu section to open Product Manager. 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
18 During the product creation the merchant can fill the attribute information from jet.com tab Click Catalog > Manage Products > created under General Information tab Open on Product the required Edit product. Page. From ASIN, here UPC, the merchant can fill the attribute information. During product ISBN, EAN, creation ISBN-13, it ISBN-10, must have GTIN-14 one of the following information (UPC, GTIN-14, ISBN-13, ISBN-10, can be EAN, entered and from ASIN). this page. 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
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
21
22
23
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. Click this button to update the Jet Product Status immediately. 2. Select Upload Selected option from the Mass Action dropdown and click Submit button. 1. Select the product whose status is Not Uploaded. 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.
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 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 Copy and Paste this Attribute Id in the Jet Attribute Id field in the Catalog > Manage Attribute section shown below. Both the attributes Color and Size should be present in a Jet Category. 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. Click Here to download the Jet_Taxonomy_attribute.csv file. 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
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 The values to this type attribute should be provided in this way. These are options that can be provided as values to the dropdown type attributes. 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.
29 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. 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.
30 This field contains values i.e. the attribute ids of the attributes being mapped. Thus, the product has been uploaded successfully.
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. Select the configurable products to be uploaded, select Batch Upload from the mass Action and click Submit button. 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.
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 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. Select the products to be uploaded and choose Batch Upload option from the Mass Action dropdown and click Submit button. 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.
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. 2. Select Archive option from the Mass Action dropdown and click Submit button. 1. Select the product from here which has to be Closed/Archived. 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
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. 2. Select Unarchive option from the Mass Action dropdown and click Submit button. v. Add Shipping Exception 1. Select the product from here which has to be Reopened/Unarchived. Only Archived products can be Unarchived. 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.
36 Shipping Exception related details can be entered over here. 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. Return Exception related details can be entered over here. 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.
37 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. 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. 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 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. 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. 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
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 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 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 Select Jet > Jet Orders > View Jet Orders from the menu section to open the Jet Orders Details page. Click this button to manually fetch the orders in case of immediate requirement. Select the orders to be acknowledged and then choose the Acknowledge option from the mass Action dropdown and click the Submit button. 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.
43 Select the orders to be deleted and then choose Delete option from the mass Action dropdown and click Submit button. 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.
44 Select Jet > Jet Orders > Return from the menu section to open the Return Management page. Respective Magento Order Id of the corresponding Jet Order. Click this button to fetch New Returns immediately. 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. Click on the Edit link of any particular row in the grid that appears on Return Management page to open this form.
Select Yes in this field if you agree to return the product. 45 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.
This is the amount that will be returned to the customer. 46 ii. iii. iii. iv. 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 Want To Send If the merchant agrees to accept the return this particular item, Yes should be selected in this field otherwise No. Qty Refunded Here the merchant needs to enter the quantity that he wants to refund to the customer. 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. vii. Shipping Tax This is the amount that was charged on the shipping apart from the shipping amount and will be refunded to the customer. Tax This is tax amount that was charged on the item and will be refunded to the customer.
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. 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. 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.
This is the merchant id that is provided by jet.com to the merchant and can be obtained from the partner panel. 48 Click on Create New Refund button to open this form. 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. 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. 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.
Provide a Refund feedback over here. 49 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. 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.
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 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