公開仕様 com.paratus-ai.supplier
版 0.1.0-draft・状態: ドラフト。買い手の AI が事業者の取引条件を読むための仕様です。今後の版で変わることがあります。 サービスと capability の一覧は /.well-known/ucp にあります。
目次
| ファイル | 説明 | 形式 |
|---|---|---|
| vocab | JSON-LD で使う語彙（jp: の名前空間）の定義。 | JSON-LD |
| openapi.json | 買い手の AI 向けの API（/v1）の要求と応答の定義。 | OpenAPI 3.1 |
| profile.md | 事業者名・法人番号・対応言語・支払方法・資格・業法上の表示・拠点を返す。 | Markdown |
| profile.schema.json | GET /v1/organizations/{id} の応答の本文の JSON Schema。 | JSON Schema |
| offerings.md | 公開中の提供物・価格・納期・業種別の項目を返す。登録していない AI には価格の上下限（price.min・max）と条件付き価格（pricing_rules）を返さず、丸めた価格帯（price.band）だけを返す。 | Markdown |
| offerings.schema.json | GET /v1/organizations/{id}/offerings の応答の本文の JSON Schema。 | JSON Schema |
| quote.md | 見積を依頼し、案件を作る。事業者の回答はメール、または案件の状態（GET /v1/cases/{id}）で返す。発注の確定（confirm-order）の委任状（mandate）は省略でき、省略したとき・検証できないとき・登録済みの来訪AIのときは 202 human_confirmation_required と確認リンク（confirmation_url）を返す。検収の確認（confirm-completion）は、発注の記録があり、事業者が完了を記録した案件だけで受け付ける（それ以外は validation_error。reason は order_required・completion_not_reported）。 | Markdown |
| quote.schema.json | POST /v1/quotes の応答の本文の JSON Schema。 | JSON Schema |
| availability.md | 最短の着手日、外部の予約先、拠点ごとの対応可否、予約できる担当者・設備、体験の申込条件を返す。 | Markdown |
| availability.schema.json | GET /v1/organizations/{id}/availability の応答の本文の JSON Schema。 | JSON Schema |
| cancellation.md | 公開中の解約・切替の条件（通知日数・返金・手数料・クーリングオフ・手続き）を返す。 | Markdown |
| cancellation.schema.json | GET /v1/organizations/{id}/cancellation-terms の応答の本文の JSON Schema。 | JSON Schema |
| track_record.md | 公開中の指標（直近12か月）と応答の状況を返す。母数が少ない指標は値を返さず status=accumulating とする。買い手の確認を経た記録と事業者申告は basis で区別する。 | Markdown |
| track_record.schema.json | GET /v1/organizations/{id}/track-record の応答の本文の JSON Schema。 | JSON Schema |