Flipkart B2C Dropship

Marketplace Overview

  • Flipkart Integration integrates Flipkart marketplace with Increff Omni for Flipkart’s B2C Dropship Model

  • Flipkart marketplace uses both push and pull models for order updates

    • Push Flow: Order updates are pushed directly from the Flipkart marketplace to the Flipkart integration.

    • Pull Flow: integration requests order updates from the marketplace based on filters (e.g., status, time).

  • Geography: India

Workflow Breakdown

Workflow

Description

Supported

Remarks

Workflow

Description

Supported

Remarks

Inventory Sync

Inventory update goes to the channel in a batch of 10

YES 

For inventory update, we need the product_id (the channel serial no of CIMS) and the channel_sku_id.

Forward Orders Sync

  • Order Fetching: By status, time, location ID

  • Shipment Details: Retrieved from Flipkart API, includes address

  • Order State: New orders are APPROVED

  • Processing:

    • Channel → Intergration → DB

    • Syncs to CIMS in configurable batches (default: 100)

 YES

  • Order ID:

    • shipment_id as channel order ID

    • parent_order_id for Flipkart order ID

  • API Calls:

    • Retrieves 20 orders per call

    • Provides nextPageUrl for the next batch

  • Error Handling:

    • If fetching fails, return successfully received orders

Routing & Splitting

 NA

 NO

 NA

Forward Order Acknowledgement

Flipkart marketplace doesn’t have the functionality of acking the orders

 NO

Used to pack the order if required

Shipment

API Calls made from Increff to Flipkart sysetm:

  • PACK_CONFIRM: to mark shipment as packed on flipkart

If DISPATCH_IN_PACK is true

  • CREATE_MANIFEST call is made to channel

YES

  • Get order by shipment_id

  • Verify no line items are cancelled and quantity is correct

  • Mark shipment as packed using API

  • Status changes from APPROVED to PACKED on the channel

  • External shipment ID is the channel order ID for Flipkart

Invoicing

Multiple calls made to Flipkart marketplace to:

  • Get invoice and shipping label pdf

  • Get invoice details

 YES

  • The invoice and shipping label documents are the same.

  • Delays in receiving the invoice can cause a PACKING IN PROGRESS error from Flipkart marketplace, which resolves automatically.

  • After packing, the AWB number and transporter details are updated in the shipment details on the marketplace.

Manifest

Call made to Flipkart marketplace to:

  • CREATE_MANIFEST (Marketplace creates manifest at their end)

  • Get order status call to check if all line items are moved to RTD(READY_TO_DISPATCH)

 YES

  • Create manifest call is made in batches of 20.

  • Verify all orders are PACKED before marking as RTD.

  • In Flipkart marketplace, moving an order to RTD adds it to an open manifest based on the transporter.

  • Generate an external manifest ID using an order ID and epoch time for tracking.

Handover

API call from Increff to Flipkart systems:

  • GET Vendor data (vendor details like transporter code, isMPS, pickup details are fetched)

  • GET manifest PDF(manifest pdf created by marketplace is fetched)

 YES

  • Flipkart marketplace fetches manifest documents by transporter/vendor group codes.

  • One open manifest per transporter/location at a time.

  • To fetch a manifest, integration used the vendor group code(seller code) from the vendor data channel API.

  • Increff provides the external manifest ID, integration maps transporters to vendor group codes.

  • Manifest can only be fetched if the vendor data API shows open manifests for the transporter.

Forward Order Customer Cancellation

  • Flipkart marketplace pushes customer cancellations to the integration in the forward order notification call.

  • Cancellations are also retrieved via the get cancellation call.

 YES

Cancellations are fetched for the last 5 hours via a paginated API call.

Forward Order Seller Cancellation

  • Partial seller cancellation is supported.

  • Seller cancellations are permitted only before the packing stage.

 

 

Replacement/Exchange Order Sync

 

 

Forward order mapping to replacement orders is supported if replacements are enabled in the integration.

Return Order Sync

  • Pull call is get return orders API 

  • Flipkart marketplace also pushes return orders to integration, in return order notification which is synced to CIMS in batches (100 default)

 

  • The API fetches returns from the previous day; longer periods may timeout.

  • Each call returns 25 orders, integration uses the next page URL for more.

  • No location filter, removes non-relevant returns in the integration.

  • For multiple quantities, integration creates separate line items with unique IDs, adding suffixes like "_1".

Return processed notification updates

The marketplace pushes return order updates to the integration, which syncs them to Increff omni system.

 YES

 

Return Order Cancellation

Synced to Increff system in the update return order push call.

 YES

 

Visualizing the Flow

Marketplace-Specific Details

Property

Values

Property

Values

Cancellation Reasons

  • SELLER_REJECTED: Cancellation initiated by seller.

  • MARKETPLACE_CANCELLATION: Cancellation initiated by marketplace.

Return Reasons

  • Customer return in case of Size, colour etc mismatch

  • RTO in case of three delivery attempt failure

  • RTO in case of courier rejection

Replacement Orders

  • Replacement orders are treated as new orders.

  • Parent order code is same for both others and charge for replacement order is 0.

Cancellation Support

Cancellation is supported until order is PACKED

API Performance

  1. UPDATE_INVENTORY : 500 ms

  2. PULL_ORDERS : 500 ms

  3. PACK_ORDER : 200 ms

  4. PUSH_ORDERS : 30 ms

  5. MANIFEST : 400 ms

Channel Onboarding Details

Onboarding Steps

  1. Seller Account Creation : A seller should have a seller account on Flipkart. With this seller account login they can register a third party application to it’s account. This registration will enable Increff’s Flipkart integration to access Flipkart APIs for that seller.

  2. Seller Migration Managed by Increff: For this client needs to share the seller credentials with increff

  3. Pull Flow onboarding:The Increff onboarding team uses the shared credentials to log into the Flipkart seller panel, request authorization, and obtain a code to generate access and refresh tokens, which are then used for API calls to the Flipkart marketplace.

  4. Push Flow onboarding: Mail is sent to Flipkart marketplace to enable push notifications with the seller's registered email, notification URLs for orders and returns, location IDs, application ID, and client name.

Information required from Client for Channel Onboarding in Increff

Configuration Parameter

Remarks

Configuration Parameter

Remarks

Seller onboarding credentials 

 Seller’s Flipkart Account Username and Password

Estimated Timeline

  • Pull Flow → 2 Business Days

  • Push Flow → 7-10 Business Days

FAQs

Q : Why do the channel credentials expire for Flipkart Marketplace and how is it fixed?

A: The refresh token for Flipkart expires after 180 days. When this happens, the Increff success team login to the Flipkart seller portal to generate a new token. Increff has alerts configured to notify the team whenever a call fails, ensuring the issue is resolved promptly.

Q: Can a client use both push and pull mechanisms simultaneously?
A: Yes, a client can use both push and pull mechanisms simultaneously. Both flows operate independently, ensuring that if an order is received through one mechanism, the other handles it idempotently.

Q: What is the PACK_IN_ACK flow and how does it work?
A: The Flipkart Marketplace often requires up to 4 hours to generate a shipping label after the pack confirmation call. To prevent delays, Increff mocks the pack confirmation call to the marketplace as soon as the inventory is allocated to the respective order. This helps streamline the process and avoid operational bottlenecks.

Q: How do replacement orders flow and how are they related to the original order?
A: Replacement orders are treated as new orders but share the same parent order code as the original order. Despite having the same parent order code, the original and replacement orders are treated independently in all other respects.