Skip to main content

Step 3: Managing Your Orders

This section explains how FBPI orders move through noon's systems and your integration. It covers how orders are received, acknowledged, converted into shipments, manifested, and handed over to noon logistics.

This is the core workflow all FBPI sellers and integrators must support.

Overview of the FBPI Order Flow​

  1. noon sends the order to your webhook or integrator
  2. Your system acknowledges the order
  3. Your system creates a shipment via API
  4. (Optional) You create a manifest in Partner Platform
  5. You pack and label the order
  6. noon collects the shipment based on your warehouse setup

Step 1 — noon Sends an Order to Your Webhook​

When a customer places an order on noon or Namshi, noon sends order details to the webhook URL configured in your Integration Warehouse.

Your integrator (or your own system) must:

  • Receive the JSON payload
  • Parse the order details
  • Store the data internally
  • Prepare to acknowledge the items

If your system does not respond correctly, noon will retry several times before marking the order as Killed.

Alternative retrieval method​

You may also retrieve orders using the /fbpi/v1/fbpi-order/:fbpi_order_nr/get API endpoint.

Step 2 — Order Acknowledgment​

After the order is received, your system must confirm which items can be fulfilled.

Your system should call /fbpi/v1/fbpi-order/update endpoint to:

  • Validate available inventory
  • Confirm order readiness
  • Respond with acknowledgment using:

You may also retrieve customer information using: /fbpi/v1/fbpi-order/:fbpi_order_nr/customer-details/get

Important​

  • Unacknowledged orders remain Pending.
  • Repeated failures cause the order to become Killed.
  • All acknowledgment responses appear in the FBPI Orders Dashboard.

Step 3 — Shipment Creation​

Once the order is acknowledged, your integration creates a shipment.

  1. Your system can create shipments using the Shipment Creation endpoint: /fbpi/v1/shipment/create
  2. Fetch the shipment data using Get Shipment API: /fbpi/v1/shipment/get
  3. Cancel a shipment if needed using: /fbpi/v1/shipment/cancel

Step 4 — Airway Bill (AWB) Mapping (If Required)​

Each shipment must be mapped to an Airway BillAirway Bill is a code that gets generated for tracking shipments (AWB).

Noon provides AWBs through the Get Noon Logistics AWBs API: /fbpi/v1/shipment/noon-logistics-awbs/get.

which can be used in two ways:

a. Bulk Configuration​

Generate multiple AWBs (e.g., 500 at once) and assign them to shipments as needed.

b. Per-Order Configuration​

Generate an AWB for each shipment in real time.

If an AWB needs to be re-generated for an existing shipment, use the Add Shipment Noon Courier Airway Bill API: /fbpi/v1/shipment/courier-awbs/add.

Step 5 — Manifestation (Manual Step)​

Once shipments are created using the Shipment API, they will appear as pending in Partner Platform. These shipments will not be picked up automatically unless a manifest is created. Unfortunately, there is no API available for creating manifests currently; this step must be completed manually through Partner Platform.

info

We are working on "easy manifestation" option which will make this step optional.

How to Create a Manifest in Partner Platform:

Please follow the steps below to complete your shipment manifestation:

  1. Log in to Noon Partner Platform

  2. Navigate to Manifestation Section

    1. Click the menu icon (☰) at the top left.
    2. Select "noon" from the menu.
    3. Go to "Fulfilled by Partner".
    4. Click on "Manifestation".

  3. Create Manifestation

    1. Select the intended warehouse.
    2. Click on "Create Manifest"
    3. A popup will appear, enter the number of shipments you want to hand over.
    4. Click "Save Changes" to complete the process.

If you do not create a manifest, noon may not collect your packages on time.

Step 6 — Packing & Handover to Noon​

Packing:​

After shipment creation

  1. the seller will pack the order in noon packing material
  2. print the shipment details they got and stick it to the order.

Handover to noon:​

Once the order is packed, noon will collect the shipment based on the handover preference you selected while creating the integration warehouse.

Pickup​

noon's courier collects the shipments from your warehouse based on:

  • Processing time
  • Manifestation data
  • Handover settings

Drop-off​

You deliver the packages to a noon logistics hub. Once the shipment is handed over, its status updates automatically in the noon system.

Tracking & Monitoring​

Throughout the flow, you can monitor:

  • Acknowledgment status
  • Shipment creation
  • Webhook delivery attempts
  • Errors or retries
  • AWB mapping
  • Manifestation completion

All tracking is available in the FBPI Orders Dashboard. For more details, see the next section.