You can manage your orders in the Lengow platform.
Order retrieval frequency
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 2 days
How to identify the marketplace on Octopia orders:
-
In the Lengow platform: The order number contains the sales channel ID, which lets you know from which Octopia marketplace the order originates.
Ex: BEBEFR123456 for a Bebeboutik order -
Via API: Marketplace identification is provided in the order metadata:
- "CorporationCode": Sales Channel ID
- "CorporationName": Sales Channel Name
Order processing
Orders go through various statuses in Lengow while being processed.
Lengow statuses correspond to the following Octopia orders statuses.
For each Lengow status, the possible actions are listed below.
| Lengow Status | Octopia Status | Possible Actions at this status |
|---|---|---|
| "new" | "Processing" | ❌ No action available |
| "waiting_acceptance" | "WaitingAcceptance" (Cdiscount only) | - "accept" / "refuse" |
| "accepted" | "Accepted" | - "refund" action requires: • "refund_reason" (must be one of the valid channel-accepted values) • Optional: "line", "refund_shipping_fees" |
| "waiting_shipment" | "InPreparation" | - "ship" action requires: • "tracking_number" • "carrier" (name of supported carrier only) • Optional: "tracking_url", "line" (except for Cdiscount), "custom_carrier" Note: You can trigger the "ship" action even if an order line is in CancelRequest status (this will automatically refuse the customer's cancellation request). - "refund" action requires: • "refund_reason" (must be one of the valid channel-accepted values) • Optional: "line", "refund_shipping_fees" |
| "shipped" | "Shipped" "Delivered" |
- "refund" action requires: • "refund_reason" (must be one of the valid channel-accepted values) • Optional: "line", "refund_shipping_fees" |
| "canceled" | "Rejected" "Refused" (Cdiscount only) |
❌ No action available Cancel must be managed manually |
| "refunded" | "Cancelled" | ❌ No action available |
- To cancel an order before it ships, you should use the "refuse" action when the order status is "WaitingAcceptance" (available for Cdiscount only).
- If the order is already accepted, waiting to ship, or shipped, you need to use the "refund" action to accept a customer's cancellation or return. Conversely, if the order is waiting to ship and you want to refuse a customer's pending cancellation request, simply use the "ship" action.
- For the "refund" action, called "cancellation" on Octopia), the possible values of the "refund_reason" depend on the order status.
- Partial shipping is not available for Cdiscount.
Shipping orders with pending cancellation requests
You can successfully trigger a "ship" action via Lengow on orders that contain a line with a pending customer cancellation request ("CancelRequest" status), provided the following conditions are met:
- The order status is InPreparation.
- The supply mode is Seller.
- The cancellation was initiated by the customer.
Important: Triggering the shipment in this scenario will automatically override and refuse the buyer's cancellation request. You no longer need to manually resolve the request in the Octopia/OSP back office prior to shipping.
Ship by Marketplace / Fulfillment
The orders from the Fulfillment program of Octopia are sent to Lengow directly with the status "Shipped".
If you import these orders into your back-office :
- using Lengow API: the information can be retrieved:
- through the node "is_delivered_by_marketplace"
- in the <ModGesLog> field: "MKPFBC" value for internal Octopia fulfillment, and "EXTFBC" value for external fulfillment.
- using one of Lengow's Plugins, into the orders import settings
- Prestashop, Magento 1, Magento 2 and Shopware : Activate the option to import the orders shipped by marketplaces.
- Woocommerce: it is not possible to import the orders shipped by marketplaces.