# Provider capabilities

Capabilities are declared during onboarding and configured by FleetBridge. There is no v1 capability endpoint. `true` means the behavior is implemented, authorized in the target environment, and passes certification; an endpoint stub or roadmap item is insufficient.

| Capability | Meaning | Certification evidence |
|---|---|---|
| `supportsWebhook` | sends signed lifecycle events | signature, retries, duplicate/order, callback routing |
| `supportsPolling` | status endpoint converges | lifecycle and unknown-delivery polling |
| `supportsTrackingUrl` | returns a usable tracking URL | tracking response |
| `supportsDriverLocation` | returns/sends driver coordinates | tracking plus location webhook |
| `supportsEta` | returns/sends ETA | tracking plus ETA webhook |
| `supportsProofOfDelivery` | proof artifact end to end | **MUST be false in v1.1** |
| `supportsExternalReference` | persists `platformReference` | create and every webhook |
| `supportsIdempotencyKey` | durable create idempotency | replay, conflict, concurrency, restart |
| `supportsCancellationBeforePickup` | cancel before pickup | controlled cancellation |
| `supportsCancellationAfterPickup` | cancel after pickup | controlled cancellation |
| `supportsOrderUpdate` | supports general update fields | field-by-field PATCH |
| `supportsAddressUpdate` | destination address/location update | PATCH evidence |
| `supportsPhoneUpdate` | phone update | PATCH evidence |
| `supportsScheduledDelivery` | accepts scheduled create | scheduled create fixture |
| `supportsScheduledDeliveryUpdate` | changes schedule | PATCH evidence |
| `supportsReturnToOrigin` | return endpoint has real behavior | controlled return fixture |

A Provider must support at least one of webhooks or polling. Return is capability gated even though the endpoint is specified. Unsupported fields and operations return `422`; they must not report success and discard data.