Integrating Maccaron with EasyEcom

Integrating Home Essential with EasyEcom

This article explains how to integrate Home Essential as an outbound marketplace (Marketplace Shipped) in EasyEcom.
  1. Go to Settings → Add Channels




  2. Select Home Essential


  3. Enter Channel Details:
    1. Username
    2. Password
    3. Enable Create Products Automatically (if required)
    4. Click Add Channel

Inventory Updates

  • EasyEcom sends inventory updates to Home Essential through the Update Inventory webhook.
  • Combo product inventory updates are also supported.

Order and Shipment Processing

The Home Essential integration follows the Marketplace Shipped flow.

  1. Order Creation: Home Essential creates orders and sends them to EasyEcom through the Create Order API.
  2. Order Assignment: After an order is created in EasyEcom, the Order Assignment webhook is sent to Home Essential.
  3. Order Confirmation: Once the order is confirmed in EasyEcom, the Confirm Order Start webhook is sent to Home Essential.
  4. AWB Assignment: Home Essential uses the Assign Shipment Details API to assign the AWB.
  5. Order Fulfilment: After AWB assignment, the fulfilment process is handled within EasyEcom.
  6. Ready to Dispatch (RTD): The RTD webhook is sent to Home Essential when the order is marked as RTD in EasyEcom.
  7. Manifestation: The Manifested webhook is sent to Home Essential when the manifest is generated in EasyEcom.

Order Cancellation

  • Whole-order cancellation is supported.
  • Partial cancellation of individual order line items is not supported.
  • Order cancellation is handled through the Cancel Order API and Cancel Order webhook.

Return Processing

  • Returns are processed using the Mark Pending Return API.
  • Partial returns are supported.

Tracking Updates

Home Essential sends shipment tracking updates to EasyEcom.
The following tracking statuses are supported:
  • Delivered
  • RTO Delivered

Supported API Touchpoints

APIDirection
Get Auth TokenHome Essential → EasyEcom
Get Product MasterEasyEcom → Home Essential
Add Carrier CredentialsHome Essential → EasyEcom
Create OrderHome Essential → EasyEcom
Get Order DetailsEasyEcom → Home Essential
Assign AWBHome Essential → EasyEcom
Unassign AWBHome Essential → EasyEcom
Update Tracking StatusHome Essential → EasyEcom
Update ManifestHome Essential → EasyEcom
Mark Pending ReturnHome Essential → EasyEcom
Cancel OrderHome Essential → EasyEcom
Get Inventory DetailsEasyEcom → Home Essential

Webhook Configuration

Home Essential uses the following webhook endpoints to receive order and inventory updates from EasyEcom.
Webhook Base URL:

Webhook Endpoints:
EventWebhook URL
Update Inventory (V2)https://staging.homeessentials.app/response/easyecom/inventory
Assign Order (V2)https://staging.homeessentials.app/response/easyecom/assign
Order Create (V2)https://staging.homeessentials.app/response/easyecom/create
Order Confirm (V2)https://staging.homeessentials.app/response/easyecom/order-confirm
Order Cancel (V2)https://staging.homeessentials.app/response/easyecom/cancel
Return (V5)https://staging.homeessentials.app/response/easyecom/return
Batch Manifested (V1)https://staging.homeessentials.app/response/easyecom/manifested
RTD (V2)https://staging.homeessentials.app/response/easyecom/packed