UCP Fulfillment Extension

Before writing code

Fetch live spec: Web-search site:ucp.dev specification fulfillment and fetch the page for the exact fulfillment schema, method types, group structure, and configuration options.

Conceptual Architecture

Extension Relationship

Fulfillment extends dev.ucp.shopping.checkout. It is pruned from negotiation if the Checkout capability is not in the intersection. Declared as "extends": "dev.ucp.shopping.checkout" in the schema.

Key Concepts

• Methods: shipping or pickup. Each method is tied to specific line items via line_item_ids.
• Destinations: Where items go. For shipping: postal addresses. For pickup: retail locations.
• Groups: Business-generated packages/shipments. Each group belongs to a method and contains selectable options.
• Options: Individual fulfillment choices within a group (e.g., "Standard Shipping 5-7 days", "Express 1-2 days"). Each has a title, carrier, estimated delivery window, and cost totals.
• Available Methods: Alternative fulfillment methods the buyer can switch to, with fulfillable_on indicating availability ("now" or an ISO date).