To get started on selling your products on the Miravia marketplace, you will need to have an Arise seller account. Getting the products set up in Arise, means you will start selling on the Miravia marketplace. In other words, the marketplace platform is called Arise and the marketplace itself is called Miravia. Therefore, from here on out, we will continue to refer to “Arise” as this is the platform you will push your product information to.
If you don't have an Arise seller account yet, we advise you to reach out to Arise to obtain this. Once you have an Arise seller account set up, you can start connecting with Channable.
Step 1 - Create a new connection
Go to the project you are working on and navigate to the API tab. Click '+ Add new API' and then ‘Add new connection'. In this screen, select the 'Arise' connection.
Step 2 - Login to Arise
You will automatically be redirected to your Arise environment. Here, you need to sign in with your account details and select the country you want to connect with Channable.
After authorizing the connection, you will be transferred back to Channable. Here, you can finish creating the connection by clicking on 'Add connection'.
Step 3 - Setup Arise API
Then in the API step, you can select your newly created 'Arise' connection.
After this, you can give the API connection a clear name, e.g. 'Arise'. It's also important to select the right field for the "Unique ID per item" value. If you are unsure about this, we recommend leaving this field on ID.
Step 4 - Create your product listings
Follow the four steps below to configure your product listings for Arise.
1. Categories
Set up Arise categories for your products by using the generate categories feature or create new categories from scratch.
2. Rules
Create different rules to optimize your product data. For example, take a look at our common rules support article.
3. Build
In the Build step, you can find our pre-set template for the product listings. All you have to do is to fill it out by clicking on the field itself and selecting the corresponding value. For instance, the field 'Quantity' should display the 'stock' of your product and so on.
The ‘Item group ID’ field is used to combine multiple variant items into a grouped listing. If you do not have multiple variants then for the item_group_id you can select the item’s unique id.
Tip! Hover over the question marks next to the fields to see a description of the field and suggestions for possible values.
In the next step, you also need to set your Shipping information, for example, weight, length, and the content of your product.
The last tab in the Build step is the Images tab. Here you can link the field(s) which contain your images.
Arise maintains some strict image requirements on both the image URL and the image itself. If these do not meet the requirements, the product will show a 302 error for your products in the results tab (Scroll down to see an example under step 6 Results). The screenshot below shows all requirements:
4. Attributes
Next, you need to fill in the attributes per category in the Attributes step. A more detailed explanation of what to do in the Attributes step can be found in our Attributes support article.
Step 5 - Send your product listings to Arise
Once you have finished configuring your product listings, you can start sending your product listings to Arise. If you have not activated the project yet, navigate to ‘Settings > Project settings’ and activate the project. Then, go back to APIs and go to the Settings of your Arise API and activate the API here. When you click on 'Run now' your products will be sent to Arise and shown on the Miravia marketplace!
Step 6 - Results
After you have sent your listing to Arise go to the Results tab. If everything went well, you will see all your products under the successful-tab, but it is possible that there are some issues with your products. By clicking on 'errors' you can see which product listings have errors and will not be placed. Click on an error to see what the error message is and which products have that error.
For example, if your product images don't meet Arise's requirements, you could see the following error:
If this happens, you need to check the image and make sure it meets the right requirements. After you have fixed the image, run the API again and see if the error is resolved.
Refreshing your connection
The Miravia connection token expires every two years. When this happens, you need to refresh the connection between Channable and Miravia. You can do this by navigating to the connection in the API settings tab, then click on the connection and finally click on 'refresh connection'.
You will then be redirected to the Arise platform sign-in page and asked to reauthorize Channable to connect with your Arise account.