# FleetBridge Order Source Integration Kit This is the complete external integration kit for anything that creates delivery orders through FleetBridge — POS systems, restaurant platforms, e-commerce systems, ordering apps, marketplaces, ERP/order-management systems, collectively "Order Sources" in the docs. Everything an integrating engineering team needs is in this package. You won't need FleetBridge source code, repo access, or an external documentation site. **Contract name:** FleetBridge Order Source API **API major:** v1 **Contract revision:** 1.1.0 **Start here:** open `index.html` in any browser. ## Start here 1. Open `index.html` — the complete, self-contained integration guide. Works offline, no external assets. 2. Read `ORDER_SOURCE_INTEGRATION_API.md` if you prefer plain Markdown (identical content, source of truth for `index.html`). 3. Implement against `fleetbridge-order-source-v1.openapi.json` — the machine-readable contract for the endpoints described in this kit, and only those endpoints. 4. Work through `CERTIFICATION_CHECKLIST.md` as you build. 5. Run `certification/certify.py` against your staging credentials before requesting production activation — see `certification/README.md`. 6. Exchange production credentials with FleetBridge through your approved onboarding channel, not through this repository or any ticket/email that isn't your agreed secure channel. ## Package contents | File / directory | Purpose | |---|---| | `index.html` | The primary artifact — a single, self-contained HTML file with the full integration guide. | | `ORDER_SOURCE_INTEGRATION_API.md` | Plain-Markdown source of truth for `index.html`. | | `fleetbridge-order-source-v1.openapi.json` | OpenAPI 3.0 document covering exactly the Order-Source-facing endpoints. | | `CHANGELOG.md` | Version history and the versioning/backward-compatibility policy. | | `CERTIFICATION_CHECKLIST.md` | The checklist to work through before requesting production activation. | | `examples/` | Sanitized, copy-ready request/response JSON for every scenario described in the guide. | | `webhook-signing/` | Copy-ready webhook signature verification code in C#, JavaScript, and Python. | | `certification/` | A runnable self-certification script plus its own README. | ## Security Never commit real credentials, webhook secrets, or production data into a repository that includes copies of this kit's examples. Every value in `examples/` and this guide is a sanitized placeholder — none of it is a real FleetBridge credential, tenant, or order.