Skill

ucp-fulfillment

Implements UCP Fulfillment extension for shipping/pickup methods, destinations, groups, selectable options, and estimated delivery in checkouts.

api-development

backend

Install

npx claudepluginhub orcaqubits/agentic-commerce-skills-plugins --plugin ucp-agentic-commerce

Tool Access

This skill is limited to using the following tools:

ReadWriteEditBashGrepGlobWebSearchWebFetch

Preview

**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.

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.1k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

claude-code-plugin-release

1 file

Automates semantic versioning and release workflow for Claude Code plugins: bumps versions in package.json, marketplace.json, plugin.json; verifies builds; creates git tags, GitHub releases, changelogs.

claude-mem

64.7k

Stats

Parent Repo Stars14

Parent Repo Forks9

Last CommitMar 9, 2026

Actions

View Source View Plugin View on GitHub View README

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).

Configuration

The fulfillment extension has two configuration scopes:

platform_config (set by the platform, describes platform-level behavior):

supports_multi_group: Whether the platform supports handling multiple fulfillment groups/shipments

merchant_config (set by the merchant/business, describes business-level behavior):

allows_multi_destination: Whether multiple shipping addresses are supported (per method type)
allows_method_combinations: Which method types can be combined (e.g., [["shipping", "pickup"]])

Flow

Platform creates checkout with line items
Business returns fulfillment methods with empty destinations and groups
Platform updates checkout with shipping address(es)
Business recalculates and returns fulfillment groups with selectable options
Platform selects an option per group (or lets user choose)
Business updates totals to include fulfillment costs
Checkout becomes ready_for_complete

Implementation Guidance

Fetch the exact current schema from the live spec before implementing. The fulfillment data model has nested structures (methods → destinations → groups → options) that evolve across spec versions.

Also check the sample server at https://github.com/Universal-Commerce-Protocol/samples for reference fulfillment implementation.