Rakuten Listing Guide
Posted by Nathan Woods on 24 Feb 2015 15:15

Last Modified by Adam Roberts on 30 Jan 2017 13:54

Listing to Rakuten from StoreFeeder is easy.

StoreFeeder includes a listing tool to allow the creation of new products and update existing products on Rakuten.

The Listing Page is split into a number of sections in order to group relevant information together and to aid usability.

The sections are as follows:

  • General
  • Description
  • Categories
  • Shipping
  • Images (simple products only)
  • Variants (variant products only)
  • Submissions

 

General

The General tab is where you will set all the basic information for that listing.

Required fields are marked by an asterisk (*) and must be completed for the listing to successfully send to Rakuten. Fields not marked by an asterisk are optional and may be left blank.

The fields presented on the General tab will differ slightly depending on whether the listing is for a simple product or a variant product. Variant products will not display the Price, Max Inventory, Oversell or Out of Stock Threshold as these values will be set against the variants on the Variants Tab.

[Images here for Variant and Simple listing page]

Below is a list of all the fields that can be set on the General Tab.

Field Name

Description

Required

Allowed Values

Title

This is the name of your product and will be displayed as the title on Rakuten

Yes

Maximum of 255 characters.

 

HTML tags are not allowed.

Tagline

This optional field acts as a sub header to your product title.

No

Maximum of 255 characters.

 

HTML tags are not allowed.

SKU

This is the SKU that your product will have on Rakuten. Once this has been set it cannot be altered unless the listing is removed and a new one created.

Yes

Maximum of 40 characters.

 

Must be unique.

 

Allowed characters: 0-9, a-z, A-Z, “-“ and “_”

Price (simple product only)

This is the price that your product will be for sale at on Rakuten.

Yes

Must be a positive number.

 

Range: 0.001 – 999999999.999

Max Inventory (simple product only)

This sets a maximum inventory value that will be sent to Rakuten. If you have 100 items in stock but set this as 10 then StoreFeeder will only ever report a maximum of 10 as the inventory to Rakuten

No

Must be a number.

Oversell (simple product only)

This value represents a number of additional items of stock that will be reported to Rakuten. If you had 10 items in stock and an oversell value of 2, we would report the inventory figure as 12.

No

Must be a number.

Out of Stock Threshold (simple product only)

This value represents a threshold under which we will report the stock value as 0. If you had 2 items in stock and an Out of Stock Threshold of 2 then we would report the inventory as 0.

No

Must be a number.

Display Start Date

This determines the date when a product will start to display on Rakuten. If you set this as a time in the future then the listing will not be visible until that date.

No

Must be a date.

Listing Controlled by StoreFeeder

This setting determines whether the listing is controlled by StoreFeeder for the purposes of stock management.

Yes

Yes/No.

Inventory Type

This determines how the inventory figure for that listing is calculated.

Yes

Inventory + Oversell.

Inventory + Oversell + Priority Supplier Inventory.

Inventory + Oversell + Sum of Supplier Inventory.

Inventory %

This determines the percentage of your available stock that will be reported to Rakuten.

Yes

Number in the range 0-100.


Description

The Description tab allows you to enter or edit the description that will be displayed for that product on Rakuten. You are free to use HTML in your description, but you are limited to including a maximum of 100 <img> tags.

[Image of description tab]

Below is a list of all the fields that can be set on the Description tab.

Field Name

Description

Required

Allowed Values

Description

The description that will be displayed for that product on Rakuten

Yes

Maximum of 15,000 characters.

 

Maximum of 100 <img> tags.


 

Categories

The Categories tab allows you to specify the categories that your product exists in on Rakuten.

There are two separate types of category on Rakuten: Marketplace Categories and Shop Categories.

Marketplace Categories are a predefined hierarchy of categories created by Rakuten. Each product must exist in one Marketplace Category.

Shop Categories are used defined categories. You are not limited by the number of Shop Categories that your product exists in.

