-logo.png

Contact IBS (Manuela Franchini / manuela.franchini@ibs.it) to know if you are eligible to sell your products on their website.

To distribute your products on IBS, 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 IBS channel catalogue in your Lengow account.

Match Categories

Match your categories with IBS's through "Categories Matching".

Complete AttributesAttributes Matching

Match your products catalogue fields with the fields requested by the channel, based on field definition. 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 IBS 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 IBS recommends you fill them in to improve your products visibility.

Some special features for IBS:

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 (example: 2016-01-01).
  • "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 (example: 2016-01-31).

2. Delivery method and costs

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

2.1 Delivery methods

Select delivery methods in your IBS 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 IBS. In that case, no action needs to be taken by you in Lengow.

OR

Change the logistics category assigned by default by IBS. In that case, fill in the field "logistic_class" (contact your IBS 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

IBS does not manage product variations and will create a separate product file for each product variation featured in your product catalogue.

Example : IBS will publish several sheets on its website for a product available in different colours :
- 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 IBS :

  • "Parent products" if your product catalogue contains any as IBS 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 IBS.

Regarding the identifiers you have to fill in:

  • "Mirakl_key": enter here your API key. To get it, go to your IBS 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.
  • "Mirakl_storeid": enter here your Mirakl store identifier. To find it, go to your IBS 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 IBS:
    • Check that your IBS online store has been created and opened.
    • Check that there are no rules created in your back office IBS.

Two distinct feeds are sent to IBS through API:

  • Product Feed: enables the integration and creation of products. It is sent to IBS once a day. If your products are free from errors, they will be created in IBS 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 IBS once an hour. When IBS receives the offer feed, data is updated almost immediately on IBS 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 IBS. For each product in error, IBS specifies the reason for the rejection.

Product and offer integration reports are available and downloadable from:

  • Lengow: "Channel" tab > select "IBS" > "Activity"
  • Your IBS 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

Contact your IBS account manager to edit this data.

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

Unpublish/Delete an offer

Manage your IBS orders

You can manage your orders in the Lengow platform.

1. Order retrieval

Lengow retrieves orders placed on IBS website every hour.

2. Order processing

Orders go through various statuses in Lengow while being processed.

3. Statuses of IBS orders

Here is the list of IBS statuses

corresponding to orders statuses in Lengow:

  • New order

"STAGING": "awaiting scoring". Order is going through an anti-fraud system.

  • Waiting acceptance

"WAITING_ACCEPTANCE": “awaiting acceptance of order". During this status you can accept or refuse the order.

  • Accepted

"WAITING_DEBIT": payment request for the order is in progress.

"WAITING_DEBIT_PAYMENT": order payment is in progress.

  • Waiting shipment

"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

"SHIPPED": "sent". Order has been sent and shipment is in progress.

  • Closed

"RECEIVED": customer received the order.

"CLOSED": customer received the order and did not open an incident.

  • Refused

"REFUSED": order refused by merchant during "WAITING_ACCEPTANCE" status.

  • Cancelled

"CANCELLED": order cancelled by merchant or customer.

  • Refunding

"WAITING_REFUND": a refund request is in progress. Go to your IBS back office to process it.

"WAITING_REFUND_PAYMENT": order refund is in progress.

  • Refunded

"REFUNDED": order has been refunded.

Contact IBS

  • Manuela Franchini / manuela.franchini@ibs.it

IBS

-logo.png

Contact IBS (Manuela Franchini / manuela.franchini@ibs.it) to know if you are eligible to sell your products on their website.

To distribute your products on IBS, 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 IBS channel catalogue in your Lengow account.

Match Categories

Match your categories with IBS's through "Categories Matching".

Complete AttributesAttributes Matching

Match your products catalogue fields with the fields requested by the channel, based on field definition. 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 IBS 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 IBS recommends you fill them in to improve your products visibility.

Some special features for IBS:

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 (example: 2016-01-01).
  • "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 (example: 2016-01-31).

2. Delivery method and costs

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

2.1 Delivery methods

Select delivery methods in your IBS 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 IBS. In that case, no action needs to be taken by you in Lengow.

OR

Change the logistics category assigned by default by IBS. In that case, fill in the field "logistic_class" (contact your IBS 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

IBS does not manage product variations and will create a separate product file for each product variation featured in your product catalogue.

Example : IBS will publish several sheets on its website for a product available in different colours :
- 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 IBS :

  • "Parent products" if your product catalogue contains any as IBS 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 IBS.

Regarding the identifiers you have to fill in:

  • "Mirakl_key": enter here your API key. To get it, go to your IBS 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.
  • "Mirakl_storeid": enter here your Mirakl store identifier. To find it, go to your IBS 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 IBS:
    • Check that your IBS online store has been created and opened.
    • Check that there are no rules created in your back office IBS.

Two distinct feeds are sent to IBS through API:

  • Product Feed: enables the integration and creation of products. It is sent to IBS once a day. If your products are free from errors, they will be created in IBS 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 IBS once an hour. When IBS receives the offer feed, data is updated almost immediately on IBS 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 IBS. For each product in error, IBS specifies the reason for the rejection.

Product and offer integration reports are available and downloadable from:

  • Lengow: "Channel" tab > select "IBS" > "Activity"
  • Your IBS 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

Contact your IBS account manager to edit this data.

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

Unpublish/Delete an offer

Manage your IBS orders

You can manage your orders in the Lengow platform.

1. Order retrieval

Lengow retrieves orders placed on IBS website every hour.

2. Order processing

Orders go through various statuses in Lengow while being processed.

3. Statuses of IBS orders

Here is the list of IBS statuses

corresponding to orders statuses in Lengow:

  • New order

"STAGING": "awaiting scoring". Order is going through an anti-fraud system.

  • Waiting acceptance

"WAITING_ACCEPTANCE": “awaiting acceptance of order". During this status you can accept or refuse the order.

  • Accepted

"WAITING_DEBIT": payment request for the order is in progress.

"WAITING_DEBIT_PAYMENT": order payment is in progress.

  • Waiting shipment

"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

"SHIPPED": "sent". Order has been sent and shipment is in progress.

  • Closed

"RECEIVED": customer received the order.

"CLOSED": customer received the order and did not open an incident.

  • Refused

"REFUSED": order refused by merchant during "WAITING_ACCEPTANCE" status.

  • Cancelled

"CANCELLED": order cancelled by merchant or customer.

  • Refunding

"WAITING_REFUND": a refund request is in progress. Go to your IBS back office to process it.

"WAITING_REFUND_PAYMENT": order refund is in progress.

  • Refunded

"REFUNDED": order has been refunded.

Contact IBS

  • Manuela Franchini / manuela.franchini@ibs.it
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request