Integrating Maccaron with EasyEcom

Integrating FOR Real-Custom Selfship with EasyEcom

This guide explains how to integrate FOR Real Marketplace with EasyEcom to manage orders, inventory, and fulfillment.

Step 1: Click on the Settings (⚙️) icon in the top-right corner


Step 2: Click on 'Add Channels'


You will be redirected to the channel selection page.

Step 3: Select 'For Real'



Once you click on it the following pop-up will appear:


Enter the API username & password and Click on Add Channel.
Keep Create Products Automatically disabled unless specifically instructed.

API Username & Password Details

The Username and Password entered here must be the EasyEcom API User credentials.
  • The API user must be created by the client inside EasyEcom.
  • The password must be set by the client.
  • Ensure the API user has the required permissions for integration.
Refer to the following article for creating and defining user roles: Adding and Defining User Role in EasyEcom

Location Key Requirement

The channel is added under a specific warehouse location.
The same Location Key must be shared with the FOR Real team.

To find the Location Key, Click on:

Profile (Top Right Corner) → Copy Account Token / Location Key from the respective warehouse.



Details to be Shared with FOR Real Team

The following 3 details must be shared with the FOR Real team:
  • API Username
  • API Password
  • Location Key

Step 4: Enable API Mode

Go to:
Settings → Sync Channels → For Real

Enable API Mode for the FOR Real marketplace.

API Mode is mandatory for Selfship marketplace integrations.

Order Flow

  1. Product listings are not automatically created via the integration. The seller must manually create or import listings in EasyEcom before orders can be processed.
  2. Customer places an order on FOR Real.
  3. Order is automatically created in EasyEcom.
  4. Seller confirms and processes the order.
  5. Seller ships the order and updates shipment details in EasyEcom.
  6. EasyEcom automatically updates FOR Real with:
    • Order Confirmation
    • Shipment / Manifest Status
    • Tracking Updates
    • Cancellation Updates
    • Return Updates

Integration Touchpoints

S No
API / Webhook Name
Endpoint URL
Direction
Trigger Type
Remarks
1
Get Auth Token
{{easyecom_base_url}}/access/token
Marketplace → EE
API
Used to generate authentication token
2
Create Order
{{easyecom_base_url}}/webhook/v2/createOrder?x-api-key={{easyecom_api_key}}
Marketplace → EE
Webhook
Order creation from FOR Real to EasyEcom
3
Fetch Inventory
{{easyecom_base_url}}/getInventoryDetailsV3?includeLocations=1&limit=50
EE → Marketplace
API
Fetch inventory with location details
4
Mark Initiated Return API
(Endpoint as configured)
Marketplace → EE
API
Used to mark return initiation
5
Cancel Order
{{easyecom_base_url}}/orders/cancelOrder?x-api-key={{easyecom_api_key}}
Marketplace ↔ EE
Webhook
& API
Supports both webhook and direct API cancellation
6
Confirm Order
https://smoked-share-sweat.medusajs.app/easycom/confirm
EE → Marketplace
Webhook
Triggered when order is confirmed
7
Shipped / Manifest
https://smoked-share-sweat.medusajs.app/easycom/shipped
EE → Marketplace
Webhook
Triggered when order is marked shipped
8
Mark Return
https://smoked-share-sweat.medusajs.app/easycom/mark-return
EE → Marketplace
Webhook
Triggered when return is marked in EasyEcom

These endpoints receive automatic updates when the corresponding status changes in EasyEcom.

Return Initiation Note

If the client wants to initiate returns from FOR Real to EasyEcom,

they must contact
care@easyecom.io
(EasyEcom Support)
to enable this feature from the backend.

Important Operational Notes

  1. This is a Selfship integration. Seller manages shipping.
  2. SKU mapping between FOR Real and EasyEcom must be maintained.
  3. Inventory must be available in EasyEcom for order processing.
  4. Order status updates are automatically synchronized once integration is active.
  5. Cancellation is supported from both systems.

    • Related Articles

    • Integrating Custom GSP Channel with EasyEcom

      This article explains how to add and configure a Custom GSP channel in EasyEcom using the integration details shared by the service provider. Prerequisites: Before configuring a Custom GSP channel, ensure you have: Base URL GST Number Username and ...

    • Integrating Loqally with EasyEcom

      This guide explains how to configure the Loqally integration in EasyEcom, and also supports reverse shipment. Step 1: Navigate to Carrier Master Masters > Carrier Master Step 2: Click on 'Add New' and Select 'Loqally Outbound' from the dropdown Step ...

    • Integrating Marketplace using EasyEcom Standard APIs

      You can easily integrate your marketplace with EasyEcom by following the process explained in this video and/or the integration workflow document shared with you.  Marketplace Integration Frequently Asked Questions  1. Do we need to add carrier ...

    • Integrating BoxD Logistics with EasyEcom

      This guide explains how to configure the BoxD Logistics integration in EasyEcom, and also supports reverse shipment. Step 1: Navigate to Carrier Master Masters > Carrier Master Step 2: Click on 'Add New' and Select 'BoxD Logistics Outbound' from the ...

    • Integrating RapidShyp B2B with EasyEcom

      This guide explains how to configure the RapidShyp B2B integration in EasyEcom. Prerequisite RapidShyp B2B works only for accounts where the New B2B Module is enabled. For B2B order processing flow, refer to: B2B Order Processing - New Workflow Step ...