# Integrator Onboarding Guide

This guide walks integrators through the technical steps to build, test, and connect an FBPI integration for one or more sellers. By the end, your webhook will be live, your API integration will handle the full order flow, and your first seller's warehouse will be active and receiving orders.

## What You Will Not Need to Do

- **No warehouse configuration in Seller Lab** — sellers configure their own Integration Warehouse and select your integration from the approved integrator list.
- **No webhook retry logic to implement** — noon retries delivery to your endpoint automatically when it receives a non-2xx response.
- **No product catalog management** — product creation and listing is the seller's responsibility.

---

## Phase 1 — Authenticate with the noon API Platform

Set up your service account credentials and verify that you can make authenticated requests to the noon API gateway.

**Guide:** [Authenticating Your Requests][authenticating-requests]

**Done when:** You receive a valid session cookie from the login endpoint and can call at least one FBPI API endpoint without an authentication error.

---

## Phase 2 — Implement Webhook Handling

Build the endpoint that receives FBPI order notifications from noon. Your endpoint must be publicly reachable, return HTTP 2xx on receipt, and parse the `fbpi_order_nr` from the payload.

For the payload format, validation rules, response requirements, and a sandbox test flow, follow the [Get Order Data from FBPI Webhooks][fbpi/webhook-order-data] guide.

**Done when:** Your endpoint receives a test webhook event, returns HTTP 200, and your system correctly parses the `fbpi_order_nr` from the request body.

---

## Phase 3 — Implement the Order Flow APIs

Integrate the FBPI, Stock, and Pricing APIs to handle the full lifecycle of a partner order: retrieve order details, update item statuses, and create shipments.

**Guide:** [Order Flow][fbpi/order-flow]

**Done when:** A sandbox order flows through your integration end to end — order details retrieved, shipment created with a valid AWB, and manifest completed in Seller Lab.

---

## Phase 4 — Push Stock and Pricing for a Seller

Ensure stock quantities and prices for the seller's catalog are correctly pushed to noon before go-live. Stock and pricing sync must run without errors before orders can be fulfilled.

**Guide:** [Product and Inventory Setup][fbpi/product-inventory]

**Done when:** The seller's products show correct stock and pricing in Seller Lab, and offers are live for all target countries.

---

## Phase 5 — Connect to a Seller's Integration Warehouse

The seller must configure their Integration Warehouse in Seller Lab to point to your webhook URL. You will provide the webhook URL and any required API key.

**Guide:** [Warehouse Setup][fbpi/warehouse-setup] *(seller completes this step with your webhook URL)*

**Done when:** The seller's warehouse status shows **Active** in Seller Lab, and your endpoint receives a test webhook event from that warehouse.

---

## Phase 6 — Validate End to End

Place a sandbox order against the seller's active warehouse and process it through your full integration flow without errors.

**Guide:** [Order Flow][fbpi/order-flow]

**Done when:** The Orders Dashboard shows a successful webhook acknowledgment for the sandbox order on the seller's active warehouse, with shipment created and manifest completed.

---

## Go-Live Checklist

- [ ] Webhook endpoint is publicly reachable over HTTPS and returns HTTP 200 for all order notifications — [Webhook Order Data][fbpi/webhook-order-data]
- [ ] Orders are acknowledged or marked out of stock before the SLA window expires — unacknowledged orders are automatically Killed by noon
- [ ] Shipments are created with valid AWB numbers before the order deadline — [Order Flow][fbpi/order-flow]
- [ ] Stock and pricing sync is running without per-item errors — [Product and Inventory Setup][fbpi/product-inventory]
- [ ] All seller warehouses connected to your integration show **Active** status in Seller Lab — [Warehouse Setup][fbpi/warehouse-setup]
- [ ] End-to-end sandbox test completed with a successful webhook acknowledgment in the Orders Dashboard — [Order Flow][fbpi/order-flow]

## After Go-Live

- [FBPI Orders Dashboard][fbpi/dashboard] — monitor webhook attempts, acknowledgment status, and shipment events across all connected warehouses
- [Webhook Order Data][fbpi/webhook-order-data] — reference for the full webhook payload format and all event types
- [FBPI API Reference][get-fbpi-order] — schema reference for all FBPI endpoints