Agent skill
acp-fulfillment
Implement ACP fulfillment options — shipping, digital delivery, in-store pickup, and local delivery. Use when building fulfillment selection, rate calculation, delivery window management, or tracking integration.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/acp-fulfillment
SKILL.md
ACP Fulfillment
Before writing code
Fetch live docs:
- Fetch
https://developers.openai.com/commerce/specs/checkout/— fulfillment options are part of the checkout spec - Web-search
site:github.com agentic-commerce-protocol spec json-schema FulfillmentOptionfor the schema - Web-search
site:github.com agentic-commerce-protocol rfcs orders fulfillmentfor fulfillment in orders
Conceptual Architecture
Four Fulfillment Types
| Type | Use Case | Key Fields |
|---|---|---|
| shipping | Physical delivery to address | Carrier, tracking number/URL, delivery windows |
| digital | Downloads, licenses, access | Access URL, license key, expiration date |
| pickup | In-store or locker collection | Location, ready-by window, pickup-by deadline |
| local_delivery | Same-day/local service delivery | Service area, delivery window |
How Fulfillment Works in Checkout
- Create session — Merchant returns available
fulfillment_options[]based on items and address - Agent selects — Agent (or buyer) picks a
fulfillment_option_id - Update session — Agent sends the chosen
fulfillment_option_idin an update - Merchant recalculates — Totals update to include fulfillment cost
- Post-purchase — Merchant emits order updates with tracking and delivery details
FulfillmentOption Object
Each option includes:
id— Unique identifier for this optiontype— One of the four types abovetitle— Display name (e.g., "Standard Shipping")subtitle— Additional info (e.g., "5-7 business days")carrier— Carrier name for shipping- Delivery window (estimated dates/times)
- Pricing — Cost of this fulfillment option
Delivery Windows
Time-based constraints:
- Estimated delivery — Date range for when buyer can expect delivery
- Ready-by (pickup) — When the order will be ready for collection
- Pickup-by (pickup) — Deadline to collect before order is returned
- Delivery window (local delivery) — Time slot for delivery
Fulfillment in Orders
After checkout completion, fulfillment details appear in order webhook events:
- Tracking number and tracking URL
- Carrier name
- Shipment status updates
- Delivery confirmation
Best Practices
- Return all available fulfillment options on session create (not just the cheapest)
- Compute fulfillment costs based on actual address (not estimates)
- Include realistic delivery windows — agents present these to buyers
- Update tracking information in real-time via order webhooks
- Support multiple fulfillment groups for split shipments
- Handle address validation before computing fulfillment options
Fetch the checkout spec and JSON schema for exact FulfillmentOption field names, types, and required fields before implementing.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?