[Image here of Categories tab]

Below is a list of all the fields that can be set on the Categories tab.

Field Name

Description

Required

Allowed Values

Marketplace Category

A Rakuten defined category that your product will exist within

Yes

You must select a first- or second-level child as appropriate.

Shop Categories

User defined categories that your product will exist within

No

N/A


Shipping

The Shipping tab allows you to enter or edit the shipping settings for the product on Rakuten.

Rakuten does currently not allow us to specify individual shipping methods for a listing, but these can be set individually using Rakuten. User predefined shipping methods will be set against the product if Free Shipping is not selected.

[Image here of Shipping tab]

Below is a list of all the fields that can be set on the Shipping tab.

Field Name

Description

Required

Allowed Values

Free Shipping

This determines whether the product on Rakuten is eligible for Free Shipping

Yes

Yes/No.

Length

The length of your product in cm.

No

Must be a positive number.

 

Range:

Width

The width of your product in cm.

No

Must be a positive number.

 

Range:

Height

The height of your product in cm.

No

Must be a positive number.

 

Range:

Weight

The weight of your product in grams.

No

Must be a positive number.

 

Range:


Images (simple products only)

The Images tab allows you to specify the images that will be sent up to Rakuten and display on the product page on Rakuten.

The images available on the Images tab will come from the images set against the product on StoreFeeder. If you want to add images to the listing you will first need to add them to the product in StoreFeeder.

On the Images tab you can specify the order of the images and also determine whether that image should be sent up or not. Clicking on the image will grey it out, indicating that that image will not be sent to Rakuten. Clicking on the image again will reactivate the image and indicate that it should be sent to Rakuten.

Images are not required by Rakuten but you are limited to including a maximum of 10 images per listing

[Image of Images tab]


Variants (variant products only)

The Variants tab allows you to specify your images, values for variants and which variants to include as part of your listing.

Images

Clicking the ‘Edit Images’ button brings up the images dialogue.

The images available on the Images dialogue will come from the images set against the product on StoreFeeder. If you want to add images to the listing you will first need to add them to the product in StoreFeeder.

Rakuten does not provide the ability to link a particular image to a variant, all images are uploaded to the product in the order that you specify.

On the Images dialog you can specify the order of the images and also determine whether that image should be sent up or not. Clicking on the image will grey it out, indicating that that image will not be sent to Rakuten. Clicking on the image again will reactivate the image and indicate that it should be sent to Rakuten.

Rakuten only allows the upload of 10 images per listing.

Variant Attributes

Each of your variants will have one or more variant attribute. Each variant attribute can be named by typing in the text box at the top of thank column. For each variant you are able to select from the drop down list of values or type a desired value in.

Choosing Which Variants to Include

To the left of each variant there is a checkbox. If this checkbox is ticked then the variant will be included as part of the product we send up to Rakuten. If the checkbox is not ticked then that variant will not be included as part of the product sent up to Rakuten.

Variant Values

Each variant as part of the product has a number of fields which can be specified. Those which are required are indicated by an asterisk (*) and must be filled in. Other values are optional and can be left blank.

In order to set specific inventory values for a variant you must click the cog to the right of that variant to access the Max Inventory, Oversell and Out of Stock Threshold for that variant.

[Images as appropriate]

Below is a list of all the fields that can be set on the Variants tab.

Field Name

Description

Required

Allowed Values

SKU

This is the SKU which the variant will have on Rakuten.

Yes

Maximum of 40 characters.

 

Must be unique.

 

Allowed characters: 0-9, a-z, A-Z, “-“ and “_”

Name

This is the name of the variant. This value is not sent up to Rakuten but is useful for helping to identify your variants

Yes

N/A

Price

This is the price that the variant will be for sale at on Rakuten.

Yes

Must be a positive number.

 

Range: 0.001 – 999999999.999

Attribute(s)

This is the attribute values (or values) that will be sent up to Rakuten in order to specify the particular attributes of that variant.

