メインコンテンツへスキップ

概要

サービスリクエストは 2 部構成の状態システムを使用します:
  • 主要状態:メインステージ(DRAFT → QC → UNDERWAY → COMPLETE)
  • 補足状態:追加コンテキスト(PENDING、APPROVED、REJECTED など)

状態の組み合わせ

主要状態補足状態説明パートナーアクション
DRAFT-作成直後、要件が不足支払い/画像を完了
QCPENDING品質管理レビュー待ちレビューを待機
QCREJECTED品質管理で問題発見問題を修正して再提出
QCAPPROVED品質管理合格認証を待機
QCCOMPLETEQC 中のファストトラック完了最終結果を確認
UNDERWAYPENDING認証割り当て準備完了割り当てを待機
UNDERWAYASSIGNED認証者が割り当てられ作業中完了を待機
UNDERWAYAPPROVED認証プロセス完了最終結果を待機
COMPLETEAPPROVED本物 - アイテムが本物と確認認証合格
COMPLETEREJECTED偽物 - アイテムは偽造品認証不合格
COMPLETECOMPLETEドキュメント付きで完全処理済み認証完了
CANCELLED-サービスリクエストがキャンセルリクエストキャンセル

ワークフロー

処理が必要な主要状態

状態必要なアクション
QC + REJECTED問題を修正 - フィードバックを確認し、画像を追加、または詳細を修正
COMPLETE + APPROVED認証合格 - アイテムが本物と確認
COMPLETE + REJECTED認証不合格 - アイテムは本物ではない
CANCELLEDリクエストキャンセル - サービスリクエストがキャンセルされた

実装

// 基本的な状態処理
function handleServiceRequestUpdate(sr) {
  if (sr.state.primary === 'QC' && sr.state.supplement === 'REJECTED') {
    showAttentionRequired(sr); // パートナーアクションが必要
  }
  
  if (sr.state.primary === 'COMPLETE') {
    if (sr.state.supplement === 'APPROVED') {
      handleAuthentic(sr); // 認証合格
    } else {
      handleNotAuthentic(sr); // 認証不合格
    }
  }
}

Webhook

Webhook を通じてリアルタイム更新が利用可能:
  • state_change - 任意の状態遷移
  • media_rejected - 画像の修正が必要
  • invalidate_sr - リクエストがキャンセル
完全な詳細は Webhook イベント をご覧ください。