Worten (Mirakl)

Add a channel catalogue

Add a channel catalogue in your Lengow account.

Match Categories

Match your categories with Worten's using "Categories Matching".

Complete Attributes Matching

Match your products catalogue fields with the fields requested by the channel, based on fields definitions. If necessary, enter hard values, use functions and/or adapt the values by creating rules. For fields with valid values, select the suggested value or match with your products catalogue values.

If a value is missing in the drop-down menu, please contact your channel account manager and ask for the creation of the concerned value.

Some fields are mandatory and must be completed for your products to be created or updated. Other fields are optional but the channel recommends you fill them in to improve your products visibility.

1. Set up your special offers/sales

To set up special offers/sales, fill in the following fields:

• "price": strikethrough price of your product (original price). If your product is not discounted, this field must be filled in with your usual selling price.
• "discount-price": discounted price of your product.
• "discount-start-date" (optional): the date on which your promotion/sale begins. If you fill in this field and the "discount_price" field, the promotion will only begin on the date provided. Format: yyyy-mm-dd
• "discount-end-date" (optional): the date on which your promotion/sale ends. If you fill in this field and the "discount_price" field, the promotion will stop on the date provided. Format: yyyy-mm-dd

Then, fill in the corresponding fields: 

• For Portugal

price[channel=WRT_PT_ONLINE]: optional
discount-price[channel=WRT_PT_ONLINE]: optional
discount-start-date[channel=WRT_PT_ONLINE]: optional
discount-end-date[channel=WRT_PT_ONLINE]: optional

• For Spain

price[channel=WRT_ES_ONLINE]: optional
discount-price[channel=WRT_ES_ONLINE]: optional
discount-start-date[channel=WRT_ES_ONLINE]: optional
discount-end-date[channel=WRT_ES_ONLINE]: optional

2. Delivery method and costs

Shipping costs and delivery methods are defined by the channel. Contact it to obtain the table of costs.

1 Delivery methods

Select delivery methods in your channel back office.

2 Shipping costs

Please note that each product is linked to a logistics category. The shipping costs are calculated on the basis of:

• the delivery method linked to the product
• the logistics category linked to the product

For the logistics category, you may choose between several options:

Keep the logistics category assigned by default by the channel. In that case, no action needs to be taken by you in Lengow.

OR

Change the logistics category assigned by default by the channel. In that case, fill in the field "logistic_class" (contact your channel account manager to obtain the list of authorised values).

3. Variation values

Worten allows variations. To decline your products, fill in the following fields:

• "parent_id": Parent ID of your variations (common reference for all variations of a product). This attribute must be empty if the product is not declined.
• Fill in the attribute(s) corresponding to your product variations (e.g "color", "size")

4. July 2021 VAT legislation - Get compliant!

In Lengow complete the " Shipping Country " field in the Attributes Matching.

Manage your Exclusions

Follow our usual recommendations here.

Parent products must be excluded from the feed sent to Worten, if your products catalogue contains any.

Preview your data

Check the data you are about to send to the channel at the "Preview" step.

Configure your Options

Configure options before sending your products catalogue to the channel.

Mirakl_storeid : Enter here your Mirakl store identifier

More about Mirakl Authentication System

Launch the channel catalogue

• Before sending your optimized catalogue to Worten:
  • Check that your Worten online store has been created and opened.
  • Check that there are no rules created in your Worten back office.

Note: contact your Worten account manager if you have any question on this matter.

• Send your optimized catalogue to Worten

Two distinct feeds are sent to Worten through API:

• Product Feed: enables the integration and creation of products. It is sent to Worten once a day.
• Offer Feed: enables the update of prices, stock, etc. It is sent to Worten every hours.

Read Integration Reports

Read product and offer integration reports to check that your products are properly configured, either at product creation level (product feed) or updates (offer feed). These reports list only items which were rejected by the channel. For each product in error, the channel specifies the reason for the rejection.

Product and offer integration reports are available and downloadable from:

• Lengow: "Channel" tab > select "name of the channel" > click on "Activity"
• Your Channel Mirakl back office:
  • Products feed report: "My Inventory" > "Import From File" > "Track product imports"
  • Offers feed report : "My Inventory" > "Import From File" > "Track offer imports"

Edit a product file

• Edit "product data"

Contact your Worten account manager to edit this data.

• Edit "offer data"

Data is automatically updated as soon as the offer feed is sent out.

Unpublish/Delete an offer

• To stop advertising an offer on Worten, read our recommendations.
• To delete an offer from your Worten Mirakl back office, set the quantity of the product at 0 (zero) in the "Attributes Matching" area.

Manage your Worten orders

• You can manage your orders in the Lengow platform.

  1. Order retrieval

Lengow retrieves new or modified orders on the channel's website:

• Every 15 minutes
• Once a day, for new orders made or amended in the last 5 days 

2. Order processing

Orders go through various statuses in Lengow while being processed.

2. Statuses of Worten orders

Here is the list of Lengow statuses corresponding to orders statuses using Mirakl System:  

• "new": [ "STAGING" ]
• "waiting_acceptance": [ "WAITING_ACCEPTANCE" ]  
• "accepted": [ "WAITING_DEBIT", "WAITING_DEBIT_PAYMENT" ]
• "waiting_shipment": [ "SHIPPING" ] 
• "shipped": [ "SHIPPED" ]
• "refused": [ "REFUSED" ]  
• "closed": [ "CLOSED", "RECEIVED" ]
• "canceled": [ "CANCELED" ]
• "refunding": [ "WAITING_REFUND", "WAITING_REFUND_PAYMENT" ]
• "refunded": [ "REFUNDED" ]

Possible actions:

• accept the order. (order must be at waiting_acceptance status) You may modify the country from where you are shipping the order.
• refuse the order. (order must be at waiting_acceptance status)

• ship the order. (order must be at waiting_shipment status)  

Ship action requires "tracking_number" to be specified, select the carier or indicates its name if not in the list.

If you're using a carrier unregistered by Mirakl, you can enter a "tracking_url". When the carrier is registered by Mirakl, this information is computed automatically.   

• refund (order must be at shipped status)  

Refund action requires "reason" to be specified from the valid values accepted by the channel.

This action may be done for product line.
You may choose to refund taxes or not, as well as shipping costs, and shipping taxes.

Contact Worten

To sign up as a merchant on Worten, fill in this Worten form.

Channel's news

Find here the latest changes/communications from the channel and what you have to do in Lengow: