# Xưởng Đồng Phục Việt

> Cửa hàng trực tuyến chạy trên nền tảng Sellsuite. AI agent có thể duyệt sản phẩm và đặt hàng
> qua REST API công khai bên dưới — không cần API key cho luồng mua hàng của khách.

## API cho agent (JSON trừ khi ghi khác)

- Thông tin cửa hàng (tiền tệ, phương thức thanh toán, khu vực): GET https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b
- Danh sách sản phẩm (lọc ?q= &category= &min_price= &max_price= &in_stock=1 &sort=): GET https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/products
- Chi tiết 1 sản phẩm (biến thể, tuỳ chọn cộng giá): GET https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/products/{id}
- Danh mục: GET https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/categories
- Catalog feed (Google Merchant RSS/XML): GET https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/feed.xml
- Tìm kiếm toàn site (sản phẩm + trang + bài viết): GET https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/search?q=
- Tính thử giỏ hàng (không side-effect): POST https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/checkout-preview
- Đặt hàng thật: POST https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/checkout
- Checkout session kiểu ACP (create/update/complete/cancel — khuyến nghị cho agent, complete idempotent):
  POST https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/acp/checkout_sessions
- Tra cứu đơn sau khi đặt: GET https://sellsuite-worker.phamgiagia.workers.dev/api/orders/{orderId}

## Đặt hàng — body tối thiểu cho POST /checkout

{"items":[{"productId":"...","qty":1}],"customerName":"...","customerPhone":"0xxxxxxxxx",
 "shippingAddress":"...","province":"...","paymentMethod":"cod"}

Điền "clientRef" (UUID tự sinh) để chống đặt trùng khi retry. Manifest máy-đọc đầy đủ:
https://sellsuite-worker.phamgiagia.workers.dev/api/site/demo-b2b/agent-commerce.json
OpenAPI 3.0 spec toàn bộ Storefront + Customer API (import Swagger/Postman được ngay):
https://sellsuite-worker.phamgiagia.workers.dev/api/storefront-openapi.json

## Lưu ý

- Giá và tồn kho trong response là THẬT — kiểm tra lại bằng checkout-preview trước khi đặt.
- Agent PHẢI xác nhận với người dùng trước khi POST /checkout (đơn thật, có nghĩa vụ thanh toán).
- Với ACP checkout session: server CƯỠNG CHẾ việc xác nhận — create/get/update trả về "confirm_url", agent
  PHẢI gửi URL này cho người dùng THẬT (không tự gọi); người dùng mở trang, xem tóm tắt đơn, tự bấm xác
  nhận. complete() sẽ bị từ chối (lỗi CONFIRMATION_REQUIRED) cho tới khi người dùng đã xác nhận.