Yes

N/A

Max Inventory

This sets a maximum inventory value that will be sent to Rakuten. If you have 100 items in stock but set this as 10 then StoreFeeder will only ever report a maximum of 10 as the inventory to Rakuten

No

Must be a number.

Oversell

This value represents a number of additional items of stock that will be reported to Rakuten. If you had 10 items in stock and an oversell value of 2, we would report the inventory figure as 12.

No

Must be a number.

Out of Stock Threshold

This value represents a threshold under which we will report the stock value as 0. If you had 2 items in stock and an Out of Stock Threshold of 2 then we would report the inventory as 0.

No

Must be a number.


Submissions

The Submissions tab is not required for the purposes of uploading a listing to Rakuten. This page will display information about recent submissions that have been made to Rakuten.

Sending a product to Rakuten will either succeed or fail after the ‘Save and Upload’ button has been clicked, but some updates that we make require a submission to be made to Rakuten which will happen asynchronously and complete at a later time.

Submissions will be made if:

  • Images are upload.
  • A description is uploaded which includes <img> tags.
  • We are updating the inventory on Rakuten.
  • We are updating the price on Rakuten.

The table on the Submissions tab will show you the OperationID, Submission Type, number of items included in that submission, the first 10 SKUs of the items in that submission, the time the submission was made, the status of the submission and a link to show the details of the submission.

Clicking the ‘Show Details’ link will display a panel at the bottom of the page, detailing the specifics of that submission including any errors with the submission. If a submission failed or completed with errors the error messages should help you determine how to correct your listing.


Saving and Uploading

Once you have completed all the data on the listing page you are able to upload or update the listing to Rakuten by clicking the ‘Save and Upload’ button located at either the top or bottom of the page.

Providing all the information you entered is complete and valid StoreFeeder will attempt to upload or update that product to Rakuten. Once the page has finished processing it will then report back whether the upload or update was successful.

View Listing

Once the listing is live on Rakuten the ‘View Listing’ button will be visible on the page. Clicking this button will open a new tab in your browser and direct you to that listing on Rakuten.

Delete Listing

You have three options available to you for deleting a listing:

  • Delete from StoreFeeder and Rakuten
  • Delete from Rakuten
  • Delete from StoreFeeder

Hovering over the ‘Delete’ button will reveal these options and clicking on the desired option will perform the following actions:

Delete from StoreFeeder and Rakuten This will remove the listing from Rakuten and also delete the listing from StoreFeeder

Delete from Rakuten – This will remove the listing from Rakuten, but will leave the listing in StoreFeeder. This can be useful if you wish to remove a listing from sale but might plan to re-upload it at some point in the future.

Delete from StoreFeeder – This will leave the listing active on Rakuten but delete the listing from StoreFeeder. If you have Automatic Product Download switched on for your channel then this listing will eventually download back into StoreFeeder.

Cancelling Changes

If, after having made some changes on the page, you decide that you do want to keep these changes you can click the ‘Cancel’ link at the bottom of the page, which will discard any changes made and return you to the previous page.


Errors

If you have failed to complete any of the required fields or you have entered data that doesn’t meet requirements then the page will report an error and will not attempt to save the listing. Any fields that have not been completed or are not completed successfully will be highlighted in red with an error message underneath them explaining what is causing the error.

Success or failure with sending the listing to Rakuten will be reported back as by the page as a user message.

A green user message indicates that the listing uploaded or updated successfully.

A red user message indicates that the listing failed to upload or update successfully and an associated error message should be reported to help you understand the nature of the error.

If you notice that product images or images within your description have not uploaded an hour after you saved the listing then checking the Submissions tab should give you an indication of if/why that failed.

If you notice any issues with pricing or inventory updates the Submissions tab will also detail any problems related to these operations.

(2 vote(s))
Helpful
Not helpful

Comments (0)
Post a new comment
 
 
Full Name:
Email:
Comments: