Integrator Onboarding

This page guides integrators through the technical responsibilities of building and maintaining the FBPI connection for one or more sellers.

Before You Begin

Integrators must have:

1. A public webhook endpoint:
   It must be reachable, secured, and able to process real-time notifications.

2. Access to the noon API platform:
   Used for stock, price, order acknowledgment, and shipment creation actions.

3. Understanding of FBPI operational flow:
   Integrators must know the sequence from order notification → acknowledgment → shipment → manifestation → handover.

4. A seller project for testing:
   Used to run end-to-end integration validations.

What You Will Do as an Integrator

Your onboarding journey consists of these high-level steps:

1. Understand the FBPI workflows:
   Familiarize yourself with order, stock, and shipment patterns.

2. Implement webhook handling:
   Receive order notifications and respond correctly.

3. Integrate with the noon APIs:
   Authentication, stock updates, price updates, shipment creation.

4. Connect your webhook to a seller’s FBPI warehouse:
   This is done in Seller Lab or the Warehouse Automation Tool.

5. Validate the full order flow:
   Ensure all events are handled correctly for test orders.

6. Monitor and troubleshoot using the Orders Dashboard:
   Validate webhook attempts, retries, and error responses.

What Integrators Are Expected to Own

• Reliability of the webhook endpoint
• Data mapping between seller systems and noon payloads
• Retry logic, idempotency, and error handling
• Logging and monitoring
• Supporting the seller during testing and after go-live

When Integrator Onboarding Is Complete

You are ready to onboard sellers once:

• Your webhook receives and processes events consistently
• You can acknowledge orders without delays
• Shipments are correctly created through the API
• Stock and price sync run without discrepancies
• Test orders flow cleanly end-to-end

Best Practices for Integrators

• Maintain Sync Accuracy: Ensure all order and stock updates are acknowledged and logged successfully in both systems.
• Implement Error Handling: Capture and retry failed API calls gracefully to avoid data inconsistencies.
• Test Before Going Live: Create a testing partner account, and set-up an integration warehouse and place test orders.
• Monitor Webhooks: Regularly validate that webhook endpoints remain active and responsive.
• Stay Updated: Periodically review our noon Developer Docs for API version updates or new endpoint additions.