Contact Boulanger (Johanna Dendievel / firstname.lastname@example.org or Nicolas Ferret / email@example.com) to know if you are eligible to sell your products on their website.
To distribute your products on Boulanger, check that your products catalogue contains the data normally required.
Note: you don't have these values in your products catalogue? Contact the Lengow Support Team to find an alternative.
Add a channel catalogue
Add a Boulanger channel catalogue in your Lengow account.
Match your categories with Boulanger'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 Boulanger 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 Boulanger recommends you fill them in to improve your products visibility.
Special features for Boulanger:
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
Sales : your sales offers should be send to Boulanger the first day of the sales period. Consult our calendar.
2. Delivery method and costs
Shipping costs and delivery methods are defined by Boulanger. Contact Boulanger to obtain the table of costs.
2.1 Delivery methods
Select delivery methods in your Boulanger back office.
2.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 Boulanger. In that case, no action needs to be taken by you in Lengow.
Change the logistics category assigned by default by Boulanger. In that case, fill in the field "logistic_class" (contact your Boulanger account manager to obtain the list of authorised values).
Note: Go to your Mirakl back office if you want to set up free shipping costs for all your products.
3. Variation values
Boulanger doesn't manage products variations and will create a separate product page for each product variation from your products catalogue.
For instance, there will be different product pages for a mobile phone available in different colours on Boulanger:
- One product sheet for the product X in black
- One product sheet for the product X in grey
- One product sheet for the product X in red
- One product sheet for the product X in blue
Manage your Exclusions
In addition to the usual instructions for exclusions, you must exclude for Boulanger:
- "Parent products" if your products catalogue contains any, since Boulanger does not want to receive parent files.
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 Boulanger.
Regarding the identifiers you have to complete:
Enter here your Mirakl API key.
To get it, go to your Mirakl back office, click on your e-mail address at the top right corner ("My account") and then on "API key".
If your API key changed, you also need to change it in your Lengow account.
Here is an example of an API key: b36a2665-109a-4135-a0f0-460d70568ca4.
Enter here your Mirakl store identifier
To find it, go to your Mirakl back office and click on "My account" > "Settings" (visible at the top of the page: identifiant: XXXX)
Launch the channel catalogue
- Before sending your optimised catalogue to Boulanger:
- Check that your Boulanger online store has been created and opened.
- Check that there are no rules created in your Boulanger back office.
Note: contact your Boulanger account manager if you have any question on this matter.
- Send your optimised catalogue to Boulanger
Two distinct feeds are sent to Boulanger through API:
- Product Feed: enables the integration and creation of products. It is sent to Boulanger once a day. If your products are free from errors, they will be created on Boulanger and will appear online within 48 hours, after the offer feed has been sent.
- Offer Feed: enables the update of prices, stock, etc. It is sent to Boulanger every 4 hours. When Boulanger receives the offer feed, data is updated almost immediately on Boulanger website.
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 Boulanger. For each product in error, Boulanger specifies the reason for the rejection.
Product and offer integration reports are available and downloadable from:
- Lengow: "Channel" tab > select "Boulanger" > click on "Activity"
- Your Boulanger 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 Boulanger 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 Boulanger, read our recommendations.
- To delete an offer from your Boulanger Mirakl back office, enter the value "delete" in the field "update_delete" in the "Attributes Matching" area.
Note: Boulanger updates stock quantities at 10 am and 3 pm. If you send the value "0" in the quantity field for a specific product, this product can not be ordered anymore but you may have to wait a few hours until the information "out of stock" appears on the product page.
Manage your Boulanger orders
You can manage your orders in the Lengow platform.
1. Order retrieval
Lengow retrieves orders placed on Boulanger website every hour.
2. Order processing
Orders go through various statuses in Lengow while being processed.
3. Statuses of Boulanger orders
Here is the list of Boulanger statuses corresponding to orders statuses in Lengow:
"STAGING": "awaiting scoring". Order is going through an anti-fraud system.
"WAITING_ACCEPTANCE": “awaiting acceptance of order". During this status you can accept or refuse the order.
"WAITING_DEBIT": payment request for the order is in progress.
"WAITING_DEBIT_PAYMENT": order payment is in progress.
"SHIPPING": order is awaiting for shipment. During this status you can confirm the shipment of the order and enter the carrier and the parcel tracking number/URL.
"SHIPPED": "sent". Order has been sent and shipment is in progress.
"RECEIVED": customer received the order.
"CLOSED": customer received the order and did not open an incident.
"REFUSED": order refused by merchant during "WAITING_ACCEPTANCE" status.
"CANCELLED": order cancelled by merchant or customer.
"WAITING_REFUND": a refund request is in progress. Go to your Boulanger back office to process it.
"WAITING_REFUND_PAYMENT": order refund is in progress.
"REFUNDED": order has been refunded.
- Johanna Dendievel : firstname.lastname@example.org
- Nicolas Ferret : email@example.com