This guide provides a comprehensive overview of FBPI, including the prerequisites, key concepts, and step-by-step integration instructions, to support you throughout your onboarding journey and enable a seamless end-to-end integration.

What is FBPI?

The Fulfilled by Partner Integration (FBPI) is a fulfillment model that connects your system directly with namshi’s fulfillment system. It automates important steps in the process, reduces manual work, and helps avoid human errors.

Benefits

1. Stock updates and shipment creation happen automatically between your system and namshi.

2. Inventory and order information is updated through the system, reducing mistakes that happen with manual work.

3. Automation reduces manual effort, helping you save time and operational costs.

4. Faster fulfillment and happier customers

5. Automated processes speed up order handling, which leads to faster deliveries and a better customer experience.

Partners Involved

The FBPI fulfillment system involves three main parties:

1. Namshi.com : The platform where customer orders are placed and received.

2.Integrator: The connection between Namshi and the seller. It handles tasks like stock updates, price updates, shipment creation etc. This can be either:

1. a namshi-approved integrator, or

2. direct integration using namshi’s APIs.

3. Seller: The store or warehouse responsible for preparing and fulfilling the order.

Pre Requisites for FBPI 

Before starting, ensure the following:

1. You have a valid Partner ID

2. Your store project is created and visible under your Partner account

3. All your products are created in catalog under your ID partner.

4. Your Integration Warehouse is setup

FBPI Order Processing Flow

Once all the prerequisite steps have been completed, the order processing can be done as follows:

1. Order Received on Namshi.com

Once a customer places an order on namshi, the order details are sent via API either to the integrator or, in case of direct integration, directly to the seller’s system.

2. Order Acknowledgment

The seller acknowledges the order through an API by either:

1. Confirming all items, or

2. Excluding any items that cannot be fulfilled (e.g., out of stock).
   
   

2. Shipment Creation

When the seller is ready to fulfill the order, the shipment is created either by the integrator or directly by the seller’s system and the shipment details are sent to namshi.

3. Order Packing & Labeling

The seller packs the order using namshi-branded packing material and pastes an AWB label on the package.

The AWB can be an external identifier, or an AWB provided by namshi.

4. Manifest Creation 

Once the seller is ready to hand over the items, they must manually create a manifest in Seller Lab or using the Supply Chain External App after generating shipments via the API.

1. This manual step is currently required and ensures the pickup rider can collect the packages and proceed with delivery.
   
   

5. Shipment Handover

The seller hands over the shipment based on the handover method selected during warehouse setup (e.g., Pickup by namshi or Drop-off by the seller).

6. Notifications

After the shipment is handed over to namshi, namshi handles delivery to the customer and sends shipment updates to the seller via webhooks.

Core Documentations

1. Setup Sellerlab (for new sellers)

If you’re new to namshi, you can refer to the steps mentioned in the guide below to set up your Partner ID and store on sellerlab. This is an essential step to sell anything on namshi. ➡ Registration & Onboarding

2. Catalog Creation

As a seller, you need to make sure all your products are listed on sellerlab. You can follow the guide below to create and manage any products manually.
➡ Product Creation

3. Warehouse Configuration Guide

Before order integration can begin, sellers must create an FBPI warehouse and configure it with their webhook to receive order notifications. This guide outlines the required steps to complete this setup.
➡ FBPI Warehouse Creation Guide

4. Manifestation Flow

All shipments prepared for Namshi pickup must be manifested to schedule collection. This guide provides a detailed overview of the manifestation process and the associated operational requirements through seller lab and mobile app.
➡ Manifestation Flow

5. API Documentations